JSON in CSV umwandeln: Alles zur Hierarchie-Abflachung im Browser
Dieser Artikel erklärt die Funktionsweise eines Browser-Werkzeugs, das JSON-Dateien in CSV-Dateien konvertiert. Anders als bei einem Export aus Tabellenkalkulationen wird hier kein strukturiertes, typisiertes Format in ein anderes mit ähnlicher Tiefe überführt, sondern ein hierarchisches Datenmodell (JSON) in ein flaches, untypisiertes Tabellenformat (CSV) gezwungen. Das Werkzeug arbeitet vollständig clientseitig – keine Daten verlassen Ihren Rechner.
Warum JSON und CSV grundverschiedene Welten sind
JSON (JavaScript Object Notation) speichert Daten in einer verschachtelten Baumstruktur mit expliziten Datentypen: Objekte, Arrays, Zahlen, Zeichenketten, Booleans und null. Ein typisches JSON aus einer API kann so aussehen:
{
"kunden": [
{ "id": 1, "name": "Müller", "adresse": { "stadt": "Berlin", "plz": 10115 } },
{ "id": 2, "name": "Schmidt", "adresse": { "stadt": "Hamburg", "plz": 20095 } }
]
}
CSV (Comma-Separated Values) hingegen kennt nur eine Ebene: Zeilen und Spalten. Jede Zelle enthält eine Zeichenkette, es gibt keine Unterscheidung zwischen Zahl und Text, keine verschachtelten Objekte und keine leeren null-Werte – stattdessen schreibt man einfach nichts. Die Konvertierung von JSON nach CSV erfordert daher eine Abflachung (engl. flattening) der Hierarchie. Dabei gehen zwangsläufig Informationen verloren: Typen, Nesting-Tiefe, und jede Struktur, die sich nicht in ein Raster pressen lässt.
Das Werkzeug auf dieser Seite setzt genau dort an. Sie laden eine JSON-Datei (oder ziehen sie per Drag-and-Drop hinein), wählen ein Trennzeichen (Komma, Semikolon oder Tabulator) und erhalten eine CSV-Datei zum Download – samt Vorschau, Zeilen- und Spaltenanzahl sowie Dateigröße.
Wie die Abflachung funktioniert: Dot-Path-Notation und Array-Handling
Der entscheidende Mechanismus ist die Dot-Path-Notation. Wenn ein JSON-Objekt verschachtelte Objekte enthält, werden deren Schlüssel durch Punkte verbunden. Aus adresse.stadt wird eine Spaltenüberschrift, und in jeder Zelle steht der entsprechende Wert. Das obige Beispiel würde so aussehen:
| id | name | adresse.stadt | adresse.plz |
|---|---|---|---|
| 1 | Müller | Berlin | 10115 |
| 2 | Schmidt | Hamburg | 20095 |
- JSON-muss tabellenförmig sein – das Werkzeug akzeptiert nur ein Array von Objekten (jedes Objekt = eine Zeile, gleiche Schlüssel = Spalten) oder ein Array von Arrays (jede innere Liste = eine Zeile, jedes Element = eine Spalte). Ist das JSON ungültig oder nicht tabellenförmig, erscheint der Fehler: „This JSON is invalid or not table‑shaped.“
- Bei Arrays von Objekten werden die Objektschlüssel zu Spalten, verschachtelte Objekte flach geklappt. Arrays innerhalb eines Objekts (z. B.
produkte: ["a","b"]) werden als eine Zelle mit den Werten ausgegeben – die Tiefe dieser Arrays wird nicht weiter aufgelöst. - Bei Arrays von Arrays (z. B.
[[1,"rot"],[2,"blau"]]) werden die inneren Arrays direkt zu Zeilen, es gibt keine Spaltenüberschriften aus Objektschlüsseln.
Die Entscheidung, wie tief geschachtelte Felder dargestellt werden, liegt beim Werkzeug: Standardmäßig wird die Dot-Path-Notation verwendet. Sie können die Struktur vor dem Download in der Vorschau prüfen.
Trennzeichen und ihre Bedeutung für das CSV-Format
CSV steht für Comma-Separated Values, doch das Trennzeichen ist nicht zwingend ein Komma. Das Werkzeug bietet drei Optionen:
- Komma (
,) – der internationale Standard; wird von den meisten englischsprachigen Anwendungen erwartet. - Semikolon (
;) – in vielen europäischen Ländern üblich, weil das Komma dort als Dezimaltrenner dient (z. B. 1,5 statt 1.5). Excel in deutschen Ländereinstellungen öffnet CSV mit Semikolon korrekt. - Tabulator (
\t) – seltener, aber nützlich, wenn die Daten selbst Kommas oder Semikolons enthalten, da Tabulatoren in Freitext seltener vorkommen.
Das Trennzeichen beeinflusst nicht nur die Lesbarkeit, sondern auch die Notwendigkeit von Anführungszeichen. Enthält ein Wert das Trennzeichen, einen Zeilenumbruch oder ein Anführungszeichen, muss die gesamte Zelle in doppelte Anführungszeichen gesetzt werden. Eingebettete Anführungszeichen werden verdoppelt (z. B. " sagt "Hallo" " wird zu " sagt ""Hallo"" "). Das Werkzeug wendet diese Regeln automatisch an.
Verluste bei der Konvertierung: Typen, Nullen und führende Nullen
Alle JSON-Typen werden zu Zeichenketten. Zahlen werden als ihre Dezimaldarstellung geschrieben – das ist in den meisten Fällen unproblematisch. Booleans werden zu true bzw. false als Text. null wird zu einer leeren Zelle.
Ein häufiges Problem: führende Nullen. In JSON ist "01234" eine Zeichenkette und bleibt erhalten. Wird jedoch eine Zahl wie 01234 (was in JSON eigentlich ungültig ist, aber manche APIs senden sie als Zahl) geschrieben, interpretieren viele CSV-Exporte die 0 als Teil der Zahl – und schreiben 1234. Das Werkzeug behandelt Zahlen als Zahlen, daher gehen führende Nullen verloren, wenn der Wert als Zahl eingegeben wurde. Als Zeichenkette bleiben sie erhalten. Eine nachträgliche Wiederherstellung ist nicht möglich, da CSV keine Typinformationen speichert.
Ein weiterer Verlust: verschachtelte Strukturen. Ein JSON-Objekt mit mehreren Ebenen wird auf eine einzige Zeile pro Datensatz reduziert. Wenn ein Objekt mehrere Arrays mit unterschiedlicher Länge enthält, lässt sich das nicht ohne Weiteres in ein Raster pressen – hier muss das JSON vorher in eine „tabellenförmige“ Form gebracht werden (z. B. durch Aufbrechen in mehrere Zeilen). Das Werkzeug erwartet diese Form bereits.
Fehlerbehandlung und Grenzen des Werkzeugs
Das Werkzeug prüft mehrere Randbedingungen und gibt gezielte Fehlermeldungen aus:
- Dateigröße: „This file is too large. Use a file under ‹max›.“ – der genaue Maximalwert wird im Werkzeug angezeigt.
- Zeilenlimit: „This table has more than ‹max› rows.“
- Spaltenlimit: „This table has more than ‹max› columns.“
- Keine Datei ausgewählt: „Choose one file first.“
- Falscher Dateityp: „Choose a CSV, JSON or XLSX file.“ – nur JSON ist für die Eingabe relevant.
- Ausgabeformat ungültig: „Choose a different output format.“
- Allgemeiner Konvertierungsfehler: „Could not convert this file.“
- Abbruch (z. B. durch manuelles Stoppen): „Conversion cancelled.“
- Zeitüberschreitung: „This conversion is taking too long. Try a smaller file.“ – bei sehr großen oder komplexen JSONs.
Alle Prüfungen laufen lokal im Browser. Das Werkzeug lädt Ihre Daten nie auf einen Server – ein entscheidender Vorteil für datenschutzsensible Anwendungen wie die Verarbeitung von Personendaten oder vertraulichen Geschäftszahlen.
Praktische Anwendung: Wer das braucht und worauf Sie achten sollten
Das Werkzeug richtet sich an Personen, die JSON-Daten (z. B. aus einer REST-API) in ein CSV umwandeln müssen, um sie in Excel, Google Sheets, einer Datenbank oder einem Statistikprogramm weiterzuverarbeiten. Typische Szenarien:
- API-Response mit Kunden-/Produktdaten → CSV für Bericht
- JSON-Export einer NoSQL-Datenbank → CSV für Analyse in R oder Python
- Schnelle, einmalige Konvertierung ohne Installation eines Tools
- Workflows mit Datenschutzauflagen: keine Uploads, keine Cloud
Vor dem Download sollten Sie die Vorschau prüfen: Sind die Dot-Paths sinnvoll? Fehlen Spalten? Stimmt die Zeilenanzahl? Wenn das JSON sehr tiefe Hierarchien hat, werden die Spaltenüberschriften lang und unhandlich – überlegen Sie, ob Sie das JSON vorher selbst flacher strukturieren können.
Ein häufiger Fehler: Rückkonvertierung. Wenn Sie eine CSV aus diesem Tool wieder in JSON umwandeln, erhalten Sie niemals das Original-JSON zurück. Die Dot-Paths bleiben als Schlüssel erhalten, und alle Werte sind Zeichenketten. Planen Sie solche Roundtrips vorher ein.
FAQ
F: Kann ich beliebige JSON-Dateien konvertieren?
Nur solche, die „tabellenförmig“ sind – also ein Array von Objekten mit konsistenten Schlüsseln oder ein Array von Arrays. Ein einzelnes Objekt ohne umschließendes Array wird abgelehnt.
F: Was passiert mit Daten, die Kommas oder Zeilenumbrüche enthalten?
Das Werkzeug setzt automatisch Anführungszeichen und maskiert enthaltene Anführungszeichen gemäß CSV-Standard. In der Vorschau sehen Sie das Ergebnis.
F: Warum gehen führende Nullen verloren?
Wenn der Wert im JSON als Zahl (ohne Anführungszeichen) vorliegt, wird er als Zahl interpretiert und ohne führende Nullen ausgegeben. Nur als Zeichenkette (in Anführungszeichen) bleiben sie erhalten.
F: Unterstützt das Werkzeug mehrere CSV-Dateien auf einmal?
Nein, es wird immer genau eine JSON-Datei verarbeitet. Sie können mehrere Durchläufe hintereinander machen.
F: Ist die Konvertierung wirklich komplett offline?
Ja. Der gesamte Code läuft im Browser – es findet kein Upload statt. Auch die Vorschau wird clientseitig erzeugt.
F: Was bedeutet „This JSON is invalid or not table‑shaped“?
Entweder ist die Datei kein gültiges JSON, oder sie enthält keine Array-Struktur, die in Zeilen und Spalten aufteilbar ist. Prüfen Sie die Datei mit einem JSON-Validator vor dem Upload.