Gerenciar gatilhos

Criação de um gatilho de tempo

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 é exibida.

2. Selecione Tempo como o tipo de gatilho.

3. No campo Nome, adicione um nome para que o gatilho o identifique facilmente.

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

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

6. From the Runtime type drop-down menu, select the runtime used to execute the jobs that are launched by the trigger.

7. Na aba Destino de Execução, selecione o mecanismo de alocação e o destino de execução de seus trabalhos.

   Descrição
   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	O processo pode ser executado em pares específicos de conta-máquina. 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 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.

8. On the Arguments tab, provide values for input arguments if your process has any.

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

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

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

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

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

      

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

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

Criação de um gatilho de fila

Observação:

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 é exibida.

2. Selecione Fila como o tipo de gatilho.

3. No campo Nome, adicione um nome para que o gatilho o identifique facilmente.

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

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

6. From the Runtime type drop-down menu, select the runtime license type.

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

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

8. On the Arguments tab, provide values for input arguments if your process has any.

9. Preencha os campos Número mínimo de itens para disparar o primeiro trabalho., Número máximo de trabalhos pendentes e em execução permitidos simultaneamente., Outro trabalho é disparado para cada _ novo(s) item(ns).

   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.

10. From the Timezone drop-down menu, select the time zone according to which the queue trigger gets disabled.

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.

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 desabilitado. O fuso horário selecionado influencia quando o gatilho da fila é desativado.

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

Edição de um gatilho

Clique no botão Editar correspondente, faça as alterações pretendidas e clique em Atualizar na janela Editar gatilho.

Desabilitação de um gatilho

Para desabilitar um disparador, clique no botão Mais Ações correspondente e, depois, em Desabilitar. Um gatilho de tempo desabilitado é marcado pelo ícone na frente dele. Um gatilho de fila desabilitado é marcado pelo ícone na frente dele.

Como alternativa, você pode selecioná-la e clicar no ícone Desabilitar.

Você também pode configurar seu gatilho para ser desabilitado automaticamente em uma data e horário específicos no futuro. Você pode fazer isso da seguinte maneira:

1. Clique no botão Editar correspondente.

2. Ative a opção Agendar a desativação automática de gatilho.

3. Preencha a data e hora desejada. O fuso horário do acionador influencia quando o acionador é desativado.

4. Clique em Atualizar para que as alterações entrem em vigor.

   Por padrão, um gatilho é desabilitado automaticamente após 10 lançamentos falhos se não tiver sido lançado com sucesso no último dia.

   Esse valor pode ser personalizado usando o parâmetro Triggers.DisableWhenFailedCount .

Habilitação de um gatilho

Para habilitar um gatilho, clique no botão Mais Ações correspondente e, depois, em Habilitar. Um gatilho de tempo habilitado é marcado pelo ícone na frente dele. Um gatilho de fila habilitado é marcado pelo em frente a ele.

Como alternativa, você pode selecioná-la e clicar no ícone Habilitar.

Remoção de um gatilho

Para remover um gatilho, clique no botão Mais ações correspondente e, depois, em Remover.

Como alternativa, você pode selecioná-la e clicar em Remover.

Exibição de trabalhos acionados por um gatilho

Para exibir os trabalhos iniciados por um gatilho específico, clique no botão Mais Ações e, depois, em Exibir trabalhos. Isso exibe a janela Trabalhos, que inclui todos os trabalhos executados no passado por meio do gatilho selecionado (se houver).

Gerenciamento de dias não úteis

Criação de novos calendários

1. Abra a guia Dias não úteis na página Configurações. Uma lista com todos os calendários definidos anteriormente é exibida, ordenada alfabeticamente.

   O calendário BankHoliday é exibido aqui, se existir. Esse calendário é criado ao atualizar seu Orchestrator para a versão 19.10, se você tiver dias não úteis definidos em sua versão anterior.

2. Clique em Adicionar para criar um novo calendário e digitar seu nome no campo em branco realçado. O nome deve ser exclusivo e pode conter no máximo 150 caracteres alfanuméricos. Você não pode criar calendários sem nomes ou contendo apenas caracteres de espaço.

3. Clique em Salvar ou pressione Enter no seu teclado para salvar o novo calendário. O calendário é salvo e exibido na lista de calendários.

4. Para o calendário selecionado, defina dias não úteis manualmente ou carregando um arquivo .csv,ou uma combinação dessas opções.

5. Na página Gatilhos, ao criar um novo gatilho ou editar um já existente, selecione o calendário desejado no menu suspenso Restrição de dias não úteis.

   Observação:

   When you use non-working days, the trigger time zone must be the same as the tenant time zone (Tenant> Settings> General), because calendar restrictions cannot be applied in different time zones. A tenant without an explicitly defined time zone inherits it from the host.

6. Clique em Atualizar para que as alterações entrem em vigor. Cada alteração feita em um calendário se propaga posteriormente para todos os gatilhos associados a esse calendário.

Selecionando manualmente os dias não úteis

1. Selecione um calendário. O calendário no lado direito da janela é devidamente atualizado.
2. No calendário exibido, clique nas datas nas quais você deseja que seus gatilhos parem de disparar. Clique novamente em uma data selecionada para desmarcá-la.
3. Selecione Salvar em para salvar as datas selecionadas como dias não úteis.

Fazendo upload de .csv arquivos

Permite que você carregue uma série de datas em um calendário selecionado, diretamente de um arquivo .csv. Observe que o arquivo deve ser previamente preenchido usando um formato predefinido, para que a operação de carregamento seja bem-sucedida. As novas datas do seu arquivo carregado substituirão quaisquer datas já contidas no calendário.

Observação:

O arquivo .csv deve conter o ExcludedDate cabeçalho da coluna. Todos os dias não úteis devem estar dentro dessa coluna, gravados no formato YYYY-MM-DD, YYYY/MM/DD ou YYYY MM DD.

See the Example section below for more information.

Opção 1

1. No calendário selecionado, clique em Carregar csv.
2. Navegue até o arquivo .csv desejado, selecione-o e clique em Abrir. O Orchestrator analisa o arquivo para confirmar se ele cumpre as regras de formatação (consulte o exemplo na seção abaixo).
3. Clique em Sim na caixa de diálogo de confirmação para substituir as datas já contidas no calendário pelas novas datas do seu arquivo carregado.
4. Clique em Salvar para salvar o calendário modificado.

Opção 2

1. Arraste e solte o arquivo . desejado sobre a parte superior do calendário. O Orchestrator analisa o arquivo para confirmar se ele cumpre as regras de formatação (veja o exemplo na seção abaixo).
2. Clique em Sim na caixa de diálogo de confirmação para substituir as datas já contidas no calendário pelas novas datas do seu arquivo carregado.
3. Clique em Salvar para salvar o calendário modificado.

Exemplo

Let's say you upload into a calendar the content of the following .csv file. An easy way to create such a file is to populate the data into an excel file and save it as a .csv file:

Ou você pode baixar um arquivo .csv com todos os cabeçalhos de colunas pré-preenchidos e personalizá-lo de acordo com suas necessidades.

Fazer download do arquivo

Observe que esse arquivo contém um cabeçalho de coluna predefinido, ExcludedDate. Insira todos os seus dias não úteis nessa coluna, usando o formato AAAA-MM-DD, AAAA/MM/DD ou AAAA MM DD.

Renomeação de calendários

1. Selecione um calendário na guia Dias não úteis na página Configurações.
2. Modifique o nome do calendário.
3. Clique em Salvar para salvar o nome alterado.

Exclusão de calendários

1. Selecione um calendário na guia Dias não úteis na página Configurações.

2. Clique em Excluir.

3. Clique em Sim na janela pop-up para confirmar sua intenção. O calendário é excluído.

   Observação:

   Você só pode excluir calendários que não estejam associados a quaisquer gatilhos.

Você também pode remover dias não úteis de um calendário. Após clicar em um dia não útil, ele não estará mais marcado. Lembre-se de salvar suas alterações.