JSON naar TSV omzetten

Deze pagina is niet zomaar een tweede JSON-naar-CSV. Die andere omzetting is voor iemand die een bestand opslaat om te openen of te importeren; deze is voor iemand wiens waarden komma’s bevatten en die het resultaat zo dadelijk in een cel van een spreadsheet gaat plakken.

Zelfde bron, ander moment, ander advies: bij plakken in een cel is een tab als scheidingsteken minder foutgevoelig dan een komma, omdat een komma in de waarde zelf dan niet met een kolomscheiding kan worden verward.

Een object met precies één sleutel die een array bevat — zoals `{"records": [...]}` — wordt automatisch uitgepakt: de array binnenin wordt gebruikt als de rijenset, niet het buitenste object als geheel.

Dat is een bewuste eigenschap van deze specifieke omzetting, anders dan bij JSON naar NDJSON, waar zo’n envelop juist niet wordt uitgepakt — hetzelfde bronformaat krijgt op de twee pagina’s dus een ander antwoord, precies omdat het doel anders is.

Een genest object, zoals `{"adres": {"stad": "Utrecht"}}`, wordt platgeslagen tot een kolom met de naam `adres.stad`. Dat gebeurt op elk niveau van nesting, dus diep geneste structuren leveren lange, met punten gescheiden kolomnamen op.

De kolommen die uiteindelijk in het resultaat staan, zijn de unie van alle sleutels over alle records heen — een record dat een bepaald veld mist, krijgt daar simpelweg een lege cel voor in plaats van dat de kolom wegvalt.

Een waarde die zelf een tab of een nieuwe regel bevat, wordt tussen dubbele aanhalingstekens gezet in het resultaat — dat voorkomt dat zo’n waarde per ongeluk als kolomscheiding of rij-einde wordt gelezen door de volgende stap.

Een gewone komma in een waarde heeft in een TSV geen speciale betekenis meer en wordt dus niet aangehaald — precies het probleem dat deze omzetting oplost ten opzichte van een gewone CSV.

Mist een record een veld dat in een ander record wel voorkomt, dan krijgt dat record een lege cel op die plek in plaats van dat de rij wordt overgeslagen. Elke rij in het resultaat komt overeen met precies één record uit de bron.

Voor gegevens met een wisselend aantal velden per record — vaak het geval bij een export die over tijd is uitgebreid — geeft dat een consistente tabel zonder rijen die verschuiven.

De omzetting draait volledig in de browser; het bestand wordt niet naar een server gestuurd. De limiet op het gratis plan is 100 MB per bestand.

Voor een groot exportbestand met veel records is dat ruim voldoende.

Tot honderd JSON-bestanden tegelijk kunnen in één sessie worden omgezet, elk met een eigen voortgangsindicator, en het resultaat komt terug als losse bestanden of als ZIP.

Dat is bruikbaar wanneer meerdere exports uit dezelfde bron dezelfde platslag- en scheidingstekenbehandeling nodig hebben.

Bevatten de waarden geen komma’s en gaat het resultaat niet direct in een spreadsheetcel geplakt worden, dan is een gewone CSV-omzetting net zo goed bruikbaar en misschien wel de meer gangbare keuze voor de meeste importsystemen.

TSV verdient hier specifiek de voorkeur bij waarden met komma’s of bij het plakken in een cel — buiten die twee gevallen maakt het weinig verschil.