Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Esse evento ocorre antes que o estágio de um controle de fluxo de processo de negócios seja alterado. Esse evento ocorre depois que o usuário seleciona os botões Next Stage, Move to previous stage ou set Ative Stage na interface do usuário ou quando um desenvolvedor usa os formContext.data.process.moveNextmétodos , formContext.data.process.movePreviousou formContext.data.process.setActiveStage .
Observação
O evento OnPreStageChange é suportado apenas na Interface Unificada.
De dentro de um script de recurso da Web registrado no evento onPreStageChange, um desenvolvedor pode invocar o seguinte no objeto executionContext passado para o script de recurso da Web:
executionContext.getEventArgs().preventDefault();
Quando invoca preventDefault:
- A navegação do palco não será processada. A instância do processo permanecerá no estágio original.
- Em uma navegação entre tabelas, o formulário da tabela do estágio de destino não será aberto.
- O salvamento do formulário principal não será processado. Se a forma principal estivesse em estado sujo, permaneceria em estado sujo.
- Quaisquer recursos da Web que se registraram onStageChange 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 que é ou
NextPreviouspara mostrar a direção da alteração de estágio. - getStage: retorna um objeto stage. Exceto quando a navegação se move para uma nova tabela, o estágio retornado representa o objeto do estágio de destino, ou seja, o próximo estágio ativo. Quando a navegação se move para uma nova tabela, o palco é o estágio a partir do qual está sendo navegado, ou seja, o objeto de estágio ativo anterior. Mais informações: Métodos de estágio.
Métodos suportados para este evento
- formContext.data.process. addOnPreStageChange método para adicionar manipuladores de eventos para este evento.
- formContext.data.process. removeOnPreStageChange método para remover manipuladores de eventos para este evento.
Artigos relacionados
Eventos (referência da API do cliente)
Eventos em formulários e grelhas em aplicações condicionadas por modelo