Poller

Der Poller-Auslöser überprüft regelmäßig die Datenquelle auf Aktualisierungen. Nachdem Sie ihn konfiguriert haben, überprüft Poller regelmäßig anhand der Polling-URL einer Datenquelle, ob neue Daten vorhanden sind. Der Poller eignet sich ideal für Anwendungsfälle, in denen Echtzeitaktualisierungen nicht verfügbar sind oder die Aktualisierungshäufigkeit gering ist.

Übersicht

Der Poller arbeitet nach dem Prinzip des Pollings, wobei der Auslöser regelmäßig Anforderungen an die Polling-URL sendet, um neue Daten abzurufen. Sie können den Poller so konfigurieren, dass er die eingehenden Ereignisbenachrichtigungen empfängt und die anschließende Automatisierung basierend auf der Benachrichtigung startet. Die Poller-URL der Anwendung dient als Endpunkt, den der Auslöser auf neue Ereignisse abfragt.

Sie können den Poller für einen GET-Aufruf oder POST-Aufruf konfigurieren. Sie müssen den Header-Parameter, den Query-Parameter, die Kontextverwaltungsdetails und den JSON-Filter hinzufügen, wenn Sie den Poller konfigurieren. Die POST-Option enthält eine Bestimmung zum Hinzufügen eines Anforderungsinhalts. Sie können diese Option verwenden, um Daten an die Poller-URL zu senden, die zusätzliche Daten für die Ereignisse benötigt.

Einstellungen

Die folgenden Einstellungen sind im Listener-Auslöser verfügbar:

Einstellungsbereich von Poller

Name
Geben Sie einen Namen für den Poller an
Polling-URL
Geben Sie die Polling-URL der Anwendung an.
Anforderungstyp
Wählen Sie den API-Anforderungstyp aus. Poller unterstützt die Methoden GET und POST.
  • GET - Sie können die Methode GET verwenden, um die Ereignisdetails abzurufen.
  • POST – Sie können die POST-Methode verwenden, um die Antwortdaten zu begrenzen. Die POST-Methode bietet die Möglichkeit, einen Anforderungsinhalt hinzuzufügen. Diese Option dient als Filter, um die Antwortdaten einzuschränken.
Anforderungstext
Geben Sie den Anforderungstext für die POST-Methode ein. Sie können den Anforderungsinhalt in Formaten wie TXT, JSON, XML und HTML hinzufügen.
Polling-Intervall
Legen Sie die Häufigkeit fest, mit der die URL nach neuen Informationen abgefragt wird. Sie können das Intervall in Minuten, Stunde oder Tag festlegen. Das Mindestlimit für das Intervall beträgt 5 Minuten.
Authentifizierungsmodus
Geben Sie den Authentifizierungsmodus für den Auslöser an. Sie können entweder Keine Authentifizierung oder OAuth2 – von Control Room verwaltet auswählen.
Verbindung
Verwenden Sie die Auswählen-Schaltfläche, um eine vorhandene OAuth-Verbindung als Authentifizierungsmodus auszuwählen. Vergewissern Sie sich, dass die Verbindung eingerichtet und aktiv ist.
Header hinzufügen
Geben Sie die Header-Parameter an, die für die Polling-Anfrage relevant sind. Sie können Authentifizierungs-Header und andere eindeutige Parameter hinzufügen, die im Anfrage-Header enthalten sein müssen.
Aktivieren Sie das Kontrollkästchen Header hinzufügen und klicken Sie auf Header hinzufügen, um das Element-Modal zu öffnen. Geben Sie den Namen des Header-Parameters und die Werte im Element-Modal an.
Abfrageparameter hinzufügen
Geben Sie die Abfrageparameter an, die für die Polling-Anfrage relevant sind. Aktivieren Sie das Kontrollkästchen und klicken Sie auf Header hinzufügen, um das Element-Modal zu öffnen.
Aktivieren Sie das Kontrollkästchen Abfrageparameter hinzufügen und klicken Sie auf Abfrage hinzufügen, um das Element-Modal zu öffnen. Geben Sie den Namen und die Werte des Query-Parameters im Element-Modal an.
Kontextverwaltung
Definieren Sie das Kontextmanagement für alle dynamischen Parameter. Der Auslöser verwendet den Kontext als Abfrage-Checkpoint, um sicherzustellen, dass er die nach dem letzten Checkpoint aktualisierten Informationen abruft. Sie können das Kontextmanagement für Polling-URLs, Header- und Abfrageparameter definieren. Definieren Sie den Parameter als Zeichenfolge und verwenden Sie diese Zeichenfolge, um den Kontext zu definieren.
Zum Beispiel verwendet die Gmail-API zum Abfragen die Verlauf-ID einer E-Mail, um die Änderungen im Postfach zu bestimmen. Wenn Sie einen Poller-Auslöser für den Gmail-Posteingang konfigurieren, können Sie die History-ID entweder in der Polling-URL als https://gmail.googleapis.com/gmail/v1/users/me/history?startHistoryId={{historyID}} definieren oder einen Abfrageparameter mit dem Schlüssel startHistoryId und dem Wert historyID hinzufügen. Sie können dann den Kontext für die History-ID mit der History-ID der letzten E-Mail konfigurieren, die der Posteingang als Prüfpunkt für die Abfrage erhalten hat. Sie müssen außerdem den JSON-Knoten hinzufügen, in dem die History-ID im Antwort-Payload im Feld Kontext aktualisieren erfasst wird. Dies stellt sicher, dass der Auslöser die ID der zuletzt empfangenen E-Mail als Start-History-ID auswählt, jedes Mal wenn der Auslöser ausgeführt wird.
Aktivieren Sie das Kontrollkästchen Kontextverwaltung und klicken Sie auf Kontext hinzufügen, um das Element-Modal zu öffnen. Geben Sie den Kontextschlüssel und die Werte im Element-Modal an. Sie können eine der folgenden Optionen als Bedingung für die Aktualisierung des Kontexts auswählen:
  • JSON-Ausdruck: Wählen Sie diese Option, um einen JSON-Knoten der Antwortnutzlast als Kontext festzulegen.
  • Aktueller Zeitstempel (Unix): Wählen Sie diese Option, um den Unix-Epoch-Zeitstempel des Abfrageparameters als Kontext festzulegen.
  • Aktueller Zeitstempel (ISO 8601): Wählen Sie diese Option, um den ISO 8601-Zeitstempel des Abfrageparameters als Kontext festzulegen.
Json-Filter
Geben Sie einen Filter für Antwortdaten an. Mit dieser Einstellung können Sie die Daten nach Ihren Anforderungen filtern. Zum Beispiel, wenn die JSON-Daten Datensätze mit mehreren Längen wie 1, 5, 10, 25 und 30 enthalten, können Sie den JSON-Filter wie folgt definieren: record.length>10 , dieser Filter verwirft die Datensätze mit einer Länge von weniger als 10.
reaktion
Wählen Sie eine Datensatzvariable aus, um die Auslöser-Antwortdaten zu speichern. Die Automatisierung speichert die Auslöser-Antwortdaten im Schlüssel-Wert-Paar-Format. Nachdem Sie den Bot ausgeführt haben, wechseln Sie zur Seite Auditprotokoll und wählen Sie das Ereignis Bot vom Auslöser ausgeführt aus, um die Antwortdaten anzuzeigen.