Convertitore online gratuito da JSON a CSV

Un foglio di calcolo, un importatore di database o un sistema di reporting può richiedere CSV tabulare anziché JSON strutturato. La conversione rende i record piatti più facili da modificare in Excel o LibreOffice Calc e fornisce il layout previsto da molti strumenti di importazione in massa.

Cos'è JSON

JSON (JavaScript Object Notation) è un formato di testo costituito da oggetti, array, coppie chiave-valore, numeri, stringhe, valori Boolean e null. Le API Web, le applicazioni browser, i sistemi di configurazione, i database e i linguaggi di programmazione producono comunemente file con estensione .json.

JSON può memorizzare oggetti e array annidati, quindi un record può contenere diversi livelli di dati correlati. Questa flessibilità non corrisponde direttamente a una tabella piatta di un foglio di calcolo. Anche un file JSON Lines o NDJSON, in cui ogni riga è un oggetto JSON separato, richiede una procedura di importazione diversa da quella di un singolo documento JSON standard.

Cos'è CSV

CSV (comma-separated values) rappresenta i record tabulari come righe, con un campo per colonna. La prima riga contiene spesso i nomi delle colonne. Un campo contenente un delimitatore, un carattere di virgolette o un'interruzione di riga deve essere racchiuso tra virgolette; le virgolette all'interno di un campo racchiuso tra virgolette sono normalmente rappresentate da due virgolette.

Excel, LibreOffice Calc, gli importatori di database, i software statistici e gli script di elaborazione dei dati supportano CSV. È adatto per elenchi piatti, filtri, ordinamento e importazioni in massa, ma non conserva nativamente oggetti annidati, array, tipi di dati, formule o formattazione delle celle. Le implementazioni CSV possono utilizzare un punto e virgola o una tabulazione invece di una virgola, quindi è necessario verificare il requisito relativo al delimitatore della destinazione.

Come convertire il file

Per una conversione una tantum, utilizza gratuitamente il convertitore da JSON a CSV su 101convert.com senza installare software:

1. Apri il convertitore e carica il file .json oppure incolla un documento JSON.
2. Se sono disponibili opzioni per la selezione dei campi o l'appiattimento, scegli l'array contenente i record e i campi che devono diventare colonne.
3. Avvia la conversione e scarica il file .csv risultante.
4. Apri il CSV in LibreOffice Calc, Excel o un'altra applicazione per fogli di calcolo e verifica il delimitatore, la codifica dei caratteri, le intestazioni, il numero di righe e alcuni valori rappresentativi.

Non caricare dati riservati o soggetti a normative, a meno che il servizio non sia approvato per tali dati.

Per conversioni ripetibili o private, i moduli json e csv della libreria standard di Python evitano l'installazione di un pacchetto aggiuntivo. Questo esempio presuppone un array di oggetti al livello principale:

import csv
import json

with open("input.json", encoding="utf-8") as source:
    records = json.load(source)

if not isinstance(records, list) or any(not isinstance(record, dict) for record in records):
    raise ValueError("Expected a top-level array of objects")

columns = list(dict.fromkeys(
    key for record in records for key in record
))

with open("output.csv", "w", newline="", encoding="utf-8-sig") as target:
    writer = csv.DictWriter(
        target, fieldnames=columns, extrasaction="ignore"
    )
    writer.writeheader()
    writer.writerows(records)

Salva il codice come json_to_csv.py ed esegui python json_to_csv.py. Lo script conserva l'ordine in cui le chiavi compaiono per la prima volta, scrive celle vuote per le chiavi mancanti e lascia invariati i valori annidati, che non sono adatti a una conversione CSV piatta. La codifica utf-8-sig aggiunge un byte order mark UTF-8 che aiuta alcune versioni di Excel per Windows a rilevare il testo Unicode; utilizza utf-8 semplice quando il sistema ricevente non accetta un byte order mark.

Alcune versioni di Microsoft Excel possono importare JSON tramite Data → Get Data → From File → From JSON. In Power Query, espandi l'elenco o il record al livello principale, espandi i record annidati in colonne, quindi utilizza Close & Load; esporta la tabella risultante con File → Save As e seleziona CSV. Se la versione di Excel installata non dispone di questo connettore, converti prima il file e apri il CSV tramite la relativa finestra di dialogo di importazione. In LibreOffice Calc, utilizza File → Open per il CSV risultante e seleziona UTF-8, il separatore richiesto e il carattere di virgolette corretto.

Limiti di qualità e compatibilità

L'input più semplice è un array al livello principale come [{"id":1,"name":"A"},{"id":2,"name":"B"}]. Un oggetto al livello principale può rappresentare un singolo record, un wrapper contenente l'array reale dei record oppure metadati non correlati. Il convertitore deve identificare l'array previsto prima di produrre righe significative.

Gli oggetti e gli array annidati richiedono una gestione esplicita. Possono essere appiattiti in colonne come address.city, serializzati come testo JSON all'interno di un singolo campo CSV racchiuso tra virgolette oppure omessi. I valori degli array possono essere concatenati in un testo. Convertitori diversi utilizzano criteri diversi, quindi esamina i campi annidati e diverse righe di output invece di controllare solo le intestazioni.

CSV non dispone di una distinzione nativa affidabile tra numeri, date, valori Boolean e stringhe. I software per fogli di calcolo possono convertire automaticamente identificatori, zeri iniziali, numeri interi lunghi o date ISO. Importa le colonne come testo quando la loro rappresentazione originale deve rimanere invariata e verifica che valori vuoti, null e campi mancanti abbiano il significato richiesto.

Utilizza UTF-8 per i caratteri non ASCII e verifica se la destinazione prevede virgole, punti e virgola, tabulazioni, terminatori di riga CRLF o un byte order mark. Considera i CSV non attendibili potenzialmente pericolosi nei software per fogli di calcolo: i valori che iniziano con =, +, - o @ possono essere interpretati come formule. Esamina o neutralizza tali valori prima di aprire il file.