Erstellen eines Triggers

Sie können einen Trigger als Teil eines benutzerdefinierten Connectors erstellen. Sie können benutzerdefinierte Connector-Trigger verwenden, um Automatisierungen oder Prozesse basierend auf Anbieterereignissen automatisch zu starten.

Wie es funktioniert

Connector-Generator-Trigger verwenden Ressourcenabrufe, um Anbieteränderungen zu erkennen. Beim Ressourcenabruf wird eine API-Ressource in einem regelmäßigen Intervall aufgerufen, um zu erkennen, wann neue Ereignisse zurückgegeben werden.

Sobald ein benutzerdefinierter Connector veröffentlicht und der Trigger in einer veröffentlichten Automatisierung verwendet wird, wird die definierte URL als Abrufressource verwendet, um Ereignisse zurückzusetzen und einen Automatisierungsflow zu starten.

Neue Ereignisse werden erkannt

Die Abruf-URL des Triggers muss Abfrageparameter enthalten, um die Ergebnisse des Anbieters zu filtern.

Der Abruf erfolgt in einem geplanten Intervall (alle 5, 10, 15 Minuten usw.). Daher muss einer der Abfrageparameter des Anbieters ein Datum zum Filtern der Ergebnisse sein. Auf diese Weise kann das Abruf-Modul den Abfrageparameterwert so auffüllen, dass nur Ereignisse enthalten sind, die seit dem letzten Abrufzeitpunkt aufgetreten sind.

Einschränkungen

• Sie können einen Trigger pro Ressource erstellen. Wenn mehr als ein Anwendungsfall erforderlich ist, verwenden Sie eine allgemeinere Abruf-URL und richten Sie Antwortfilterfelder ein, die für mehrere Anwendungsfälle geeignet sind.

• Anbieter-APIs müssen eine datumsbasierte Filterung von Abfrageparametern zulassen. Wenn vom Anbieter keine datumsbasierten Abfrageparameter verfügbar sind, sollte er nicht als Trigger verwendet werden.

Voraussetzungen

Anforderungen an die Anbieter

Die API des Anbieters muss eine Ressource mit einem GET -Endpunkt anbieten, der eine Liste von Objekten zurückgibt. Darüber hinaus muss der Endpunkt es Ihnen ermöglichen, die Ressource basierend auf einem Datumsparameter abzufragen.

Beispiel für eine gültige Ressource

Pipedrive bietet einen Get all activities -Endpunkt, der eine Sammlung von Aktivitäten zurückgibt. Dieser Endpunkt enthält einen since -Abfrageparameter, der die Ergebnisse nach allen Aktivitäten filtert, deren update_time -Datum größer als das since -Datum ist, das als Wert für den Abfrageparameter angegeben ist. Sie können den Parameter since als Teil der Abruf-URL verwenden, um Aktualisierungen von Pipedrive-Aktivitäten zu erkennen. Die UiPath-Abruf-Engine füllt dieses Datumsfeld automatisch aus, um Ereignisse zu erfassen.

Connector-Anforderungen

Connector-Generator-Trigger verwenden Ressourcen, die bereits auf dem Connector als Abruf-URL verfügbar sind. Beim Erstellen eines neuen Triggers muss auf der Connector-Seite eine vorhandene Ressource vorhanden sein, damit der Trigger zugeordnet werden kann.

Trigger verwenden die Konfiguration der Ressource, daher ist es wichtig, dass die vorhandene Ressource bereits über Folgendes verfügt:

• Abfrageparameter: Trigger können vorhandene Abfrageparameter importieren, daher sollten für die Ressource bereits einige Parameter konfiguriert sein, bevor der Trigger erstellt wird.

• Antwortfelder: Trigger geben das Antwortobjekt der zugeordneten Ressource aus und ermöglichen die Aktivitätskonfiguration basierend auf diesen Feldern. Es ist erforderlich, die Antwortfelder für die Ressource zu generieren, indem der Endpunkt erfolgreich aufgerufen wird.

Erstellen eines benutzerdefinierten Triggers

Um einen Trigger im Connector Builder zu erstellen, führen Sie die folgenden Schritte aus:

Einen Trigger hinzufügen

1. Stellen Sie zunächst sicher, dass Sie die Voraussetzungen erfüllen.
2. Öffnen Sie im Integration Service Connector Builder und wählen Sie dann Ihren benutzerdefinierten Connector aus.
3. Wählen Sie Weitere Optionen aus -Menü neben Triggern.
4. Wählen Sie Trigger hinzufügen aus.

Legen Sie den Namen und die Ressource fest

Das Popup-Fenster „Ereignis erstellen “ wird angezeigt. Hier können Sie auswählen, welchen Ereignistyp erstellt werden soll. Derzeit ist Abruf die einzige verfügbare Option.

1. Wählen Sie den Ereignistyp aus.
2. Fügen Sie einen Namen für Ihren Trigger hinzu.
3. Wählen Sie die Ressource aus, die zum Erkennen dieser Ereignisse verwendet wird.
4. Wählen Sie Erstellen aus, um mit der Konfiguration Ihres Triggers zu beginnen.

Konfigurieren Sie den Trigger

Das Erstellen eines Triggers besteht aus drei Schritten:

1. Konfigurieren Sie eine Anforderung.
2. Konfigurieren Sie die Antwort.
3. Konfigurieren Sie Trigger-Filter.

Diese Schritte entsprechen dem Abfragen einer Ressourcen-URL und dem Arbeiten mit der Antwort.

Tipp: Verwenden Sie die Funktion Test-Trigger während des gesamten Trigger-Konfigurationsprozesses, um sicherzustellen, dass sie wie erwartet funktioniert.

Konfigurieren Sie eine Anforderung

Zunächst konfigurieren Sie, wie die Abruf-URL eingerichtet ist und wie der Trigger in Studio angezeigt wird, wenn er in einer Automatisierung verwendet wird.

Das Vorschaulayout stellt dar, wie der Trigger in Studio angezeigt wird. Sie können die Parameter und Antwortfelder konfigurieren, um zu ändern, welche Felder Sie in Studio sehen und verwenden, wenn Sie den Trigger für eine Automatisierung einrichten.

Abruf-URL

Die Abruf-URL wird oben auf der Konfigurationsseite angezeigt. Diese URL wird verwendet, um Anforderungen an den Anbieter zu stellen, um neue Ereignisse zu erkennen.

Diese URL muss so konfiguriert werden, dass sie nach Ereignissen von Interesse gefiltert wird. Die Abruf-URL verwendet einen Datumsparameter, um nach neuen Ereignissen seit der letzten Abrufanforderung zu filtern. Es ist obligatorisch, einen Datumsparameter einzuschließen, den die Abfrage-Engine ausfüllen kann.

Parameter importieren

Trigger können Ressourcenparameter importieren, die in der Abruf-URL verwendet werden sollen.

Wenn ein Parameter in der Ressource nicht verfügbar ist, navigieren Sie zur Ressource, fügen Sie ihn hinzu und kehren Sie dann zum Fenster der Triggerkonfiguration zurück, um ihn zu importieren.

1. Wählen Sie Parameter importieren aus, um die Liste der verfügbaren Parameter für eine bestimmte Ressource anzuzeigen.
2. Wählen Sie den Parameter aus, den Sie in der Abruf-URL verwenden möchten.
3. Sobald ein Parameter hinzugefügt wurde, ist er in der URL-Vorschau oben auf der Seite enthalten.

Sie können importierte Parameter als Erforderlich markieren, damit sie auf der Trigger-Canvas angezeigt werden. Das bedeutet, dass Sie einen Wert für den Abfrageparameter eingeben müssen, wenn Sie den Trigger in einer Automatisierung verwenden.

Wichtig: Für die Abruf-URL ist mindestens ein datumsbasierter Abfrageparameter erforderlich. Ein datumsbasierter Abfrageparameter ist ein beliebiger Parameter mit dem Format DateTime . DateTime -Formate können für einen Parameter mit einem String - oder Integer -Anbieterdatentyp gefunden werden.

Wenn kein bestimmter Datumswert angegeben ist, werden datumsbasierte Abfrageparameter automatisch mit einem Wert aufgefüllt, der dem Datum und der Uhrzeit der vorherigen Abrufanforderung entspricht.

Trigger testen

Verwenden Sie die Option Trigger testen , um sicherzustellen, dass die erwarteten Ergebnisse zurückgegeben werden.

Wenn Sie Trigger testen auswählen, wird das Fenster Anforderung testen angezeigt, das Folgendes anzeigt:

• Lookback-Zeitraum: Dieses Feld definiert, welches Datum in die datumsbasierten Abfrageparameter eingefügt werden soll, und repliziert das Verhalten unseres Abrufmoduls, das diesen Wert basierend auf dem Datum der letzten Abrufanforderung automatisch ausfüllt.
• Die Abfrageparameter, die als erforderlich angegeben wurden.

Wählen Sie Anforderung testen aus, um das Panel Ereignis-Debug zu öffnen und die Anforderungsablaufverfolgung mit einer Schritt-für-Schritt-Aufschlüsselung des Anforderungsprozesses anzuzeigen. Die Anzahl der zurückgegebenen Ergebnisse wird ebenfalls angezeigt.

Hinweis: Stellen Sie sicher, dass die Anzahl der zurückgegebenen Ergebnisse die Anzahl der erwarteten Ergebnisse ist. Die falsche Verwendung von Abfrageparametern kann zu einer großen Anzahl von Ausgabeobjekten und unnötiger Roboternutzung führen, nachdem der Connector veröffentlicht und der Trigger in einem Workflow verwendet wurde.

Es wird empfohlen, Antworterwartungen (Anzahl von Ereignissen, Ereignistypen usw.) beim Testen eines Triggers zu verwenden, um zu überprüfen, ob die Abfrageparameterfilter wie erwartet funktionieren.

Konfigurieren Sie die Antwort

Bei diesem Schritt geben Sie an, welches Antwortfeld dem Primärschlüssel oder der Trigger-Ausgabe entspricht.

1. Verwenden Sie die Dropdownliste unter Primärschlüssel , um ein Feld auszuwählen.
2. Das ausgewählte Feld wird der Triggervorschau unter Ausgabe hinzugefügt. Sie können diese Ausgabe in späteren Schritten Ihres Workflows verwenden.

Der Schritt Antwort konfigurieren bietet auch eine Ansicht des Antwortobjekts, das der Abrufressource zur Überprüfung zugeordnet ist.

Konfigurieren Sie Trigger-Filter

Sobald Sie die Anforderung und Antwort konfiguriert haben, können Sie den Trigger mithilfe von Filtern weiter konfigurieren.

Sie konfigurieren die Ereignisfilterung, indem Sie bestimmte Werte für Antwortfelder festlegen. Diese Werte werden während der Automatisierungseinrichtung (in Studio) angegeben. Mit dem Trigger-Designer können Sie jedoch auch konfigurieren, welche Felder zum Filtern angezeigt werden.

Hydration

Wenn die Ressource, die als Abruf-URL verwendet wird, nicht das gesamte Objekt zurückgibt, das für die Triggerausgabe erforderlich ist, ist es möglich, die Antwort mithilfe eines GETBYID -Endpunkts zu hydratisieren. Dieser Prozess wird als Hydratisierung bezeichnet.

Wählen Sie die Registerkarte Hydratisierung aus, aktivieren Sie die Schaltfläche Hydratisierung verwenden, und geben Sie den Endpunkt an, der für die Hydratisierung verwendet werden soll, sowie die ID, die für die Abfrage des Objekts verwendet wird.

Hinweis: Die Liste der möglichen Hydratisierungsressourcen wird aus der Liste „Datensätze abrufen“ im Navigationsbereich auf der linken Seite abgerufen. Konfigurieren Sie die GETBYID -Ressource, bevor Sie sie als Hydrationsressource für einen Trigger verwenden.

Bei der Verwendung von Hydratisierung werden die Antwortfelder aus den Abrufantwort-Ressourcenfeldern durch die hydratisierten Ressourcenantwortfelder ersetzt. Dann werden die Hydratisierungsantwortfelder die einzigen Felder, die für Triggerparameter und Filterkonfiguration verfügbar sind.

Filter

Der Triggerkonfigurationsprozess bietet drei Optionen zum Anzeigen von Feldern, die zum Filtern verwendet werden. Diese Felder werden aus den Ressourcenantwortfeldern der Abrufressource oder der Hydrierungsressource abgerufen. Diese Optionen sind in der Spalte Anzeigen als der Tabelle Filterparameter verfügbar:

• Ausgeblendet: Das Feld ist auf der Arbeitsfläche ausgeblendet und im Filter -Generator nicht verfügbar. Wenn alle Felder als ausgeblendet markiert sind, wird auch der Filtergenerator ausgeblendet.

• Optional: Zur Entwurfszeit wird das Feld als Option im Filtergenerator angezeigt.

• Erforderlich: Zur Entwurfszeit wird das Feld direkt auf der Trigger-Canvas angezeigt und erfordert eine Benutzereingabe. Nur Ereignisse mit einem Antwortfeldwert, der mit dem angegebenen Wert übereinstimmt, führen zu einem Automatisierungsereignis.

Speichern Sie den Trigger

Nachdem Sie mit dem Konfigurieren des Filters fertig sind, wählen Sie die Schaltfläche Speichern aus. Nach dem Speichern wird der Trigger als Ereignis aufgenommen, wenn der Connector veröffentlicht wird.

Verwenden des Triggers

Sobald ein Trigger gespeichert wurde und sich nicht mehr im Entwurfsmodus befindet, kann der Trigger verwendet werden, sobald Sie Ihren benutzerdefinierten Connector veröffentlichen.