Dataconverters

Data verplaatsen tussen CSV, JSON, YAML en XML

Data staat zelden stil in één formaat. Een rapport komt binnen als spreadsheet, een API wil JSON, een deployment-pipeline verwacht YAML en ergens in de kelder spreekt een verouderde dienst nog steeds XML. De meeste alledaagse wrijving bij het werken met data zit niet in de data zelf, maar in het omzetten van de vorm die je hebt naar de vorm die iets anders vereist. Dat is het hele doel van een dataconverter: gestructureerde tekst in de ene notatie innemen en opnieuw uitsturen in een andere, zonder de betekenis onderweg te verliezen.

De converters van Speedor draaien volledig in je browser. Je plakt, klikt en kopieert het resultaat. Er wordt niets geüpload, niets gelogd en niets verlaat je apparaat. Voor iedereen die ooit heeft geaarzeld voordat hij een klantexport op een willekeurige website dropte, is dat lokale ontwerp de kern van de zaak.

Waarvoor elk formaat werkelijk goed is

Het helpt om te weten waarom deze formaten bestaan voordat je begint met omzetten, omdat elk voor een andere taak is gebouwd.

CSV is het platte, kommagescheiden raster dat spreadsheets lekker vinden. Het is van nature tabellair: rijen en kolommen, niets genest. Open het in Excel, Google Spreadsheets of Numbers en het werkt gewoon. Het nadeel is dat CSV geen concept van types heeft. De waarde 007 kan een string, een getal of een postcode zijn, en CSV vertelt je niet welke.

JSON is de gemeenschappelijke taal van het moderne web. Vrijwel elke API die je ooit aanroept, spreekt het. JSON verwerkt nesting, arrays en een handvol echte types (strings, getallen, booleans, null), wat het veel expressiever maakt dan een platte tabel. Het is compact, machinevriendelijk en overal ondersteund.

YAML is de beter leesbare neef van JSON. Het gebruikt inspringing in plaats van haakjes, ondersteunt opmerkingen en is doorgaans het formaat bij uitstek voor configuratiebestanden, Docker Compose, Kubernetes-manifesten en CI-pipelines. Als een mens iets handmatig moet bewerken, is YAML doorgaans vriendelijker voor de ogen.

XML is de oudste van de groep. Breedsprakig, tag-zwaar en nog steeds diep verankerd in bedrijfssystemen, SOAP-diensten, financiële berichten en documentstandaarden zoals RSS. Je ontmoet het minder vaak in nieuwe projecten, maar als je het nodig hebt, heb je het écht nodig.

Waar conversies daadwerkelijk plaatsvinden

De scenario's worden behoorlijk concreet als je er goed naar kijkt. Stel dat marketing je een spreadsheet geeft met 4.000 contacten en de aanmeldings-API alleen een JSON-array accepteert. Je exporteert het blad naar CSV, voert het door CSV naar JSON en je hebt een payload klaar om te POST-en. Geen lijmscript, geen pandas, geen wachten op een ingenieur.

Of je haalt een stuk JSON terug van diezelfde API en wilt het in een configuratiebestand plaatsen dat je dienst bij het opstarten leest. Converteer het met JSON naar YAML en je krijgt iets overzichtelijks met commentaarmogelijkheden dat naadloos in je repository past. De andere richting werkt ook als een tool alleen JSON accepteert maar je configuratie in YAML staat.

En dan is er de integratie die niemand leuk vindt: een partnersysteem dat alleen XML inleest. Je bouwt je payload in JSON omdat dat de manier is waarop je app denkt, en converteert vervolgens naar XML aan de grens. De structuur blijft gelijk, alleen de syntaxis verandert.

De valkuilen die het waard zijn te kennen

Formaatconversie is niet altijd verliesvrij, en doen alsof dat wel zo is leidt tot fouten. Een paar dingen om in gedachten te houden:

CSV vergeet types. Omdat elke cel gewoon tekst is, komen getallen, booleans en datums allemaal als strings uit tenzij de converter voor je raadt. Als true een boolean moet zijn en niet het woord "true," controleer dan de uitvoer voordat je hem verstuurt.

YAML geeft om witruimte. Inspringing is in YAML niet cosmetic maar structureel. Eén overbodige spatie kan veranderen bij welke sleutel een waarde hoort, en tabs zijn helemaal verboden. Na een JSON-naar-YAML-omzetting is een snelle blik het waard, of voer het resultaat terug door een JSON-formatter om te bevestigen dat de structuur intact is gebleven.

XML en JSON passen niet schoon op elkaar. JSON heeft arrays; XML heeft herhaalde elementen. JSON heeft attributen nergens; XML heeft ze overal. De meeste converters kiezen een zinvolle conventie, maar als je XML attributen intensief gebruikt, ziet de JSON die het produceert er een beetje anders uit dan handgeschreven JSON. Dat is verwacht, geen fout.

Nestdiepte telt. CSV is plat, dus diep geneste JSON kan niet altijd in kolommen worden samengevouwen zonder sleutels plat te maken (denk aan adres.stad). De andere kant op wordt een platte CSV een platte array, nooit een boom.

Waarom lokale verwerking hier belangrijk is

Veel data die je wilt converteren is niet van jou om te delen. Gebruikersrecords, interne configuraties, API-sleutels verstopt in een respons, financiële rijen. Veel online converters sturen je plaksel stilletjes naar een server om het werk te doen. Speedor doet dat niet. De conversielogica draait in je browsertabblad, de data steekt het netwerk nooit over en het tabblad sluiten is het enige opruimwerk. Het is ook sneller, want er is geen upload-round-trip, en het werkt offline zodra de pagina is geladen. Gratis, geen aanmelding, geen quota.

Veelgestelde vragen