Ir para o conteúdo

Agendamentos

Ir para 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.

initial-scheduling

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.

select-automation

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.

Schedule type

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.

schedule-frequency

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).

schedule-second

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

schedule-minute

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

schedule-hour

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

schedule-day

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

schedule-week

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

schedule-month

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.

schedule-preference

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

schedule-summary

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.

schedule-cron

Lista de agendamentos

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

scheduling-list

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.

scheduling-schedule-menu

Mais informações

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

scheduling-more-info

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.

scheduling-edit

Excluir agendamento

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

scheduling-delete