Saltar al contenido principal

Scheduler

1. Visión General​

El componente Scheduler (schedule) dispara el flujo automáticamente en horarios programados, usando una expresión cron. Es el punto de partida de flujos que necesitan correr periódicamente (por ejemplo, todos los días a las 6h, o cada 15 minutos).

Úsalo cuando el flujo necesita ejecutarse por programación, sin depender de una acción externa (como una llamada HTTP o un evento). Solo funciona como disparador de entrada — no puede usarse en el medio o al final de un flujo.

2. Prerrequisitos​

No hay credenciales externas — la programación corre internamente en el motor de flujo.

3. Autenticación y Conexión​

No aplica.

4. Configuración / Operaciones Soportadas​

El componente tiene una única configuración: la expresión que define cuándo debe dispararse el flujo.

CampoObligatorioTipoDescripciónEjemplo
cronSíTexto (expresión cron)Define la frecuencia/horario de disparo del flujo."0 0 6 * * ?" (todos los días a las 6h)

En cada disparo, el flujo recibe un cuerpo vacío ({}) y un header startTimestamp con la hora exacta del disparo.

5. Ejemplos Prácticos​

Ejemplo simple: disparar un flujo todos los días a las 6 de la mañana, para generar un informe diario.

Configuración del componente (inicio del flujo):

{
  "componentName": "schedule",
  "configurations": {
    "cron": "0 0 6 * * ?"
  }
}

Cuerpo recibido por el flujo en cada disparo:

{}

Header disponible:

{
  "startTimestamp": "1753000800000"
}

Ejemplo avanzado: disparar un flujo cada 15 minutos, durante el horario comercial, para verificar pendientes.

Configuración del componente:

{
  "componentName": "schedule",
  "configurations": {
    "cron": "0 0/15 8-18 * * ?"
  }
}

Cuerpo recibido en cada disparo:

{}

6. Errores Comunes y Troubleshooting​

Error / SíntomaCausa probableCómo resolverlo
"Error to create route"La expresión cron está malformada.Revisar la sintaxis de la expresión cron (formato Quartz: segundos, minutos, horas, día del mes, mes, día de la semana).
El flujo no dispara en el horario esperadoLa expresión cron no corresponde al horario deseado, o está usando una zona horaria diferente a la esperada.Probar la expresión cron en una herramienta de validación y confirmar la zona horaria del servidor.