Plataforma Dataforall

Este documento explica como funcionam todas as periodicidades de agendamento dentro da Plataforma Dataforall, incluindo orientações, exemplos e boas práticas ao utilizar expressões CRON.

📌 Campos Básicos de um Agendamento

• Nome: identificação do agendamento

• Periodicidade: frequência com que o agendamento será executado

• Tipo de Tarefa: operação que será executada automaticamente

Dependendo da periodicidade escolhida, campos adicionais serão exibidos.

🔄 Tipos de Periodicidade

A seguir, você encontra uma explicação clara de cada periodicidade, acompanhada de exemplos.

⏱️ Intervalo de Tempo

Executa uma tarefa a cada X minutos, podendo limitar horários e dias da semana.

Campos exibidos:

• A cada X minutos

• Horas (ex.: 09-20 ou *)

• Dia da Semana (1-7 ou *)

Exemplo equivalente em CRON:

*/10 9-20 * * *

Isso executa a cada 10 minutos, entre 09h e 20h.

🕐 A Cada Hora

Executa a tarefa de hora em hora, apenas nas horas e dias informados.

Exemplo:

0 * * * 1-5

Executa toda hora, de segunda a sexta.

📅 Diariamente

Executa uma vez ao dia, no horário definido.

Exemplo:

10 16 * * *

Executa todos os dias às 16:10.

📆 Semanalmente

Executa no dia da semana escolhido, sempre no mesmo horário.

Exemplo:

30 8 * * 3

Executa todas as quartas-feiras às 08:30.

🗓️ Mensalmente

Executa uma vez por mês no dia e horário definidos.

Exemplo:

0 7 1 * *

Executa no dia 1º de cada mês às 07:00.

⚙️ Estilo Cron (Avançado)

Permite liberdade total na configuração da periodicidade.

A expressão CRON segue a estrutura:

MINUTO HORA DIA_DO_MÊS MÊS DIA_DA_SEMANA

Valores aceitos:

• Minuto: 0–59

• Hora: 0–23

• Dia do mês: 1–31

• Mês: 1–12

• Dia da semana: 0–7 (0 e 7 = domingo)

📘 Exemplos Úteis de CRON

Aqui estão exemplos práticos que ajudam na construção de um CRON válido:

Executar todo dia às 08:00

0 8 * * *

Executar todo dia às 18:30

30 18 * * *

Executar a cada hora

0 * * * *

Executar de segunda a sexta às 09:00

0 9 * * 1-5

Executar no dia 1 do mês às 07:00

0 7 1 * *

Executar todo domingo às 23:45

45 23 * * 0

Executar a cada 15 minutos

*/15 * * * *

Executar às 03:00 e às 15:00

0 3,15 * * *

Executar no dia 15 de cada mês à meia-noite

0 0 15 * *

Executar diariamente em janeiro e julho às 12:00

0 12 * 1,7 *

Executar de hora em hora entre 09h e 18h

0 9-18 * * *

❌ Exemplo de CRON que gera erro

Expressão incorreta:

0 12,24 * * *

Por quê?
No CRON, a hora 24 não existe. Os valores válidos vão de 0 a 23.

✔️ Correção da expressão

0 12,0 * * *

Isso agenda a execução às 00h e às 12h.

💡 Boas Práticas ao Criar Agendamentos

• Sempre confira se os valores usados são válidos (principalmente a faixa de horas).

• Evite misturar intervalos incorretos, como 12-30.

• Se estiver em dúvida, utilize periodicidades prontas ao invés do Estilo Cron.

• Antes de salvar, revise a expressão CRON para garantir que não travará o agendamento.