Evento OnPreStageChange (referencia de la API de cliente)
Este evento ocurre Antes de que cambie la etapa de un control flujo de proceso de negocio. Este evento ocurre después de que el usuario selecciona los botones Siguiente etapa, Mover a la etapa anterior o Establecer etapa activa en la interfaz de usuario o cuando un desarrollador usa los métodos formContext.data.process.moveNext
, formContext.data.process.movePrevious
o formContext.data.process.setActiveStage
.
Nota
El evento OnPreStageChange solo se admite en Interfaz unificada.
Desde un script de recurso web registrado al evento onPreStageChange, un programador puede invocar lo siguiente en el objeto executionContext pasado en el script de recurso web:
executionContext.getEventArgs().preventDefault();
Cuando invocas preventDefault
:
- La navegación de fase no se procesará. La instancia de proceso se mantendrá en la fase original.
- En una navegación de tabla cruzada, el formulario de la tabla de la etapa de destino no se abrirá.
- No se procesará el guardado del formulario principal. Si el formulario principal está en estado modificado, se mantendría en estado modificado.
- No invocará ningún recurso web que haya registrado onStageChange.
Un objeto de contexto de ejecución se pasa a controladores de eventos para este evento. Puede utilizar el método getEventArgs para recuperar un objeto que tenga los siguientes métodos:
- getDirection: Devuelve una cadena que es
Next
oPrevious
para mostrar la dirección del cambio de etapa. - getStage: Devuelve un objeto de etapa. Excepto cuando la navegación se mueve a una nueva tabla, la fase devuelta representa el objeto de fase de destino, es decir, la siguiente fase activa. Cuando la navegación se mueve a una nueva tabla, la fase es la fase desde la que se navega, es decir, el objeto de fase de destino activa anterior. Más información: Métodos de etapas.
Métodos admitidos para este evento
- método formContext.data.process.addOnPreStageChange para agregar controladores de eventos para este evento.
- método formContext.data.process.removeOnPreStageChange para eliminar los controladores de eventos para este evento.
Artículos relacionados
Eventos (referencia de API de cliente)
Eventos en formularios y cuadrículas en aplicaciones basadas en modelos