Pular para o conteúdo

Agendar fluxos de trabalho específicos pode ser uma ferramenta de organização útil, e por isso o PlaidCloud oferece essa possibilidade. Com o Agendador de eventos, você 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 lido.

Um evento agendado nomeia um fluxo de trabalho em um projeto, além do agendamento em que ele é executado. Para executar vários fluxos de trabalho com a mesma periodicidade, adicione um evento para cada um.

A tabela de eventos lista todos os eventos do espaço de trabalho, com o projeto e o fluxo de trabalho que cada um executa, seu deslocamento UTC, o status e os horários de início e término da última execução, e quando é a próxima.

Para ver os eventos:

  1. Abra o Analyze
  2. Selecione “Tools”
  3. Clique em “Agendador de eventos”

Isso abrirá a tabela de eventos, que mostra todos os eventos atualmente configurados para o espaço de trabalho.

Agendamentopor mês · dia · hora · minutolido em um fuso horário escolhidodisparaexecução do fluxoexecuçãoexecuçãoexecuçãono 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 você escolher — e o evento dispara o fluxo de trabalho automaticamente em cada horário agendado.

Para criar um evento:

  1. Abra o Analyze
  2. Selecione “Tools”
  3. Clique em “Agendador de eventos”
  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 tabela de eventos. Obrigatório.

Memorando — uma observação opcional sobre a finalidade do evento.

Ativar o trabalho e executar na programação definida — marcado por padrão. Desmarque-o para salvar o evento sem permitir que ele 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 a partir do projeto selecionado. Ambos são obrigatórios e ambos ficam fixos depois que o evento existe — para mover um evento para outro fluxo de trabalho, exclua-o e adicione um novo.

O agendamento é lido neste fuso horário, escolhido como um deslocamento de UTC -12 a UTC +14. O padrão é UTC +0, que é lido como o horário de Londres, incluindo o horário de verão britânico.

A maioria dos deslocamentos corresponde ao horário local de um lugar com esse deslocamento e segue o horário de verão desse lugar: um evento em UTC -5 definido para 09:00 é executado às 09:00 em Nova York, no verão e no inverno, o que equivale a 13:00 UTC no verão e 14:00 UTC no inverno. A coluna Próxima execução e o calendário de próximas execuções mostram quando o evento será realmente executado.

Deslocamento Lido como Horário 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 York 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 Karachi Não
UTC +6 UTC +6 Não
UTC +7 Bangcoc 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 na parte superior. O evento é executado sempre que o horário atual corresponde a um valor marcado em todos os campos ao mesmo tempo.

Todo campo precisa de algum valor: marque Todos para corresponder a todos os valores ou marque os valores individuais que você deseja. Um campo deixado totalmente em branco impede que o evento seja salvo, e a mensagem nomeia o campo para que você o encontre.

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.
  • No 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.
  • A cada 15 minutos — Todos em Meses, Dias do mês, Dias da semana e Horas; 00, 15, 30 e 45 em Minutos.

Cada evento tem seu próprio modo de lançamento no ERP — Ao vivo, Simular ou Desativado — e cada execução que ele inicia o utiliza. Um evento sem modo definido é executado Ao vivo, e o limite do modo de lançamento do próprio projeto continua se aplicando por cima, de modo que um evento nunca pode lançar com mais liberdade do que o projeto permite.

Defina o modo pela API ou por 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 o mantém a partir de então. Editar o evento no Agendador de eventos, pausá-lo ou reativá-lo deixa o modo como estava; assim, um agendamento definido como Simular continua simulado toda vez que for disparado, até você alterar o próprio modo.

Para editar um evento:

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

O projeto e o fluxo de trabalho são exibidos somente para leitura durante a edição — um evento permanece associado ao fluxo de trabalho em relação ao qual foi criado.

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

Para excluir um evento:

  1. Abra o Analyze
  2. Selecione “Tools”
  3. Clique em “Agendador de eventos”
  4. Escolha Excluir no menu da linha do evento (⋯), clicando nele com o botão direito ou no menu Ações
  5. Confirme a exclusão

Para pausar um ou mais eventos:

  1. Abra o Analyze
  2. Selecione “Tools”
  3. Clique em “Agendador de eventos”
  4. Selecione o evento ou os eventos
  5. Clique em “Desativar selecionados”

Clique em Ativar selecionados para que voltem a ser executados. Um evento pausado mantém seu agendamento e seu histórico de execuções — ele apenas deixa de ser disparado até ser reativado, e o ícone Ativo dele é desmarcado na tabela de eventos.

Você também pode pausar um único evento enquanto o edita: desmarque Ativar o trabalho e executar na programação definida e clique em Atualizar.

Para executar um evento imediatamente:

  1. Abra o Analyze
  2. Selecione “Tools”
  3. Clique em “Agendador de eventos”
  4. Selecione o evento ou os eventos desejados
  5. Clique em “Run Selected Events”

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