Terminología

Antes de continuar leyendo sobre los Catalyst Event Listeners, asegúrate de comprender los siguientes términos en el contexto de Catalyst:

• Event Listener: Un event listener, ya sea de componentes, personalizado o de Zoho, puede activar la ejecución de event functions o circuits. No puede activar la ejecución de ningún otro tipo de función, y una event function no puede invocarse de ninguna otra manera. Puedes asociar múltiples reglas con un event listener, y cada regla puede activar múltiples event functions o cualquier circuit objetivo.

  Cuando se crea un event listener en Catalyst, se crea automáticamente un Event Listener ID único para él. Este ID y el nombre del event listener se pasan como parte de los detalles del bus de eventos a la función o circuit objetivo. Cada proyecto puede contener un máximo de cinco event listeners: cuatro personalizados y un event listener de componentes.

• Reglas: Una regla define la acción específica que activará el event listener de componentes o personalizado.

  • Event listener de componentes: Una regla se asocia con las instancias de un componente particular y un conjunto de acciones que ocurren en ellas.
  • Event listener personalizado: Cada regla actúa como una instancia individual del event listener y se identifica mediante un identificador de regla único.
  • Event listener de Zoho: Una regla se asocia con un evento específico que ocurre en un servicio de Zoho asociado.
    
    Aprenderás sobre esto en detalle en la siguiente sección.
    
    Una regla vincula el evento entrante con la ejecución de la event function asociada o el circuit objetivo y enruta los datos para su procesamiento. Se crea automáticamente un Rule ID único cuando creas una regla para un event listener.

• Eventos:

  • Event listener de componentes: Se considera evento a una acción específica que ocurre en un componente. Por ejemplo, una tabla en el Data Store que se actualiza o un usuario que se registra en tu aplicación. La lista completa de eventos de componentes se proporciona en la siguiente sección.
  • Event listener personalizado: Se dice que un evento ha ocurrido cuando la URL del event listener es invocada por el usuario final de tu aplicación.
  • Event listener de Zoho: Una acción específica que ocurre en un servicio externo de Zoho, como Zoho CRM. Por ejemplo, Leads Created, Sales Order Updated, Campaigns Approved o Email Sent en la cuenta de CRM asociada con la regla particular.

• Eventos en cola: Cuando ha ocurrido un evento para el cual se ha configurado una regla de event listener, la regla asociada se activará. El evento será puesto en cola para su procesamiento. Cada event listener que crees tendrá su propia cola individual. Catalyst invocará las funciones objetivo o circuits asociados para su ejecución durante el procesamiento y les pasará los datos del evento. Después de que la función o el circuit complete su ejecución, o si falla en ejecutarse, el evento será eliminado de la cola.
  
  

  Por ejemplo, si hubieras configurado una regla con un evento de inserción en una tabla del Data Store, el event listener de componentes estará escuchando una acción de inserción en esa tabla. Cuando ocurra esa acción, la regla asociada se activará y el evento será puesto en cola para su procesamiento. En el caso de un event listener personalizado, cuando se invoca la URL del event listener, el evento se pone en cola hasta que la regla haya activado las funciones asociadas y estas completen su ejecución. Puedes ver información detallada de los eventos cuando entran en una cola y están siendo procesados desde la sección Queued Events en la consola.

• Eventos procesados: Después de que la función objetivo o un circuit asociado de una regla de event listener de componentes o personalizado se ejecuta con éxito, se considerará un evento procesado. La sección Processed Events en la consola contendrá información detallada sobre el tráfico de eventos y el historial de ejecución de cada regla que se ejecutó.

• Eventos fallidos: Si la ejecución de las funciones objetivo o circuits asociados de una regla de event listener de componentes o personalizado falla, o si la regla no logra invocar las funciones objetivo o circuits por cualquier motivo, se considerará un evento fallido.