Agendador de eventos
Descrição
Seção intitulada “Descrição”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:
- Abra o Analyze
- Selecione “Tools”
- Clique em “Agendador de eventos”
Isso abrirá a tabela de eventos, que mostra todos os eventos atualmente configurados para o espaço de trabalho.
Criar um evento
Seção intitulada “Criar um evento”Para criar um evento:
- Abra o Analyze
- Selecione “Tools”
- Clique em “Agendador de eventos”
- Clique em “Add Scheduled Event”
- Preencha os campos de detalhes, fuso horário e agendamento descritos abaixo
- Clique em “Create”
Detalhes
Seção intitulada “Detalhes”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.
Fuso horário
Seção intitulada “Fuso horário”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 |
Agendamento
Seção intitulada “Agendamento”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.
Modo de lançamento no ERP
Seção intitulada “Modo de lançamento no ERP”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.
Editar um evento
Seção intitulada “Editar um evento”Para editar um evento:
- Abra o Analyze
- Selecione “Tools”
- Clique em “Agendador de eventos”
- Clique no ícone de edição
- Ajuste os campos desejados
- 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.
Excluir um evento
Seção intitulada “Excluir um evento”Para excluir um evento:
- Abra o Analyze
- Selecione “Tools”
- Clique em “Agendador de eventos”
- Escolha Excluir no menu da linha do evento (⋯), clicando nele com o botão direito ou no menu Ações
- Confirme a exclusão
Pausar um evento
Seção intitulada “Pausar um evento”Para pausar um ou mais eventos:
- Abra o Analyze
- Selecione “Tools”
- Clique em “Agendador de eventos”
- Selecione o evento ou os eventos
- 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.
Executar eventos sob demanda
Seção intitulada “Executar eventos sob demanda”Para executar um evento imediatamente:
- Abra o Analyze
- Selecione “Tools”
- Clique em “Agendador de eventos”
- Selecione o evento ou os eventos desejados
- 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.