Verschachteltes JSON verflachen: Regeln für das Verbinden von Schlüsseln

VeröffentlichtToolJSON Flachleger & Entfalter

Inhalt
  1. Das Problem beim Übertragen von verschachteltem JSON in eine Tabelle
  2. Regeln für die Umwandlung von Hand
  3. Häufige Stolpersteine: Umgang mit Arrays und Wahl des Trennzeichens
  4. Zusammenfassung
  5. Häufig gestellte Fragen

Wenn Sie ein tief verschachteltes JSON-Objekt nach Excel oder in eine CSV-Datei übertragen möchten, müssen Sie die mehrstufige Hierarchie in eine eindimensionale Schlüssel-Wert-Struktur umwandeln, die in einer einzigen Tabelle Platz findet. Diese Umwandlung heißt JSON-Flattening (Verflachen). Der umgekehrte Vorgang, bei dem eine eindimensionale Struktur wieder in das ursprüngliche verschachtelte Objekt zurückgeführt wird, heißt Unflattening (Entfalten). Beide Umwandlungen sind rein mechanische Berechnungen nach festen Regeln. Kennen Sie die Regeln, können Sie sie auch ohne Werkzeug von Hand nachvollziehen.

Zusammenfassung ① Die Schlüssel verschachtelter Objekte werden in der Form „übergeordneter Schlüssel + Trennzeichen + untergeordneter Schlüssel" zusammengesetzt und ergeben so eine eindimensionale Struktur. ② Arrays sind keine Objekte und werden deshalb nicht verflacht; ihr Wert bleibt unverändert erhalten. ③ Kommt das gewählte Trennzeichen bereits im ursprünglichen Schlüssel vor, wird dieser Schlüssel beim Unflatten unbeabsichtigt weiter aufgeteilt.

Das Problem beim Übertragen von verschachteltem JSON in eine Tabelle

API-Antworten und Konfigurationsdateien bestehen häufig aus Objekten, die wiederum Objekte enthalten. Ein Beispiel: {"user": {"name": "김철수", "address": {"city": "서울"}}} – die Adressdaten sind hier noch einmal in die Benutzerdaten eingebettet.

Überträgt man eine solche Struktur unverändert nach Excel oder in eine CSV-Datei, entstehen Probleme. Eine Tabellenzelle kann nur einen einzigen Wert aufnehmen. Fügt man einen Eintrag wie address ein, dessen Wert insgesamt ein Objekt ist, werden die Spalten nicht korrekt angelegt oder die Werte erscheinen fehlerhaft.

Deshalb braucht man eine eindimensionale Struktur, in der übergeordneter und untergeordneter Schlüssel zu einem Spaltennamen zusammengefasst sind, etwa address.city. Das Verflachen erledigt diese Umwandlung nach klaren Regeln, sodass Sie die Schlüssel nicht jedes Mal von Hand neu zusammensetzen müssen.

Regeln für die Umwandlung von Hand

Flatten und Unflatten funktionieren jeweils nach einer festen rekursiven Regel. Wenn Sie ihr folgen, können Sie kleine JSON-Dateien selbst umwandeln.

Regeln für das Verflachen (Flatten)

Ist der Wert eines Schlüssels ein reines Objekt (also in der Form {}, weder ein Array noch null), geht man in dieses Objekt hinein und hebt jeden untergeordneten Schlüssel unter dem neuen Namen „übergeordneter Schlüssel + Trennzeichen + untergeordneter Schlüssel" auf die oberste Ebene. Ist der Wert kein Objekt (Arrays eingeschlossen), wird er unter dem ursprünglichen Schlüssel ins Ergebnis übernommen.

Angenommen, das folgende JSON soll mit dem Punkt (.) als Trennzeichen verflacht werden:

{"user": {"name": "김철수", "address": {"city": "서울"}}, "tags": ["a", "b"]}

user ist ein Objekt, also geht man hinein. user.name hat den Wert „김철수". user.address ist wiederum ein Objekt, man geht also noch eine Ebene tiefer, und user.address.city erhält den Wert „서울". tags ist ein Array und damit kein Objekt, bleibt also unverändert.

{"user.name": "김철수", "user.address.city": "서울", "tags": ["a", "b"]}

Regeln für das Entfalten (Unflatten)

Die Gegenrichtung zerlegt jeden Schlüssel am Trennzeichen und baut anhand der Teilstücke der Reihe nach die verschachtelten Objekte wieder auf. Man folgt den Teilstücken von vorn nach hinten, legt fehlende Ebenen neu an und trägt im letzten Teilstück den ursprünglichen Wert ein.

Entfalten Sie die oben erzeugten flachen Daten wieder, wird user.address.city in die drei Teilstücke user, address und city zerlegt. Unter dem Objekt user entsteht das Objekt address, und darunter wird city: "서울" eingetragen. user.name landet im selben Objekt user, und die ursprüngliche verschachtelte Struktur ist vollständig wiederhergestellt.

Mit unserem Tool ausprobieren.

JSON Flachleger & Entfalter

Ihr JSON wird nicht an einen Server gesendet. Das Verflachen und Entfalten geschieht ausschließlich in Ihrem Browser.

Häufige Stolpersteine: Umgang mit Arrays und Wahl des Trennzeichens

Zwei Punkte sorgen besonders oft für Verwirrung. Der eine: Enthält das JSON Arrays, fällt das Ergebnis anders aus als erwartet. Der andere: Durch die Wahl des Trennzeichens weicht das Ergebnis des Unflatten vom Original ab.

Ergebnis bei vorhandenen Arrays

Zuerst zu den Arrays. Auch wenn ein Array Objekte enthält, etwa bei {"users": [{"name": "김철수"}, {"name": "이영희"}]}, ist der Wert von users selbst ein Array und wird daher nicht verflacht. Das Objekt {"name": "김철수"} im Array wird nicht durchlaufen und auch nicht mit einem Index wie users.0.name aufgefächert. Stattdessen bleibt das Array unter dem Schlüssel users unverändert als Ganzes bestehen.

Form des WertsBehandlung beim Verflachen
Reines Objekt {}Rekursiver Einstieg; die untergeordneten Schlüssel werden zu „übergeordneter Schlüssel + Trennzeichen + untergeordneter Schlüssel" zusammengesetzt
Array [] (auch mit Objekten darin)Keine Rekursion; das ursprüngliche Array bleibt als Wert erhalten
String, Zahl, Boolean, nullBleibt unverändert unter dem ursprünglichen Schlüssel

Wenn die Wahl des Trennzeichens das Ergebnis verändert

Als Nächstes das Trennzeichen. Dasselbe Zeichen, mit dem Flatten die Schlüssel verbindet, wird auch beim Unflatten zum erneuten Zerlegen verwendet. Steckte dieses Zeichen schon im Schlüssel der Originaldaten, zerlegt Unflatten den Schlüssel feiner als beabsichtigt.

Angenommen, Sie haben flache Daten wie {"상품가격.원": 15000}, bei denen der Schlüsselname selbst einen Punkt enthält. Entfalten Sie sie mit dem Punkt (.) als Trennzeichen, entstehen die beiden Teilstücke 상품가격 und 원. Das Ergebnis ist {"상품가격": {"원": 15000}} – ein verschachteltes Objekt, das so nie beabsichtigt war.

Das passiert häufig bei Schlüsseln mit Punkt, etwa bei Versionsnummern (1.2.3), Dateiendungen oder Domainnamen. Wählen Sie in solchen Fällen ein Zeichen als Trennzeichen, das in den Originalschlüsseln nicht vorkommt, zum Beispiel den Unterstrich (_) oder den Schrägstrich (/), vermeiden Sie das Problem.

Zusammenfassung

  • Das Verflachen löst nur reine Objekte rekursiv auf und erzeugt neue Schlüssel in der Form „übergeordneter Schlüssel + Trennzeichen + untergeordneter Schlüssel".
  • Arrays sind keine Objekte und werden daher nicht verflacht; auch wenn sie Objekte enthalten, bleiben sie unverändert als Wert erhalten.
  • Das Entfalten ist der umgekehrte Vorgang: Jeder Schlüssel wird am Trennzeichen zerlegt und die verschachtelten Objekte werden der Reihe nach neu aufgebaut.
  • Das Trennzeichen sollte ein Zeichen sein, das in den ursprünglichen Schlüsseln nicht vorkommt, damit Unflatten keine unbeabsichtigten zusätzlichen Aufteilungen vornimmt.
  • Text mit fehlerhaftem Format wird bereits im Schritt JSON.parse abgefangen und als Fehler angezeigt, statt umgewandelt zu werden.
JSON Flachleger & Entfalter

Ihr JSON wird nicht an einen Server gesendet. Das Verflachen und Entfalten geschieht ausschließlich in Ihrem Browser.

Häufig gestellte Fragen

Werden auch Objekte innerhalb eines Arrays verflacht?

Nein. Ist der Wert ein Array, gilt er selbst nicht als Objekt und wird von der Rekursion ausgenommen. Auch wenn das Array Objekte wie {"name": "김철수"} enthält, werden sie nicht mit einem Index wie users.0.name aufgefächert, sondern das Array bleibt unverändert als Wert erhalten.

Welches Trennzeichen sollte ich wählen?

Zur Auswahl stehen Punkt (.), Schrägstrich (/) und Unterstrich (_); die Standardeinstellung ist der Punkt. Kommt das Zeichen bereits in den ursprünglichen Schlüsselnamen vor, kann Unflatten sie unbeabsichtigt weiter aufteilen. Sicherer ist daher ein Zeichen, das in Ihren Schlüsseln nicht vorkommt.

Wie wird ein null-Wert behandelt?

null gilt nicht als reines Objekt und wird daher nicht rekursiv durchlaufen, sondern bleibt unverändert unter dem ursprünglichen Schlüssel stehen. Es wird nicht in untergeordnete Schlüssel zerlegt.

Was passiert, wenn ich ungültiges JSON eingebe?

Hat der Text ein Format, bei dem JSON.parse fehlschlägt (etwa fehlende Anführungszeichen oder Kommafehler), wird die Umwandlung nicht ausgeführt. Stattdessen erscheint eine rote Fehlermeldung, und das Ausgabefenster bleibt leer. Prüfen Sie daher zuerst, ob der Originaltext gültiges JSON ist.

Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen

Ähnliche Artikel

  1. JSON-Schlüssel von camelCase in snake_case umwandelnSo wandeln Sie JSON-Schlüssel zwischen camelCase, snake_case, PascalCase und kebab-case um – auch in verschachtelten Objekten und Arrays – samt Sonderfällen.
  2. JSON-Schlüssel löschen: Mehrere Eigenschaften rekursiv entfernenSo entfernen Sie mehrere JSON-Schlüssel per Komma-Liste rekursiv in einem Schritt – inklusive Groß-/Kleinschreibung, exakter Übereinstimmung und ungültigem JSON.
  3. JSON Schlüssel sortieren: Was die Sortierung tatsächlich ändertJSON-Schlüssel alphabetisch sortieren: Die Reihenfolge im Array bleibt erhalten. Beispiele zeigen, wie rekursive Option und Einrückung das Ergebnis beeinflussen.
  4. JavaScript-Objekt in JSON umwandeln: Fehlerursachen und LösungWarum JSON.parse bei kopierten JS-Objekten „Unexpected token“ meldet, was JSON-Syntax von Objektliteralen unterscheidet und wie Sie in der Konsole konvertieren.
  5. JSON-Schema erstellen: So werden Typen erkannt (Draft-07)Wie aus einem JSON-Beispiel ein Draft-07-Schema entsteht: Typerkennung bei Strings, Zahlen und Arrays, required und anyOf erklärt, plus Grenzen eines Beispiels.
  6. JSON Syntaxfehler: Ursachen anhand der Fehlermeldung findenWas die Position in JSON-Fehlermeldungen bedeutet und wie Sie typische Syntaxfehler wie Trailing Comma, einfache Anführungszeichen und Kommentare erkennen.

Passende Tools