← Alle Module · Daten & Formate

`json`

Liest, durchsucht, ändert und prüft JSON-Dateien und -Werte direkt auf dem PC oder Netzlaufwerk — ohne Office-Programm. Damit lassen sich Konfigurationen, Export-Dateien und API-Antworten im Klartext-Format auslesen, gezielt anpassen und wieder speichern.

Block-Einstellungen

Gelten für den ganzen Modul-Block (im Editor oben im Inspektor, in YAML direkt unter dem Modulnamen).

Feld	Typ	Pflicht	Beschreibung
datei	Text	—	Pfad zur .json-Datei. Existiert sie nicht, startet das Modul mit einem leeren Objekt und 'speichern' legt sie an. Ohne 'datei' funktionieren nur 'parsen' und 'serialisieren'.
einrückung	Wahrheit	—	Standard true — die Datei wird beim Schreiben eingerückt (lesbar). Auf false gesetzt wird kompakt ohne Leerzeichen geschrieben.

Aktionen

`lesen`lesend

Gibt den gesamten geparsten Inhalt der Datei als Objekt/Liste zurück, auf den der Workflow per Punkt-Zugriff navigieren kann.

Ausgaben (über `ergebnis:`)

inhalt

Das komplette geparste JSON-Dokument als Objekt oder Liste.

`wert-lesen`lesend

Liest den Wert an einem Punkt-Pfad (z. B. kunde.adressen.0.stadt); fehlt der Pfad, wird der Standard-Wert geliefert.

Eingaben

Feld	Typ	Pflicht	Beschreibung
pfad	Text	—	Punkt-Pfad zum Wert, Array-Indizes als Zahl (z. B. kunde.adressen.0.stadt). Leer = ganze Wurzel.
standard	Text	—	Ersatzwert, falls der Pfad nicht existiert.

Ausgaben (über `ergebnis:`)

wert	Der gefundene Wert oder der Standard-Wert.

`existiert`lesend

Prüft, ob am angegebenen Pfad ein Wert vorhanden ist.

Eingaben

Feld	Typ	Pflicht	Beschreibung
pfad	Text	—	Punkt-Pfad, der geprüft wird.

Ausgaben (über `ergebnis:`)

vorhanden

true, wenn am Pfad ein Wert existiert, sonst false.

`typ`lesend

Liefert den Datentyp des Werts am Pfad: objekt, array, text, zahl, wahrheitswert oder null.

Eingaben

Feld	Typ	Pflicht	Beschreibung
pfad	Text	—	Punkt-Pfad zum Wert. Leer = Wurzel.

Ausgaben (über `ergebnis:`)

typ	Typname: objekt, array, text, zahl, wahrheitswert oder null.

`abfragen`lesend

Durchsucht das Dokument mit einem JSONPath-Ausdruck und gibt alle Treffer als Liste zurück.

Eingaben

Feld	Typ	Pflicht	Beschreibung
abfrage	Text	ja	JSONPath-Ausdruck, z. B. $.kunden[*].stadt.

Ausgaben (über `ergebnis:`)

treffer

Liste aller von der Abfrage gefundenen Werte.

`schlüssel-liste`lesend

Gibt die Feldnamen (Schlüssel) eines Objekts am Pfad als Liste zurück.

Eingaben

Feld	Typ	Pflicht	Beschreibung
pfad	Text	—	Punkt-Pfad zum Objekt. Leer = Wurzel. Muss auf ein Objekt zeigen.

Ausgaben (über `ergebnis:`)

schlüssel

Liste der Schlüsselnamen des Objekts.

`array-länge`lesend

Zählt die Elemente einer Liste am angegebenen Pfad.

Eingaben

Feld	Typ	Pflicht	Beschreibung
pfad	Text	—	Punkt-Pfad zur Liste. Leer = Wurzel. Muss auf ein Array zeigen.

Ausgaben (über `ergebnis:`)

anzahl

Anzahl der Elemente in der Liste.

`parsen`lesend

Wandelt einen JSON-Text (z. B. aus einer API-Antwort) in ein Objekt/eine Liste um — braucht keine Datei.

Eingaben

Feld	Typ	Pflicht	Beschreibung
text	Text	ja	Der JSON-Text, der geparst werden soll.

Ausgaben (über `ergebnis:`)

inhalt

Der geparste Inhalt als Objekt oder Liste.

`serialisieren`lesend

Wandelt einen Wert in JSON-Text um, wahlweise eingerückt oder kompakt — braucht keine Datei.

Eingaben

Feld	Typ	Pflicht	Beschreibung
wert	Objekt	—	Der Wert/das Objekt, der/das in JSON-Text umgewandelt wird.
kompakt	Wahrheit	—	true = kompakt ohne Einrückung; ohne Angabe gilt die Block-Einstellung 'einrückung'.

Ausgaben (über `ergebnis:`)

text	Der erzeugte JSON-Text.

`wert-setzen`verändernd

Setzt einen Wert am Punkt-Pfad und legt dabei fehlende Zwischenobjekte und -listen automatisch an (im Speicher, erst 'speichern' schreibt zurück).

Eingaben

Feld	Typ	Pflicht	Beschreibung
pfad	Text	ja	Punkt-Pfad, an dem der Wert gesetzt wird (Zwischenstufen werden angelegt).
wert	Text	—	Der zu setzende Wert.

`feld-entfernen`verändernd

Entfernt das Feld bzw. Element am angegebenen Pfad; ein nicht existierender Pfad führt zum Fehler.

Eingaben

Feld	Typ	Pflicht	Beschreibung
pfad	Text	ja	Punkt-Pfad zum zu entfernenden Feld oder Listenelement.

`array-anhängen`verändernd

Hängt einen Wert an eine Liste an; ohne Pfad muss die Wurzel selbst eine Liste sein, mit Pfad wird die Liste bei Bedarf neu angelegt.

Eingaben

Feld	Typ	Pflicht	Beschreibung
pfad	Text	—	Punkt-Pfad zur Liste. Ohne Pfad wird an die Wurzel-Liste angehängt.
wert	Text	—	Der Wert, der an die Liste angehängt wird.

`zusammenführen`verändernd

Führt ein weiteres JSON-Objekt tief in die Wurzel ein (verschachtelte Objekte werden rekursiv gemischt, gleiche Schlüssel überschrieben).

Eingaben

Feld	Typ	Pflicht	Beschreibung
quelle	Objekt	—	Das einzufügende JSON-Objekt, als Objekt oder als JSON-Text. Muss ein Objekt sein.

`validieren`lesend

Prüft das Dokument gegen ein JSON-Schema (Typ, Pflichtfelder, Feld-Typen) und meldet Gültigkeit samt Fehlerliste.

Eingaben

Feld	Typ	Pflicht	Beschreibung
schema	Objekt	ja	Das JSON-Schema als Objekt, JSON-Text oder Pfad zu einer Schema-Datei.

Ausgaben (über `ergebnis:`)

gültig	true, wenn das Dokument dem Schema entspricht.
fehler	Liste der gefundenen Schema-Verletzungen (leer bei gültig).

`formatieren`verändernd

Schreibt die Datei neu — entweder eingerückt (lesbar) oder kompakt (minimiert).

Eingaben

Feld	Typ	Pflicht	Beschreibung
kompakt	Wahrheit	—	true = kompakt/minimiert; ohne Angabe gilt die Block-Einstellung 'einrückung'.

`schreiben`verändernd

Ersetzt den kompletten Datei-Inhalt (die Wurzel) durch den angegebenen Wert; erst 'speichern' schreibt auf die Platte.

Eingaben

Feld	Typ	Pflicht	Beschreibung
inhalt	Objekt	—	Der neue Wurzel-Inhalt der Datei.

`speichern`verändernd

Schreibt den aktuellen Inhalt zurück in die unter 'datei' angegebene Datei.

`speichern-unter`verändernd

Speichert den aktuellen Inhalt unter einem neuen Datei-Pfad.

Eingaben

Feld	Typ	Pflicht	Beschreibung
pfad	Text	ja	Ziel-Pfad für die neue Datei.

Beispiele

Stadt eines Kunden aus einer Konfigurations-Datei auslesen

Öffnet eine JSON-Datei und liest gezielt einen verschachtelten Wert über einen Punkt-Pfad.

json

json (Block öffnen)

dateiC:\Daten\kunde.json

json

wert-lesen

pfadkunde.adressen.0.stadt

standardunbekannt

ergebnisstadt

- json:
    datei: "C:\\Daten\\kunde.json"
    aktionen:
      - wert-lesen:
          pfad: kunde.adressen.0.stadt
          standard: unbekannt
          ergebnis: stadt

Konfigurations-Wert ändern und Datei speichern

Setzt einen Wert (legt fehlende Zwischenobjekte automatisch an) und schreibt die Datei eingerückt zurück.

json

json (Block öffnen)

dateiC:\Daten\config.json

einrückungtrue

json

wert-setzen

pfadserver.port

wert8080

- json:
    datei: "C:\\Daten\\config.json"
    einrückung: true
    aktionen:
      - wert-setzen:
          pfad: server.port
          wert: 8080
      - speichern: {}

json

Block-Einstellungen

Aktionen

lesenlesend

Ausgaben (über ergebnis:)

wert-lesenlesend

Eingaben

Ausgaben (über ergebnis:)

existiertlesend

Eingaben

Ausgaben (über ergebnis:)

typlesend

Eingaben

Ausgaben (über ergebnis:)

abfragenlesend

Eingaben

Ausgaben (über ergebnis:)

schlüssel-listelesend

Eingaben

Ausgaben (über ergebnis:)

array-längelesend

Eingaben

Ausgaben (über ergebnis:)

parsenlesend

Eingaben

Ausgaben (über ergebnis:)

serialisierenlesend

Eingaben

Ausgaben (über ergebnis:)

wert-setzenverändernd

Eingaben

feld-entfernenverändernd

Eingaben

array-anhängenverändernd

Eingaben

zusammenführenverändernd

Eingaben

validierenlesend

Eingaben

Ausgaben (über ergebnis:)

formatierenverändernd

Eingaben

schreibenverändernd

Eingaben

speichernverändernd

speichern-unterverändernd

Eingaben

Beispiele

Stadt eines Kunden aus einer Konfigurations-Datei auslesen

Konfigurations-Wert ändern und Datei speichern

`json`

`lesen`lesend

Ausgaben (über `ergebnis:`)

`wert-lesen`lesend

Ausgaben (über `ergebnis:`)

`existiert`lesend

Ausgaben (über `ergebnis:`)

`typ`lesend

Ausgaben (über `ergebnis:`)

`abfragen`lesend

Ausgaben (über `ergebnis:`)

`schlüssel-liste`lesend

Ausgaben (über `ergebnis:`)

`array-länge`lesend

Ausgaben (über `ergebnis:`)

`parsen`lesend

Ausgaben (über `ergebnis:`)

`serialisieren`lesend

Ausgaben (über `ergebnis:`)

`wert-setzen`verändernd

`feld-entfernen`verändernd

`array-anhängen`verändernd

`zusammenführen`verändernd

`validieren`lesend

Ausgaben (über `ergebnis:`)

`formatieren`verändernd

`schreiben`verändernd

`speichern`verändernd

`speichern-unter`verändernd