Definir um contexto externo usando eventos externos

Eventos externos são mensagens de comunicação entre janelas personalizadas que permitem a troca segura de dados entre janelas pai e aplicativos incorporados em janelas filhas (iframes). No runtime, isso permite que os aplicativos escutem eventos externos configurados e executem as automações associadas.

Os eventos externos trazem:

• Arquitetura orientada a eventos - Dispare ações específicas com base em tipos de eventos personalizados.
• Mensagens seguras — certifique-se de que a comunicação ocorra apenas entre origens confiáveis.
• Troca de dados em tempo real — habilitar interações dinâmicas entre o aplicativo de host e o UiPath Apps incorporado.

Pré-requisitos

A funcionalidade de eventos externos depende do Driver de Comunicação da UiPath, uma biblioteca de comunicação leve e segura para mensagens entre janelas.

O Driver de Comunicação da UiPath deve ser instalado na plataforma do host. Acesse a página do pacote npm para baixar o driver e leia a documentação detalhada sobre como instalá-lo e usá-lo.

Habilitação de eventos externos

1. Abra um aplicativo.
2. Clique com o botão direito do mouse em Aplicativo no explorador de projetos e selecione Propriedades.
3. Expanda a seção Eventos externos e selecione Habilitar.
4. No campo Origens permitidas , insira o domínio do aplicativo de host. Você pode adicionar várias entradas adicionando uma lista separada por vírgulas de URLs.

   As origens permitidas são cruciais para a segurança de eventos externos. Definir origens permitidas permite:

   • Validação de origens de mensagens – Processa apenas mensagens de origens especificadas.

   • Entrega de mensagens de destino — garante que as respostas vão para os destinatários pretendidos.

   • Prevenção de ataques CSRF - Bloqueia solicitações entre sites não autorizadas.

   • Manutenção da integridade dos dados – Garante canais de comunicação confiáveis.

   

Criação de um evento externo

1. Abra um aplicativo e selecione uma página no explorador de projetos.

2. Navegue até a guia Eventos no painel Propriedades .

3. Selecione Criar evento externo.

4. Insira um nome significativo para o evento externo.

   

5. Selecione Definir arquivo de fluxo de trabalho para configurar o arquivo de fluxo de trabalho a ser executado para o evento definido. Os dados recebidos no evento externo ficam disponíveis no argumento de fluxo de trabalho chamado ExternalEventData.