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 aba 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 são compatíveis com o paradigma de identidade do usuário moderno e, portanto, não podem ser compatíveis com 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
  • Observação do UiPathEventObjectId: saiba mais sobre como os argumentos funcionam e como gerenciá-los aqui.

• To retrieve and work with a record that has a trigger on a job run, use the UiPathEventObjectId input argument to retrieve the record from the source system.

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 à esquerda, 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. Em seguida, 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. A lista de runtimes exibida se baseia na resposta recebida do Orchestrator, ou seja, as licenças de runtime "atribuídas" a 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.

Ou então, você pode criar um novo gatilho na guia Conexões . Para fazer isso:

1. Selecione o botão Mais Ações de uma conexão.
2. Select the Add trigger option.
3. Select the desired Event and Record Type from their respective dropdown menus. In this case, the Connector and Connection are already selected and cannot be changed.
4. On the right, select the Process to execute and the respective Runtime license.
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 cinco minutos. Dessa forma, pode levar até cinco minutos antes que o processo associado seja iniciado. É possível ver os detalhes de um trabalho na guia Trabalhos em sua Pasta do Orchestrator. Um trabalho iniciado a partir do 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. Genérico, que representam operações típicas de Criar, Atualizar e Excluir. Quando você seleciona 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. Predefinido, que representa ações específicas em objetos específicos. Por exemplo, Calendar event Created.

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.

With Data filters, you can configure triggers that match specific data patterns. This means fewer launches of your robot and not having to apply additional filtering within your automation.

Intervalo de Pesquisa

Os conectores suportam eventos por meio de um mecanismo 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.

O campo Intervalo de pesquisa ajustável permite que você personalize o intervalo no qual os gatilhos de eventos verificam novos eventos de objetos.

Importante:

You can have only one polling interval per connection, even though you can have several triggers set up per connection. Changing the polling interval affects all the associated triggers on a connection.

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 Integration Service.

2. Go to the Connectors page and select a connector.

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.

   

Alternatively, you can configure your polling interval from the Connections tab:

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.

3. Selecione o intervalo encontrado sob o nome da conexão.

4. The Update polling interval window is displayed.

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 maior do que um minuto e não maior do que 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 Intervalo de atualização.

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 os eventos que foram recebidos pelo Integration Service e se o processo foi iniciado com sucesso, nesse caso mostra a palavra Bem-sucedido na coluna Estado .

Observação:

The Successful state only indicates that the job was successfully launched. It does not reflect whether the job was successfully executed to the end or not.

Importante:

In case a job fails to start, its State will appear as Failed. Hover with the mouse cursor over the Failed state to view the error message.

Para verificar se um trabalho foi executado com sucesso, selecione o botão Exibir logs de trabalho . Ele vai redirecionar você para o Orchestrator, onde todas as informações necessárias sobre a execução de trabalhos 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. 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

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

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