Criação de um gatilho de fila

Importante:

Os gatilhos de fila que são criados no momento do projeto usando atividades de disparo de filas podem ser configurados ainda mais no momento da criação do projeto, no Orchestrator, já que esses tipos de gatilho são identificados como requisitos de pacotes. Leia Gerenciamento de requisitos de pacote > Adição de gatilhos de tempo e fila para saber mais.

Você não pode criar acionadores de fila para processos que já contêm uma atividade de acionador de fila.

Disparadores de filas e previsões do SLA são interdependentes em termos de associação entre fila e processo. Portanto, sempre que for configurar um deles, o outro é pré-preenchido, de forma que haja paridade entre as configurações. Suponhamos que eu defina um disparador de fila para a fila Y usar o processo X. As previsões do SLA para a fila Y podem ser feitas apenas usando o processo X e, portanto, X é pré-preenchido e fica em um estado de somente leitura ao habilitar o SLA de fila para Y.

1. Em uma pasta, navegue até Automações > Gatilhos e na página Gatilhos, clique em Adicionar um novo gatilho. A página Criar gatilho de fila é 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 tipo de licença de runtime.
6. Na aba Destino de Execução, selecione o mecanismo de alocação e o destino de execução de seus trabalhos.

   Descrição
   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.

   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 fazer outra seleção de nome de host ou não escolher nenhum (ou seja, a primeira máquina disponível no pool de modelos é selecionada), clique em Cancelar.

   Configurar o mesmo gatilho com o mesmo mapeamento de conta-máquina, mas com a 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 nessa 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. Selecione a fila usada para acionar a execução.
9. Defina os parâmetros de configuração descritos nesta tabela.

   Description
   Número mínimo de itens que disparam o primeiro trabalho	O trabalho de processamento de itens é iniciado apenas após a fila de destino ter pelo menos esse número de novos itens. Os itens da fila adiados não são contados.
   Número máximo de trabalhos pendentes e em execução permitidos ao mesmo tempo	O número máximo permitido de trabalhos pendentes e em execução, contados juntos. Para dois ou mais trabalhos permitidos simultaneamente, a terceira opção precisa ser definida conforme descrito abaixo.
   Outro trabalho é disparado para cada __ novo(s) item(ns)	O número de novos itens na fila (acima do número configurado para a opção Número mínimo de itens que disparam o primeiro trabalho) para disparar um novo trabalho.
   Após concluir os trabalhos, reavalie as condições e inicie novos trabalhos se possível	Se selecionado, o gatilho de fila é avaliado após a conclusão de cada trabalho e novos trabalhos são iniciados se houver robôs disponíveis. Isso complementa a verificação automática que ocorre a cada 30 minutos e ajuda a garantir que os itens da fila restantes sejam processados sem atrasos, quando possível.

10. No menu suspenso Fuso horário, selecione o fuso horário a ser usado como base para a hora de desabilitar o gatilho de fila (veja a etapa 13).
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.

    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.

    • Select Stop from the drop-down - attempts to gracefully end the execution after the defined time interval has passed since the job is stuck in a Pending or Running state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes);
      Example: Orchestrator will attempt to stop jobs that have been stuck for at least 10 minutes in Pending or Running.

      

    • Select Kill from the drop-down - attempts to forcefully end the execution after the defined time interval has passed since the job is stuck in a Pending or Running state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes);

      Example: Orchestrator will attempt to kill jobs that have been stuck for at least 10 minutes in Pending or Running.

    • Select Stop from the drop-down and enable the If the job does not stop, kill it option - attempts to gracefully end the execution after the defined time interval has passed since the job is stuck in a Pending or Running state and then attempts to forcefully end it after the defined time interval has passed since the job is stuck in a Stopping state (set the time to a minimum of 1 minute, maximum of 10 days, 23 hours and 59 minutes).

      Example: Orchestrator will attempt to stop jobs that have been stuck in Pending or Running for at least 10 minutes. If the termination does not happen, Orchestrator will attempt killing those jobs that have been Stopping for at least 20 minutes.

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 desabilitado. O fuso horário selecionado influencia quando o gatilho da fila é 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. É possível escolher um valor entre 0 e 30. O padrão é 0, o que significa que o disparador é desabilitado assim que o trabalho falha, sem tempo de espera.

    Observação:

    Se você escolher um runtime Cloud - Serverless para o processo subjacente, a opção Definir desativação do gatilho com base na execução é habilitada automaticamente, com os seguintes valores padrão (os campos são apenas 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.

    Isso só se aplica a você se você estiver no plano de licenciamento Community.

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.