Catalyst Component Event Listener

Introducción

Cada proyecto de Catalyst contiene un event listener de componentes que se crea cuando se crea el proyecto. Como se mencionó en las secciones anteriores, los comportamientos y funcionalidades de los event listeners de componentes y personalizados varían.

El event listener de componentes de Catalyst se utiliza para vincular un componente de Catalyst con una función o circuit objetivo, y pasar los datos del componente a la función o circuit cuando se invoca.

La siguiente tabla describe la lista de componentes de Catalyst y las ocurrencias de eventos en ellos que se pueden asociar con el event listener de componentes:

Por ejemplo, supongamos que la regla de un event listener de componentes está asociada con el evento Upload de archivo en tres carpetas: Folder1, Folder2 y Folder3 en el File Store. Sus funciones objetivo son Function1 y Function2. Esto significa que cada vez que se sube un archivo a una de estas tres carpetas, tanto Function1 como Function2 se ejecutan.

Los datos del evento, como el ID de la carpeta, el nombre del archivo y la hora del evento para las tres carpetas, se pasan tanto a Function1 como a Function2 en un patrón predefinido. Los datos siempre se pasan a la función o circuit objetivo desde el event listener en formato JSON, y estos datos se pueden procesar dentro de tu circuit o función para llevar a cabo la acción requerida.

Se muestra un patrón de datos de ejemplo en la consola cuando creas una regla. Este muestra una estructura de ejemplo de los datos que se pasarán a la función cuando ocurra el evento. El patrón de datos varía según el componente y las acciones con las que la regla está asociada, porque diferentes eventos contendrán diferentes datos.

Por ejemplo, si una regla está asociada con un evento de registro de Authentication, los datos del evento tendrían el siguiente patrón:

{
    "project_details": {
        "id": 57*************,
        "project_name": "Eventbus"
    },
    "event_bus_details": {
        "name": "Default",
        "id": 57*************
    },
    "data": {
        "platform_type": null,
        "user_details": {
            "email_id": "emma@zylker.com",
            "role_details": {
                "role_name": "App User",
                "role_id": 57*************
            },
            "zaaid": 1002347509,
            "created_time": "Sep 10, 2019 11:47 PM",
            "invited_time": "Sep 10, 2019 11:47 PM",
            "modified_time": "Sep 10, 2019 11:47 PM",
            "user_id": 57*************,
            "is_confirmed": true,
            "last_name": "",
            "first_name": "Amelia Burrows",
            "zuid": 1002342431,
            "status": "ACTIVE"
        },
        "org_id": 1002347509,
        "zaid": 1002345135,
        "redirect_url": null
    },
    "current_project": {
        "id": 57*************,
        "project_name": "Eventbus"
    },
    "action": "SignUp",
    "source": "UserManagement",
    "event_time": 1568139437092
}

La regla pasa los datos del usuario y del registro, junto con los detalles del proyecto y otros metadatos sobre el evento. Puedes programar tu función objetivo o configurar tu circuit para procesar los datos del evento como lo necesites.

Ahora trabajemos con event listeners en la consola de Catalyst.

Crear una regla en el event listener de componentes

Puedes acceder al componente Event Listeners desde la sección Triggers en la sección Cloud Scale de la consola. El event listener de componentes de Catalyst ya estará presente de forma predeterminada.

Para crear una regla en el event listener de componentes:

1. Navega a Event Listeners en Triggers en la sección Cloud Scale de la consola de Catalyst.
   
   La página de Event Listeners mostrará el mosaico de Catalyst Component Events con las estadísticas del día de eventos procesados, fallidos y en cola
2. Haz clic en View en el mosaico del event listener para abrirlo.
   
   
3. Haz clic en Create Rule.
   
   
4. Ingresa un nombre y una descripción para la regla.
   
   
5. Selecciona un componente de la lista desplegable para asociar la regla. Cuando seleccionas un componente, la ventana emergente mostrará una estructura de ejemplo de los datos que se pasarán a la función o circuit objetivo. Este patrón de datos varía para cada componente que selecciones, como se mencionó anteriormente.
   
   Según el componente que hayas seleccionado, es posible que debas proporcionar información adicional. Por ejemplo, si eliges “Data Store”, puedes seleccionar una o más tablas para asociar la regla.
6. Selecciona las acciones que ocurren en el componente para asociar la regla. Estas acciones también varían según el componente, como se discutió anteriormente.
   
   

7. Elige Function o Circuit como tu Target Point:

   • Si eliges activar Functions:
     Selecciona las funciones objetivo a invocar cuando ocurra el evento. Puedes seleccionar una o más funciones.
     
     

   • Si eliges activar Circuits:
     Selecciona los circuits objetivo de la lista desplegable. Puedes seleccionar uno o más circuits.
     
     

8. Haz clic en Create.

La regla ya está creada. Puedes ver una lista de todas las reglas y sus detalles del event listener de componentes desde su sección.

Cuando haces clic en el nombre de una regla de la lista, verás los detalles de la regla y su patrón de datos de ejemplo.

Puedes consultar las páginas de Processed Events y Queued Events para obtener detalles sobre esas secciones.

Configurar alertas para Catalyst Component Listeners

Como se mencionó anteriormente, puedes configurar alertas automáticas por correo electrónico que se te envíen si el event listener encuentra un fallo, una excepción de código o un tiempo de espera del proceso. Puedes configurar estas alertas directamente en la sección de Event Listeners sin tener que navegar al componente Application Alerts.

1. Haz clic en el botón + Configure en la sección de detalles del event listener para configurar una alerta.

2. Haz clic en Confirm después de configurar la alerta para habilitarla.

3. También puedes eliminar la alerta haciendo clic en el icono de puntos suspensivos junto al estado de la alerta y haciendo clic en Remove.