Os agendamentos de matching definem quando o matching automático é executado para o contexto de reconciliação. Eles não extraem dados: para agendar quando uma fonte ingere dados, abra uma fonte e gerencie seus agendamentos de ingestão.
Acessando os agendamentos
- Navegue até Configurar → Contextos na barra lateral esquerda.
- Clique em um contexto para abrir sua página de configuração.
- Selecione a aba Schedules.
A aba Schedules se aplica a um contexto existente. Para contextos novos, salve o contexto primeiro.
Lista de agendamentos
A lista mostra todos os agendamentos de matching configurados para o contexto. Cada linha exibe:
- A expressão cron
- Um selo Enabled ou Disabled
- Os carimbos de data/hora Last run · Next run em UTC; a UI mostra
–para Last run até que um agendamento seja executado e para Next run quando ele está desabilitado - Botões em linha de edição (lápis) e exclusão (lixeira)
Criando um agendamento
1
Na aba Schedules, clique no botão Add matching schedule.
2
Um diálogo intitulado Add matching schedule é aberto. Insira o agendamento no campo Cron expression (placeholder
0 2 * * *, até 100 caracteres).Enquanto você digita, uma pré-visualização ao vivo aparece abaixo do campo: uma frase legível como “Runs: Every day at 02:00” para formatos comuns, “Valid schedule expression.” para expressões válidas mas incomuns, ou um erro se a expressão estiver malformada. A pré-visualização é uma ajuda e não impede o envio. Ela reconhece sintaxe de intervalos e macros nomeadas, como @every 15m, embora os agendamentos de matching do Matcher não a aceitem; o servidor aceita somente uma expressão cron padrão de cinco campos e aplica sua política de cadência ao salvar.3
A caixa de seleção Enabled vem marcada por padrão. Mantenha-a marcada para criar um agendamento ativo ou desmarque-a para criar um desabilitado. Um agendamento desabilitado permanece configurado, não tem horário da próxima execução e não é selecionado nos ciclos posteriores do worker.
4
Clique em Create matching schedule.
Como escrever uma expressão de agendamento
Como escrever uma expressão de agendamento
O Matcher avalia uma expressão cron em UTC. Ela usa cinco campos separados por espaços:
minuto hora dia-do-mês mês dia-da-semana.Caracteres especiais comuns:
*— qualquer valor,— lista de valores (por exemplo,1,15,30)-— intervalo (por exemplo,9-17)/— passo (por exemplo,*/15para cada 15 unidades)
0 6 * * *— todos os dias às 06:00 UTC*/15 * * * *— a cada 15 minutos0 9 * * 1-5— às 09:00 UTC nos dias úteis
@every … e as macros nomeadas não são compatíveis. Quando dia-do-mês e dia-da-semana estão ambos restritos (não são * simples), o Matcher aplica a semântica OR padrão do cron: uma correspondência em qualquer um dos campos dispara o agendamento. O servidor exige um intervalo mínimo de cinco minutos entre execuções: */5 * * * * é a menor cadência permitida; por exemplo, * * * * * e */2 * * * * são rejeitadas.Precisa validar uma expressão? Use o crontab.guru para pré-visualizar quando ela será executada.Editando um agendamento
Clique no botão de lápis de uma linha de agendamento. O diálogo Edit matching schedule é aberto com a expressão cron atual e o estado Enabled pré-preenchidos. Atualize os campos e clique em Save changes. Se o agendamento estiver habilitado, ao salvar o Matcher recalcula Next run a partir do horário UTC atual; ao desabilitá-lo, remove esse carimbo de data/hora.
O diálogo de edição mostra apenas a expressão cron e a caixa de seleção Enabled. Os carimbos Last run e Next run aparecem na linha da lista.
Excluindo um agendamento
Clique no botão de lixeira de uma linha de agendamento. Um diálogo de confirmação Delete matching schedule? aparece; clique em Delete para remover o agendamento permanentemente.