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 das moderne Benutzeridentitätsparadigma nicht und können daher keine Verbindungen im Allgemeinen oder Trigger unterstützen.

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, führen Sie die folgenden Schritte aus:

• 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 im Orchestrator, wie Sie es normalerweise machen. Sie können sie in einem freigegebenen Ordner oder in 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. Wählen Sie im Menü auf der linken Seite Integration Service aus. Das Fenster Integration Service enthält drei separate Registerkarten: Connectors, Verbindungen und Trigger.
3. Greifen Sie auf die Registerkarte Trigger zu und wählen Sie die Schaltfläche Trigger hinzufügen aus .
4. Wählen Sie den gewünschten Connector und die gewünschte Verbindung aus dem jeweiligen Dropdownmenü aus. Wenn für diesen bestimmten Connector nur eine Verbindung konfiguriert ist, wird sie 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 als Nächstes den auszuführenden Prozess aus.

7. Wählen Sie die Runtime-Lizenz (die Runtime, die zum Ausführen der vom Trigger gestarteten Aufträge verwendet wird) aus der Dropdownliste aus.

   Die Liste der angezeigten Runtimes basiert auf der Antwort, die vom Orchestrator empfangen wurde, d. h. die diesem Ordner „zugewiesenen“ Runtime-Lizenzen. Für die ausgewählte Laufzeitumgebung gibt eine Meldung die Anzahl der zugewiesenen Laufzeitumgebungen an. Weitere Informationen finden Sie unter Verwalten von Triggern im Orchestrator und in der Dokumentation zu Runtimes (Roboterlizenzen) .
8. Wählen Sie die Schaltfläche Trigger hinzufügen aus, 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. Wählen Sie die Schaltfläche Weitere Aktionen einer Verbindung aus.
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. Wählen Sie die Schaltfläche Trigger hinzufügen aus, um Ihren Trigger zu erstellen und zu aktivieren.

Hinweis:

Die Ereignisüberwachung ist derzeit auf Abfragen alle fünf Minuten eingestellt. Daher kann es bis zu fünf 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 durch 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 Vorgänge zum Erstellen, Aktualisieren und Löschen darstellen. Wenn Sie ein generisches Ereignis auswählen, müssen Sie auch den zu überwachenden Ereignisdatensatz definieren. Beispiel: Datensatz erstellt für den Kalenderdatensatz .

2. Vordefiniert, die bestimmte Aktionen für bestimmte Objekte darstellen. Beispiel: Kalenderereignis 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

Connectors unterstützen Ereignisse durch einen Abrufmechanismus.

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

Mit dem Feld Variable Abrufintervall können Sie das Intervall anpassen, 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. Wählen Sie das Intervall, das unter dem Verbindungsnamen zu finden ist, wie folgt aus. 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. Wählen Sie das Intervall aus, das unter dem Verbindungsnamen zu finden ist.
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 ihn einfach auf der Registerkarte Trigger auswählen. 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, wählen Sie die Schaltfläche Auftragsprotokolle anzeigen aus. 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 . Wählen Sie die Schaltfläche Weitere Aktionen aus, die Ihrem Trigger entspricht, und wählen Sie Löschen aus.

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

Triggerdetails-Ansicht

Wählen Sie einen Trigger aus, um seine Details anzuzeigen.

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.

Einschränkungen

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