JSON a CSV

Esempio

Input:

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

Output (appiattire annidati, unire array):

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

Scelta del delimitatore

Regole di citazione

Un campo deve essere citato quando contiene:

• il delimitatore
• una doppia virgoletta (che viene eseguita raddoppiando: " -> "")
• una nuova riga

“Citare sempre” è più sicuro per la compatibilità tra strumenti; “citare solo quando necessario” rende il file più facile da leggere manualmente.

Gestione degli oggetti annidati

• Appiattire: { user: { name: "A" } } diventa una colonna user.name. I percorsi profondi diventano a.b.c.d.
• Stringa JSON: l’oggetto annidato rimane come un valore JSON a colonna singola: "{\"name\":\"A\"}". Utile quando gli strumenti downstream possono analizzarlo.
• Stringificare: unisce con un separatore, perdendo la struttura.

Gestione degli array

• Unire: ["a", "b"] diventa "a,b" in una singola colonna.
• Colonne indicizzate: produce tags.0, tags.1, tags.2, funziona solo quando la lunghezza dell’array è coerente.
• Solo primo elemento: prende tags[0] e ignora il resto.

Errori comuni

• Chiavi disuguali tra oggetti. Se un oggetto ha phone e un altro no, il CSV ottiene una colonna phone con celle vuote per le righe mancanti. Valida sempre che il set di chiavi sia coerente.
• Dimenticare BOM per Excel. Excel su Windows legge i CSV UTF-8 senza BOM come Latin-1 e distorce i caratteri accentati. Lo strumento offre un’opzione “prefisso UTF-8 BOM” per quel caso.
• Incorporare nuove righe nei valori. Legale nel CSV RFC 4180, ma alcuni importatori si bloccano. Se il tuo target è fragile, sostituisci \n con uno spazio o un token \\n.
• Utilizzare Excel come formato di andata e ritorno. Excel converte silenziosamente 007 in 7, tronca numeri lunghi e corrompe zeri iniziali negli ID. Per l’integrità dei dati, utilizza CSV con un parser adeguato.