Conceptos clave

Antes de aprender a configurar un cron, es importante comprender ciertos conceptos clave y terminología sobre Catalyst Cron.

Task Engine

El task engine maneja la lógica del backend de cron y gestiona la ejecución de las tareas cron según su hora de ejecución definida.

Schedule Point

El schedule point determina la entidad que se activará cuando se ejecute una tarea cron. Un cron puede activar cualquiera de los siguientes:

• Function: Puedes codificar una cron function para ejecutar cualquier tarea rutinaria única o recurrente que necesites. Puedes pasar valores de parámetros a esta function de destino de forma dinámica cuando se llame a la function, si es necesario. También puedes insertar un marcador de posición en un parámetro. Un marcador de posición es una variable representacional para el valor dinámico que se pasa. Cuando el valor se genera en el momento de la ejecución, reemplaza la variable del marcador de posición.

• URL de terceros: Cuando la ejecución de un cron invoca una URL de terceros, envía una solicitud HTTP a la URL de destino que especifiques. Esto permite que se produzca la transmisión de datos entre Catalyst y la URL de destino especificada, donde Catalyst puede leer datos del servidor de destino o introducir los datos de tu aplicación en los componentes correspondientes del servidor. Los siguientes componentes participan en el envío de una solicitud a la URL de terceros:

  • Métodos de solicitud HTTP
    Se admiten los siguientes métodos de solicitud HTTP al invocar una URL de terceros mediante un cron:

    • POST: Crea un nuevo recurso en la URL de destino
    • GET: Recupera datos de la URL de destino
    • PUT: Reemplaza un recurso existente en la URL de destino
    • DELETE: Elimina un recurso existente en la URL de destino

  • Headers
    Cuando se envía la solicitud HTTP a la URL de destino, la entidad solicitante envía headers predeterminados en la solicitud para proporcionar información sobre la misma. Algunos ejemplos de headers predeterminados incluyen el origen de la solicitud, el tipo de conexión y el Content-Type.
    

    Además de los headers predeterminados, también puedes definir headers personalizados en la solicitud HTTP. Por ejemplo, puedes incluir un header que especifique el tipo de autorización utilizado, una lista de codificaciones aceptables o la fecha de origen de la solicitud.
    

    Nota: Si usas los métodos HTTP POST o PUT en tu solicitud, debes establecer el content-type de los datos que se envían en el header. Los content-types admitidos son TEXT (text/plain), JSON (application/JSON), JavaScript (application/javascript), XML (application/xml), XML (text/xml) y HTML (text/html).

  • Parámetros de URL
    Puedes pasar parámetros de URL personalizados en formato definido por el usuario con la solicitud HTTP, cuyos valores se establecen dinámicamente cuando se invoca la URL de terceros. Puedes personalizar el valor del parámetro e incluir cualquier término que necesites pasar en el parámetro.

  • Cuerpo de la solicitud
    Puedes incluir un cuerpo de solicitud HTTP opcional al invocar la URL, que puede usarse para transportar datos de formulario y otros datos opcionales. Puedes pasar los datos del formulario en el cuerpo del mensaje opcional en varios formatos.

• Circuits: Puedes crear un flujo de trabajo automatizado usando el componente Circuits y configurar una tarea cron para activarlo una sola vez o de forma recursiva. Puedes crear un Circuit y diseñar su esquema desde la sección Serverless en la consola, ya sea mediante un simple arrastrar y soltar o codificando el flujo de trabajo en JSON. Luego puedes asociar el circuit con un cron al crearlo. Necesitarás configurar la entrada que se pasará al circuit asociado en forma de JSON. Al igual que con functions, también puedes proporcionar valores de marcador de posición en la entrada JSON. Circuits te permite ejecutar un conjunto de tareas en paralelo o en secuencia, y pasar datos entre ellas.

Schedule Type

El schedule type determina la frecuencia de ejecución de una tarea cron. Un cron puede ejecutarse de una de dos formas:

• One Time: La tarea cron se activa solo una vez en la fecha y hora configuradas.
• Recursive: La tarea cron se activa múltiples veces de forma recursiva según la frecuencia, fecha y hora que configures, hasta que la deshabilites o elimines. La frecuencia mínima de recurrencia con la que se puede activar un cron es de una hora.

Execution ID

A cada tarea cron se le asigna un Execution ID único cuando se invoca el cron. Puedes usar este ID para referirte a la tarea cron en el código de tu aplicación o al ver sus registros de ejecución.