Agendador de eventos

Descrição

Agendar fluxos de trabalho específicos pode ser uma ferramenta de organização útil, pelo que o PlaidCloud oferece essa possibilidade. Com o Event Scheduler, pode agendar a execução de um fluxo de trabalho por mês, dia do mês, dia da semana, hora e minuto — no fuso horário em que o agendamento deve ser interpretado.

Um evento agendado indica um fluxo de trabalho de um projeto, mais o agendamento segundo o qual é executado. Para executar vários fluxos de trabalho com a mesma cadência, adicione um evento para cada um.

A Events Table lista todos os eventos da área de trabalho com o projeto e o fluxo de trabalho que executam, o desfasamento UTC, o estado e as horas de início e de fim da última execução, e quando é devida a próxima.

Para ver eventos:

1. Abra Analyze
2. Selecione “Tools”
3. Clique em “Event Scheduler”

Isto abre a Events Table, que mostra todos os eventos atualmente configurados para a área de trabalho.

Nota

Se o evento estiver ativo, é apresentado o ícone “Active”.

Defina quando — por mês, dia do mês, dia da semana, hora e minuto, no fuso horário que escolher — e o evento dispara o fluxo de trabalho automaticamente em cada hora agendada.

Criar um evento

Para criar um evento:

1. Abra Analyze
2. Selecione “Tools”
3. Clique em “Event Scheduler”
4. Clique em “Add Scheduled Event”
5. Preencha os campos de Details, Timezone e agendamento descritos abaixo
6. Clique em “Create”

Detalhes

Name — como o evento aparece na Events Table. Obrigatório.

Memo — uma nota opcional sobre a finalidade do evento.

Activate Job and Run on Defined Schedule — selecionado por predefinição. Desmarque para guardar o evento sem permitir que seja executado; consulte Pausar um evento.

Project e Workflow — o fluxo de trabalho que este evento executa. Escolha primeiro o projeto: a lista Workflow é preenchida a partir do projeto selecionado. Ambos são obrigatórios e ambos ficam fixos depois de o evento existir — para mudar um evento para outro fluxo de trabalho, elimine-o e adicione um novo.

Fuso horário

O agendamento é interpretado neste fuso horário, escolhido como um desfasamento de UTC -12 a UTC +14. Por predefinição é UTC +0, que é interpretado como a hora de Londres, incluindo a hora de verão britânica.

A maioria dos desfasamentos corresponde à hora local de um local com esse desfasamento e segue a hora de verão desse local: um evento em UTC -5 definido para as 09:00 é executado às 09:00 em Nova Iorque, tanto no verão como no inverno, o que corresponde às 13:00 UTC no verão e às 14:00 UTC no inverno. A coluna Next Run e o calendário de próximas execuções mostram quando o evento será realmente executado.

Desfasamento	Interpretado como	Hora de verão
UTC -12	UTC -12	Não
UTC -11	Pago Pago	Não
UTC -10	Honolulu	Não
UTC -9	Anchorage	Sim
UTC -8	Los Angeles	Sim
UTC -7	Denver	Sim
UTC -6	Chicago	Sim
UTC -5	Nova Iorque	Sim
UTC -4	Porto Rico	Não
UTC -3	São Paulo	Não
UTC -2	Geórgia do Sul	Não
UTC -1	Açores	Sim
UTC +0	Londres	Sim
UTC +1	Roma	Sim
UTC +2	UTC +2	Não
UTC +3	Riade	Não
UTC +4	Dubai	Não
UTC +5	Carachi	Não
UTC +6	UTC +6	Não
UTC +7	Banguecoque	Não
UTC +8	Singapura	Não
UTC +9	Tóquio	Não
UTC +10	Sydney	Sim
UTC +11	Guadalcanal	Não
UTC +12	Auckland	Sim
UTC +13	Apia	Não
UTC +14	Kiritimati	Não

Agendamento

O agendamento é composto por cinco campos — Months, Hours, Minutes, Days of Month e Days of Week — cada um com uma lista de caixas de seleção e uma caixa All no topo. O evento é executado sempre que a hora atual corresponde a um valor selecionado em todos os campos em simultâneo.

Todos os campos precisam de algo: selecione All para corresponder a todos os valores ou selecione os valores individuais pretendidos. Um campo totalmente em branco impede a gravação do evento, e a mensagem indica o campo para que o possa encontrar.

Alguns exemplos:

• Todos os dias às 06:30 — All em Months, Days of Month e Days of Week; 06 em Hours; 30 em Minutes.
• No dia 1 de cada mês à meia-noite — All em Months e Days of Week; 01 em Days of Month; 00 em Hours e Minutes.
• Todos os dias úteis às 18:00 — All em Months e Days of Month; de segunda a sexta-feira em Days of Week; 18 em Hours; 00 em Minutes.
• A cada 15 minutos — All em Months, Days of Month, Days of Week e Hours; 00, 15, 30 e 45 em Minutes.

Nota

Um novo evento começa sem nada selecionado, pelo que não será executado até escolher um agendamento.

Modo de lançamento no ERP

Cada evento tem o seu próprio modo de lançamento no ERP — Live, Simulate ou Off — e todas as execuções que inicia utilizam esse modo. Um evento sem modo definido é executado em Live, e o limite do modo de lançamento do próprio projeto continua a aplicar-se, pelo que um evento nunca pode lançar com mais liberdade do que o projeto permite.

Defina o modo através da API ou de um assistente de IA: o campo erp_write_mode (live, simulate ou off) em PUT /rest/v1/analyze/workflow/scheduled-event, ou no upsert da ferramenta MCP workflow_schedule. O evento mantém-no a partir daí. Editar o evento no Event Scheduler, colocá-lo em pausa ou reativá-lo deixa o modo como estava, pelo que um agendamento definido como Simulate permanece simulado sempre que dispara, até alterar o próprio modo.

Editar um evento

Para editar um evento:

1. Abra Analyze
2. Selecione “Tools”
3. Clique em “Event Scheduler”
4. Clique no ícone de edição
5. Ajuste os campos pretendidos
6. Clique em “Update”

O projeto e o fluxo de trabalho são apresentados só de leitura durante a edição — um evento permanece associado ao fluxo de trabalho contra o qual foi criado.

Um assistente de IA pode editar um evento através da ferramenta MCP workflow_schedule, enviando apenas os campos a alterar, como um novo nome ou agendamento. Todos os campos que omitir mantêm o valor atual.

Eliminar um evento

Para eliminar um evento:

1. Abra Analyze
2. Selecione “Tools”
3. Clique em “Event Scheduler”
4. Clique no ícone de eliminação
5. Clique novamente em eliminar

Nota

Eliminar um fluxo de trabalho também elimina todos os eventos agendados para o mesmo. Não precisa de remover primeiro os respetivos eventos, e nenhum evento fica para trás a executar um fluxo de trabalho que já não existe. Os eventos agendados para outros fluxos de trabalho não são afetados.

Pausar um evento

Para pausar um ou mais eventos:

1. Abra Analyze
2. Selecione “Tools”
3. Clique em “Event Scheduler”
4. Selecione o evento ou os eventos
5. Clique em “Disable Selected”

Clique em Enable Selected para voltar a iniciar a sua execução. Um evento em pausa mantém o agendamento e o histórico de execuções — simplesmente deixa de disparar até ser reativado, e o respetivo ícone Active desaparece na Events Table.

Também pode pausar um único evento enquanto o edita: desmarque Activate Job and Run on Defined Schedule e clique em Update.

Executar eventos a pedido

Para executar um evento imediatamente:

1. Abra Analyze
2. Selecione “Tools”
3. Clique em “Event Scheduler”
4. Selecione o evento ou os eventos pretendidos
5. Clique em “Run Selected Events”

Cada evento é executado no seu próprio modo de lançamento no ERP, pelo que um evento Simulate é executado de forma simulada. Um evento cujo fluxo de trabalho já esteja em execução é ignorado, e a mensagem após a execução conta apenas os eventos que foram iniciados.