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).

Tooltip

Syntax: $get(host,dataFieldPath)

Parameter	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

Gibt den Wert zurück, welcher aus dem angegebenen Datenfeld gelesen wurde oder null, wenn das Datenfeld nicht existiert oder leer ist.

Beispiel: $get($el(4),id) - Liefert den Wert des Feldes "id" des Wertes von Element 4

Syntax

$get(host,dataFieldPath)

Parameter

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"