Agendador de eventos

Descrição

Agendar fluxos de trabalho específicos pode ser uma ferramenta útil de organização, e o PlaidCloud oferece exatamente essa possibilidade. Com o Agendador de eventos, você 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 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 em relação ao UTC, o status e os horários de início e término da última execução e quando está previsto o próximo.

Para ver os eventos:

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

Isso abrirá a Events Table, mostrando todos os eventos atualmente configurados para o espaço de trabalho.

Nota

Se o evento estiver ativo, o ícone “Ativo” será exibido.

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.

Criação de um evento

Para criar um evento:

1. Abra 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”

Detalhes

Nome: como o evento aparece na Events Table. 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 para salvar o evento sem permitir que ele seja executado; consulte Pausa de um evento.

Projeto e Fluxo de trabalho: o fluxo de trabalho que este evento executa. Escolha o projeto primeiro: a lista de fluxos de trabalho é preenchida a partir do projeto selecionado. Ambos são obrigatórios e 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

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 nesse 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, tanto no verão quanto no inverno, o que corresponde 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	Riad	Não
UTC +4	Dubai	Não
UTC +5	Karachi	Não
UTC +6	UTC +6	Não
UTC +7	Bangkok	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 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 o horário atual corresponde a um valor marcado em todos os campos ao mesmo tempo.

Todo campo precisa de algo: marque Todos para corresponder a todos os valores ou marque os valores individuais desejados. Um campo totalmente em branco impede que o evento seja salvo, e a mensagem informa o nome do 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.
• 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.
• A cada 15 minutos: Todos em Meses, Dias do mês, Dias da semana e Horas; 00, 15, 30 e 45 em Minutos.

Nota

Um novo evento começa sem nada marcado, portanto não será executado até que você escolha um agendamento.

Modo de lançamento no ERP

Cada evento tem seu próprio modo de lançamento no ERP (Ao vivo, Simular ou Desativado), e toda execução que ele inicia o usa. Um evento sem modo definido é executado Ao vivo, e o limite do modo de lançamento do próprio projeto continua valendo por cima, de modo que um evento nunca possa 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 mantém o modo daí em diante. Editar o evento no Agendador de eventos, pausá-lo ou reativá-lo deixa o modo como estava, de modo que um agendamento definido como Simular permanece simulado toda vez que for disparado, até que você altere o próprio modo.

Edição de um evento

Para editar um evento:

1. Abra 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 vinculado ao fluxo de trabalho para o 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. Todo campo omitido mantém o valor atual.

Exclusão de um evento

Para excluir um evento:

1. Abra Analyze
2. Selecione “Tools”
3. Clique em “Agendador de eventos”
4. Clique no ícone de exclusão
5. Clique em delete novamente

Nota

Excluir um fluxo de trabalho também exclui todos os eventos agendados para ele. Você não precisa remover os eventos antes, e nenhum evento fica para trás tentando executar um fluxo de trabalho que não existe mais. Os eventos agendados para outros fluxos de trabalho não são afetados.

Pausa de um evento

Para pausar um ou mais eventos:

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

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 seu ícone Ativo é desmarcado na Events Table.

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.

Execução de eventos sob demanda

Para executar um evento imediatamente:

1. Abra 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.