Compartilhar via

Evento OnPreStageChange (referência da API do Cliente)

Esse evento ocorre antes que o estágio de um controle de fluxo de processo empresarial seja alterado. Esse evento ocorre depois que o usuário seleciona o Próximo Estágio, Mover para o estágio anterior ou definir botões de Estágio Ativo na interface do usuário ou quando um desenvolvedor usa os formContext.data.process.moveNextmétodos ou formContext.data.process.setActiveStage . formContext.data.process.movePrevious

Observação

O evento OnPreStageChange tem suporte apenas na Interface Unificada.

De dentro de um script de recurso da Web registrado para o evento onPreStageChange, um desenvolvedor pode invocar o seguinte no objeto executionContext passado para o script de recurso da Web:

executionContext.getEventArgs().preventDefault();

Quando você invoca preventDefault:

  • A navegação do estágio não será processada. A instância do processo permanecerá no estágio original.
  • Em uma navegação entre tabelas, a forma da tabela do estágio de destino não será aberta.
  • O salvamento do formulário principal não será processado. Se a forma principal estivesse em um estado sujo, permaneceria em um estado sujo.
  • Todos os recursos da Web registrados noStageChange não serão invocados.

Um objeto de contexto de execução é passado para manipuladores de eventos para esse evento. Você pode usar o método getEventArgs para recuperar um objeto que tenha os seguintes métodos:

  • getDirection: retorna uma cadeia de caracteres Next que é ou Previous para mostrar a direção da alteração de estágio.
  • getStage: retorna um objeto de estágio. Exceto quando a navegação é movida para uma nova tabela, o estágio retornado representa o objeto de estágio de destino, ou seja, o próximo estágio ativo. Quando a navegação se move para uma nova tabela, o estágio é o estágio do qual está sendo navegado, ou seja, o objeto de estágio ativo anterior. Mais informações: métodos de estágio.

Métodos com suporte para este evento

  • formContext.data.process. Método addOnPreStageChange para adicionar manipuladores de eventos para este evento.
  • formContext.data.process. Método removeOnPreStageChange para remover manipuladores de eventos para este evento.

Eventos (referência à API do cliente)
Eventos em formulários e grades em aplicativos baseados em modelos

  • Last updated on