Gatilhos

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

Gatilhos no Orchestrator

Importante:

A partir do final de abril de 2025, é possível criar novos gatilhos do Integration Service apenas no Orchestrator. Os gatilhos criados no Orchestrator não serão listados na aba Gatilhos do Integration Service. Os gatilhos do Integration Service existentes continuarão a ser executados e permanecerão visíveis na aba 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 aba Gatilhos no Integration Service será removida. Essa alteração é programada para ficar disponível primeiro para os usuários Community e, em seguida, para os 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 habilita o controle no nível da máquina sobre processos disparados pelo Integration Service.
2. Controle de execução de processos específico por robô: o Orchestrator permite especificar qual robô deve executar um processo em uma pasta na qual vários robôs estão alocados. Isso fornece controle preciso sobre qual robô executa um processo disparado, elimina a necessidade de soluções alternativas, como pastas de robô único, e melhora a escalabilidade ao permitir vários robôs sem perder o controle de execução.
3. Argumentos de entrada e alocação de processos dinâmicos: o Orchestrator habilita 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 limitando 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 ao encerrar processos de longa duração e garante a execução no tempo certo ao interromper fluxos de trabalho que não respondem.
5. Recursos de edição: o Orchestrator permite que você edite gatilhos existentes.
6. Experiência de gatilhos unificada: crie e gerencie todos os tipos de gatilhos a partir de 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 visualizaçã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 uma atividade Trigger 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 disparo no Studio, usado dentro de um processo.
• Desconectado — Criado no Orchestrator ou Integration Service, usado para iniciar qualquer automação.

Observação:

Os gatilhos dependem de 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 aba 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 Histórico de tentativas está disponível exclusivamente para gatilhos criados no Integration Service e listados na aba 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 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. Não reflete se o trabalho foi executado com sucesso até o final ou não. Caso um trabalho falhe ao iniciar, seu Estado aparecerá como Falhado. Passe o cursor do mouse sobre o estado Com falha para visualizar 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. Access the Triggers tab.
2. Passe o cursor do mouse sobre o nome do gatilho que você deseja modificar. O botão Editar é exibido. Ou então, você pode selecionar seu gatilho na lista para acessar a visualização detalhada. O botão Editar está localizado no lado direito do nome de seu gatilho.
3. Selecione o botão Editar e 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 tempo de execução do gatilho e você não pode visualizá-los ou editá-los no painel Argumentos no Studio. Saiba mais sobre como os argumentos funcionam e como gerenciá-los na documentação do Studio: Gerenciamento de 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 Recebido gera um objeto do tipo Office365Message, com propriedades como AttachmentsNamesList, FromAddress, InternetMessageId, SentDateTime etc. Para obter detalhes, consulte Microsoft OneDrive & SharePoint.

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

Limitações

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