Gatilho Cron

Um Cron gatilho inicia o fluxo de trabalho de acordo com uma programação. Dolibarr deve executar o cron do sistema para que Knot possa calcular next_run_at e enfileirar execuções.

⚡ Pré-requisitos

Tarefa do OS cron ou Plesk chamando htdocs/cron/cron_run.php (ou equivalente) regularmente.
Fluxo de trabalho no estado Ativo.
Conta de execução com direitos necessários: Permissões.

Knot editor with a Cron trigger scheduled at 08:00 — Click to enlarge

⚡ Sintaxe

O Knot aceita expressões cron padrão de 5 campos:

┌───────────── minute (0 - 59)
│ ┌───────────── hour (0 - 23)
│ │ ┌───────────── day of month (1 - 31)
│ │ │ ┌───────────── month (1 - 12)
│ │ │ │ ┌───────────── day of week (0 - 6) (Sunday = 0)
│ │ │ │ │
* * * * *

⚡ Exemplos

Expressão	Efeito
`0 8 * * *`	Todos os dias às 08:00
`0 * * * *`	Toda hora às :00
`/15 * * *`	A cada 15 minutos
`0 9 * * 1-5`	Dias de semana às 09:00

Combine a frequência com o volume de negócios: um Cron agressivo multiplica as execuções e a carga do banco de dados.

⚡ Fuso horário

O servidor PHP usa SO ou fuso horário php.ini. Os turnos de horário de verão podem mover os envios em uma hora.

Verifique date.timezone na hospedagem.
Para “9h, horário de Paris”, documente o servidor TZ em seu runbook interno.

⚡ Pegadinhas

Late Dolibarr cron → late Knot runs (backlog da fila).
Dois fluxos de trabalho no mesmo slot → pico de CPU; escalonar minutos.
Sem idempotência padrão: se uma execução durar mais que o intervalo, serão possíveis sobreposições — use Lógica ou bloqueios de negócios.