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.

Visão geral

Há dois tipos de gatilhos de eventos baseados em conexões do Integration Service:

• Conectado - Criado com atividades de gatilho no Studio, usado dentro de um processo.
• Desconectado – Criado no Orchestrator ou no Integration Service, usado para iniciar qualquer automação.

Observação: os gatilhos dependem das conexões. Excluir uma conexão também exclui todos os gatilhos associados.

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

Atualização do intervalo de pesquisa

Os conectores suportam eventos por meio de um mecanismo de pesquisa.

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

O intervalo de pesquisa é definido no nível da conexão. Isso significa que você pode ter apenas um intervalo de pesquisa por conexão, mesmo que crie vários gatilhos por conexão. Alterar o 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.

Para atualizar o intervalo de pesquisa:

1. No Integration Service, vá para a guia Conexões .
2. Selecione uma conexão específica para abrir a página de detalhes da conexão.

   O intervalo de pesquisa é exibido apenas para conexões com gatilhos adicionados.

3. Selecione o intervalo de tempo para abrir a janela Atualizar intervalo de pesquisa .

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

5. Selecione Atualizar e verificar.

Exibição do histórico de execução de gatilhos

Para visualizar o histórico de execução do gatilho:

1. No Integration Service, selecione a guia Gatilhos .
2. Para qualquer gatilho listado, selecione Exibir gatilho usando o Menu Mais ações:

A tabela de Histórico de tentativas mostra:

• A hora do evento - quando o evento foi capturado
• O número de tentativas
• O estado do gatilho - se o processo foi iniciado com sucesso ou não.

Observação: O estado Bem-sucedido indica apenas que o trabalho foi iniciado com sucesso. Ele não reflete se o trabalho foi executado com sucesso até o fim ou não. Caso um trabalho falhe ao iniciar, seu Estado aparecerá como 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 . Essa ação redireciona você para o Orchestrator, onde você pode ver todas as informações necessárias sobre a execução de trabalhos.

Gerenciar gatilhos

As seguintes ações estão disponíveis para gatilhos criados no Integration Service.

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.
   Alternativamente, é possível selecionar seu gatilho na lista para acessar a exibição detalhada. O botão Editar está localizado no lado direito do nome do seu gatilho.
3. Selecione o botão Editar e você poderá escolher um novo nome para o seu gatilho

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.

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.

Argumentos de evento

Os gatilhos desconectados permitem que você recupere dados sobre o conector e o evento que dispara um processo.

Se você 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 as preenche automaticamente quando inicia o trabalho:

• UiPathEventConnector - Determina qual conector iniciou a automação.
• UiPathEvent – Determina o tipo de evento que ocorreu.
• UiPathEventObjectType - Define o tipo de registro específico resultante do evento.
• UiPathEventObjectId - Fornece o identificado exclusivo para o objeto envolvido no evento.

Você não pode atribuir qualquer valor a esses argumentos. Eles são preenchidos automaticamente no momento da execução do gatilho, e você não pode exibi-los ou editá-los a partir do painel Argumentos no Studio. Saiba mais sobre como os argumentos funcionam e como gerenciá-los na documentação do Studio: Gerenciando argumentos.

Para recuperar e trabalhar com um registro que possui 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 o Integration Service passa os valores do argumento de entrada para os logs do Orchestrator:

Saídas específicas do gatilho

Os gatilhos conectados têm saídas específicas do objeto. Por exemplo, o gatilho Microsoft OneDrive & SharePoint Email Received gera um objeto do tipo Office365Message, com propriedades como AttachmentsNamesList, FromAddress, InternetMessageId, SentDateTime etc. Para obter detalhes, consulte EventosMicrosoft OneDrive & SharePoint .

Use o Editor de Expressão no Studio para exibir todas as propriedades disponíveis para qualquer objeto de saída de gatilho.

Limitações

As limitações de gatilhos estão documentadas na seção Solução de problemas deste guia. Consulte Limitações de gatilhos.