Legen Sie einen externen Kontext mithilfe externer Ereignisse fest

Externe Ereignisse sind benutzerdefinierte fensterübergreifende Kommunikationsnachrichten, die einen sicheren Datenaustausch zwischen übergeordneten Fenstern und Apps ermöglichen, die in untergeordnete Fenster (iframes) eingebettet sind. Zur Laufzeit können Apps auf konfigurierte externe Ereignisse lauschen und die zugehörigen Automatisierungen ausführen.

Externe Ereignisse bringen Folgendes:

• Ereignisgesteuerte Architektur – Lösen Sie bestimmte Aktionen basierend auf benutzerdefinierten Ereignistypen aus.
• Secure Messaging – Stellen Sie sicher, dass die Kommunikation nur zwischen vertrauenswürdigen Quellen erfolgt.
• Echtzeit-Datenaustausch – Aktivieren Sie dynamische Interaktionen zwischen der Hostanwendung und eingebetteten UiPath Apps.

Voraussetzungen

Die Funktion externe Ereignisse basiert auf dem UiPath Communication Driver, einer einfachen und sicheren Kommunikationsbibliothek für fensterübergreifendes Messaging.

Der UiPath Communication Driver muss auf der Hostplattform installiert sein. Gehen Sie zur Seite npm-Paket, um den Treiber herunterzuladen und die detaillierte Dokumentation zur Installation und Verwendung zu lesen.

Aktivieren externer Ereignisse

1. Öffnen Sie eine App.
2. Klicken Sie im Projekt-Explorer mit der rechten Maustaste auf App und wählen Sie Eigenschaften aus.
3. Erweitern Sie den Abschnitt Externe Ereignisse und wählen Sie Aktivieren aus.
4. Geben Sie im Feld Zulässige Quellen die Domäne der Hostanwendung ein. Sie können mehrere Einträge hinzufügen, indem Sie eine durch Kommas getrennte Liste von URLs hinzufügen.

   Zulässige Quellen sind für die Sicherheit externer Ereignisse von entscheidender Bedeutung. Das Definieren zulässiger Quellen ermöglicht Folgendes:

   • Validierung von Nachrichtenquellen – Verarbeitet nur Nachrichten von angegebenen Quellen.

   • Gezielte Nachrichtenzustellung – Stellt sicher, dass Antworten an die vorgesehenen Empfänger gehen.

   • Verhinderung von CSRF-Angriffen – Blockiert nicht autorisierte Cross-Site-Anforderungen.

   • Aufrechterhaltung der Datenintegrität – Gewährleistet vertrauenswürdige Kommunikationskanäle.

   

Erstellen eines externen Ereignisses

1. Öffnen Sie eine App und wählen Sie eine Seite im Projekt-Explorer aus.

2. Gehen Sie zur Registerkarte Ereignisse im Eigenschaftenbereich .

3. Wählen Sie Externes Ereignis erstellen.

4. Geben Sie einen aussagekräftigen Namen für das externe Ereignis ein.

   

5. Wählen Sie Workflow-Datei definieren aus , um die Workflow-Datei zu konfigurieren, die für das definierte Ereignis ausgeführt werden soll. Die im externen Ereignis empfangenen Daten sind im Workflow-Argument mit dem Namen ExternalEventData verfügbar.