P1 Línea única de cabecera opcional¶
Las tablas de datos pueden contener, opcionalmente, una y solo una línea de cabecera para especificar los nombres de los campos.
A tener en cuenta:
-
La existencia de múltiples líneas de cabecera, aunque pueden incrementar la interpretación de los datos para las personas por su expresividad y formato, dificultan el procesamiento para las máquinas, por tanto, cualquier información adicional sobre los datos debe incluirse en la descripción de los mismos utilizando los metadatos apropiados en el Diccionario de Datos.
-
Los nombres de las columnas que se incluyen en la línea de cabecera son un tipo de anotación o metadato que describe cada columna y no forma parte de los datos, es decir, no se debe considerar cuando se cuenta el número de filas de datos en una tabla.
-
Para nombrar las columnas se deben usar celdas simples y en ningún caso, celdas combinadas.
-
Hay que tener en cuenta que no existe un mecanismo para discernir automáticamente si el primer registro de un CSV es una línea de cabecera ya que ésta se codifica como cualquier otro registro. Por tanto, es buena práctica especificar la presencia o ausencia de línea de cabecera, a través del diccionario de datos incluyendo la propiedad "
title
". -
Otra forma de indicar la presencia o ausencia de la línea de cabecera es mediante un parámetro del tipo de contenido cuando el archivo de datos es tr smitido vía HTTP, de la forma: Content-Type: text/csv;header=absent.
Ejemplo 1: No usar múltiples celdas de cabecera¶
Mala práctica
Datos sobre la de ventas de coches (años 1998 – 1999) | ||
Unidades expresadas en miles | ||
marca | año | ventas_por_año |
chevrolet chevelle malibu | 1998 | 2.5 |
chevrolet chevelle malibu | 1999 | 2.63 |
buick skylark 320 | 1998 | 3.4 |
buick skylark 320 | 1999 | 3.57 |
Buena práctica
marca | año | ventas_por_año |
chevrolet chevelle malibu | 1998 | 2.5 |
chevrolet chevelle malibu | 1999 | 2.63 |
buick skylark 320 | 1998 | 3.4 |
buick skylark 320 | 1999 | 3.57 |
La información “Datos sobre la de ventas de coches (años 1998 – 1999)” y “Unidades expresadas en miles”, se debe trasladar al diccionario de datos utilizando la propiedad "description`”.
Ejemplo 2: No usar celdas combinadas¶
Mala práctica
marca | contacto_concesionario | |
concesionario_mail | concesionario_telefono | |
chevrolet chevelle malibu | mail@concesionario_chevrolet.com | +34-1111111 |
buick skylark 320 | mail@concesionario_buick.com | +34-2222222 |
Buena práctica
marca | contacto_concesionario_mail | contacto_concesionario_telefono |
chevrolet chevelle malibu | mail@concesionario_chevrolet.com | +34-1111111 |
buick skylark 320 | mail@concesionario_buick.com | +34-2222222 |