Pular para o conteúdo

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

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 enumera todos os eventos da área de trabalho com o projeto e o fluxo de trabalho que executam, o respetivo desvio UTC, o estado e as horas de início e de fim da última execução, e quando é devida a seguinte.

Para ver os eventos:

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

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

Agendamentopor mês · dia · hora · minutolido num fuso horário escolhidodisparaexecução do fluxoexecuçãoexecuçãoexecuçãosegundo o agendamento, ao longo do tempo →
Defina quando — por mês, dia do mês, dia da semana, hora e minuto, lidos no fuso horário que escolher — e o evento dispara o fluxo de trabalho automaticamente em cada hora agendada.

Para criar um evento:

  1. Abra o Analyze
  2. Selecione “Tools”
  3. Clique em “Event Scheduler”
  4. Clique em “Add Scheduled Event”
  5. Preencha os campos de detalhes, fuso horário e agendamento descritos abaixo
  6. Clique em “Create”

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

Memorando — uma nota opcional sobre a finalidade do evento.

Ativar a tarefa e executá-la no agendamento definido — assinalado por predefinição. Desmarque-o para guardar o evento sem permitir que seja executado; consulte Pausar um evento.

Projeto e Fluxo de trabalho — o fluxo de trabalho que este evento executa. Escolha primeiro o projeto: a lista de fluxos de trabalho é preenchida com base no projeto selecionado. Ambos são obrigatórios e ficam fixos depois de o evento existir — para mudar um evento para outro fluxo de trabalho, elimine-o e adicione um novo.

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

A maioria dos desvios corresponde à hora local de um local com esse desvio 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, no verão e no inverno, o que corresponde às 13:00 UTC no verão e às 14:00 UTC no inverno. A coluna Próxima execução e o calendário de execuções futuras mostram quando o evento será realmente executado.

Desvio Lido 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

O agendamento tem cinco campos — Meses, Horas, Minutos, Dias do mês e Dias da semana — cada um com uma lista de caixas de seleção e uma caixa Todos no topo. O evento é executado sempre que a hora atual corresponde a um valor assinalado em todos os campos em simultâneo.

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

Alguns exemplos:

  • Todos os dias às 06:30 — Todos em Meses, Dias do mês e Dias da semana; 06 em Horas; 30 em Minutos.
  • O dia 1 de cada mês à meia-noite — Todos em Meses e Dias da semana; 01 em Dias do mês; 00 em Horas e Minutos.
  • Todos os dias úteis às 18:00 — Todos em Meses e Dias do mês; de segunda a sexta-feira em Dias da semana; 18 em Horas; 00 em Minutos.
  • De 15 em 15 minutos — Todos em Meses, Dias do mês, Dias da semana e Horas; 00, 15, 30 e 45 em Minutos.

Cada evento tem o seu próprio modo de lançamento ERP — Real, Simular ou Desligado — e todas as execuções que inicia o utilizam. Um evento sem modo definido é executado em modo Real, e o limite do modo de lançamento do próprio projeto continua a aplicar-se por cima, pelo que um evento nunca pode lançar com mais liberdade do que o seu 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 daí em diante. Editar o evento no Agendador de eventos, pausá-lo ou voltar a ativá-lo deixa o modo como estava, pelo que um agendamento definido como Simular permanece simulado sempre que dispara, até alterar o próprio modo.

Para editar um evento:

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

O projeto e o fluxo de trabalho são mostrados 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.

Para eliminar um evento:

  1. Abra o Analyze
  2. Selecione “Tools”
  3. Clique em “Event Scheduler”
  4. Escolha Eliminar no menu da linha do evento (⋯), clicando com o botão direito do rato sobre ele ou no menu Ações
  5. Confirme a eliminação

Para pausar um ou mais eventos:

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

Clique em Ativar selecionados para voltar a pô-los em execução. Um evento pausado mantém o seu agendamento e o histórico de execuções — simplesmente deixa de disparar até ser reativado, e o respetivo ícone Ativo desaparece na Events Table.

Também pode pausar um único evento enquanto o edita: desmarque Ativar a tarefa e executá-la no agendamento definido e clique em Atualizar.

Para executar um evento imediatamente:

  1. Abra o 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 ERP, pelo que um evento em modo Simular é executado em simulação. Um evento cujo fluxo de trabalho já está em execução é ignorado, e a mensagem depois da execução conta apenas os eventos que foram iniciados.