Agendamento, fuso horário e concorrência

Antes de criar um agendamento

Agende somente um Workflow publicado e testado manualmente. Confirme as permissões para administrar calendários e executar o Workflow, entradas disponíveis sem interação com o navegador, Connections autorizadas e capacidade de worker. Um arquivo anexado no teste manual não se torna uma origem permanente para futuras execuções agendadas.

Abra Configuration → Workflow Scheduler para preparar um calendário reutilizável e associe-o pelo Workflow. Revise recorrência, horário inicial, fuso e estado habilitado no formulário. Mantenha-o desabilitado enquanto verifica os valores.

Preparar uma execução diária

1. Publique e execute manualmente o Workflow de laboratório; confirme a saída.
2. Crie um nome reconhecível, como daily_customers_lima.
3. Escolha recorrência diária às 02:15 e selecione America/Lima. Se usar a representação cron, o equivalente é 15 2 * * *.
4. Confira a próxima execução calculada. O fuso do calendário é independente do fuso de Profile usado para exibir datas.
5. Associe o calendário ao Workflow e revise a concorrência. Habilite o agendamento somente depois de aceitar os valores.
6. Após o horário previsto, localize a tentativa no Monitor. Confira tarefas e saída: uma próxima data calculada não comprova execução bem-sucedida.

Interpretar horário local e cron

Não substitua o fuso IANA por uma abreviação ambígua como CST. Em fusos com horário de verão, confira o comportamento previsto perto da transição. Revise o calendário ao mudar seu fuso; alterar apenas o idioma ou Profile não comprova uma reprogramação da execução.

Separar execuções simultâneas de tarefas paralelas

concurrencyPolicy controla a coexistência de execuções do mesmo Workflow: allow, forbid ou replace; o padrão é forbid. Revise essa política antes de agendar cargas que possam se sobrepor. Substituir uma execução não garante desfazer operações externas já realizadas.

maxParallelTasks limita tarefas paralelas dentro de uma execução: aceita 1–64, com padrão 4. Isso não reserva workers, slots, CPU nem capacidade do destino. A seleção real continua dependendo de recursos, autorização e disponibilidade. Uma sequência simples facilita interpretar a primeira aceitação do laboratório.

Conferir e manter o calendário

• Confira o Workflow e as versões publicadas, o calendário associado e o estado habilitado.
• Revise horário e fuso da próxima execução e compare depois uma tentativa real.
• Confirme qual entrada permanente foi lida e onde a saída foi gravada.
• Ao retirar um calendário, confira tentativas existentes: desabilitar futuros disparos não cancela uma execução ativa.

Quando o horário previsto não produz resultado

Confira primeiro se o calendário está habilitado e associado, se o Workflow está disponível e se a política de concorrência impediu sobreposição. Depois examine fila, worker e erros das tarefas. Não crie calendários duplicados como primeira solução: eles podem iniciar gravações extras quando a causa original for resolvida.

Um Timer espera dentro de um percurso; não substitui o Scheduler. Consulte Monitor e recuperação para escolher a ação adequada ao estado observado.