Webhook aufrufen

Diese Transformation ermöglich den Aufruf eines Webhooks. Der Einsatz kann für lesende oder schreibende Aktionen genutzt werden.

Basis ist eine Url, die für jeden Datensatz aufgerufen wird. Zusätzlich kann der Aufruf mit einem Header erweitert werden. Die Methode legt die HTTP-Methode des Aufrufes fest. Unter „Daten senden“ wird ein Json definiert, welches als Nachricht versendet wird. Diese Vorlage kann mit Platzhaltern aus dem aktuellen Datensatz gefüllt werden. Das Json sollte mit einfachen Hochkommas definiert werden, da diese automatisch in den Platzhaltern escaped werden. Bei der Verwendung von doppelten Anführungszeichen und doppelten Anführungszeichen im Datensatz kann es zu einem fehlerhaften Json kommen.

Die Ausführung kann Datensatz-spezifisch mit der Ausführungsbedingung übersprungen werden. Die logische Bedingung in SQL-Notation kann Platzhalter enthalten und wird für jedenDatensatz ausgewertet. Damit kann z.B. gesteuert werden, ob ein neuer Datensatz erzeugt werden muss.

Die Antwort des Webhooks wird in ein neues Feld gespeichert, dessen Name unter „Zielfeld für Antwort“ festgelegt wird. Sollte die Antwort ein Json-Objekt sein, kann der Inhalt mit der Transformation „Json in Spalten“ (Json in Spalten) ausgewertet werden.

Mit der Checkbox für das Zwischenspeichern kann festgelegt werden, ob Aufrufe mit identischem Inhalt wiederverwendet werden können. Das kann bei lesenden Webhooks mit identischem Resulat die Ausführungszeit verkürzen.

Einstellungen

Folgende Parameter werden konfiguriert.

Name

Ist eine administrative Bezeichnung.

Url

Url des Webhooks. Enthaltene Platzhalter werden ersetzt.

Optionaler Header

Name des zusätzlichen Headers.

Wert für Header

Wert des zusätzlichen Headers.

Methode

HTTP-Methode des Aufrufs.

Daten senden

Vorlage für den Versand der Json-Nachricht. Inhalte des Datensatzes werden mit Platzhaltern übernommen.

Ausführungsbedingung

Logische Bedingung in SQL-Notation. Inhalte des Datensatzes werden mit Platzhaltern übernommen. Ein negatives Resultat überspringt den aktuellen Datensatz.

Zielfeld für Antwort

Feldname für die Ablage der Antwort des Aufrufs. Das Feld wird ggf. neu hinzugefügt.

Zwischenspeichern gleicher Anfragen

Bei identischem Nachrichteninhalt werden Aufrufe nicht erneut ausgeführt, sondern die zwischengespeicherte Antwort verwendet.