Abschlusskriterien angeben
Geben Sie die Bedingung an, die die Kriterien für einen erfolgreichen Abschluss der REST-Ausführung festlegt.
Eine Erfolgsbedingung ist erforderlich, um einen REST-Aufruf abzuschließen, unabhängig davon, ob die API einen Vorgang mit kurzer oder langer Ausführungszeit aufruft.
Informationen zum Definieren des Abschlusses des REST-Aufrufs für einen Vorgang mit langer Ausführungszeit über Polling finden Sie unter Abschlusskriterien durch Polling angeben.
Einfache Zeichenfolgen- und Operatorfunktionen werden in Erfolgs- und Polling-Bedingungen unterstützt.
Der Ausdruck für eine Erfolgs- oder Polling-Bedingung kann nur die Funktionen enthalten, die im folgenden Abschnitt dargestellt sind. Um Werte aus JSON-Strukturen zu extrahieren, verwenden Sie die Funktion json_path
.
Einfache arithmetische Funktionen |
|
Einfache boolesche Funktionen |
|
Einfache Vergleichsfunktionen |
|
Einfache Nullfunktionen |
|
Einfache Zeichenfolgenfunktionen |
|
Einfache Datums-/Uhrzeitfunktionen |
|
json_path -Funktion |
Informationen zu JSONPath-Syntaxelementen finden Sie unter:
Beispiel: Um den aktuellen Statuswert aus der folgenden Antwort abzurufen, verwenden Sie die Syntax:
|
Die Erfolgsbedingung in einer REST-Aufgabe ist ein Ausdruck, der den erfolgreichen Abschluss des REST-API-Aufrufs bestimmt. Polling wird gestoppt, wenn die Erfolgsbedingung erfüllt ist.
Standardmäßig stellt Data Integration eine Erfolgsbedingung für eine REST-Aufgabe bereit. Die Standarderfolgsbedingung ist ein HTTP-Statuscode von 200 oder höher, aber kleiner als 300, der als der folgende Ausdruck geschrieben wird:
SYS.RESPONSE_STATUS >= 200 AND SYS.RESPONSE_STATUS < 300
Der Ausdruck für die Erfolgsbedingung referenziert die Ausgabe in der JSON-Antwort, die von der im Ausführungsschritt definierten REST-Anforderung empfangen wird.
Sie können die Standarderfolgsbedingung verwenden oder einen Bedingungsausdruck mit Systemausgaben oder extrahierten JSON-Eigenschaftenwerten aus der Antwort schreiben.
So bearbeiten Sie die Erfolgsbedingung:
Sie können der Erfolgsbedingung in einer REST-Aufgabe einen Aufgabenparameter zuweisen.
Mit der folgenden Prozedur können Sie auch eine Polling-Bedingung parametrisieren.
So parametrisieren Sie eine Bedingung:
Sie können die Beschreibung und den Standardwert des Aufgabenparameters für die Erfolgsbedingung ändern.
Mit der folgenden Prozedur können Sie auch den Parameter für die Polling-Bedingung bearbeiten.
So bearbeiten Sie die parametrisierte Bedingung:
Wenn Sie den Bedingungsparameter entfernen, wird nur die Verknüpfung des Parameters mit der für die REST-Aufgabe angegebenen Erfolgsbedingung entfernt.
Mit der folgenden Prozedur können Sie auch den Parameter für die Polling-Bedingung entfernen.
So heben Sie die Zuweisung des Parameters zur Bedingung auf: