Ir para o conteúdo

Agendamentos

No menu Agendamentos você pode criar regras de agendamento de 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.

Visualizar Agendamentos

Nessa tela, você visualiza o resumo dos Agendamentos nos seguintes cartões:

  • Total de Agendamentos: quantidade total de Agendamentos criados.
  • Agendamentos Ativos: quantidade de Agendamentos ativos.
  • Agendamentos Inativos: quantidade de Agendamentos inativos.

Abaixo do resumo, você pode visualizar os agendamentos no formato de lista com as seguintes colunas:

  • Nome: nome do agendamento.
  • Automação: automação vinculada ao agendamento.
  • Regra: regra de agendamento definida, como frequência e horário de execução.
  • Status: botão para ativar ou desativar o agendamento.
  • Menu de ações: ações disponíveis para o agendamento:

Captura de tela do Orquestrador da BotCity, apresentando o menu Agendamentos. A página tem o título 'Schedules' e o botão 'New Schedule' no canto superior direito. Abaixo, os campos de filtro e ordenação, os cartões de resumo Total schedules, Active schedules e Inactive schedules, e a lista de agendamentos com as colunas Name, Automation, Rule, Status e o menu de ações.

Criar um agendamento

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

1. Automação

No 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 para identificar agendamento.
  • Prioridade: defina a prioridade das tarefas criadas pelo agendamento.
  • Parâmetros: caso a automação possua parâmetros, você pode preenchê-los nesse campo.

Fuso horário

Os horários dos servidores do Orquestrador BotCity estão em UTC. Portanto, se você estiver em qualquer outro fuso horário, precisará ajustar o agendamento.

Captura de tela do Orquestrador da BotCity, apresentando o formulário de Novo Agendamento no passo 1 - Automação. Exibe o aviso sobre o fuso horário UTC dos servidores e os campos Automation, Schedule Name, Priority e Parameters. No rodapé, os botões Cancel e Next.

2. Agendamento

Nesse passo define o tipo de agendamento por calendário ou expressão CRON.

Fuso horário

Os horários dos servidores do Orquestrador BotCity 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.

Captura de tela do Orquestrador da BotCity, apresentando o passo 2 - Agendamento do formulário de Novo Agendamento, com o campo Schedule Type expandido mostrando as opções Calendar e Cron Expression.

Calendário

Selecionando a opção Calendário, você pode 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.

    Captura de tela do Orquestrador da BotCity, apresentando o passo 2 - Agendamento com o Schedule Type definido como Calendar e o campo Scheduling Frequency com a opção Repeat frequency selecionada.

Ao selecionar a opção Frequência de repetição, você define qual frequência de criação de tarefas:

  • Minuto: repete a tarefa a cada intervalo de minutos definido (de 1 a 59).
  • Hora: repete a tarefa a cada intervalo de horas definido (de 1 a 23).
  • Dia: repete a tarefa a cada intervalo de dias definido, em um horário específico.
  • Semana: repete a tarefa nos dias da semana selecionados, em um horário específico.
  • Mês: repete a tarefa no dia do mês selecionado, em um horário específico.

O campo Política de agendamento é gerado automaticamente conforme o calendário selecionado.

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

  • Imediatamente: a regra é aplicada imediatamente.

  • Iniciar em uma data específica: a regra iniciará a partir da data escolhida.

    Captura de tela do Orquestrador da BotCity, apresentando o campo Start Preferences expandido, com as opções Immediately e Start on a specific date, além dos campos Scheduling Frequency e Schedule Strategy já preenchidos.

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

Captura de tela do Orquestrador da BotCity, apresentando o resumo do agendamento (Scheduling Summary) com as informações de Automation, Schedule Name, Schedule Strategy e Priority, e os botões Back e Schedule.

Expressão CRON

Selecionando a opção expressão CRON, você pode definir agendamentos mais complexos, pois ela é mais poderosa e flexível.

Preencha o campo String de agendamento CRON com a regra desejada.

Exemplo de expressão CRON

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

Formato aceito

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

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

O campo Política de agendamento é gerado automaticamente conforme a string CRON preenchida.

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

Captura de tela do Orquestrador da BotCity, apresentando o passo 2 - Agendamento com o Schedule Type definido como Cron Expression, o campo CRON Scheduling String preenchido e o resumo do agendamento (Scheduling Summary).

Ações

Você pode realizar algumas ações no Menu de ações de um agendamento.

Captura de tela do Orquestrador da BotCity, apresentando a lista de agendamentos com o menu de ações de um agendamento aberto, exibindo as opções Info, Edit e Delete.

Informações

Na opção Info, você pode visualizar o resumo do agendamento e o histórico de tarefas criadas pelo agendador.

Captura de tela do Orquestrador da BotCity, apresentando a página Schedule Info com o resumo do agendamento (Scheduling Summary) e o histórico de execuções (Running history), contendo as colunas Id Task, Scheduling time, Executed time e State.

Editar agendamento

Na opção Editar, você pode alterar as informações de um agendamento existente:

  • Nome do Agendamento
  • Parâmetros
  • Tipo do agendamento
  • Frequência
  • Preferências iniciais

Excluir agendamento

Na opção Excluir, você pode remover o agendamento da lista.

Captura de tela do Orquestrador da BotCity, apresentando a janela de confirmação para excluir um agendamento, com o título 'Delete consult', a pergunta 'Confirm scheduling delete?' e os botões No e Yes.