get (Wert aus Datenfeld lesen)

Die $get Funktion wird zum Auslesen eines Datenfeldwertes von einem bestimmten Objekt verwendet. Dabei kann das Datenfeld als Datenfeldpfad angegeben werden (siehe Parameterliste).

Syntax

$get(host,dataFieldPath)

Parameter

Name

Beschreibung

host

Das Objekt von dem ausgehend der Datenfeldpfad ausgewertet werden soll

dataFieldPath

Der Pfad zu einem Datenfeld.
Wie immer gilt hier, dass Pfadteile von Punkten getrennt werden. z.B. "datenFeldLevel1.datenFeldLevel2".
Auf Listeneinträge kann über den Index (beginnend bei 0) als Datenfeld zugegriffen werden.
z.B. "datenFeldDerListe.3" → greift auf das vierte Element einer Liste zu

Rückgabewert

Der Wert, welcher aus dem angegebenen Datenfeld gelesen wurde oder null, wenn das Datenfeld nicht existiert oder leer ist.

Beispiel

Gegeben sei folgendes Objekt, welches an die Berechnungsfunktion übergeben wird:

Beispiel host Objekt im JSON-Format
{
"person": {
"name": "Robert Weber",
"age": "32",
"tasks": [
"IT Leiter",
"3rd Level Support",
"Software Customizing"
]
}
}

Das oben gezeigte Objekt wird als Eingabeobjekt ($input) an den Berechnungsausdruck übergeben. Als Ergebnis des Ausdrucks soll sowohl der Name der Person als auch deren primäre Aufgabe (erstes Element von tasks) ausgegeben werden.

$get($input,person.name) - $get($input,person.tasks.0)

Ergebnis des Beispiels für das oben gezeigte Objekt: "Robert Weber - IT Leiter"