TSV naar JSON omzetten

Een TSV-bestand is een tabel: kolomkoppen op de eerste regel, tab-gescheiden waarden op elke regel daarna. JSON kent die vorm niet rechtstreeks, dus elke rij wordt hier een los object, met de kolomkoppen als sleutels en de celwaarden als waarden.

Het resultaat is een array met net zoveel objecten als er datarijen in het bronbestand stonden, in dezelfde volgorde.

Elke celwaarde komt als tekst het JSON-object binnen — een TSV kent geen typen, dus «8080» en «true» blijven tekenreeksen, ook al zien ze eruit als een getal of een booleaanse waarde.

Moet een applicatie die waarden als getal of boolean inlezen, dan gebeurt die interpretatie aan de kant van de applicatie die de JSON verder verwerkt, niet bij deze omzetting.

De eerste regel van de TSV bepaalt de sleutelnamen in elk object. Bevat een kolomkop een spatie of een bijzonder teken, dan komt die precies zo terug als sleutel — er wordt niets automatisch opgeschoond.

Twee identieke kolomkoppen in het bronbestand leveren twee sleutels met dezelfde naam op binnen elk object, waarbij de laatste waarde de eerdere overschrijft, zoals bij elk JSON-object het geval is.

Een lege cel in de TSV wordt een lege tekenreeks in de JSON, niet `null` en niet een ontbrekende sleutel — het veld blijft aanwezig in elk object, ook wanneer de rij daar niets voor invulde.

Voor software die het verschil maakt tussen «leeg» en «niet aanwezig», is dat iets om rekening mee te houden bij het verder verwerken van het resultaat.

Bevat een kolomkop een punt, zoals `adres.stad`, dan blijft dat een platte sleutelnaam met een punt erin — de omzetting bouwt daar geen geneste `adres`-object van op. Elke rij levert een plat object op, één niveau diep.

Wil je een geneste JSON-structuur, dan is dat een handmatige of aparte bewerkingsstap na deze omzetting.

Het lezen van de TSV en het schrijven van de JSON gebeurt in deze browsertab, tot 100 MB per bestand. Er wordt niets naar een server gestuurd, wat te controleren is via het netwerktabblad tijdens het omzetten.

Voor een export met klant- of personeelsgegevens is dat relevant.

Tot honderd TSV-bestanden tegelijk neerzetten kan; elk bestand wordt onafhankelijk verwerkt en het resultaat komt terug als één ZIP met de JSON-bestanden erin.

Praktisch voor wie een reeks exports uit dezelfde bron in één keer wil omzetten naar JSON voor verdere verwerking.