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.

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.
• Die Registerkarte Trigger wird im Fenster Integrationen angezeigt.
• 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).

  Hinweis:

  Trigger werden nur in modernen Ordnern unterstützt. Klassische Ordner unterstützen nicht das moderne Benutzeridentitätsparadigma, daher können Verbindungen im Allgemeinen oder Trigger nicht unterstützt werden.

Erstellen Ihres Prozesses

Erstellen Sie Ihren Prozess in UiPath® Studio, wie Sie es normalerweise machen. Mit dem Integration Service kann jede Automatisierung für jeden Prozess ausgelöst werden.

Um die Details eines Datensatzes zu erhalten, können Sie auch den folgenden Anweisungen folgen:

• Wenn Sie den Connector, das Ereignis, den Datensatztyp oder den Datensatz wissen möchten, die den Prozess in Ihrem Workflow ausgelöst haben, können Sie die folgenden Eingabeargumente vom Typ String in Ihrem Prozess definieren.

  Der Integration Service füllt sie automatisch aus, wenn der Auftrag gestartet wird.

  • UiPathEventConnector
  • UiPath-Ereignis
  • UiPathEreignisobjekttyp
  • UiPathEreignisobjektID
    Hinweis: Weitere Informationen zur Funktionsweise und Verwaltung von Argumenten finden Sie hier.
• Um einen Datensatz abzurufen und mit ihm zu arbeiten, 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 die Eingabeargumentwerte vom Integration Service übergeben werden.

Prozess veröffentlichen

Veröffentlichen Sie Ihren Prozess wie gewohnt im Orchestrator. Sie können sie in einem freigegebenen Ordner oder einem persönlichen Arbeitsbereich veröffentlichen. Stellen Sie sicher, dass Sie einen Prozess aus Ihrem Paket erstellen.

Konfigurieren Ihres Triggers

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

1. Greifen Sie auf die Automation Cloud^{TM zu}.
2. Klicken Sie im Menü auf der linken Seite auf Integration Service. Das Integration Service- Fenster enthält drei separate Registerkarten: Connectors, Verbindungen und Trigger.
3. Greifen Sie auf die Registerkarte Trigger zu und klicken Sie auf die Schaltfläche Trigger hinzufügen.
4. Wählen Sie den gewünschten Connector und die Verbindung aus den jeweiligen Dropdown-Menüs aus. Wenn für diesen bestimmten Connector nur eine Verbindung konfiguriert ist, wird diese automatisch ausgewählt.

5. Wählen Sie das gewünschte Ereignis und den Datensatz aus den jeweiligen Dropdown-Menüs aus.

   Hinweis: Ereignistypen können je nach Connector variieren.
6. Wählen Sie rechts den auszuführenden Prozess aus.

7. Wählen Sie die Runtime-Lizenz (die Runtime, die zum Ausführen der Aufträge verwendet wird, die vom Trigger gestartet werden) von der Dropdownliste aus. Verfügbare Optionen: NonProduction, Unattended, Headless, TestAutomation, AutomationCloud, Serverless, Development.

   • Die Liste der angezeigten Laufzeiten basiert auf der vom Orchestrator empfangenen Antwort, d. h. den Laufzeitlizenzen, die diesem Ordner „zugewiesen“ wurden. Für die ausgewählte Laufzeit gibt eine Meldung die Anzahl der zugewiesenen Laufzeiten an.
   • Weitere Informationen finden Sie in der Dokumentation zu Verwalten von Triggern im Orchestrator und Laufzeiten (Roboterlizenzen) .
8. Klicken Sie auf die Schaltfläche Trigger hinzufügen, um Ihren Trigger zu erstellen und zu aktivieren.

Alternativ können Sie einen neuen Trigger auf der Registerkarte Verbindungen erstellen. Gehen Sie dazu folgendermaßen vor:

1. Klicken Sie auf die Schaltfläche Weitere Aktionen einer Verbindung.
2. Wählen Sie die Option Trigger hinzufügen aus.
3. Wählen Sie das gewünschte Ereignis und den Datensatztyp aus den jeweiligen Dropdown-Menüs aus. In diesem Fall sind der Connector und die Verbindung bereits ausgewählt und können nicht geändert werden.
4. Wählen Sie rechts den auszuführenden Prozess und die jeweilige Runtime-Lizenz aus.

5. Klicken Sie auf die Schaltfläche Trigger hinzufügen, um Ihren Trigger zu erstellen und zu aktivieren.

   Hinweis:

   Die Ereignisüberwachung ist derzeit auf eine Abfrage alle 5 Minuten eingestellt. Daher kann es bis zu 5 Minuten dauern, bis der zugehörige Prozess gestartet wird.

   Sie können die Details eines Auftrags auf der Registerkarte Aufträge in Ihrem Orchestrator-Ordner sehen. Ein Auftrag, der über Integration Service gestartet wurde, zeigt seine Quelle als Integration Trigger an.

Events

Connectors unterstützen Ereignisse über einen Abrufmechanismus. Dies wird für den Großteil des Connector-Katalogs unterstützt.

Integration Service unterstützt die folgenden beiden Ereignistypen:

1. Generisch, die typische Erstellungs-, Aktualisierungs- und Löschvorgänge darstellen. Wenn Sie ein generisches Ereignis auswählen, müssen Sie auch den zu überwachenden Ereignisdatensatz definieren. Zum Beispiel Neuer Datensatz für Kalenderdatensatz erstellt.

   
   

   

   
   

2. Vordefiniert, die bestimmte Aktionen für bestimmte Objekte darstellen. Beispiel: Das Kalenderereignis wird erstellt.

   
   

   

   
   

Weitere Informationen zu Ereignissen finden Sie auf den Seiten der einzelnen Connectors.

Datenfilter

Wenn Sie ein Ereignis für Ihren Trigger definieren, können Sie eine spezifischere Filterung hinzufügen.

Mit Datenfiltern können Sie Trigger konfigurieren, die bestimmten Datenmustern entsprechen. Das bedeutet, dass Ihr Roboter weniger gestartet wird und Sie keine zusätzlichen Filter in Ihrer Automatisierung anwenden müssen.

Abrufintervall

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

Sie können dieses Intervall mit der Funktion Anpassbares Abrufintervall anpassen, mit der Sie das Intervall auswählen können, in dem Ereignistrigger nach neuen Objektereignissen suchen.

Wichtig: Sie können nur ein Abrufintervall pro Verbindung haben, obwohl Sie mehrere Trigger pro Verbindung einrichten können. Das Ändern des Abrufintervalls wirkt sich auf alle zugehörigen Trigger für eine 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.

Ändern des Abrufintervalls

Sie können das Abrufintervall entweder auf der Seite eines bestimmten Connectors oder auf der Registerkarte Verbindungen ändern.

1. Öffnen Sie die Automation Cloud^TM und öffnen Sie den Integration Service.
2. Gehen Sie zur Seite Connectors und wählen Sie einen Connector aus.
3. Wählen Sie auf der Seite des Connectors eine Verbindung aus, um die Seite mit den Verbindungsdetails zu öffnen.

4. Klicken Sie wie folgt auf das Intervall unter dem Verbindungsnamen. Das Abrufintervall wird nur für Verbindungen mit hinzugefügten Triggern angezeigt.

Alternativ können Sie Ihr Abrufintervall auf der Registerkarte Verbindungen konfigurieren:

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.
3. Klicken Sie auf das Intervall unter dem Verbindungsnamen.
4. Das Fenster Abrufintervall aktualisieren wird angezeigt.

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

   
   

   

   
   

   Die folgende Fehlermeldung warnt Sie, wenn Sie einen falschen Wert eingeben: „Das Abrufintervall muss eine natürliche Zahl von 1 bis 1440 Minuten oder 24 Stunden sein.“

6. Wählen Sie Aktualisierungsintervall aus.

Triggerausführungsverlauf

Sie können den Ausführungsverlauf eines Triggers anzeigen, indem Sie einfach auf der Registerkarte Trigger darauf klicken. Auf der neuen Seite wird der Verlauf der Versuche im unteren Teil der Benutzeroberfläche angezeigt.

Dieser Verlauf zeigt Ereignisse an, die vom Integration Service empfangen wurden und ob der Prozess erfolgreich gestartet wurde. In diesem Fall wird das Wort Erfolgreich in der Spalte „Status“ angezeigt.

Hinweis: Der Status Erfolgreich zeigt nur an, dass der Auftrag erfolgreich gestartet wurde. Es wird nicht angegeben, ob der Auftrag erfolgreich bis zum Ende ausgeführt wurde oder nicht.

Wichtig: Falls das Starten eines Auftrags fehlschlägt, 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, klicken Sie auf die Schaltfläche Auftragsprotokolle anzeigen . Sie werden zum Orchestrator weitergeleitet, wo alle erforderlichen Informationen zur Auftragsausführung angezeigt werden.

Löschen eines Triggers

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

Triggerdetails-Ansicht

Klicken Sie einfach auf einen Trigger, um seine Details anzuzeigen.

Aktivieren/Deaktivieren eines Triggers

Um einen Trigger zu aktivieren oder zu deaktivieren, müssen Sie zuerst darauf klicken, um seine Details anzuzeigen. Klicken Sie dann auf den Schalter oben links im Fenster.

Automatisches Deaktivieren eines Triggers bei Fehlern

Ein Trigger wird deaktiviert und in den Fehlerstatus versetzt, wenn Sie den Auftrag nach 11 Versuchen (~34 Stunden) für ein einzelnes Ereignis nicht starten können oder wenn der Auftrag für die letzten 100 Ereignisse nicht gestartet wird.

Die 10 Wiederholungen für jedes Ereignis erfolgen mit einer exponentiellen Backoff-Strategie. Jeder weitere Wiederholungsversuch erfolgt nach einer doppelt so langen Verzögerung wie der vorherige Versuch.

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, und die Schaltfläche Bearbeiten sollte nun angezeigt werden.

   Hinweis: 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. Klicken Sie auf die Schaltfläche Bearbeiten und wählen Sie einen neuen Namen für Ihren Trigger.

Einschränkungen

Derzeit stellen wir die Integration Service-APIs nicht über Swagger zur Verfügung.