1. Una sola riga di intestazione¶
Il file contiene sempre una, e una sola, riga di intestazione, nella prima riga. Il formato CSV ammette anche file senza intestazione (RFC 4180), ma chi pubblica dati non dovrebbe usare questa possibilità: lo raccomandano anche le Linee guida AgID.
Così sì e così no¶
I nomi delle biblioteche e le spese sono inventati.
Non mettere titoli o note sopra l'intestazione.
Così no
| Biblioteche comunali | |||
|---|---|---|---|
| Dati del 2023 | |||
| comune | biblioteca | anno | spesa_acquisti_euro |
| Palermo | Biblioteca di esempio A | 2023 | 8200.50 |
| Roma | Biblioteca di esempio D | 2023 | 15400.75 |
Così sì
| comune | biblioteca | anno | spesa_acquisti_euro |
|---|---|---|---|
| Palermo | Biblioteca di esempio A | 2023 | 8200.50 |
| Roma | Biblioteca di esempio D | 2023 | 15400.75 |
Le informazioni delle righe tolte vanno nel dizionario dei dati o nella descrizione del dataset. L'anno, se serve, sta in una colonna.
Non unire le celle dell'intestazione: ogni colonna ha una sola cella con il suo nome. Qui indirizzo è una cella unita sulle ultime tre colonne, e i nomi veri stanno nella riga sotto. dug è la denominazione urbanistica generica: via, piazza e simili.
Così no
| biblioteca | indirizzo | ||
|---|---|---|---|
| dug | denominazione | civico | |
| Biblioteca di esempio A | Via | Roma | 10 |
| Biblioteca di esempio D | Via | Cavour | 20 |
Così sì
| biblioteca | dug | denominazione | civico |
|---|---|---|---|
| Biblioteca di esempio A | Via | Roma | 10 |
| Biblioteca di esempio D | Via | Cavour | 20 |
Perché¶
Un programma prende la prima riga come nomi di colonna e tutte le altre come dati. Con le due righe di titolo, Biblioteche comunali diventa il nome della prima colonna, le altre restano senza nome e la vera intestazione finisce fra i dati. Anche la colonna degli importi diventa testo, perché fra i numeri c'è la parola spesa_acquisti_euro, e chi riusa il file deve ripulirlo a mano prima di fare una somma.
Più righe di intestazione aiutano l'occhio di chi legge e ostacolano i programmi. Il CSV non conosce le celle unite: una cella unita lascia celle vuote accanto al nome, e per sapere come si chiama una colonna occorre leggere due righe.
I nomi di colonna descrivono i dati ma non ne fanno parte: un file con l'intestazione e quattro biblioteche ha quattro righe di dati.
Casi particolari¶
File ereditati senza intestazione¶
Meglio aggiungere l'intestazione. Se non puoi, devi dichiarare che manca, nel dizionario dei dati e nella descrizione del dataset: nessun programma può capirlo da solo, perché la prima riga è scritta come tutte le altre.
Per chi pubblica uno schema
In CSVW con "dialect": {"header": false}, in Table Dialect con "header": false, oppure via HTTP con Content-Type: text/csv;header=absent. Chi pubblica uno schema CSVW può mettere nella proprietà dc:description anche le informazioni tolte dalle righe di titolo.
Come si fa nel foglio di calcolo¶
Prima di esportare il CSV:
- Elimina le righe sopra l'intestazione, così che i nomi di colonna stiano nella riga 1.
- Annulla l'unione delle celle e scrivi un nome in ogni colonna.
- Sposta titoli, legende e note in un altro foglio o nel dizionario dei dati.
Per l'esportazione vedi Esportare un CSV da Excel o LibreOffice.
Vedi anche: 2. Una riga per ogni record, 3. Nomi di colonna chiari, 6. Niente totali e subtotali.