Come convertire testo CSV in JSON

A cosa serve la conversione

Il convertitore trasforma il testo CSV che fornisci in una rappresentazione JSON, utile quando devi passare da righe e colonne a una struttura leggibile da altri strumenti. Puoi adattare l’interpretazione al formato dei dati scegliendo il delimitatore, decidendo come trattare la prima riga e regolando l’indentazione. Prima di iniziare, osserva il testo originale: riconoscere il carattere tra i campi aiuta a evitare un risultato inatteso. La gestione delle intestazioni è importante perché determina se le righe regolari saranno associate a nomi di campo oppure trattate senza intestazione. Il risultato va quindi valutato in base alla forma effettiva del CSV inserito, non soltanto all’aspetto desiderato dell’output. Ricorda inoltre che il contenuto deve essere fornito come testo e non può consistere soltanto di spazi.

Come impostare i dati

1. Inserisci nell’area prevista il contenuto CSV come testo. Verifica che non sia vuoto e che non contenga soltanto spazi, perché queste condizioni vengono rifiutate invece di produrre una conversione.

2. Imposta il delimitatore in base al carattere che separa i campi nel testo. La virgola è selezionata come impostazione predefinita; se tra i valori compare il punto e virgola, scegli quest’ultimo.

3. Mantieni attiva la gestione delle intestazioni quando la prima riga contiene i nomi delle colonne. Disattiva questa opzione se la prima riga deve essere elaborata come una riga normale e non deve fornire le chiavi dei record.

4. Scegli il livello di indentazione JSON. L’impostazione predefinita è 2; un valore diverso modifica la disposizione visiva del risultato e può renderlo più compatto o più spazioso.

5. Avvia la conversione e osserva l’esito restituito. Se l’analisi del CSV solleva un’eccezione, l’operazione termina senza fornire un output JSON, quindi occorre controllare la struttura del testo prima di riprovare.

Come leggere l’output

Quando la gestione delle intestazioni è attiva, la prima riga fornisce i nomi usati per i record successivi che hanno lo stesso numero di campi. In questi record, gli spazi presenti all’esterno del testo delle intestazioni e delle celle vengono rimossi. Questo comportamento rende più semplice leggere le coppie tra chiave e valore, ma non corregge una riga con una struttura diversa.

Una riga con meno o più campi rispetto all’intestazione segue infatti un percorso distinto: viene conservata come insieme di valori di riga, invece di diventare un record associato ai nomi delle colonne. Per questo il JSON può contenere forme differenti quando il CSV non è uniforme.

Se l’esito non è riuscito, ricontrolla prima il contenuto inserito, il carattere separatore e la coerenza delle righe. Un errore durante l’analisi impedisce la restituzione del JSON, mentre una differenza nel numero di campi può spiegare la presenza di una riga non associata alle intestazioni.

Esempio pratico

Hai un testo CSV in cui la prima riga contiene i nomi dei contatti e una riga successiva presenta un campo in più rispetto all’intestazione.

Per un elenco di contatti separato da punto e virgola, imposta il punto e virgola come delimitatore, conserva attiva la gestione delle intestazioni, lascia l’indentazione su 2 e avvia la conversione.

Il risultato è una lista JSON nella quale le righe regolari compaiono come record con chiavi ricavate dall’intestazione, mentre la riga con un campo aggiuntivo resta una lista di valori.

Limiti

• Le righe con un numero di campi diverso dall’intestazione mantengono una forma separata, mentre un’eccezione di analisi non restituisce JSON.

Errori comuni

• Se incolli valori separati da punto e virgola ma lasci la virgola, oppure se invii un campo vuoto, l’interpretazione può non corrispondere ai dati; seleziona il separatore presente nel testo e inserisci contenuto CSV non vuoto.

Domande frequenti

Quale delimitatore posso usare nel CSV?

La virgola è il delimitatore predefinito, mentre il punto e virgola è supportato come alternativa. Se il testo usa un altro carattere, verifica che la scelta disponibile corrisponda davvero alla separazione dei campi prima di avviare l’operazione.

La prima riga viene considerata un’intestazione?

Quando la prima riga contiene i nomi delle colonne, lascia attiva la gestione delle intestazioni. Se invece deve essere trattata come una riga di dati, disabilita tale gestione prima della conversione.

Che cosa accade a una riga con campi mancanti o aggiuntivi?

Se la gestione delle intestazioni è attiva e il numero di campi non coincide, la riga viene mantenuta come valori di riga anziché essere trasformata in un record con chiavi. Controlla questa forma nel risultato prima di usarlo.