Mit diesem Kommando kann ein JSON-Array als Kind eines JSON-Objekts oder JSON-Arrays gelesen oder hinzugefügt werden. Alle Kommandos, die als Kinder von diesem Blockkommando verwendet werden, beziehen sich auf das Array.
Parameter:
- Schlüssel: Gibt den Schlüssel im Eltern-JSON-Objekt an, der ausgelesen werden soll und als JSON-Array interpretiert werden soll. (Parameter ist nur verfügbar, wenn das Eltern-JSON ein JSON-Objekt ist).
- Index: Gibt den Index in Eltern-JSON-Array an, an dem das JSON-Array gelesen bzw. angefügt werden soll. Wird der Index nicht gefüllt, dann wird das leere, neue Array am Ende des Eltern-Arrays hinzugefügt. (Dieser Parameter ist nicht verfügbar, wenn das Array in einer Schleife durchlaufen wird)
- Zielfeld Anzahl Einträge: Feld, in welches die Gesamtanzahl der Einträge des gelesenen JSON-Arrays geschrieben wird.
- Verhalten: Legt fest, wie sich das Kommando verhalten soll, wenn kein Eintrag am Schlüssel existiert:
- Element anlegen: (Standard) Ein Schlüssel wird angelegt, falls noch keiner exisitieErt
- Element überspringen: Es entsteht kein Fehler, es wird ein leeres Array verarbeitet, aber nicht in das Objekt geschrieben
- Fehler werfen: Ein Fehler wird geworfen
Ab der DLE-Version 2.1.2 verfügbar.
Beispiel:
Szenario 1: JSON-Objekt mit Unterarray aus primitiven Datentypen:
{
"array": ["wert1", "wert2", 3.14, true, null]
}
Szenario 2: JSON-Objekt mit Unterarray aus JSON-Objekten:
{
"array": [
{
"attribut": "wert1"
},
{
"attribut": "wert2"
}
]
}
