http json-lookup(a,b,c,d,e,f,g,h,i,j)

Gruppe

Basic Functions


Mit dieser Funktion kann man eine JSON-Datei per HTTP auslesen. Dabei kann man entweder die komplette Datei als JSON-Objekt einlesen, welches man dann später abfragen kann. Alternativ kann man direkt mit einem XPath-Ausdruck einen Wert auslesen (siehe Funktion execute json xpath(key a, expression b, array as text c, ignore exception d) für ein Beispiel).

Parameterbeschreibung


Parameter

Beschreibung

a

Die URL, über die die JSON-Datei abgefragt werden soll.

b

(optional) Fall true, dann erfolgt die HTTP-Abfrage über den DMZ-Server (falls dieser existiert). Default: false.

c

Schlüsselname des zu erzeugenden JSON-Objekts im Cache.

d

Der XPath-Abfrage-Ausdruck. Siehe https://github.com/json-path/JsonPath.

e

(optional) Die zu verwendende HTTP-Methode. Erlaubte Werte: PUT, POST, PATCH, HEAD, DELETE, GET. Default: GET.

f

Wenn hier die ID eines HTTP(S)-Kanals angegeben wird, dann erfolgt die HTTP-Abfrage über die dort angegebenen Verbindungsparameter. Das kann z. B. nötig sein, wenn eine Authentifizierung erforderlich ist. Hinweis: Sie können über den Button mit den drei Punkten einen Kanal auswählen und bekommen dann direkt die ID geliefert.

g

Will man weitere HTTP-Header in der HTTP-Anfrage verwenden (oder vorhandene überschreiben), kann hier der Name einer Map angegeben werden. Der Schlüssel eines Eintrags in der Map muss der Name des HTTP-Headers sein und der Wert des Eintrags ist dann der Wert für diesen HTTP-Header.

h

Wenn Sie den HTTP-Request per POST schicken (siehe Parameter e), können Sie hier die Nutzlast (Payload) eintragen. Hinweis: Siehe auch Abschnitt Methode GET/Methode POST.

i

(optional) Falls true, dann wird eine aufgetretene Exception ignoriert und ein leerer String zurückgegeben. Default: <leer> (== false).

j

(optional) Die Zeichenkodierung. Default: UTF-8.