Mit diesem Kommando kann im aktuellen JSON-Objekt ein Attribut/Schlüssel gesetzt werden. Existiert dieser Schlüssel bereits, wird der Wert geändert.
Parameter:
- Schlüssel: Der Schlüssel, der im JSON-Objekt gesetzt bzw. geändert werden soll. (Pflichtfeld)
- Wert: Der Wert der diesem Schlüssel gesetzt werden soll. Kann auch leer gelassen werden.
- Datentyp: Erlaubt das Setzen von Werten ohne Anführungszeichen, wenn es zum Beispiel Zahlen oder Boolsche Werte sind. Für Unter-Arrays bzw. Unter-Objekte müssen eigene Kommandos verwendet werden.
- Null-Verhalten: (optional)
- Wert behalten (default): Undefinierte Werte werden zu null, Leerwerte und 0 bleiben erhalten
- Null erzwingen: Undefinierte Werte sowie Leerwerte und 0/false werden zu null
- Null verbieten: Es entsteht nie ein null-Wert. Auch undefinierte Felder werden zu Leerwerten, 0 oder false
- Leerwerte unterdücken: Leere Strings, 0 und undefinierte Felder werden nicht in das JSONArray aufgenommen (ab DLE 2.1.2.031)
Ab der DLE-Version 2.1.2 verfügbar.
Sonderverhalten bei Wert:
Wird KEIN Datentyp angegeben und als Wert ein Text der entweder mit [ oder mit { beginnt, so wird der Text als JSON String geparsed. Ist dies nicht erfolgreich, dann wird der Text als String hinzugefügt.