Auslöser

Trigger bieten einen einheitlichen Mechanismus zum Abonnieren von Ereignissen von den Connector-Plattformen. Sie gibt Ihnen die Flexibilität, Automatisierungen oder Prozesse im Orchestrator automatisch zu starten.

Trigger im Orchestrator

Wichtig:

Ab Ende April 2025 können Sie neue Integration Service-Trigger nur im Orchestrator erstellen.

Im Orchestrator erstellte Trigger werden nicht auf der Registerkarte Integration Service -Trigger aufgelistet. Vorhandene Integration Service-Trigger werden weiterhin ausgeführt und bleiben bis zum 31. Juli 2025 auf der Registerkarte Integration Service -Trigger sichtbar (dieses Datum unterliegt möglichen Erweiterungen). Nach diesem Datum werden vorhandene Integration Service-Trigger zum Orchestrator migriert und die Registerkarte Trigger im Integration Service wird entfernt.

Diese Änderung soll zuerst für Community-Benutzer und dann für Enterprise-Benutzer verfügbar werden, abhängig von der Organisation und den Mandantenregionen. Folgen Sie den Integration Service-Versionshinweisen, um zu erfahren, wann die Änderung zum ersten Mal angekündigt wird.

Vorteile von Triggern im Orchestrator

Das Verschieben von Integration Service-Triggern in den Orchestrator ist eine große Veränderung, bringt aber viele Vorteile mit sich. Hier sind die Hauptgründe für dieses Update:

1. Konto-Maschine-Zuordnung: Der Orchestrator ermöglicht die Kontrolle auf Maschinenebene über vom Integration Service ausgelöste Prozesse.
2. Bot-spezifisches Prozessausführungssteuerelement: Mit dem Orchestrator können Sie angeben, welcher Roboter einen Prozess in einem Ordner ausführen soll, in dem mehrere Bots zugeordnet sind. Dies bietet eine präzise Kontrolle darüber, welcher Bot einen ausgelösten Prozess ausführt, macht Problemumgehungen wie Einzel-Bot-Ordner überflüssig und verbessert die Skalierbarkeit, indem mehrere Bots zugelassen werden, ohne die Ausführungskontrolle zu verlieren.
3. Eingabeargumente und dynamische Prozesszuweisung: Der Orchestrator ermöglicht dynamische Eingabeargumente und ermöglicht das Definieren der maximalen Anzahl aktiver Prozessinstanzen. Dies reduziert Prozessduplizierung, indem dynamische Argumente zugelassen werden, optimiert die Ressourcennutzung durch Begrenzung aktiver Prozesse und verbessert die Effizienz von Prozessen, die Anforderungen sequenziell verwalten.
4. Verbesserte Verwaltung von Prozessen mit langer Ausführungszeit: Im Orchestrator erstellte Trigger unterstützen die Optionen „Anhalten nach“ und „Beenden nach“, wodurch Prozesse nach einer bestimmten Dauer oder Bedingung automatisch beendet werden können. Dies verhindert eine Ressourcenüberverwendung, indem Prozesse mit langer Ausführungszeit beendet werden, und gewährleistet eine rechtzeitige Ausführung, indem nicht reagierende Workflows gestoppt werden.
5. Bearbeitungsfunktionen: Der Orchestrator ermöglicht es Ihnen, vorhandene Trigger zu bearbeiten.
6. Einheitliche Trigger-Erfahrung: Erstellen und verwalten Sie alle Triggertypen an einem Ort.
7. Einzelne Triggeransicht: Die Verlagerung der Triggererstellung in den Orchestrator stellt sicher, dass alle Integration Service-basierten Trigger eine einzige Ansicht behalten. Sie können jetzt einen Integration Service-basierten Trigger auf zwei Arten erstellen: aus dem Integration Service, indem Sie einen Trigger für einen bestimmten Connector erstellen, und aus Studio, indem Sie eine Triggeraktivität verwenden, um eine Automatisierung zu starten. Die für die beiden Trigger angezeigten Konfigurationsinformationen können sich leicht unterscheiden, obwohl sie dasselbe Ereignis erfassen.

Überblick

Es gibt zwei Arten von Ereignistriggern, die auf Integration Service-Verbindungen basieren:

• Verbunden – Erstellt mit Triggeraktivitäten in Studio, verwendet innerhalb eines Prozesses.
• Getrennt – Erstellt im Orchestrator oder Integration Service, wird zum Starten einer Automatisierung verwendet.

Hinweis: Trigger hängen von Verbindungen ab. Beim Löschen einer Verbindung werden auch alle zugehörigen Trigger gelöscht.

Voraussetzungen

Bevor Sie Trigger konfigurieren können, stellen Sie sicher, dass die folgenden Bedingungen erfüllt sind:

• Der Integration Service ist aktiviert und für Ihren Mandanten bereitgestellt.
• Sie haben in Ihrer Orchestrator-Instanz bereits einen Unattended- oder Non-production-Roboter eingerichtet.
• Sie verwenden moderne Ordner (Prozesse innerhalb klassischer Ordner sind beim Definieren von Triggern nicht sichtbar).

Erstellen von Triggern

Sie erstellen getrennte Ereignistrigger direkt im Orchestrator. Weitere Informationen finden Sie im Abschnitt Ereignistrigger im Orchestrator-Benutzerhandbuch.

Der Orchestrator bietet die direkte Verwaltung dieser Trigger. Im Integration Service besteht Ihre einzige Option für die Triggeränderung im Anpassen des Abrufintervalls, das auf Verbindungsebene festgelegt wird.

Aktualisieren des Abrufintervalls

Connectors unterstützen Ereignisse durch einen Abrufmechanismus.

Wenn Sie einen Ereignistrigger für eine Verbindung einrichten, wird das Abrufintervall standardmäßig auf fünf Minuten festgelegt.

Das Abrufintervall wird auf Verbindungsebene festgelegt. Das bedeutet, dass Sie nur ein Abrufintervall pro Verbindung haben können, obwohl Sie mehrere Trigger pro Verbindung erstellen. Das Ändern des Abrufintervalls wirkt sich auf alle zugehörigen Trigger bei einer Verbindung aus.

Das Abrufen wird für die Verbindung im ausgewählten Intervall ausgeführt. Sobald Daten abgerufen wurden, werden alle aktiven Trigger für diese Verbindung auf das Dataset angewendet. Wenn eine Abfrage ausgeführt wird, während Sie das Intervall ändern, wartet der Dienst auf den Abschluss der vorhandenen Abfrage und startet dann eine andere.

So aktualisieren Sie das Abrufintervall:

1. Wechseln Sie im Integration Service zur Registerkarte Verbindungen .
2. Wählen Sie eine bestimmte Verbindung aus, um die Seite mit den Verbindungsdetails zu öffnen.

   Das Abrufintervall wird nur für Verbindungen mit hinzugefügten Triggern angezeigt.

3. Wählen Sie das Zeitintervall aus, um das Fenster Abrufintervall aktualisieren zu öffnen.

4. Sie können eine der verfügbaren Optionen auswählen oder ein benutzerdefiniertes Intervall in Minuten oder Stunden festlegen. Das Abrufintervall muss mehr als eine Minute und darf höchstens 24 Stunden oder 1440 Minuten betragen.

5. Wählen Sie Aktualisieren und Überprüfen aus.

Anzeigen des Verlaufs der Trigger-Ausführung

Wichtig: Die Verlaufstabelle der Versuche ist ausschließlich für Trigger verfügbar, die im Integration Service erstellt und auf der Registerkarte Trigger aufgeführt sind. Der Verlauf der Versuche ist für Trigger, die im Orchestrator erstellt wurden, nicht verfügbar.

So zeigen Sie den Verlauf der Trigger-Ausführung an:

1. Wählen Sie im Integration Service die Registerkarte Trigger aus.
2. Wählen Sie für jeden aufgelisteten Trigger die Option Trigger anzeigen mit aus Menü „Weitere Aktionen“:

Die Verlaufstabelle der Versuche zeigt:

• Die Ereigniszeit – Wenn das Ereignis erfasst wurde
• Die Anzahl der Versuche
• Der Triggerstatus – ob der Prozess erfolgreich gestartet wurde oder nicht.

Hinweis: Der Status Erfolgreich bedeutet nur, dass der Auftrag erfolgreich gestartet wurde. Sie spiegelt nicht wider, ob der Auftrag erfolgreich bis zum Ende ausgeführt wurde oder nicht. Falls ein Auftrag nicht gestartet werden kann, wird sein Status als Fehlgeschlagen angezeigt. Zeigen Sie mit dem Mauszeiger auf den Status Fehlgeschlagen , um die Fehlermeldung anzuzeigen.

Um zu überprüfen, ob ein Auftrag erfolgreich ausgeführt wurde, wählen Sie die Schaltfläche Auftragsprotokolle anzeigen aus. Diese Aktion leitet Sie zum Orchestrator weiter, wo Sie alle erforderlichen Informationen zur Auftragsausführung sehen können.

Verwalten von Triggern

Die folgenden Aktionen sind für Trigger verfügbar, die im Integration Service erstellt wurden. Trigger, die direkt im Orchestrator erstellt wurden, können über den Orchestrator verwaltet werden.

Umbenennen eines Triggers

Führen Sie die folgenden Schritte aus, um einen Trigger umzubenennen:

1. Greifen Sie auf die Registerkarte Trigger zu.
2. Zeigen Sie mit dem Mauszeiger auf den Namen des Triggers, den Sie ändern möchten. Die Schaltfläche Bearbeiten wird angezeigt.
   Alternativ können Sie Ihren Trigger aus der Liste auswählen, um auf die detaillierte Ansicht zuzugreifen. Die Schaltfläche Bearbeiten befindet sich rechts neben Ihrem Triggernamen.
3. Wählen Sie die Schaltfläche Bearbeiten aus und Sie können einen neuen Namen für Ihren Trigger wählen

Löschen eines Triggers

Wechseln Sie im Fenster Integration Service zur Registerkarte Trigger . Wählen Sie die Schaltfläche Weitere Aktionen aus, die Ihrem Trigger entspricht, und wählen Sie Löschen aus.

Aktivieren oder Deaktivieren eines Triggers

Um einen Trigger zu aktivieren oder zu deaktivieren, müssen Sie ihn zuerst auswählen, um seine Details anzuzeigen. Wählen Sie dann den Schalter aus, der sich auf der oberen linken Seite des Fensters befindet.

Ereignisargumente

Getrennte Trigger ermöglichen es Ihnen, Daten in Bezug auf den Connector und das Ereignis abzurufen, das einen Prozess auslöst.

Wenn Sie den tatsächlichen Connector, das Ereignis, den Datensatztyp oder den Datensatz wissen möchten, der den Prozess in Ihrem Workflow ausgelöst hat, definieren Sie die folgenden Eingabeargumente des Typs String in Ihrem Prozess. Integration Service füllt sie automatisch auf, wenn er den Auftrag startet:

• UiPathEventConnector – Bestimmt, welcher Connector die Automatisierung gestartet hat.
• UiPathEvent – Bestimmt den Typ des aufgetretenen Ereignisses.
• UiPathEventObjectType – Definiert den spezifischen Datensatztyp, der sich aus dem Ereignis ergibt.
• UiPathEventObjectId – Stellt die eindeutige Identifizierung für das am Ereignis beteiligte Objekt bereit.

Sie können diesen Argumenten keinen Wert zuweisen. Sie werden automatisch zur Ausführungszeit des Triggers aufgefüllt und Sie können sie im Bereich Argumente in Studio nicht anzeigen oder bearbeiten. Weitere Informationen zur Funktionsweise von Argumenten und deren Verwaltung finden Sie in der Studio-Dokumentation unter Verwalten von Argumenten.

Um einen Datensatz abzurufen, der einen Trigger bei einer Auftragsausführung hat, verwenden Sie das Eingabeargument UiPathEventObjectId , um den Datensatz aus dem Quellsystem abzurufen.

Hier ist ein Beispiel dafür, wie Integration Service die Eingabeargumentwerte an Orchestrator-Protokolle übergibt:

Triggerspezifische Ausgaben

Verbundene Trigger haben objektspezifische Ausgaben. Beispielsweise gibt der Microsoft OneDrive & SharePoint -Trigger E-Mail erhalten ein Objekt vom Typ Office365Message mit Eigenschaften wie AttachmentsNamesList, FromAddress, InternetMessageId, SentDateTime usw. aus. Weitere Informationen finden Sie unter Microsoft OneDrive & SharePoint -Ereignisse.

Verwenden Sie den Ausdrucks-Editor in Studio, um alle verfügbaren Eigenschaften für ein beliebiges Trigger-Ausgabeobjekt anzuzeigen.

Einschränkungen

Trigger-Einschränkungen werden im Abschnitt Fehlerbehebung dieses Handbuchs dokumentiert. Siehe Trigger-Einschränkungen.