Suscripción de eventos

Escucha una llamada de un suceso o función de vista y, a continuación, obtiene los datos de suceso que se han publicado (utilizando el método bpmext.ui.publishEvent() ) y realiza la lógica especificada en el suceso Al publicar.

Los sucesos se pueden publicar mediante uno de los dos métodos siguientes:

  • view.ui.publishEvent(eventName, payloadData)
  • bpmext.ui.publishEvent(eventName, payload, persistence)

Si la persistencia se ha establecido en true para el método bpmext.ui.PublishEvent, se activarán los escuchas de sucesos, aunque se carguen después de que se haya activado el suceso. Esta funcionalidad solo está disponible a través de bpmext.

Propiedades de configuración

En Configuración, establezca o modifique las propiedades de configuración de la vista.

Las propiedades de configuración para la Suscripción de suceso se muestran en la tabla siguiente:

Tabla 1. Propiedades de configuración para Suscripción de suceso
Propiedad de configuración Descripción Tipo de datos
Nombre de suceso Especifica el nombre del suceso al que se está suscrito. De forma predeterminada, no hay ningún nombre de suceso especificado. String
En suceso publicado Especifica la lógica que tiene lugar cuando se ha publicado el suceso especificado al que se está suscrito. De forma predeterminada, no hay ninguna lógica especificada. String

Ejemplo

Imagine que tiene dos vistas de Texto enmascarado donde los usuarios pueden escribir el número de su tarjeta de crédito. La segunda vista de Texto enmascarado está dentro de una vista Ayuda contextual y la vista Ayuda contextual está dentro de una vista Grupo de entrada. Puede utilizar la vista Suscripción de suceso para verificar si los dos números introducidos coinciden. Para la vista Suscripción de suceso, puede especificar el nombre de suceso CCN_Match en el campo Nombre de suceso. Y puede especificar la siguiente lógica en el campo En suceso publicado (donde el texto en negrita indica los ID de control de las vistas de texto enmascarado, de ayuda contextual y de grupo de entrada).

if(${CCN}.getText() == ${VerifyCCN}.getText() && (${CCN}.getText() != "" && ${VerifyCCN}.getText() != "")){${Input_Group1}.setIcon("check");
${Tooltip1}.setText("Numbers Match");
${Tooltip1}.setColorStyle("S");
${Input_Group1}.setColorStyle("S") } else {${Tooltip1}.setText("Numbers Don't Match");
${Tooltip1}.setColorStyle("E"); ${Input_Group1}.setIcon("close");
${Input_Group1}.setColorStyle("G") }

En el fragmento de código anterior, el ID de control de la primera vista de Texto enmascarado es CCN y la vista tiene la siguiente lógica especificada para el suceso Al cambiar:

${CCN}.ui.publishEvent("CCN_Match");

El ID de control de la segunda vista de Texto enmascarado es VerifyCCN y la vista tiene la siguiente lógica especificada para el suceso Al cambiar:

${VerifyCCN}.ui.publishEvent("CCN_Match");

Si los dos números de tarjeta de crédito especificados coinciden, la primera instancia del número de tarjeta de crédito se marca con el textoNumbers Matchy la segunda instancia se marca con un símbolo de marca de selección. Si los dos números de tarjeta de crédito especificados no coinciden, la primera instancia del número de tarjeta de crédito se marca con el textoNumbers Don't Matchy la segunda instancia se marca con unXsímbolo !.

Nota: Para publicar un suceso, debe llamar al método bpmext.ui.publishEvent . La vista Suscripción de suceso leerá el suceso publicado y puede manejar el nombre y los datos como corresponda a través del suceso En suceso publicado. Por ejemplo:

bpmext.ui.publishEvent(${Name}.getText(), ${Data}.getText())

Sucesos

Establezca o modifique los manejadores de sucesos para la vista en las propiedades de Sucesos. Puede establecer que los sucesos se activen mediante programación o cuando un usuario interactúe con la vista. Para obtener información sobre cómo definir y codificar sucesos, consulte Sucesos definidos por el usuario.

La Suscripción de suceso tiene el tipo siguiente de manejador de sucesos:

  • On published event: Se activa cuando se publica un suceso. Por ejemplo:

    ${SubResult}.setText(me.getEventData())

Según el suceso específico, puede utilizar lógica de JavaScript para modificar los efectos de la vista. Puede encontrar más información sobre cómo utilizar sucesos con vistas en el tema Sucesos definidos por el usuario.

Métodos

Para obtener información detallada sobre los métodos disponibles para la suscripción de sucesos, consulte la API de Suscripción de sucesos JavaScript .

Recursos adicionales

Para obtener información sobre cómo crear un coach o una página, consulte Creación de coaches.
Para obtener información sobre las propiedades estándar (General, Configuración, Posicionamiento, Visibilidady Atributos HTML), consulte Ver propiedades.