Come convertire testo CSV in JSON

A cosa serve

Questo convertitore trasforma il contenuto di un CSV, fornito come testo, in dati formattati come JSON. È utile quando hai già righe e colonne in formato CSV e vuoi ottenere una struttura leggibile da un’applicazione o da un altro passaggio del tuo flusso di lavoro.

Il comportamento delle intestazioni dipende dall’impostazione scelta. Per impostazione predefinita, quando sono presenti più righe, la prima viene usata come nomi dei campi e le righe successive diventano record. Puoi disattivare questa corrispondenza se la prima riga contiene dati e non intestazioni. L’output può inoltre usare un livello di indentazione numerico, con valore predefinito pari a 2.

Come convertire il CSV

1. Prepara il contenuto CSV come testo. Mantieni la prima riga come intestazione se vuoi usarla per nominare i campi dei record. Per esempio:

text nome,citta Luca,Roma Sara,Torino

1. Incolla o inserisci il testo nell’area di input del convertitore.

2. Lascia attiva la corrispondenza delle intestazioni quando la prima riga contiene i nomi delle colonne. In questo caso, la prima riga viene riservata ai nomi dei campi e le righe seguenti vengono convertite in record.

3. Disattiva la corrispondenza delle intestazioni quando vuoi trattare ogni riga, inclusa la prima, come dati. Questa scelta è adatta a un CSV privo di intestazioni.

4. Imposta il livello di indentazione JSON, se vuoi modificare la leggibilità dell’output. Il valore iniziale è 2; un valore numerico diverso cambia la formattazione, non la struttura di base dei record.

5. Avvia la conversione e controlla il JSON prodotto insieme al numero di record restituiti.

Come leggere il risultato

Leggi il risultato in due parti: il JSON mostra i record generati, mentre il conteggio indica quanti record sono stati prodotti dalle righe analizzate. Con il mapping delle intestazioni attivo, un esempio con una riga di intestazione e due righe di dati produce normalmente una sequenza JSON di due record, con i campi associati ai nomi presenti nella prima riga. Se disattivi il mapping nello stesso esempio, anche la prima riga viene trattata come dati.

Un input vuoto o composto soltanto da spazi restituisce un array JSON vuoto e un conteggio pari a zero. Se durante l’elaborazione si verifica un’eccezione, l’operazione risulta comunque contrassegnata come riuscita, ma restituisce un array vuoto, conteggio zero e una descrizione dell’errore. Per questo conviene controllare sia il contenuto dell’output sia l’eventuale descrizione dell’errore, invece di basarsi soltanto sullo stato dell’operazione.

Esempio pratico

Hai un CSV con le colonne nome e citta e vuoi ottenere due record JSON usando la prima riga come intestazione.

Inserisci il CSV dell’esempio, lascia attiva la corrispondenza delle intestazioni e avvia la conversione con l’indentazione predefinita.

Il risultato ha la forma di un array JSON di record e include il conteggio dei record prodotti; con una riga di intestazione e due righe di dati, il conteggio atteso è due quando il mapping delle intestazioni è attivo.

Limiti

• Il flusso descritto parte da contenuto CSV fornito come testo e restituisce dati JSON formattati; prepara quindi il contenuto in questo formato prima della conversione.

Errori comuni

• Se la prima riga viene trasformata in un record quando doveva fornire i nomi dei campi, verifica che la corrispondenza delle intestazioni sia attiva. Se invece la prima riga contiene dati, disattiva questa opzione prima di avviare la conversione.

Domande frequenti

Come viene trattata la prima riga del CSV?

Quando il mapping delle intestazioni è attivo e sono presenti più righe, la prima riga viene usata come nomi dei campi e le righe successive diventano record.

Posso convertire un CSV senza intestazioni?

Se disattivi il mapping delle intestazioni, ogni riga viene trattata come dati, inclusa la prima.

Cosa restituisce il convertitore con un input vuoto?

Con un input vuoto o composto soltanto da spazi, il risultato è un array JSON vuoto e il conteggio dei record è zero.