Da CSV a JSON: guida pratica (e trappole da evitare)

Il CSV è la lingua dei fogli di calcolo; il JSON è la lingua delle web app e delle API. Prima o poi ti serve passare i dati dall’uno all’altro: per importare un elenco di prodotti, popolare un database o dare in pasto un file a uno script. La conversione sembra banale, ma qualche dettaglio decide se i tuoi dati arrivano intatti.

Come un CSV diventa JSON

Un file CSV è una tabella. Di solito la prima riga contiene i nomi delle colonne:

id,name,city,zip
1,Ana,Vilnius,01100
2,Ben,Austin,73301

La forma JSON più comune è un array di oggetti: un oggetto per riga, con i nomi delle colonne come chiavi:

[
  { "id": 1, "name": "Ana", "city": "Vilnius", "zip": "01100" },
  { "id": 2, "name": "Ben", "city": "Austin", "zip": "73301" }
]

È proprio ciò che produce di default il convertitore da CSV a JSON.

Trappola 1: numeri che non sono numeri

Nota che id è diventato un numero, mentre zip è rimasto una stringa. È voluto. CAP, numeri di telefono, numeri di conto e codici prodotto iniziano spesso con uno zero. Se tratti 01100 come un numero, diventa silenziosamente 1100: un bug che può passare inosservato per mesi.

FileCrafty decide il tipo colonna per colonna: una colonna diventa numerica solo se tutti i suoi valori sono numeri puliti. Basta un valore con uno zero iniziale o non numerico e l’intera colonna resta testo.

Trappola 2: il delimitatore sbagliato

I file “separati da virgola” non sono sempre separati da virgole. In molte impostazioni europee, Italia compresa, Excel salva i CSV con il punto e virgola, perché lì la virgola è il separatore decimale. Anche i file separati da tabulazione (TSV) sono molto diffusi. Il convertitore rileva il delimitatore in automatico, quindi 1;Ana;Vilnius viene diviso correttamente.

Trappola 3: virgole e virgolette dentro i valori

Un valore come "Smith, John" contiene una virgola, quindi nel CSV è racchiuso tra virgolette. Le virgolette all’interno di un valore vengono raddoppiate: "He said ""hi""". Le conversioni ingenue che si limitano a dividere sulle virgole rompono queste righe. Un vero parser CSV, come quello del convertitore, gestisce i campi tra virgolette, le virgole al loro interno e perfino gli a capo dentro una cella.

Trappola 4: le celle vuote

Una cella vuota può significare “nessun valore” oppure “testo vuoto”. In JSON sono due cose diverse: null e "". Verifica cosa si aspetta il sistema in cui stai importando i dati e controlla qualche record dopo la conversione.

Il percorso inverso

Devi trasformare la risposta di un’API di nuovo in un foglio di calcolo? Da JSON a CSV appiattisce gli oggetti annidati in colonne come address.city, e da JSON a Excel ti dà direttamente un file .xlsx. Per controllare o riordinare un JSON prima di usarlo, incollalo nel formattatore JSON: ti indica riga e colonna di ogni errore di sintassi.

I tuoi dati restano privati

Elenchi clienti ed esportazioni contengono spesso dati personali. Il convertitore funziona interamente nel tuo browser, quindi il file non viene mai caricato su un server.

In breve

Trascina il tuo file in Da CSV a JSON, controlla l’anteprima e scarica il risultato. Zeri iniziali, punti e virgola e virgole tra virgolette vengono gestiti per te.