Scheduler

1. Visão Geral

O componente Scheduler (schedule) dispara o fluxo automaticamente em horários programados, usando uma expressão cron. É o ponto de partida de fluxos que precisam rodar periodicamente (por exemplo, todo dia às 6h, ou a cada 15 minutos).

Use quando o fluxo precisa ser executado por agendamento, sem depender de uma ação externa (como uma chamada HTTP ou um evento). Só funciona como gatilho de entrada — não pode ser usado no meio ou fim de um fluxo.

2. Pré-requisitos

Não há credenciais externas — o agendamento roda internamente na engine de fluxo.

3. Autenticação e Conexão

Não aplicável.

4. Configuração / Operações Suportadas

O componente tem uma única configuração: a expressão que define quando o fluxo deve ser disparado.

Campo	Obrigatório	Tipo	Descrição	Exemplo
cron	Sim	Texto (expressão cron)	Define a frequência/horário de disparo do fluxo.	"0 0 6 * * ?" (todo dia às 6h)

A cada disparo, o fluxo recebe um corpo vazio ({}) e um header startTimestamp com o horário exato do disparo.

5. Exemplos Práticos

Exemplo simples: disparar um fluxo todos os dias às 6 da manhã, para gerar um relatório diário.

Configuração do componente (início do fluxo):

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

Corpo recebido pelo fluxo a cada disparo:

{}

Header disponível:

{
  "startTimestamp": "1753000800000"
}

Exemplo avançado: disparar um fluxo a cada 15 minutos, durante o horário comercial, para verificar pendências.

Configuração do componente:

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

Corpo recebido a cada disparo:

{}

6. Erros Comuns e Troubleshooting

Erro / Sintoma	Causa provável	Como resolver
"Error to create route"	A expressão cron está malformada.	Revisar a sintaxe da expressão cron (formato Quartz: segundos, minutos, horas, dia do mês, mês, dia da semana).
Fluxo não dispara no horário esperado	A expressão cron não corresponde ao horário desejado, ou está usando um fuso horário diferente do esperado.	Testar a expressão cron em uma ferramenta de validação e confirmar o fuso horário do servidor.