O que é um agendamento?
Um agendamento é um gatilho baseado em cron ligado a um contexto. Quando ele dispara, o Matcher inicia uma execução de correspondência
COMMIT para esse contexto com as regras e as fontes dele. A execução só concilia quando o contexto está ACTIVE.
Ciclo de vida do agendamento
Os agendamentos têm um ciclo de vida CRUD completo em
/v1/contexts/{contextId}/schedules.
Como criar um agendamento
Forneça uma
cronExpression. O campo enabled fica ativo por padrão quando omitido.
cURL
String
obrigatório
Expressão cron que define a frequência de execução (1–100 caracteres), com pelo menos cinco minutos entre disparos. Use cinco campos: minuto, hora, dia do mês, mês e dia da semana. O Matcher rejeita um campo de segundos, macros como
@daily e agendamentos por minuto e abaixo de um minutoBoolean
Se o agendamento fica ativo imediatamente
id, o nextRunAt e os timestamps dele. Listar agendamentos (GET) retorna cada agendamento do contexto, habilitados e desabilitados igualmente.
Pausar vs. excluir um agendamento
Quando você precisar parar uma conciliação recorrente, tem duas opções. Desabilite o agendamento para pausar as execuções automáticas mantendo a configuração e o histórico dele. Reabilitar depois é uma única chamada, sem precisar recriá-lo. Atualize a expressão cron, alterne
enabled ou faça os dois (os campos omitidos ficam inalterados):
cURL
DELETE .../schedules/{scheduleId}) apenas quando a cadência tiver acabado de vez. A exclusão é permanente. Para dar uma pausa, desabilite.
Boas práticas
Alinhe a cadência com a disponibilidade das fontes
Alinhe a cadência com a disponibilidade das fontes
Agende as execuções para disparar depois que todas as fontes do contexto entregarem os dados delas do período. Rodar antes de a ingestão terminar produz exceções evitáveis.
Prefira desabilitar a excluir
Prefira desabilitar a excluir
Para pausar uma cadência de conciliação, desabilite o agendamento. Ele mantém o histórico e a configuração, e reabilitar é uma única chamada.
Use expressões cron explícitas
Use expressões cron explícitas
Mantenha as expressões cron legíveis e documentadas (por exemplo
0 0 * * * = diariamente às 00:00). O Matcher as avalia em UTC.Próximos passos
Contextos e fontes
Configure os contextos e as fontes que um agendamento concilia.
Geração de relatórios
Revise os resultados produzidos pelas execuções agendadas.