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, 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
  • UiPathEventObjectId Hinweis: Weitere Informationen zur Funktionsweise und Verwaltung von Argumenten finden Sie hier.

• To retrieve and work with a record that has a trigger on a job run, use the UiPathEventObjectId input argument to retrieve the record from the source system.

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. Das Integration Service Fenster enthält drei separate Registerkarten: Connectors, Verbindungen und Trigger.
3. Greifen Sie auf die Registerkarte Trigger zu und wählen Sie die Taste Trigger hinzufügen .
4. Wählen Sie den gewünschten Connector und die gewünschte Verbindung in den jeweiligen Dropdown-Menüs aus. Wenn nur eine Verbindung für diesen bestimmten Connector konfiguriert ist, wird sie automatisch ausgewählt.
5. Wählen Sie das gewünschte Ereignis und den gewünschten Datensatz in 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 zur Ausführung der Aufträge, die vom Trigger gestartet werden) aus der Dropdownliste aus. Die Liste der angezeigten Runtimes basiert auf der Antwort, die vom Orchestrator empfangen wurde, d. h. den „zugewiesenen“ Runtime-Lizenzen zu diesem Ordner. Für die ausgewählte Runtime gibt eine Meldung die Anzahl der zugewiesenen Runtimes an. Weitere Informationen finden Sie unter Verwalten von Triggern in der Dokumentation zum Orchestrator und 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. Folgendes ist dafür notwendig:

1. Wählen Sie die Schaltfläche Weitere Aktionen einer Verbindung aus.
2. Select the Add trigger option.
3. Select the desired Event and Record Type from their respective dropdown menus. In this case, the Connector and Connection are already selected and cannot be changed.
4. On the right, select the Process to execute and the respective Runtime license.
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 darauf eingestellt, alle fünf Minuten abzufragen. 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 anzeigen. 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. Zum Beispiel Datensatz erstellt für den Kalenderdatensatz .
2. Vordefiniert, die bestimmte Aktionen für bestimmte Objekte darstellen. Zum Beispiel: Calendar event 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.

With Data filters, you can configure triggers that match specific data patterns. This means fewer launches of your robot and not having to apply additional filtering within your automation.

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.

Im Feld Anpassbares Abrufintervall können Sie das Intervall anpassen, in dem Ereignistrigger nach neuen Objektereignissen suchen.

Wichtig:

You can have only one polling interval per connection, even though you can have several triggers set up per connection. Changing the polling interval affects all the associated triggers on a connection.

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 Ihr Abrufintervall entweder auf der Seite eines bestimmten Connectors oder auf der Registerkarte Verbindungen ändern.

1. Greifen Sie in Automation Cloud^TM auf Integration Service zu

2. Go to the Connectors page and select a connector.

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.

   

Alternatively, you can configure your polling interval from the Connections tab:

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. The Update polling interval window is displayed.

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 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, die vom Integration Service empfangen wurden, und ob der Prozess erfolgreich gestartet wurde. In diesem Fall wird in der Spalte Status das Wort Successful angezeigt.

Hinweis:

The Successful state only indicates that the job was successfully launched. It does not reflect whether the job was successfully executed to the end or not.

Wichtig:

In case a job fails to start, its State will appear as Failed. Hover with the mouse cursor over the Failed state to view the error message.

Um zu überprüfen, ob ein Auftrag erfolgreich ausgeführt wurde, wählen Sie die Taste 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 . Wählen Sie die Schaltfläche Weitere Aktionen aus, die Ihrem Trigger entspricht, und wählen Sie Löschen.

Umbenennen eines Triggers

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

1. Access the Triggers tab.
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 zur Fehlerbehebung dieses Handbuchs dokumentiert. Siehe Trigger-Einschränkungen.