Définir un contexte externe à l'aide d'événements externes

Les événements externes sont des messages de communication inter-fenêtres personnalisés qui permettent un échange de données sécurisé entre les fenêtres parentes et les applications intégrées dans les fenêtres enfants. Au moment du runtime, cela permet aux applications d'écouter les événements externes configurés et d'exécuter les automatisations associées.

Les événements externes apportent :

• Architecture centrée sur les événements : déclenchez des actions spécifiques en fonction de types d'événements personnalisés.
• Messagerie sécurisée : vérifiez que la communication n'a lieu qu'entre des sources approuvées.
• Échange de données en temps réel - Activez les interactions dynamiques entre l'application hôte et les applications UiPath intégrées.

Prérequis

La fonctionnalité d’événements externes repose sur UiPath Communications Driver, une bibliothèque de communication légère et sécurisée pour la messagerie multi-fenêtres.

Le pilote de communication UiPath doit être installé sur la plate-forme hôte. Accédez à la page du package npm pour télécharger le pilote et lire la documentation détaillée sur la façon de l'installer et de l'utiliser.

Activation des événements externes

1. Ouvrez une application.
2. Cliquez avec le bouton droit sur App dans l’explorateur de projet et sélectionnez Propriétés.
3. Développez la section Événements externes et sélectionnez Activer.
4. Dans le champ Origines autorisées , saisissez le domaine de l'application hôte. Vous pouvez ajouter plusieurs entrées en ajoutant une liste d'URL séparées par des virgules.

   Les sources autorisées sont essentielles pour la sécurité des événements externes. La définition des sources autorisées permet :

   • Validation des sources de messages : traite uniquement les messages provenant d'origines spécifiées.

   • Livraison des messages ciblés : garantit que les réponses sont envoyées aux destinataires prévus.

   • Préférence des attaques CSRF : bloque les requêtes multi-sites non autorisées.

   • Maintien de l'intégrité des données : garantit des canaux de communication fiables.

   

Création d'un événement externe

1. Ouvrez une application et sélectionnez une page dans l'explorateur de projet.

2. Accédez à l'onglet Events dans le panneau Propriétés .

3. Sélectionnez Créer un événement externe.

4. Saisissez un nom significatif pour l'événement externe.

   

5. Sélectionnez Définir le fichier de workflow pour configurer le fichier de workflow à exécuter pour l'événement défini. Les données reçues dans l'événement externe sont disponibles dans l'argument de workflow nommé DonnéesÉvénementExternes.