CSV in JSON umwandeln: Anleitung mit typischen Fallen

CSV ist die Sprache der Tabellenkalkulation, JSON die Sprache von Web-Apps und APIs. Früher oder später müssen Sie Daten vom einen ins andere bringen – um eine Produktliste zu importieren, eine Datenbank zu befüllen oder ein Skript zu füttern. Die Umwandlung wirkt trivial, doch ein paar Details entscheiden darüber, ob Ihre Daten unversehrt ankommen.

Wie aus CSV JSON wird

Eine CSV-Datei ist eine Tabelle. Die erste Zeile enthält meist die Spaltennamen:

id,name,city,zip
1,Ana,Vilnius,01100
2,Ben,Austin,73301

Die häufigste JSON-Struktur ist ein Array von Objekten – ein Objekt pro Zeile, mit den Spaltennamen als Schlüsseln:

[
  { "id": 1, "name": "Ana", "city": "Vilnius", "zip": "01100" },
  { "id": 2, "name": "Ben", "city": "Austin", "zip": "73301" }
]

Genau das erzeugt der CSV-in-JSON-Konverter standardmäßig.

Falle 1: Zahlen, die keine Zahlen sind

Beachten Sie, dass id zu einer Zahl wurde, zip aber ein String blieb. Das ist Absicht. Postleitzahlen, Telefonnummern, Kontonummern und Artikelnummern beginnen oft mit einer Null. Behandelt man 01100 als Zahl, wird daraus stillschweigend 1100 – ein Fehler, der monatelang unbemerkt bleiben kann.

FileCrafty bestimmt die Typen pro Spalte: Eine Spalte wird nur dann zu Zahlen, wenn jeder Wert darin eine saubere Zahl ist. Sobald ein Wert eine führende Null hat oder nicht numerisch ist, bleibt die ganze Spalte Text.

Falle 2: das falsche Trennzeichen

„Kommagetrennte“ Dateien sind nicht immer durch Kommas getrennt. Excel speichert CSV in vielen europäischen Ländereinstellungen – auch in Deutschland, Österreich und der Schweiz – mit Semikolons, weil das Komma dort das Dezimaltrennzeichen ist. Auch tabulatorgetrennte Dateien (TSV) sind verbreitet. Der Konverter erkennt das Trennzeichen automatisch, sodass 1;Ana;Vilnius korrekt aufgeteilt wird.

Falle 3: Kommas und Anführungszeichen in Werten

Ein Wert wie "Smith, John" enthält ein Komma und steht deshalb in der CSV in Anführungszeichen. Anführungszeichen innerhalb eines Werts werden verdoppelt: "He said ""hi""". Einfache Umwandlungen, die nur an Kommas trennen, zerlegen solche Zeilen. Ein richtiger CSV-Parser – wie der im Konverter – kommt mit Feldern in Anführungszeichen, eingebetteten Kommas und sogar Zeilenumbrüchen innerhalb einer Zelle zurecht.

Falle 4: leere Zellen

Eine leere Zelle kann „kein Wert“ oder „leerer Text“ bedeuten. In JSON ist das ein Unterschied: null gegenüber "". Klären Sie, was das System erwartet, in das Sie importieren, und prüfen Sie nach der Umwandlung einige Datensätze.

Der umgekehrte Weg

Sie möchten eine API-Antwort wieder in eine Tabelle verwandeln? JSON in CSV löst verschachtelte Objekte in Spalten wie address.city auf, und JSON in Excel liefert Ihnen direkt eine .xlsx-Datei. Um JSON vor der Verwendung zu prüfen oder aufzuräumen, fügen Sie es in den JSON-Formatierer ein – er zeigt Zeile und Spalte jedes Syntaxfehlers genau an.

Ihre Daten bleiben privat

Kundenlisten und Exporte enthalten oft personenbezogene Daten. Der Konverter läuft vollständig in Ihrem Browser, die Datei wird also nie auf einen Server hochgeladen.

Kurz gesagt

Ziehen Sie Ihre Datei in CSV in JSON, prüfen Sie die Vorschau und laden Sie das Ergebnis herunter. Um führende Nullen, Semikolons und Kommas in Anführungszeichen kümmert sich das Tool.