Verschachteltes JSON mit Punktpfaden in Tabelle umwandeln

Jede verschachtelte Eigenschaft erhält einen Punktpfad, Arraypositionen werden zu numerischen Segmenten. Eine Bestellnummer lässt sich dadurch einheitlich als orders.0.id ansprechen. Das Ergebnis eignet sich für Tabellenkalkulationen, Stagingtabellen in Datenbanken, Protokolle, Zuordnungswerkzeuge und alle Abläufe, die vorhersehbare Pfade statt verschachtelter Strukturen benötigen. Die Verarbeitung ist deterministisch, bewahrt JSON-Werttypen und weist fehlerhaftes JSON oder einen skalaren Wurzelwert mit einer klaren Eingabemeldung zurück.

Erzeugen Sie vorhersehbare Pfade aus verschachtelten Daten

Verschachteltes JSON ist für API ideal, weil zusammengehörige Werte gruppiert bleiben. Viele Berichts- und Importwerkzeuge erwarten jedoch eine flache Feldfolge. Diese Funktion durchläuft jede Objekteigenschaft und jedes Arrayelement und verbindet die einzelnen Segmente mit einem Punkt. Ein Wert im Objekt customer unter der Eigenschaft name wird zu customer.name. Das erste Element des Arrays orders wird über orders.0 angesprochen, seine Kennung somit über orders.0.id. Jedes Blatt erscheint als Zeile mit Schlüssel und Wert. Dadurch lässt sich die Ausgabe leicht anzeigen, filtern oder in Spalten umformen. Der Durchlauf hält die Reihenfolge des eingelesenen JSON ein und liefert für dieselbe Eingabe stabile Ergebnisse. Zeichenfolgen, Zahlen und boolesche Werte behalten ihren Typ; null bleibt ebenfalls erhalten. Leere Objekte und Arrays werden als Werte ausgegeben und verschwinden nicht unbemerkt. So dokumentiert die abgeflachte Ausgabe weiterhin, dass die betreffenden Pfade im Quelldokument vorhanden waren.

Bereiten Sie die Eingabe vor und lesen Sie die Ausgabe

Übergeben Sie das vollständige JSON-Dokument als Text im Feld json. Der Wurzelwert muss ein Objekt oder Array sein. So wird ein mehrdeutiger leerer Schlüssel für alleinstehende Zeichenfolgen, Zahlen, boolesche Werte oder null vermieden. Namen von Objekteigenschaften werden unverändert übernommen, Arrayindizes als bei null beginnende numerische Segmente geschrieben. Die Antwort enthält pairs, ein Array mit Einträgen aus den Feldern key und value, das direkt als Tabellenzeilen verarbeitet werden kann. Ist die Wurzel selbst ein leeres Objekt oder Array, wird eine leere Zeichenfolge als Schlüssel ausgegeben und der leere Container als Wert erhalten. Punkte, die bereits in einem ursprünglichen Eigenschaftsnamen vorkommen, werden nicht maskiert. Eine wörtliche Eigenschaft user.name erzeugt daher denselben sichtbaren Pfad wie ein verschachteltes Objekt user mit name. Wenn Ihre Daten gepunktete Eigenschaftsnamen verwenden und Pfade eindeutig rückführbar sein müssen, benennen Sie diese Eigenschaften vorher um oder bewahren Sie das ursprüngliche JSON zusammen mit dem flachen Ergebnis auf.

Nutzen Sie flache Paare in Datenabläufen

Die abgeflachten Paare sind eine praktische Zwischendarstellung. Eine Tabellenautomatisierung kann Schlüssel und Werte in getrennte Spalten schreiben; ein Importprozess kann ausgewählte Pfade in die Spalten einer breiten Zeile drehen; ein Vergleichswerkzeug kann Paare nach Schlüsseln indizieren und anschließend zwei Dokumente prüfen. Numerische Arraysegmente kennzeichnen wiederholte Datensätze eindeutig, statt Werte verschiedener Elemente zu vermischen. Da der Vorgang keine Netzwerkanfragen sendet und weder Zufallswerte noch Zeitstempel oder Modellinferenz verwendet, erzeugt identischer JSON-Text stets dieselbe Ausgabe. Ungültiges JSON schlägt ohne Teilergebnis fehl; gültiges skalares JSON wird ebenfalls abgewiesen, weil es den Objekt-oder-Array-Vertrag nicht erfüllt. Die API kostet $0.002 pro Element, während der Browser dieselbe deterministische Logik lokal ausführen kann. Bei sehr großen Dokumenten kann ein Streaming- oder schemaspezifischer Prozess geeigneter sein, denn das Abflachen erzeugt für jedes primitive Blatt und jeden leeren Container im gesamten Dokument eine Ausgabezeile.