Vai al contenuto principale

Appiattire JSON annidato

Appiattisci JSON annidato in dati tabellari: scegli separatore dei percorsi e gestione degli array, controlla le colonne ed esporta in CSV o Excel.

  • Esporta
Automatizza

Integra questo widget

Personalizza il risultato, controlla l’anteprima e copia il codice.

Anteprima

Tipo di codice di integrazione

Codice da copiare

Responsive e ridimensionato automaticamente da Bethemesh.

Appiattisci oggetti JSON annidati in colonne con percorsi espliciti per riutilizzarli come dati tabellari.

I tuoi file vengono elaborati localmente nel browser e non vengono mai inviati ai nostri server.

Rilascia qui il tuo file

Dimensione consigliata: fino a 30 MB

Opzioni

Questo strumento ti è stato utile?

Come funziona questo strumento?

Un JSON annidato descrive spesso schede con sotto-oggetti, come cliente.indirizzo.citta, e liste di etichette o contatti. L’appiattimento trasforma questa struttura in colonne denominate secondo i percorsi, per usare i valori in CSV o in un foglio di calcolo. Lo strumento conserva i valori scalari e offre due modalità per gli array interni. Non convalida uno schema applicativo, non seleziona espressioni JSONPath e non genera una riga distinta per ciascun elemento di una lista annidata.

Importa un file JSON fino a 30 MiB. La radice deve essere un oggetto o array; uno scalare isolato come 42 o null viene rifiutato. Un oggetto radice produce una riga. Un array radice produce una riga per elemento: gli scalari finiscono in value, gli oggetti vengono appiattiti. Tutto avviene nel browser. Vale il parser JSON nativo: commenti e virgole finali non sono validi, interi molto grandi possono perdere precisione e chiavi ripetute mantengono l’ultimo valore prima della trasformazione.

Le chiavi dei sotto-oggetti sono unite dal separatore scelto, un punto per impostazione predefinita. Un oggetto indirizzo con citta diventa indirizzo.citta. Il separatore non viene protetto nei nomi originali. Se una chiave letterale indirizzo.citta collide con lo stesso percorso annidato, il processo fallisce anziché sovrascrivere dati. Scegli un separatore assente dalle chiavi oppure rinominale prima. Gli oggetti vuoti restano come testo {} e non scompaiono silenziosamente dalla tabella.

Normalmente ogni array interno rimane in una cella come testo JSON, per esempio ["blu","verde"]. La modalità indice crea invece colonne terminate da 0, 1 e successive, attraversando anche gli oggetti nelle relative posizioni. Non espande array in righe né crea prodotti cartesiani tra liste. Gli array vuoti restano il testo [] in entrambe le modalità. Numeri, booleani e null mantengono tipi scalari; le proprietà assenti appaiono vuote nell’esportazione. Controlla l’anteprima ed esporta CSV o XLSX.

Come usare questo strumento

  1. Controllare radice e chiavi

    Esamina oggetti, array e separatori già presenti nei nomi. Verifica che ogni elemento dell’array radice rappresenti un record desiderato.

  2. Scegliere la gestione degli array

    Mantieni JSON per conservare una lista in una cella oppure usa indice per confrontare posizioni. Nessuna modalità aggiunge righe per elementi interni.

  3. Verificare la tabella

    Controlla un percorso annidato, un array vuoto e una proprietà assente. Verifica identificativi numerici lunghi: la precisione persa durante il parsing non si recupera dopo.

Casi d’uso

Esaminare un’esportazione API

Esponi indirizzi e preferenze in colonne senza copiare manualmente i percorsi annidati.

Preparare una tabella d’importazione

Appiattisci sotto-oggetti per un sistema destinatario che accetta soltanto celle scalari.

Confrontare posizioni fisse

Sviluppa array brevi per indice quando le posizioni hanno significato coerente tra i record.

Esempi

Conservare una lista nella scheda

Con punto e modalità JSON predefiniti si ottengono cliente.nome e cliente.citta; etichette resta testo JSON in una cella.

Input

{"cliente":{"nome":"Ada","citta":"Roma"},"etichette":["pro","attivo"]}

Risultato

cliente.nome;cliente.citta;etichette
Ada;Roma;"[""pro"",""attivo""]"

Esporre le posizioni dell’array

Punto e modalità indice creano punti.0 e punti.1. L’array vuoto resta [] in una colonna punti.

Input

[{"id":1,"punti":[7,9]},{"id":2,"punti":[]}]

Risultato

id;punti.0;punti.1;punti
1;7;9;
2;;;[]

Consigli e buone pratiche

  • Scegli un separatore assente dalle chiavi originali. I punti rendono leggibili i percorsi, ma una convenzione esplicita è più sicura che presumere l’assenza di punti letterali.
  • Salva identificativi lunghi come stringhe nel JSON originale. I numeri JavaScript hanno precisione finita e l’appiattimento non ripara un intero già arrotondato durante la lettura.
  • Evita la modalità indice per array molto lunghi se non serve ogni posizione. Migliaia di colonne generate possono essere meno pratiche del testo JSON completo della lista.

Domande frequenti

La modalità indice crea una riga per elemento?

No. Crea colonne come contatti.0.nome e contatti.1.nome nella stessa riga. Una riga per contatto richiede un’altra trasformazione e una regola esplicita per ripetere gli identificativi. Le liste annidate non vengono combinate automaticamente tra loro.

Perché una collisione blocca l’elaborazione?

Una chiave letterale a.b e un oggetto a contenente b producono lo stesso percorso con punto. Sceglierne uno perderebbe dati. Il motore segnala quindi il conflitto: cambia separatore oppure assegna nomi univoci alle chiavi originali.

Qual è la differenza rispetto a CSV in JSON?

Il convertitore CSV/JSON richiede una tabella piatta con celle scalari. L’appiattimento prepara dati annidati per questo uso. Alcuni array restano testo JSON secondo la modalità scelta e non è garantita la ricostruzione esatta dell’oggetto originale.

Sono accettati tutti i documenti JSON validi?

La radice deve essere un oggetto o array con sintassi JSON standard. Radici scalari isolate vengono rifiutate. I file sono letti nella memoria del browser; il limite di 30 MiB non garantisce comodità con strutture molto profonde o tabelle estremamente larghe.

Strumenti correlati

Strumenti simili o complementari a questo.

Strumenti simili

Converti Excel, CSV e altri formati di foglio di calcolo direttamente nel browser.

Dati e fogli di calcoloIn evidenzaUsa questo strumento

Genera istruzioni SQL INSERT da Excel, CSV o JSON.

Dati e fogli di calcoloUsa questo strumento