Convertire JSON in XLSX

Questa è l’intera distinzione dalla conversione in CSV, e decide tutto il resto. Un programma vuole CSV: fa streaming, ogni routine di importazione lo legge, e non porta formattazione che intralci. Una persona vuole una cartella di lavoro che si apra con le colonne alla larghezza giusta, le intestazioni già come riga di intestazione, e i tipi già corretti.

Se i dati andranno in un database, uno script o una pipeline di analisi, il CSV è la risposta migliore e questa è la pagina sbagliata. Se andranno a un collega che li guarderà, li ordinerà e aggiungerà una colonna, questa è quella giusta, ed è una distinzione che vale la pena fare prima di scegliere il formato, perché la conversione giusta dipende interamente da chi è dall’altra parte.

Un CSV non ha tipi affatto. Excel ne apre uno indovinando un tipo per ogni colonna, e quell’indovinare è dove avviene il danno familiare: gli zero iniziale scompaiono dai CAP e dai codici prodotto, qualunque cosa assomigli a una data diventa una data, e gli identificativi oltre le quindici cifre perdono le ultime cifre a causa della virgola mobile.

Un XLSX dichiara ciò che ogni cella è, quindi nulla è inferito e nulla è riscritto all’apertura. Questa singola differenza rimuove un’intera categoria di conversazioni di supporto, ed è il motivo per cui vale la pena fare il passaggio in più invece di mandare un CSV con una spiegazione allegata, ed è la differenza tra un file che funziona al primo tentativo e uno che richiede una telefonata.

Ogni record diventa una riga e ogni chiave diventa una colonna, con la riga di intestazione presa dalle chiavi stesse. I record che non condividono tutte le chiavi sono riconciliati costruendo l’insieme completo di colonne attraverso il file e lasciando celle vuote dove un record non ha nulla da mettere.

Questa riconciliazione vale la pena conoscerla perché spiega una sorpresa comune. Convertire dieci record per un test può produrre un foglio più stretto che convertendo l’intera esportazione, semplicemente perché il campione non conteneva i campi più rari, ed è il tipo di dettaglio che si vede solo aprendo il file e contando le colonne.

JSON descrive un albero e un foglio di calcolo è una griglia, quindi un oggetto annidato è appiattito unendo i nomi delle chiavi nell’intestazione di colonna. Un livello produce un foglio che chiunque può leggere; due è di solito ancora accettabile.

Oltre degrada in un modo che è ovvio nel momento in cui lo si guarda: le intestazioni diventano lunghe, il foglio diventa molto largo, e la maggior parte delle celle nella maggior parte delle righe sono vuote perché record diversi annidano in modo diverso. Se una conversione produce sessanta colonne da quello che sembrava un’esportazione semplice, è la forma dei dati invece di un difetto, ed è un segnale che il JSON dovrebbe probabilmente restare JSON, ed è una decisione che si fa meglio prima di incollare il risultato a un collega.

Un ordine con cinque voci, un post con un elenco di tag, una persona con diversi indirizzi precedenti, nessuno di questi ha una rappresentazione corretta a riga singola. Le tre risposte disponibili sono una colonna per posizione, una colonna con i valori uniti, o una riga per elemento, e ognuna rompe qualcosa.

Quando gli array portano il significato, fare ciò che farebbe un database: produrre un foglio per i record genitore e uno per i figli, collegati da un identificativo. È più lavoro di una singola conversione ed è l’unica versione con cui un utente di foglio di calcolo può effettivamente ragionare, ed è il tipo di struttura che fa risparmiare ore al primo PivotTable.

L’archivio che ChatGPT, Claude o un cruscotto API consegna è JSON perché quello è ciò che una macchina legge, e la maggior parte delle persone che ne riceve uno non ha uno strumento che lo apra in modo utile. Un foglio di calcolo è la risposta realistica: XLSX dichiara i suoi tipi, quindi i timestamp restano timestamp e gli identificativi numerici lunghi non vengono silenziosamente riscritti in notazione scientifica come accadrebbe a un CSV aperto in Excel.

Funziona bene per le parti piatte, log di utilizzo, righe di fatturazione, elenchi di messaggi con una voce per riga. Funziona male per l’archivio delle conversazioni stesso, che è un albero di nodi di messaggio invece di una tabella, e appiattirlo produce colonne con nomi di percorsi che nessuno vuole leggere. Convertire la parte che serve effettivamente invece dell’intera esportazione, ed è una distinzione che fa risparmiare tempo a chiunque riceva l’archivio.

Guardare il foglio, brevemente. Due cose vale la pena controllare ogni volta: che le colonne di identificativi si leggano come testo invece di essere state formattate come numeri, e che le colonne di data sembrino date invece di numeri a cinque cifre.

E controllare cosa c’è effettivamente dentro. Un’esportazione JSON da un’API contiene ogni campo che l’API restituisce, inclusi identificativi interni, flag, e occasionalmente campi di cui nessuno si era reso conto esistessero. Un foglio di calcolo rende tutto visibile in un modo che un file JSON non fa, il che è una cosa buona da scoprire prima che il file lasci l’organizzazione invece che dopo, ed è il tipo di controllo che evita incidenti.

La conversione gira nella scheda del browser sul proprio processore. Il file non viene mai spedito, non c’è account né tetto giornaliero, e il limite è 100 MB a file.

Questo è più rilevante qui che sulla maggior parte delle conversioni. Un’esportazione JSON è quasi sempre l’output grezzo di un sistema, record di clienti, ordini, submission di moduli, account utente, e consegnarlo a un convertitore di terze parti significa consegnare esattamente i dati di cui un’organizzazione è responsabile. Non spedirlo da nessuna parte è la forma più semplice di non doversi fidare di nessuno con esso, ed è una distinzione che diventa ovvia quando il file è il registro di un cliente.