JSON in CSV

Was ist JSON in CSV?

Die Umwandlung von JSON in CSV konvertiert strukturierte JSON-Daten in eine CSV-Datei, die sich für Tabellenansicht und weitere Verarbeitung eignet. Das Tool kann API-Antworten, exportierte Konfigurationsdaten oder JSON-Arrays in Tabellen umwandeln und ermöglicht vor der Konvertierung die Auswahl der Datenquelle, Felder sowie die Behandlung verschachtelter Daten.

Welche JSON-Strukturen werden unterstützt?

Die häufigste Eingabe ist ein JSON-Array mit mehreren Objekten, zum Beispiel [{"name":"Tom","age":18},{"name":"Jack","age":20}]. Jedes Objekt wird in eine Zeile umgewandelt und seine Felder werden zu CSV-Spalten.

Wenn das JSON auf der obersten Ebene ein Objekt ist, kann je nach Struktur die oberste Datenebene ausgewählt oder JSONPath verwendet werden, um ein bestimmtes Array anzugeben, beispielsweise $.data.list. Dadurch lässt sich eine Liste direkt aus typischen API-Strukturen wie {"data":{"list":[...]}} extrahieren.

Drei Möglichkeiten zur Auswahl der Datenquelle

Die automatische Erkennung wählt anhand der JSON-Struktur eine geeignete Datenquelle. Mit „Top-Level-Daten“ werden Daten direkt aus dem obersten Objekt oder Array konvertiert. Mit JSONPath kann die gewünschte Datenposition manuell angegeben werden, beispielsweise $.data.list. Wenn ein JSON-Dokument viele Felder enthält, aber nur ein bestimmtes verschachteltes Array exportiert werden soll, ist JSONPath besonders praktisch.

Wie werden JSON-Felder behandelt?

Für Felder stehen ein automatischer Modus und ein vollständiger Feldmodus zur Verfügung. Der automatische Modus erzeugt anhand der tatsächlichen Daten geeignete CSV-Spalten. Der vollständige Feldmodus übernimmt alle Felder, die im Konvertierungsbereich vorkommen. Wenn verschiedene Objekte unterschiedliche Felder besitzen, beeinflusst die gewählte Feldbehandlung die CSV-Kopfzeile und die Position leerer Werte.

Wie werden verschachtelte Objekte in CSV umgewandelt?

Verschachtelte JSON-Objekte lassen sich nicht direkt wie gewöhnliche Tabellenfelder darstellen. Deshalb bietet das Tool zwei Optionen. Bei „Als JSON beibehalten“ wird das verschachtelte Objekt als JSON-Wert in einer Zelle gespeichert. Bei „In Spalten aufteilen“ werden verschachtelte Felder in einzelne Spalten aufgeteilt, was für Tabellenkalkulation und Datenanalyse geeigneter sein kann.

Beispielsweise kann das user-Objekt aus {"user":{"name":"Tom","age":18}} als eine JSON-Zelle erhalten bleiben oder in Felder wie user.name und user.age aufgeteilt werden.

Wie werden Arrays in CSV umgewandelt?

Arrays können als JSON-String in einer Zelle erhalten bleiben oder zeilenweise erweitert werden. Die JSON-Variante eignet sich zum Bewahren der ursprünglichen Struktur. Die zeilenweise Variante eignet sich, wenn die Array-Elemente einzeln in der Tabelle verarbeitet werden sollen. Welche Option sinnvoll ist, hängt davon ab, ob die JSON-Struktur erhalten oder die Elemente direkt tabellarisch dargestellt werden sollen.

Wie konvertiert man eine lokale JSON-Datei in CSV?

Wechsle zum Datei-Upload-Tab und ziehe eine .json-Datei auf die Upload-Fläche oder wähle sie über die Dateiauswahl aus. Die Datei wird direkt im Browser gelesen. Die maximale Größe beträgt 10 MB pro Datei. Danach können Datenquelle, Felder sowie die Behandlung von verschachtelten Objekten und Arrays ausgewählt werden.

Wie verwendet man die erzeugte CSV?

Nach der Konvertierung werden eine CSV-Vorschau und der vollständige Text angezeigt. Das Ergebnis kann kopiert oder als CSV-Datei heruntergeladen werden. Die CSV-Datei kann anschließend mit Excel, Tabellenkalkulationsprogrammen, Datenbank-Importwerkzeugen oder anderen Datenverarbeitungsprogrammen geöffnet werden.

Häufige Probleme bei JSON zu CSV

Wenn das Ergebnis leer ist, sollte zunächst geprüft werden, ob das JSON gültig ist und ob die gewählte Datenquelle tatsächlich auf ein Array mit Datensätzen zeigt. Wenn die Daten in einem verschachtelten Objekt liegen, kann JSONPath wie $.data.list verwendet werden. Wenn die erzeugten Spalten nicht den Erwartungen entsprechen, sollten die Einstellungen für verschachtelte Objekte und Arrays sowie die Feldunterschiede zwischen den Eingabeobjekten geprüft werden.

Wie verarbeitet dieses Tool JSON?

JSON-Parsing, Feldaufbereitung, Verarbeitung verschachtelter Daten und CSV-Erzeugung erfolgen vollständig lokal im Browser. Die Eingabedaten werden nicht auf den Server hochgeladen. Dadurch eignet sich das Tool auch für API-Daten, Konfigurationsdateien und lokale JSON-Dateien, die nicht an einen Drittanbieter übertragen werden sollen.