JSON naar CSV

Voorbeeld

Invoer:

[
  { "id": 1, "user": { "name": "Alice", "email": "a@a.com" }, "tags": ["admin"] },
  { "id": 2, "user": { "name": "Bob",   "email": "b@b.com" }, "tags": ["user", "beta"] }
]

Uitvoering (platte vormen van geneste arrays en samenvoegen van arrays):

id,user.name,user.email,tags
1,Alice,a@a.com,admin
2,Bob,b@b.com,"user,beta"

Keuze van een scheider

Citeringsregels

Een veld moet worden tussen aanhalingstekens geplaatst wanneer het de volgende inhoud bevat:

• het scheidingsteken
• een dubbel aanhalingsteken (dat wordt geëscaped door het te verdubbelen: " -> "")
• een nieuwe regel

“Altijd tussen aanhalingstekens” is veiliger voor de compatibiliteit tussen verschillende tools; “alleen tussen aanhalingstekens wanneer nodig” maakt het bestand handmatig makkelijker leesbaar.

Verwerking van geneste objecten

• Afvlakken: { user: { name: "A" } } wordt een kolom user.name. Diepe paden worden a.b.c.d.
• JSON-string: het geneste object blijft een JSON-waarde in één kolom: "{\"name\":\"A\"}". Handig wanneer downstream-tools dit kunnen parsen.
• Naar tekst omzetten: voegt samen met een scheidingsteken en verliest daardoor de structuur.

Verwerking van arrays

• Samenvoegen: ["a", "b"] wordt in één kolom "a,b".
• Geïndexeerde kolommen: genereert tags.0, tags.1 en tags.2; werkt alleen wanneer de lengte van de array consistent is.
• Alleen het eerste element: neemt alleen tags[0] en negeert de rest.

Veelvoorkomende fouten

• Inconsistente sleutels tussen objecten. Als één object de sleutel phone heeft en een ander niet, krijgt de CSV een kolom phone met lege cellen voor de ontbrekende rijen. Controleer altijd of de set sleutels consistent is.
• De BOM voor Excel vergeten. Excel op Windows leest UTF-8-CSV-bestanden zonder BOM als Latin-1 en verminkt tekens met accenten. De tool biedt een schakelaar “UTF-8 BOM vooraan toevoegen” voor dit geval.
• Nieuwe regels in waarden insluiten. Toegestaan volgens RFC 4180 voor CSV, maar sommige importprogramma's lopen hierop vast. Als uw doelsysteem kwetsbaar is, vervang \n door een spatie of het token \\n.
• Excel als heen-en-weerformaat gebruiken. Excel zet stilletjes 007 om naar 7, kapt lange getallen af en verminkt voorloopnullen in ID's. Gebruik voor gegevensintegriteit CSV met een geschikte parser.