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. No menu suspenso Tipo de runtime, selecione o runtime usado para executar os trabalhos que são iniciados pelo gatilho.
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. 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. 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 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. Na aba Argumentos, forneça valores para argumentos de entrada se seu processo tiver algum.
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 pode ser encontrada aqui.
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.
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.

    • Selecionar Parar no menu suspenso tenta encerrar naturalmente a execução após o intervalo de tempo definido ter passado desde que o trabalho esteja travado no estado Pendente (defina o tempo como um mínimo de 1 minuto, máximo de 10 dias, 23 horas e 59 minutos);
      Exemplo: o Orchestrator tentará interromper trabalhos que travarem por pelo menos 10 minutos no estado Pendente.

      

    • Selecionar Encerrar no menu suspenso - tenta encerrar forçadamente a execução após o intervalo de tempo definido ter passado desde que o trabalho travou no estado Pendente (defina o tempo como um mínimo de 1 minuto, máximo de 10 dias, 23 horas e 59 minutos);

      Exemplo: o Orchestrator tentará encerrar trabalhos que travarem por pelo menos 10 minutos no estado Pendente.

      

    • Selecionar Parar no menu suspenso e habilitar a opção Se o trabalho não parar, interrompa-o - tenta encerrar normalmente a execução após o intervalo de tempo definido ter passado desde que o trabalho esteja travado em um estado Pendente e, em seguida, tenta encerrá-lo à força após o intervalo de tempo definido ter passado desde que o trabalho esteja 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 travaram por pelo menos 10 minutos no estado Pendente. 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. 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: acionadores 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. No menu suspenso Tipo de runtime, selecione o tipo de licença de runtime.
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. 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 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. Na aba Argumentos, forneça valores para argumentos de entrada se seu processo tiver algum.
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. No menu suspenso Fuso horário , selecione o fuso horário de acordo com o qual o acionador da fila é desabilitado.
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.
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.

    • Selecionar Parar no menu suspenso tenta encerrar naturalmente a execução após o intervalo de tempo definido ter passado desde que o trabalho esteja travado no estado Pendente (defina o tempo como um mínimo de 1 minuto, máximo de 10 dias, 23 horas e 59 minutos);
      Exemplo: o Orchestrator tentará interromper trabalhos que travarem por pelo menos 10 minutos no estado Pendente.

      

    • Selecionar Encerrar no menu suspenso - tenta encerrar forçadamente a execução após o intervalo de tempo definido ter passado desde que o trabalho travou no estado Pendente (defina o tempo como um mínimo de 1 minuto, máximo de 10 dias, 23 horas e 59 minutos);

      Exemplo: o Orchestrator tentará encerrar trabalhos que travarem por pelo menos 10 minutos no estado Pendente.

      

    • Selecionar Parar no menu suspenso e habilitar a opção Se o trabalho não parar, interrompa-o - tenta encerrar normalmente a execução após o intervalo de tempo definido ter passado desde que o trabalho esteja travado em um estado Pendente e, em seguida, tenta encerrá-lo à força após o intervalo de tempo definido ter passado desde que o trabalho esteja 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 travaram por pelo menos 10 minutos no estado Pendente. 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 em frente a ele. Um gatilho de fila desabilitado é marcado pelo ícone em frente a ele.

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 em frente a ele. 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: ao usar dias não úteis, o fuso horário do gatilho deve ser igual ao fuso horário do tenant (Tenant > Configurações > guia General), porque restrições do calendário não podem ser aplicadas a diferentes fusos horários. Um tenant sem um fuso horário explicitamente definido o herdará do 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. Clique em um calendário para selecioná-lo. 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. Clique em Salvar 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.

Consulte a seção Exemplo abaixo para obter mais informações.

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

Digamos que você carregue em um calendário o conteúdo do seguinte arquivo .csv. Uma maneira fácil de criar esse arquivo é preencher os dados em um arquivo do Excel e salvá-lo como um arquivo .csv:

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.