Aktion Webhook aufrufen

Mit der Aktion Webhook aufrufen legen Sie fest, dass als Folge des Ereignisses ein HTTP-Request an eine vorher definierte URL gesendet werden soll. CAS genesisWorld unterstützt POST-Requests über HTTP(S) mit einem Body im JSON-Format.

URL

Tragen Sie hier die Endpunkt-URL des Drittsystems ein, die aufgerufen werden soll. Aus Sicherheitsgründen ist das Verwenden von HTTPS empfehlenswert.

JSON

JSON muss folgende Bedingungen erfüllen:

• JSON muss den Standards RFC 8259 bzw. ECMA-404 entsprechen.
• Die Anforderungen des Drittsystems an die JSON-Struktur müssen erfüllt werden.

Im Eingabefeld für JSON lassen sich Platzhalter für Feldwerte aus den Registern Aktionsfeld und Tabellenfeld einfügen. Beim Ausführen von Regeln werden die Platzhalten durch entsprechende Feldwerte ersetzt.

Beachten Sie folgende Besonderheiten:

• Felder vom Datentyp datetime werden mit ISO 8601 formatiert. Beispiel: 2012-04-23T18:25:43.511Z
• Felder vom Datentyp bit werden als true bzw. false angezeigt.
• Felder vom Datentyp money werden von Fließkommazahlen nicht unterschieden. Beispiel: 55.5.
• Felder mit Null-Werten bleiben leer.
• Die Werte von Aktionsfeldern mit einem Link werden als reine Hyperlinks formatiert. Das endgültige Format des Hyperlinks sollte an die Struktur des jeweiligen Drittsystems angepasst werden. Das betrifft diese Aktionsfelder:
  • Link zu CAS genesisWorld Web
  • Link zu CAS genesisWorld SmartDesign Web
  • Link zu CAS teamWorks.

Bei der Vorschau werden die Platzhalter durch Testwerte ersetzt.

Mit der Schaltfläche Text ausrichten können Sie den JSON-Quelltext kompakt und übersichtlich formatieren.

Beim Anklicken der Schaltfläche Test wird die Syntax von JSON überprüft. Ist die Syntax korrekt, wird JSON mit den Testwerten an die eingetragene URL gesendet. Das Ergebnis des Tests wird im Feld Status angezeigt. Dabei bedeuten:

• -1: Syntaxfehler in JSON.
• HTTP-Statuscode zwischen 200 und 299: Der Test war erfolgreich.
• Andere HTTP-Statuscodes: Der Test war nicht erfolgreich.

Einschränkungen

Eine erfolgreiche Zustellung von Daten an ein Drittsystem über Webhooks kann nicht garantiert werden. Mögliche Gründe dafür können sein:

• Eine Regel kann auch dann gespeichert werden, wenn das Testen eines Webhooks nicht erfolgreich war.
• Im Drittsystem kann die Verfügbarkeit der Endpunkt-URL und das erwartete Format des JSONs geändert werden.
• Ein Internetzugang fehlt.