Agendamentos¶

No Orquestrador BotCity Maestro, você pode agendar tarefas para suas automações. Isso é útil para tarefas que precisam ser executadas em horários específicos, ou para tarefas que precisam ser executadas regularmente.

No menu Agendamentos, você poderá visualizar, criar, editar e excluir agendamentos para suas automações.

Criar um agendamento¶

Para criar um agendamento, clique no botão Criar Agendamento. Você será redirecionado para a página de criação de agendamentos em dois passos.

1. Automação¶

Nesse primeiro passo, preencha as informações referentes a automação e clique em Próximo.

Automação: Selecione a automação que deseja agendar.
Nome do agendamento: Preencha o nome do agendamento.
Parâmetros: Caso a automação possua parâmetros, você poderá preenchê-los nesse campo.

Informação

O campo Prioridade é preenchido com o valor que está definido na automação. Caso deseje alterar, você poderá fazer isso no menu Automações.

2. Agendamento¶

Nesse passo você tem a opção de definir o agendamento por um calendário ou de uma expressão CRON.

Aviso

Os horários dos servidores do Orquestrador BotCity Maestro estão em UTC. Portanto, se você estiver em qualquer outro fuso horário, precisará ajustar o horário no calendário ou a expressão CRON para corresponder ao seu fuso horário.

Aqui está um exemplo deste ajuste do fuso horário:

Estou no Brasil e gostaria de agendar tarefas para minha automação todos os dias às 10:00 da manhã horário padrão de Brasília (GMT-3).

O horário no calendário seria 10:00.
Como o horário do servidor é em UTC, você precisará ajustar o horário para 13:00.
A expressão regular Quartz Cron seria 0 0 10 ? * * .
Com a correção do fuso horário, ficará com a seguinte: 0 0 13 ? * * .
Isso agendará as tarefas a serem executadas às 13:00 UTC, que fica 3 horas antes do horário padrão de Brasília.

Calendário¶

Selecionando a opção Calendário, você poderá definir um agendamento mais simples, com uma frequência diária, semanal ou mensal, por exemplo.

Frequência de repetição: Direciona para as opções de frequência de repetição.
Execução única: Direciona para criar uma nova tarefa única.

Ao selecionar a opção Frequência de repetição, você poderá definir entre as opções:

Segundo: A cada quantos segundos a tarefa será criada (entre 1 e 59).

Minuto: A cada quantos minutos a tarefa será criada (entre 1 e 59).

Hora: A cada quantas horas a tarefa será criada (entre 1 e 23).

Dia: A cada quantos dias e qual o horário que a tarefa será criada.

Semana: Quais dias da semana e o horário que a tarefa será criada.

Mês: Qual o dia específico do mês e o horário que a tarefa será criada.

O próximo campo é referente à Configuração de Início, as opções são:

Imediatamente: O agendamento será iniciado imediatamente.
Iniciar em uma data específica: O agendamento iniciará a partir da data escolhida.

Com os campos preenchidos é possível visualizar um resumo do agendamento criado e clicar em Agendar para finalizar.

Expressão CRON¶

Outra opção é definir um agendamento por uma expressão CRON. Ela é mais poderosa e flexível, permitindo definir agendamentos mais complexos.

Com a expressão CRON de 0 */5 * ? * * definida para uma automação, o Orquestrador BotCity Maestro criará e colocará uma nova tarefa na fila automaticamente a cada 5 minutos.

A string de expressão CRON não é o formato de expressão CRON padrão. O Orquestrador BotCity Maestro usa o formato de expressão Quartz CRON.

O site Free Formatter oferece uma ótima ferramenta para gerar expressões CRON, além de descrevê-las e mostrar as próximas datas de execução.

Após definir a expressão CRON, a política de agendamento referente a ela será gerada automaticamente.

Por fim, um resumo do agendamento será exibido e você poderá clicar em Agendar para finalizar.

Lista de agendamentos¶

No menu Agendamentos, você poderá visualizar a lista de agendamentos cadastrados no Orquestrador BotCity Maestro.

Você terá acesso a informações como o nome do agendamento, a automação vinculada, a regra de agendamento, os parâmetros para a tarefa, o status de agendamento ativado ou desativado, um menu com mais informações e ações como editar e excluir.

Mais informações¶

No menu Info, você poderá visualizar o resumo do agendamento e o histórico de tarefas lançadas pelo agendador.

Editar agendamento¶

No menu Editar, você poderá alterar as informações de um agendamento existente, como o nome, parâmetros de entrada, tipo do agendamento, frequência e preferências iniciais.

Excluir agendamento¶

No menu Excluir, você poderá remover o agendamento da lista.