Singola riga intestazione
Le tabelle di dati possono opzionalmente contenere una e una sola riga di intestazione per specificare i nomi dei campi.
Da prendere in considerazione:
-
L'esistenza di più righe di intestazione, mentre possono aumentare l'interpretabilità dei dati per gli esseri umani a causa della loro espressività e formato, rendono difficile l'elaborazione per le macchine, quindi qualsiasi informazione aggiuntiva sui dati deve essere inclusa nella descrizione dei dati utilizzando i metadati appropriati nel dizionario dei dati.
-
I nomi delle colonne inclusi nella riga di intestazione sono un tipo di annotazione o metadati che descrivono ogni colonna e non fanno parte dei dati, cioè non dovrebbero essere considerati quando si conta il numero di righe di dati in una tabella.
-
Per nominare le colonne si devono usare celle singole e in nessun caso celle unite.
-
Si noti che non c'è alcun meccanismo per discernere automaticamente se il primo record in un CSV è una riga di intestazione, poiché è codificato come qualsiasi altro record. Pertanto, è buona pratica specificare la presenza o l'assenza di una riga di intestazione attraverso il dizionario dei dati includendo la proprietà "
title". -
Un altro modo per indicare la presenza o l'assenza della linea di intestazione è un parametro content-type quando il file di dati è trasmesso via HTTP, della forma: Content-Type: text/csv;header=absent.
Esempio 1:¶
non usare celle multiple di intestazione.
Cattiva prassi
| Dati sulle vendite di auto (anni 1998 - 1999) | ||
| Unità espresse in migliaia | ||
| marca | anno | vendite_per_anno |
| chevrolet chevelle malibu | 1998 | 2.5 |
| chevrolet chevelle malibu | 1999 | 2.63 |
| buick skylark 320 | 1998 | 3.4 |
| buick skylark 320 | 1999 | 3.57 |
Buona prassi
| marca | anno | vendite_per_anno |
| chevrolet chevelle malibu | 1998 | 2.5 |
| chevrolet chevelle malibu | 1999 | 2.63 |
| buick skylark 320 | 1998 | 3.4 |
| buick skylark 320 | 1999 | 3.57 |
Le informazioni "Dati di vendita delle auto (anni 1998 - 1999)" e "Unità espresse in migliaia" dovrebbero essere trasferite al dizionario dei dati usando la proprietà "description".
Esempio 2:¶
non usare celle unite.
Cattiva prassi
| marca | contatto_concessionario | |
| concessionario_mail | concessionario_telefono | |
| chevrolet chevelle malibu | mail@concesionario_chevrolet.com | +39-1111111 |
| buick skylark 320 | mail@concesionario_buick.com | +39-2222222 |
Buona prassi
| marca | contatto_concessionario_mail | contatto_concessionario_telefono |
| chevrolet chevelle malibu | mail@concesionario_chevrolet.com | +39-1111111 |
| buick skylark 320 | mail@concesionario_buick.com | +39-2222222 |