Criação de um gatilho de tempo

Importante:

Time triggers that are created at design-time using time trigger activities can be further configured at process-creation time, in Orchestrator, as these types of triggers are identified as package requirements.

Read Managing package requirements > Adding time and queue triggers to find out more.

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 campo Nome, adicione um nome para que o gatilho o identifique facilmente.

3. No menu suspenso Nome do processo, selecione o processo para o qual você deseja configurar um gatilho de tempo.

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. From the Runtime type drop-down menu, select the runtime used to execute the jobs that are launched by the trigger.

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. 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. 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	The process can be executed on specific account-machine pairs. Learn more about account-machine mappings. 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. On the Arguments tab, provide values for input arguments if your process has any. More details about input and output arguments.

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 (Minutos, A cada hora, Diário, Semanal, Mensal, Avançado). No lado direito desta seção, configure os detalhes dependendo da opção escolhida (frequência, tempo exato ou uma expressão cron). O Orchestrator usa uma biblioteca de código aberto para analisar e exibir descrições cron, que podem ser encontradas 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:

    The cron standard employed by our cron expressions uses a time system based on 60 minutes to an hour. This means that the only way it can execute a trigger at the exact interval configured in the Repeat every field is if the value of that interval is a divisor of 60. Otherwise, the recurrence will not entirely abide by the number of minutes in that field, thus causing execution discrepancies. To avoid this, we recommend adjusting your trigger settings or using event triggers.

    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.

    The reason why the fourth job starts after 18 minutes instead of 21 is that the cron component matches every 21^st item from a set of minutes between 1 and 59. In this example, these items are 00, 21, 42.

11. From the Non-working days restrictions drop-down menu, select a non-working days calendar, if you want your trigger to stop firing on certain non-business days. More details about non-working days.

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

    • Schedule automatic "Kill", if the job does not stop:Kill job after 2 mins

      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.

    Example: If you schedule to stop a Pending or Running job after 2 hours and also configure to kill the same job after 3 hours, the job will be killed after 5 hours. This happens because, first, the signal is sent to Orchestrator that the job was indeed stopped after 2 hours. Once the signal has been received, the kill job action is triggered to occur in 3 hours, thus resulting a total of 5 hours.

    • 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 o botão de alternância Definir a desativação do gatilho baseado em execução se quiser controlar quando o gatilho é desativado após a falha de um trabalho. Esse botão 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. Você pode escolher um valor entre 1 e 100.O padrão é 1, o que significa que o disparador é desabilitado após 1 inicialização com falha. 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.

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.