JSON_GET_VALUE

Verwenden Sie die Script-Funktion JSON_GET_VALUE, um Daten aus einem JSON-Dokument mithilfe eines JSONPath-Ausdrucks abzufragen.

Syntax

JSON_GET_VALUE (JSON, JSONPath)

Parameter

• JSON

  Ein String, der ein gültiges JSON-Dokument enthält
  

• JSONPath

  Ein gültiger JSONPath-Ausdruck
  

Weitere Informationen:https://goessner.net/articles/JsonPath/

Wichtig!

• Stellen Sie sicher, dass Sie JSONPath Ausdrücke innerhalb eines Automation Engine-Scripts testen, bevor Sie sie in der Produktion verwenden.
• JSONPath-Ausdrücke, die in anderen Tools entwickelt wurden, funktionieren möglicherweise aufgrund eines fehlenden gemeinsamen JSONPath-Standards nicht.

Einschränkungen

JSON-Dokumente, die größer als 1 MB sind, werden nicht unterstützt.

Rückgabewert

Der zurückgegebene Wert ist immer ein String, es sei denn, der Ausdruck ist:

• Eine Zahl, dann wird eine Automic-Scriptnummer zurückgegeben
• Kein Wert, dann wird ein leerer String ("") zurückgegeben
• Ein Objekt oder ein Array von Werten, dann enthält der String eine serialisierte JSON-Darstellung dieses Objekts oder Arrays.

Laufzeitfehler

JSON_GET_VALUE schlägt mit einem Laufzeitfehler unter den folgenden Bedingungen fehl:

• 45334

  Wenn Ihr JSON-Dokument ungültig ist

• 45342

  Syntaxfehler im JSONPath-Ausdruck
  

Hinweis:

Der JSON_GET_VALUE kann nur einen JSON-Wert (String oder Zahl) angeben. Verwenden Sie JSON_TO_PROCESS, wenn der JSONPath-Ausdruck mehrere Werte zurückgibt und Sie sie einzeln verarbeiten möchten.

Beispiele:

In diesem Beispiel wird die Script-Funktion verwendet, um die E-Mail-Adresse aus dem JSON-Dokument zu extrahieren und sie in den Job-Report auszugeben:

:SET &JSON_DOC# = '{"name": "Mick", "lastName" : "Myers", "contact": {"email": "mick.myers@example.com","phone": "++43 1 999992999"}}'
:SET &JSON_VAL# =JSON_GET_VALUE(&JSON_DOC#,"$.contact.email")
:P &JSON_VAL#

Ergebnis des Aktivierungsreports

U00020408 mick.myers@example.com

In diesem Beispiel wird die Script-Funktion verwendet, um zu überprüfen, ob die JSON-Antwort einen Fehlerschlüssel enthält. Wenn dies der Fall ist, wird das Script mit einer Fehlermeldung beendet.

:SET &JSON_DOC# = '{"code":404, "error":"NOT FOUND"}'
:SET &RESPONSE_ERROR# =JSON_GET_VALUE(&JSON_DOC#,"$.error")
:IF&RESPONSE_ERROR#<> ''
:print 'es ist ein Fehler aufgetreten'
:EXIT10
:ENDIF

Ergebnis des Aktivierungsreports

2019-05-13 10:10:31 - U00020408 ein Fehler ist aufgetreten
2019-05-13 10:10:31 - U00020411 Der Befehl 'EXIT 0000000010' in 'SCRI.NEW.TEST', Zeile '00005' hat die Generierung dieser Aufgabe unterbrochen.

Siehe auch: