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.

Gatilhos no Orchestrator

Importante:

A partir do final de abril de 2025, você pode criar novos gatilhos do Integration Service apenas no Orchestrator.

Os gatilhos criados no Orchestrator não serão listados na guia Gatilhos do Integration Service. Os gatilhos do Integration Service existentes continuarão a ser executados e permanecerão visíveis na guia Gatilhos do Integration Service até 31 de julho de 2025 (essa data está sujeita a possíveis extensões). Após essa data, os gatilhos existentes do Integration Service serão migrados para o Orchestrator e a guia Gatilhos no Integration Service será removido.

Essa alteração está programada para ficar disponível primeiro para usuários Community e depois para usuários Enterprise progressivamente, dependendo da organização e das regiões do tenant. Siga o guia de notas de versão do Integration Service para saber quando a alteração é anunciada pela primeira vez.

Principais benefícios dos gatilhos no Orchestrator

Mover os gatilhos do Integration Service para o Orchestrator é uma grande mudança, mas ela traz muitos benefícios. Estes são os principais motivos que impulsionaram esta atualização:

1. Mapeamento de conta-máquina: o Orchestrator permite o controle no nível da máquina sobre os processos acionados pelo Integration Service.
2. Controle de execução de processos específicos por bot: o Orchestrator permite que você especifique qual robô deve executar um processo em uma pasta na qual vários bots estão alocados. Isso fornece controle preciso sobre qual bot executa um processo disparado, elimina a necessidade de soluções alternativas como pastas de robô único e melhora a escalabilidade ao permitir vários bots sem perder o controle de execução.
3. Argumentos de entrada e alocação dinâmica de processos: o Orchestrator habilita os argumentos de entrada dinâmicos e permite que você defina o número máximo de instâncias de processos ativas. Isso reduz a duplicação de processos ao permitir argumentos dinâmicos, otimiza o uso de recursos ao limitar os processos ativos e melhora a eficiência para processos que gerenciam solicitações sequenciais.
4. Gerenciamento aprimorado de processos de longa duração: os gatilhos criados no Orchestrator suportam as opções "Interromper após" e "Encerrar após", permitindo o encerramento automático de processos após uma duração ou condição especificada. Isso impede o uso excessivo de recursos encerrando processos de longa execução e garante uma execução oportuna interrompendo fluxos de trabalho sem resposta.
5. Recursos de edição: o Orchestrator permite que você edite gatilhos existentes.
6. Experiência de gatilho unificada: crie e gerencie todos os tipos de gatilhos em um local.
7. Visualização de gatilho único: mover a criação de gatilho para o Orchestrator garante que todos os gatilhos baseados no Integration Service mantenham uma única exibição. Agora, você pode criar um gatilho baseado no Integration Service de duas maneiras: a partir do Integration Service, criando um gatilho para um conector específico, e a partir do Studio, usando um gatilho de atividade para iniciar uma automação. As informações de configuração exibidas para os dois gatilhos podem diferir ligeiramente, mesmo que capturem o mesmo evento.

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

Criação de gatilhos

Você cria gatilhos de eventos desconectados diretamente do Orchestrator. Para obter detalhes, consulte a seção Gatilhos de eventos no guia do usuário do Orchestrator.

O Orchestrator fornece o gerenciamento direto desses gatilhos. No Integration Service, sua única opção para a modificação de gatilhos é ajustar o intervalo de pesquisa, que é definido no nível de conexão.

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

Importante: a tabela de Histórico de tentativas está disponível exclusivamente para gatilhos criados no Integration Service e listados na guia Gatilhos . O histórico de tentativas não está disponível para gatilhos criados no Orchestrator.

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.

Os gatilhos criados diretamente no Orchestrator podem ser gerenciados a partir do Orchestrator.

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.