Gatilhos

Os gatilhos fornecem um mecanismo uniforme para assinar eventos a partir das plataformas de Conector. Isso dá a você a flexibilidade de iniciar automaticamente automações ou processos no Orchestrator.

Pré-requisitos

Antes de configurar os gatilhos, certifique-se de que as seguintes condições sejam atendidas:

• O Integration Service é habilitado e provisionado para seu tenant.
• A guia Gatilhos é exibida na janela Integrações.
• Você já configurou um Robô não assistido ou Non-production na sua instância do Orchestrator.

• Você está usando pastas modernas (os processos dentro de pastas clássicas não ficam visíveis ao definir gatilhos).

Observação: os gatilhos são compatíveis apenas com pastas modernas. As pastas clássicas não suportam o paradigma de identidade do usuário moderno e, portanto, não podem suportar conexões em geral, ou gatilhos.

Criar seu processo

Crie seu processo no UiPath® Studio como você faria normalmente. Usando o Integration Service, qualquer automação pode ser disparada para qualquer processo.

Para receber os detalhes de um registro, siga as seguintes etapas:

• Se quiser saber o conector, evento, tipo de registro ou registro real que disparou o processo em seu fluxo de trabalho, defina os seguintes argumentos de entrada do tipo String em seu processo.

  O Integration Service os preencherá automaticamente quando iniciar o trabalho.

  • Conector de Eventos do UiPath
  • EventoDoUiPath
  • Tipo de Objeto de Evento do UiPath
  • ID de Objeto do Evento do UiPath
    Observação: saiba mais sobre como os Argumentos funcionam e como gerenciá-los aqui.
• Para recuperar e trabalhar com um registro que tenha um gatilho em uma execução de trabalho, use o argumento de entrada UiPathEventObjectId para recuperar o registro do sistema de origem.

Aqui está um exemplo de como os valores do argumento de entrada são passados pelo Integration Service.

Como publicar seu processo

Publique seu processo no Orchestrator como você faria normalmente. Você pode publicá-lo em uma pasta compartilhada ou um espaço de trabalho pessoal. Certifique-se de criar um processo fora do seu pacote.

Configuração do seu disparador

Para adicionar um gatilho, siga as seguintes etapas:

1. Acesse o Automation Cloud^TM.
2. No menu do lado esquerdo, selecione Integration Service. A janela Integration Service inclui três guias separadas: Conectores, Conexões e Gatilhos.
3. Acesse a guia Gatilhos e selecione o botão Adicionar gatilho .
4. Selecione o Conector e a Conexão desejados em seus respectivos menus suspensos. Se houver apenas uma conexão configurada para esse conector específico, ela será selecionada automaticamente.

5. Selecione o Evento e Registro desejados em seus respectivos menus suspensos.

   Observação: os tipos de eventos podem variar de acordo com o conector.
6. À direita, selecione o Processo a ser executado.

7. Selecione a Licença de runtime (o runtime usado para executar os trabalhos que são iniciados pelo gatilho) no menu suspenso. Opções disponíveis: NonProduction, Não Assistidos, Headless, TestAutomation, AutomationCloud, Serverless, Desenvolvimento.

   • A lista de runtimes exibida é baseada na resposta recebida do Orchestrator, ou seja, as licenças de runtime “atribuídas” para essa pasta. Para o runtime selecionado, uma mensagem indica o número de runtimes atribuídos.
   • Para obter mais informações, consulte a documentação de Gerenciamento de gatilhos no Orchestrator e Runtimes (licenças de robô) .
8. Selecione o botão Adicionar gatilho para criar seu gatilho e ativá-lo.

Alternativamente, você pode criar um novo gatilho a partir da aba Conexões. Para fazer isso:

1. Selecione o botão Mais Ações de uma conexão.
2. Selecione a opção Adicionar gatilho .
3. Selecione o Evento e o Tipo de Registro desejados em seus respectivos menus suspensos. Nesse caso, o Conector e a Conexão já estão selecionados e não podem ser alterados.
4. À direita, selecione o Processo a executar e a respectiva Licença de runtime.

5. Selecione o botão Adicionar gatilho para criar seu gatilho e ativá-lo.

Observação:

O monitoramento de eventos está atualmente definido para pesquisar a cada 5 minutos. Dessa forma, pode levar até 5 minutos antes que o processo associado seja iniciado.

Você pode ver os detalhes de um trabalho na guia Trabalhos na sua pasta do Orchestrator. Um trabalho iniciado no Integration Service mostrará sua origem como Integration Trigger.

Events

Os conectores suportam eventos por meio de um mecanismo de pesquisa. Isso é compatível com a maior parte do catálogo de conectores.

O Integration Service oferece suporte aos dois tipos de eventos a seguir:

1. Generic, que representam as operações típicas de Create, Update e Delete. Ao selecionar um evento genérico, você também deve definir o registro de evento a ser monitorado. Por exemplo, Registro criado para o registro de Calendário .

2. Predefinidos, que representam ações específicas em objetos específicos. Por exemplo, Evento criado no calendário.

Mais informações sobre eventos estão disponíveis na página de cada conector.

Filtros de dados

Ao definir um evento para seu disparador, você pode adicionar uma filtragem mais específica.

Com Filtros de dados, você pode configurar gatilhos que correspondam a padrões de dados específicos. Isso significa menos acionamentos do seu robô e não precisar aplicar filtros adicionais na sua automação.

Intervalo de Pesquisa

Quando você cria uma nova conexão e configura um gatilho de evento nessa conexão, o intervalo de pesquisa é definido por padrão como cinco minutos.

Você pode personalizar esse intervalo usando a funcionalidade Intervalo de pesquisa ajustável , que permite escolher o intervalo no qual os gatilhos de evento verificam novos eventos de objetos.

Importante: você pode ter apenas um intervalo de pesquisa por conexão, mesmo que possa ter vários gatilhos configurados por conexão. A alteração do intervalo de pesquisa afeta todos os gatilhos associados em uma conexão.

A sondagem é executada na conexão no intervalo selecionado. Após os dados serem recuperados, todos os gatilhos ativos para essa conexão são aplicados ao conjunto de dados. Se uma pesquisa estiver em execução quando você alterar o intervalo, o serviço aguardará a pesquisa existente terminar e, então, iniciará outra.

Alteração do intervalo de pesquisa

Você pode alterar seu intervalo de pesquisa na página de um conector específico ou na guia Conexões .

1. No Automation Cloud^TM, acesse o Integration Service.
2. Acesse a página Conectores e selecione um conector.
3. Na página do conector, selecione uma conexão para abrir a página Detalhes da conexão.

4. Selecione o intervalo encontrado sob o nome da conexão, da seguinte forma. O intervalo de pesquisa é exibido apenas para conexões com gatilhos adicionados.

   
   

   

   
   

Como alternativa, você pode configurar seu intervalo de pesquisa na guia Conexões :

1. No Integration Service, acesse a guia Conexões .
2. Selecione uma conexão específica para abrir a página de detalhes da conexão.
3. Selecione o intervalo encontrado sob o nome da conexão.
4. A janela Atualizar intervalo de pesquisa é exibida.

5. Você pode escolher uma das opções disponíveis ou configurar um Intervalo personalizado , em minutos ou horas. O intervalo de pesquisa deve ser superior a um minuto e não superior a 24 horas ou 1440 minutos.

   
   

   

   
   

   A seguinte mensagem de erro avisa você se você inserir um valor incorreto: "O intervalo de pesquisa deve ser um número natural de 1 a 1440 minutos ou 24 horas."

6. Selecione Atualizar intervalo.

Histórico de execução do gatilho

Você pode visualizar o histórico de execução de um gatilho simplesmente selecionando-o na guia Gatilhos . Na nova página, o histórico de Tentativas é exibido na parte inferior da interface.

Esse histórico mostra eventos que foram recebidos pelo Integration Service e se o processo foi iniciado com sucesso, nesse caso mostra a palavra Sucesso na coluna Estado .

Observação: o estado Bem- sucedido apenas indica que o trabalho foi iniciado com sucesso. Ele não reflete se o trabalho foi executado com sucesso até o fim ou não.

Importante: caso um trabalho falhe ao iniciar, seu Estado aparecerá como Com falha. Passe o cursor do mouse sobre o estado Com falha para exibir a mensagem de erro.

Para verificar se um trabalho foi executado com sucesso, selecione o botão Exibir logs de trabalho . Ele redirecionará você para o Orchestrator, onde todas as informações necessárias sobre a execução do trabalho são exibidas.

Exclusão de um gatilho

Vá para a guia Gatilhos na janela Integration Service . Selecione o botão Mais ações correspondente ao seu gatilho e selecione Excluir.

Renomeando um disparador

Para renomear um gatilho, siga as seguintes etapas:

1. Acesse a guia Disparadores .

2. Passe o cursor do mouse sobre o nome do gatilho que você deseja modificar. O botão Editar é exibido.

   Observação: como alternativa, você pode selecionar seu disparador da lista para acessar a exibição detalhada. O botão Editar está localizado no lado direito do nome do gatilho.
3. Selecione o botão Editar e você poderá escolher um novo nome para o seu gatilho.

Exibição de detalhes do gatilho

Selecione um gatilho para exibir seus detalhes.

Ativar ou desativar um gatilho

Para ativar ou desativar um gatilho, primeiro você precisa selecioná-lo para exibir seus detalhes. Em seguida, selecione o botão localizado no lado superior esquerdo da janela.

Limitações

Esta seção lista as limitações conhecidas dos gatilhos do Integration Service.

Limitação máxima de registros

Description

Atualmente, os gatilhos do Integration Service têm um limite máximo de 1.000 registros por execução de gatilho. Se um gatilho tentar recuperar mais de 1.000 registros dentro do intervalo de tempo configurado (por exemplo, um minuto ou cinco minutos) e o sistema do fornecedor emitir mais registros do que esse limite, quaisquer registros que excedam o limite não serão capturados e poderão ser perdidos.

Impacto

Essa limitação pode afetar fluxos de trabalho ou automações que exijam o processamento de grandes conjuntos de dados, pois o gatilho pode não recuperar todos os registros.

Solução alternativa

Estamos trabalhando ativamente para resolver essa restrição. Até lá, para minimizar o impacto, você pode configurar o intervalo de gatilho para a duração mínima possível, conforme explicado em Intervalo de pesquisa. Aumentar a frequência da execução do gatilho garante que todos os registros sejam capturados em várias execuções do gatilho.

Desabilitar gatilhos automaticamente

Se um gatilho encontrar 100 erros consecutivos causados por problemas em aplicativos de terceiros durante a pesquisa de eventos novos ou atualizados, o sistema desabilitará automaticamente o gatilho. Esse mecanismo ajuda a manter a estabilidade do sistema.

Quando um dos seus gatilhos for desabilitado, você receberá uma notificação por e-mail. Você deve reabilitar manualmente o gatilho após o problema subjacente que causa os erros ter sido corrigido.

Edição de gatilhos

A edição de um gatilho existente não é compatível atualmente. As únicas opções para o gerenciamento de gatilhos são criar ou excluir gatilhos. Para quaisquer alterações desejadas, você deve excluir o disparador existente e adicionar um novo.