Criação de um gatilho de tempo

Importante: Os acionadores de tempo que são criados em tempo de design usando atividades de acionador de tempo podem ser configurados posteriormente no momento da criação do processo, no Orchestrator, pois esses tipos de acionadores são identificados como requisitos de pacote.

Leia Gerenciamento de requisitos de pacote > Adição de gatilhos de tempo e fila para saber mais.

1. Em uma pasta, navegue até Automações > Gatilhos e, na página Gatilhos de tempo, clique em Adicionar um novo gatilho. A página Criar gatilho de tempo é exibida.
2. No menu suspenso Nome do processo, selecione o processo para o qual você deseja configurar um gatilho de tempo.
3. O campo Nome é pré-preenchido com o nome do processo, seguido pelo tipo de gatilho no formato <ProcessName>_<TriggerType>. No entanto, o nome do gatilho pode ser editado com um nome diferente, se preferido.
4. No menu suspenso Prioridade do trabalho, selecione a prioridade do trabalho. O valor padrão é Herdada, significando que a prioridade do trabalho é a mesma que foi definida para o processo selecionado.
5. No menu suspenso Tipo de runtime, selecione o runtime usado para executar os trabalhos que são iniciados pelo gatilho.
6. Na aba Destino de Execução, selecione o mecanismo de alocação e o destino de execução de seus trabalhos.

   Description
   Alocação Dinâmica	Alocar de forma dinâmica A alocação dinâmica sem seleção explícita de conta e máquina permite que você execute um processo em primeiro plano várias vezes sob a conta e a máquina que ficarem disponíveis primeiro. Os processos em segundo plano serão executados em qualquer conta, independentemente de estar ocupada ou não, desde que você tenha runtimes suficientes. Usando a opção Alocar dinamicamente você pode executar um processo até 10.000 vezes em um trabalho.
   	Conta O processo é executado sob uma conta específica. Especificar apenas a conta resulta na alocação dinâmica da máquina pelo Orchestrator. Especificar a conta e o modelo de máquina significa que os trabalhos serão iniciados nesse par de conta-máquina.
   	Máquina O processo será executado em uma das máquinas do host conectadas ao modelo de máquina selecionado. Especificar apenas o modelo de máquina resulta no Orchestrator alocando a conta dinamicamente. Especificar a conta e o modelo de máquina significa que os trabalhos serão iniciados nesse par de conta-máquina. Observação: certifique-se de que as licenças de runtime necessárias para executar o trabalho estejam alocadas para o modelo de máquina associado.
   	Hostname Após selecionar um modelo de máquina, a opção Nome do host é exibida, permitindo selecionar a sessão de estação de trabalho/robô desejada para executar o processo. Todas as sessões disponíveis na pasta ativa são exibidas: não conectadas, desconectadas ou conectadas. Observação: apenas runtimes não assistidos podem ser usados para configurar o mapeamento. Certifique-se de que as licenças de runtime necessárias para executar o trabalho estejam alocadas para o modelo de máquina associado.
   Selecionar Mapeamentos de conta-máquina válidos	O processo pode ser executado em pares específicos de conta-máquina. Saiba mais sobre mapeamentos de conta-máquina. Observação: Um aviso é exibido ao selecionar um nome de host que não esteja ativo (por exemplo, com o status Não responsivo ou Desconectado). As contas que fazem parte dos mapeamentos usados em gatilhos não podem ser excluídas ou ter sua atribuição cancelada da pasta em que o gatilho reside. Certifique-se de que a conta não esteja definida como um destino de execução em um gatilho para que você possa excluí-las.

   Observação: um aviso é exibido ao selecionar um nome de host que não esteja ativo (por exemplo, com o status Não responsivo ou Desconectado). Os trabalhos programados para serem executados pela sessão inativa permanecem em um estado Pendente até a conexão correspondente com o Orchestrator ser feita.

   • Para reconhecer sua seleção do nome de host inativo, clique em Confirmar.

   • Para voltar e selecionar outro nome de host, clique em Cancelar.

   Configurar o mesmo gatilho com o mesmo mapeamento de conta-máquina, mas com uma seleção de nome de host adicional, dobra o número de trabalhos a serem executados.

   • Por exemplo, suponhamos que você tenha configurado um gatilho T1 com a conta A1 mapeada para o modelo de máquina MT1. Dez trabalhos são enfileirados para execução nesta configuração.

     Mais tarde, você configura o mesmo gatilho T1 com a conta A1 mapeada para o modelo de máquina MT1, mas agora também seleciona o nome de host H1. Os mesmos dez trabalhos são enfileirados novamente para esse caso, já que o Orchestrator interpreta a configuração como nova.

7. Na aba Argumentos, forneça valores para argumentos de entrada se seu processo tiver algum. Veja mais detalhes sobre argumentos de entrada e saída.
8. No menu suspenso Fuso horário, selecione o fuso horário de acordo com o qual o gatilho deve ser acionado.
   Observação:

   • O fuso horário do acionador não depende do fuso horário do locatário. Você pode definir um fuso horário diferente para a execução do acionador de tempo.
   • Os locais que usam horário de verão (DST) estão listados na diferença UTC deles. A diferença UTC não será aumentada quando o horário de verão estiver em vigência. Por exemplo, durante o período de horário de versão, o fuso horário de Londres será exibido como UTC+00:00.
   • Não é necessário ajustar o fuso horário para considerar o horário de verão, pois o mecanismo de programação do Orchestrator o leva em consideração automaticamente ao iniciar um trabalho. Um trabalho agendado para executar às 12h será executado às 12h, tanto no inverno quanto no verão.
9. Selecione a frequência de execução do gatilho. As opções disponíveis são:
   • Minuto a minuto - Escolha o número de minutos que devem decorrer entre as execuções do gatilho. Exemplo: a cada 5 minutos.
   • Horária - Escolha o número de horas que devem decorrer entre as execuções do gatilho, bem como o minuto que deve marcar o início de uma nova execução. Exemplo: a cada 2 horas aos 20 minutos passados.
   • Diária - Escolha o número de dias que devem decorrer entre as execuções do gatilho, bem como a hora em que uma nova execução deve começar. Exemplo: a cada 4 dias, às 12h30.
   • Semanal - Escolha o dia da semana e a hora específicos em que você deseja que o gatilho seja executado. Exemplo: segunda-feira às 11h45.
   • Mensal (dia do mês) - Escolha o número de meses que devem decorrer entre as execuções do gatilho, bem como o dia e a hora em que uma nova execução deve começar. Exemplo: a cada 2 meses, às 11h30, sendo executado no último dia útil do mês.
   • Mensal (dia da semana) - Escolha o número de meses que devem decorrer entre as execuções do gatilho, bem como o dia da semana e a hora em que uma nova execução deve começar. Exemplo: a cada 2 meses, às 11h30, sendo executado às segundas-feiras.
   • Avançado - Defina uma expressão CRON personalizada. Para obter detalhes, consulte a página Uso de expressões CRON.
   O Orchestrator usa uma biblioteca de código aberto para analisar e exibir descrições cron, que pode ser encontrada aqui.

   Observação:

   As expressões CRON podem ser usadas em combinação com dias não úteis. Isso significa que, se um gatilho for configurado por meio de uma expressão CRON para ser executado em um dia que cai em uma data excluída, esse dia será ignorado e o gatilho será reagendado para o próximo dia disponível e assim por diante.

10. Escolha a frequência com a qual você deseja que o gatilho seja executado, em minutos.
    Importante:

    O padrão cron empregado por nossas expressões cron usa um sistema de tempo com base em 60 minutos a uma hora. Isso significa que a única maneira de executar um gatilho no intervalo exato configurado no campo Repetir a cada é se o valor desse intervalo for um divisor de 60. Caso contrário, a recorrência não obedecerá inteiramente ao número de minutos nesse campo, causando discrepâncias de execução. Para evitar isso, recomendamos ajustar suas configurações de gatilho ou usar gatilhos de eventos.

    Exemplo: você define um gatilho a ser executado a cada 21 minutos e inicia um trabalho às 9:00. Isso renderiza o seguinte agendamento de execução:

    • O primeiro trabalho começa às 9:00.
    • O segundo trabalho começa às 9:21.
    • O terceiro trabalho começa às 9:42.
    • O quarto trabalho começa às 10:00.

    A razão pela qual o quarto trabalho começa após 18 minutos em vez de 21 é que o componente cron corresponde a cada 21^o item de um conjunto de minutos entre 1 e 59. Nesse exemplo, esses itens são 00, 21, 42.

11. No menu suspenso Restrições de dias não úteis, selecione um calendário de dias não úteis, se você quiser que seu gatilho pare de disparar em determinados dias não úteis. Veja mais detalhes sobre dias não úteis.
12. Ative a alternância Agendar o fim da execução de trabalho para selecionar uma estratégia de encerramento do trabalho.
    Observação:

    • O quantidade de tempo especificado aqui transcorre de acordo com as especificações, mesmo se o trabalho estiver enfileirado. Por exemplo, se você agendar um trabalho para executar às 13h e o definir para parar após 20 minutos, o trabalho será interrompido às 13h20, mesmo que tenha permanecido em uma fila até as 13h15 e, depois, iniciado.
    • As opções de Agendar o fim da execução de trabalho de um gatilho são preservadas para trabalhos iniciados manualmente.

    Por exemplo, digamos que você tenha criado um gatilho T1 e ativado os seguintes agendamentos de fim de trabalho:

    • Agendar o fim da execução de trabalho:interrompe um trabalho após 10 minutos

    • Agendar “Encerramento” automático, se o trabalho não parar:encerra o trabalho após 2 minutos

      Na página Automações > Gatilhos, ao clicar em Iniciar um trabalho agora para o gatilho T1, a página Iniciar trabalho será aberta com os agendamentos de fim de trabalho já aplicados, os mesmos configurados na criação do gatilho.

    Exemplo: se você agendar para interromper um trabalho Pendente ou Em Execução após 2 horas e também configurar para encerrar o mesmo trabalho após 3 horas, o trabalho será encerrado após 5 horas. Isso acontece porque, primeiro, é enviado ao Orchestrator o sinal de que o trabalho foi interrompido após 2 horas. Depois que o sinal é recebido, a ação de encerramento do trabalho é disparada para ocorrer em 3 horas, resultando em um total de 5 horas.

    • Selecione Parar no menu suspenso - tenta encerrar com graça a execução depois que o intervalo de tempo definido tiver transcorrido após o trabalho ficar travado em um estado Pendente ou Em Execução (defina o tempo como no mínimo 1 minuto, máximo de 10 dias, 23 horas e 59 minutos);
      Exemplo: o Orchestrator tentará interromper trabalhos que ficaram travados por pelo menos 10 minutos em Pendente ou Em Execução.

      

    • Selecione Encerrar no menu suspenso - tenta encerrar com força a execução depois que o intervalo de tempo definido tiver transcorrido após o trabalho ficar travado em um estado estado Pendente ou Em Execução (defina o tempo como no mínimo 1 minuto, máximo de 10 dias, 23 horas e 59 minutos);

      Exemplo: o Orchestrator tentará encerrar trabalhos que ficaram travados por pelo menos 10 minutos em Pendente ou Em Execução.

    • Selecione Parar no menu suspenso e habilite a opção Se o trabalho não parar, encerre-o - tenta encerrar com graça a execução depois que o intervalo de tempo definido tiver transcorrido após o trabalho ficar travado em um estado Pendente ou Em Execução e, em seguida, tenta encerrá-lo com força depois que o intervalo de tempo definido tiver transcorrido após o trabalho ficar travado em um estado Parando (defina o tempo para um mínimo de 1 minuto, máximo de 10 dias, 23 horas e 59 minutos).

      Exemplo: o Orchestrator tentará interromper trabalhos que ficaram parados em Pendentes ou Em Execução por pelo menos 10 minutos. Se o término não ocorrer, o Orchestrator tentará encerrar os jobs que estiveram no status Parando por pelo menos 20 minutos.

13. Ative a opção Agendar a desativação automática de gatilho e insira a data e hora em que o gatilho deve ser desativado. O fuso horário influencia quando o gatilho do tempo é desativado.
14. Ative a alternância Gerar um alerta se o trabalho estiver preso (no status Pendente ou Retomado) e defina a duração aceitável para o trabalho permanecer no status Pendente ou Retomado. A duração mínima configurável é de um minuto. A duração máxima configurável é de onze dias. Se o trabalho exceder a duração configurada, um pop-up de alerta de gravidade de “Erro” informa a você sobre isso com o seguinte texto: “N trabalhos para o processo no. {process_number} estão pendentes ou foram retomados há mais de X horas e Y minutos.“, Onde:
    • N - é o número de trabalhos que acionaram o alerta;
    • {process_number} - o identificador do processo;
    • X — o número configurado de horas que o trabalho excedeu enquanto tinha o status Pendente ou Retomado; dias são convertidos em horas.
    • Y - o número configurado de minutos que o trabalho excedeu enquanto tinha o status Pendente ou Retomado.
15. Ative a alternância Gerar um alerta se o trabalho for iniciado e não tiver sido concluído e defina a duração aceitável para o trabalho ser concluído. A duração configurável é de no mínimo um minuto e no máximo onze dias. Se o trabalho exceder a duração configurada, um pop-up de alerta de gravidade de "Erro" informa a você sobre isso com o seguinte texto: "O trabalho para processo no. {process_number} está pendente foi executado por mais de X horas e Y minutos.", onde:
    • {process_number} - o identificador do processo;
    • X — o número de horas configuradas que o trabalho excedeu ao tentar ser concluído; dias são convertidos em horas.
    • Y - o número configurado de minutos que o trabalho excedeu enquanto tentava ser concluído.
16. Ative a alternância Definir a desativação do gatilho baseado em execução se desejar controlar quando o gatilho é desativado quando um trabalho falha. Essa alternância revela duas opções:

    Opção	Description
    Desabilitar quando a execução consecutiva do trabalho falhar na contagem	O disparador é desabilitado após o número de execuções com falha que você escolher para esta configuração. É possível escolher um valor entre 0 e 100. O padrão é 0, o que significa que o disparador nunca é desabilitado. Os trabalhos interrompidos não são contados para esse valor.
    Período de tolerância ao desabilitar o gatilho (dias)	O número de dias a se esperar antes que o disparador seja desabilitado após a primeira falha de um trabalho. Você pode escolher um valor entre 0 e 30. O padrão é 0, significando que o gatilho é desativado assim que o número de execuções de trabalho definidas no campo acima é alcançado para o dia atual.

    Observação:

    Se você estiver no plano de licenciamento Community e selecionar um runtime Cloud Serverless para o processo subjacente, a opção Definir desativação do gatilho com base na execução será habilitada automaticamente, com os seguintes valores padrão (os campos são somente leitura):

    • Desabilitar quando a contagem de falhas da execução do trabalho estiver definida como 10.

    • O período de tolerância para desabilitar o gatilho (dias) está definido como 0.

17. Para manter o mesmo contexto conta-máquina configurado para iniciar o trabalho, marque a caixa Manter alocação conta/máquina na retomada do trabalho. Isso otimiza sua licença e o uso de recursos.