Cos'è un file CSV?
CSV sta per Comma Separated Values (valori separati da virgola). È un formato di file comunemente utilizzato per rappresentare dati tabulari in modo semplice e leggibile.
Un file CSV organizza i dati in righe e colonne, con ciascun valore separato da un delimitatore, solitamente una virgola o, a volte, un punto e virgola.
La prima riga di solito contiene le intestazioni, che definiscono i nomi delle colonne e aiutano a rendere i dati più comprensibili.
Ecco un esempio di come appare un file CSV:
Nome,Cognome,Età,Città
Marco,Rossi,30,Roma
Anna,Verdi,25,Milano
Luca,Bianchi,40,Torino
In questo esempio, abbiamo una tabella con quattro colonne: Nome, Cognome, Età e Città. Ogni riga rappresenta i dati di una persona. I valori di ogni colonna sono separati da virgole, quindi il nome è "Marco", il cognome è "Rossi", l'età è "30" e la città è "Roma".
Informazioni generiche utili da sapere sul formato CSV
In questa sezione troverai due concetti molto importanti sui file CSV:
come inserire testi o numeri che contengono virgole in un file CSV
come lasciare i campi vuoti
Gestione delle virgole nei campi CSV: "Virgolette"
Immagina di dover inserire un numero come 1.550,50 in un file CSV.
Se lo lasci così com’è, il software che legge il CSV penserà che 1.550 sia il valore di un campo e 50 quello del campo successivo, perché interpreterà la virgola come un separatore tra colonne.
Per evitare questo problema, dovresti racchiudere il numero tra virgolette:
Ecco un esempio sul formato CSV
Nome,Cognome,Età,StipendioMensile
Marco,Rossi,30,"1550,50"
Anna,Verdi,25,2540
Luca,Bianchi,40,"3432,65"
In questo modo, il software capisce che 1.550,50 è un valore unico e lo mantiene insieme in un’unica colonna.
Campi vuoti
I file CSV hanno alcune colonne che sono obbligatorie da compilare, mentre altre sono facoltative e possono essere lasciate vuote.
Quando lasci vuota una colonna facoltativa, devi comunque inserire una virgola come separatore.
Questo indica al software che la cella per la colonna facoltativa è vuota e che stai passando alla colonna successiva.
Ecco un esempio di come appare un file CSV con la colonna "Età" facoltativa:
Nome,Cognome,Età,Città
Marco,Rossi,,Roma
Anna,Verdi,25,Milano
Luca,Bianchi,,Torino
In questo esempio, il valore "Età" è facoltativo e non è stato inserito nella prima riga.
Tuttavia, è stata aggiunta una virgola aggiuntiva per indicare il campo "Età" vuoto.
La riga 2, invece, include il valore "Età" e segue il formato normale.
Strumenti per modificare un file CSV
Puoi modificare un file CSV utilizzando diversi tipi di software, a seconda delle tue esigenze e preferenze:
Programmi per fogli di calcolo
Applicazioni come Microsoft Excel, Google Sheets, LibreOffice Calc o Apple Numbers ti consentono di aprire, modificare e salvare file CSV in un formato intuitivo, simile a una tabella.Editor di testo
Semplici editor di testo come Blocco note (Windows), TextEdit (Mac) o editor più avanzati come VS Code, Sublime Text o Notepad++ possono essere utilizzati per modificare i file CSV direttamente come testo semplice.
Nelle sezioni seguenti spiegheremo come modificare un file CSV con un Editor di testo o con Excel.
Come modificare il file CSV di CryptoBooks utilizzando un Editor di testo
Per modificare correttamente il formato CSV di CryptoBooks per le connessioni personalizzate utilizzando un Editor di testo, puoi seguire questi passaggi:
Scarica il file modello CSV da questo [link]. Contiene già le intestazioni richieste al suo interno.
Apri il file con il software di editing di testo sul tuo computer (per gli utenti Mac si chiama TextEdit, per gli utenti Windows si chiama Blocco note).
Ecco come appare il file CSV precompilato con la riga di intestazione.
Mantieni la riga di intestazione racchiusa tra virgolette ("") per evitare che il software interpreti gli spazi tra le parole come separatori di colonna.
Premi Invio sulla tastiera per spostare il cursore su una nuova riga.
Compila i valori necessari seguendo le istruzioni fornite in questo articolo: Guida alla compilazione CSV di CryptoBooks
Una volta inserite tutte le righe che desideri importare, salva il file.
Come modificare un file CSV nel formato di CryptoBooks con Excel
Scarica il file modello CSV da questo link. Contiene già le intestazioni richieste al suo interno.
Apri il file con Microsoft Excel. Ecco come appare il file CSV precompilato con la riga di intestazione.
Fai clic sulla colonna A per selezionare l’intera colonna.
Nel menu di navigazione, fai clic su Dati.
Fai clic su Testo in colonne.
Seleziona Delimitato e poi fai clic su Avanti.
Scegli Virgola e fai clic su Avanti.
Fai clic su Fine.
Ora la tua riga di intestazione verrà visualizzata come segue.
Vai alla cella A2 e inserisci i valori necessari seguendo le istruzioni fornite in questo articolo: Guida alla compilazione del CSV di CryptoBooks
Una volta inserite tutte le righe che desideri importare, salva il file seguendo questi passaggi:
Fai clic su File
Fai clic su Salva con nome
Seleziona la cartella in cui salvare il file
Assicurati che il tipo di file selezionato sia CSV (delimitato da virgola)
Clicca su salva
🚨 Possibile problema con Excel
A volte, durante la creazione e modifica di un file CSV con Excel, vengono apportate modifiche automatiche che invalidano il file e ne impediscono il caricamento.
In questi casi, sarà necessario controllare e correggere il file utilizzando un software di editing di testo.
Ecco un esempio di formattazione errata causata da questo tipo di modifiche automatiche:
Il file compilato sembra corretto utilizzando Excel.
Ma lo stesso file, aperto con un software di editing di testo, mostra che alcune virgolette sono state inserite per errore, sia nell’intestazione che nelle prime due righe.
In questi casi sarà necessario rimuovere l’errore utilizzando l’editor di testo.