Elaborazione locale e riservatezza dei dati tabellari
Il processo di conversione dei file avviene interamente all'interno del browser web dell'utente. I file in formato CSV, JSON e XLSX vengono analizzati ed elaborati direttamente sul dispositivo in uso, e il file di output per il download viene generato localmente. Durante questo flusso di lavoro, nessun dato viene caricato sui server di BroBroGo. Questo approccio basato sul client-side garantisce che le informazioni tabellari non lascino il computer dell'utente durante la trasformazione tra i diversi formati.
Formati supportati e parametri di configurazione
Lo strumento gestisce la conversione bidirezionale tra tre dei più diffusi formati di rappresentazione dei dati:
- CSV (Comma-Separated Values): Un formato di testo piatto in cui i dati tabellari sono strutturati riga per riga, con valori separati da un carattere specifico.
- JSON (JavaScript Object Notation): Un formato leggero per lo scambio di dati, basato su coppie chiave-valore e strutture ordinate.
- Excel (XLSX): Il formato standard per i fogli di calcolo elettronici basati su XML.
L'utente può caricare un singolo file alla volta. Il formato di input viene rilevato automaticamente dal sistema analizzando il file caricato. Per la generazione dei file di output, l'interfaccia permette di selezionare il formato di destinazione desiderato e, nel caso in cui si scelga il formato CSV, consente di specificare il delimitatore di campo tra tre opzioni:
- Virgola
- Punto e virgola
- Tabulazione
Regole di conversione e gestione delle strutture dati
La transizione dei dati tra strutture piatte e gerarchiche segue regole logiche precise per preservare l'integrità delle informazioni:
Da Excel a CSV o JSON
La conversione estrae esclusivamente i valori visibili presenti nel primo foglio di lavoro del file Excel. Lo strumento non esegue il calcolo delle formule matematiche o logiche eventualmente presenti nelle celle e non conserva gli stili di formattazione, i colori, i bordi o i font applicati al foglio di calcolo originale.
Da JSON a formato tabellare (CSV o Excel)
Poiché il formato JSON supporta strutture nidificate e non necessariamente piatte, l'algoritmo applica le seguenti regole di mappatura per ricondurre i dati a una griglia bidimensionale di righe e colonne:
- Gli array di oggetti vengono trasformati in righe della tabella.
- Le chiavi di primo livello degli oggetti definiscono i nomi delle colonne.
- Le chiavi degli oggetti annidati vengono appiattite creando percorsi univoci in cui i diversi livelli gerarchici sono separati da punti (ad esempio,
utente.indirizzo.citta). - Gli array di array vengono mantenuti direttamente come righe della tabella.
Diagnostica e gestione degli errori
Durante il caricamento, l'analisi o la scrittura dei file, il sistema esegue controlli di validità strutturale e dimensionale. Se l'operazione non può essere completata, l'interfaccia mostra uno dei seguenti messaggi di errore specifici:
- Se si tenta di avviare la conversione senza aver selezionato un documento: "Selezioni prima un file."
- Se il file caricato non appartiene alle estensioni supportate: "Scelga un file CSV, JSON o XLSX."
- Se la dimensione del file supera i limiti di memoria del browser: "Questo file è troppo grande. Utilizzi un file inferiore a
{max}." - Se si seleziona un formato di output identico a quello di input: "Scelga un formato di output differente."
- In caso di errore generico durante il processo: "Impossibile convertire questo file."
- Se la struttura interna del file CSV è corrotta o non conforme: "Impossibile analizzare questo CSV."
- Se il file JSON presenta errori di sintassi o non è riconducibile a una struttura tabellare: "Questo JSON non è valido o non ha una struttura a tabella."
- Se il file Excel è protetto, corrotto o illeggibile: "Impossibile aprire questo file Excel."
- Se il file di origine è vuoto: "Questo file non contiene righe di tabella."
- Se il set di dati supera i limiti fisici di gestione delle righe: "Questa tabella ha più di
{max}righe." - Se il set di dati supera i limiti fisici di gestione delle colonne: "Questa tabella ha più di
{max}colonne." - Se l'utente interrompe manualmente il processo: "Conversione annullata."
- Se l'elaborazione richiede risorse eccessive che bloccano il browser: "La conversione sta richiedendo troppo tempo. Provi con un file di dimensioni inferiori."
Al termine di una conversione corretta, l'interfaccia mostra un'anteprima dei dati e fornisce le statistiche relative al file generato, indicando il numero di Righe, il numero di Colonne e la dimensione finale dell'Output.
Domande frequenti
I miei fogli di calcolo vengono caricati online?
No. I file CSV, JSON e XLSX vengono analizzati direttamente nel browser e il download viene generato localmente.
Preserva le formule e la formattazione di Excel?
No. Questo strumento converte i valori visibili dal primo foglio di lavoro in una tabella pulita. Non calcola formule né preserva gli stili delle celle.
Come viene convertito un JSON in tabella?
Gli array di oggetti diventano righe, le chiavi degli oggetti diventano colonne e le chiavi degli oggetti annidati vengono appiattite con percorsi separati da punti. Gli array di array vengono mantenuti come righe di tabella.