Federador. Manual de Usuario

Transcripción

1 Federador Manual de Usuario Madrid 01/12/2015

2 Contenidos 1 Introducción Descripción del Federador Utilización del Federador Catálogo del Organismo Generación del feed Configuración del Federador para un Organismo Configuración del Federador por el administrador de datos.gob.es Anexo I. Listado de metadatos Anexo II. Listas de valores válidos por tipo de metadato Anexo II. a. Valores válidos para los identificadores Anexo II. b. Valores válidos para los nombres Anexo II. c. Valores válidos para los organismos publicadores Anexo II. d. Valores válidos para las fechas Anexo II. e. Términos de las categorías (sectores) Anexo II. f. Valores válidos para los idiomas Anexo II. g. Términos de la cobertura geográfica Anexo II. h. Valores válidos para la frecuencia de actualización Anexo II. i. Valores válidos para los formatos de las distribuciones Anexo III. Formato ATOM Anexo III. a. Esquema XML extendido ATOM Anexo III. b. Plantilla ATOM Anexo IV. Formato DCAT/RDF Anexo IV. a. Plantilla RDF/XML FEDERADOR - Manual de Usuario 2

3 1 Introducción Datos.gob.es es el portal web institucional que alberga el Catálogo de Información Pública reutilizable definido en el artículo 5 del Real Decreto 1495/2011, de 24 de octubre, por el que se desarrolla la Ley 37/2007, de 16 de noviembre, sobre reutilización de la información del sector público, para el ámbito del sector público estatal. Este Catálogo ofrece un punto único de acceso a todos los recursos de información pública reutilizables puestos a disposición por las Administraciones y organismos del sector público. De esta manera, las empresas o ciudadanos interesados en reutilizar datos públicos pueden localizar la información que deseen sin necesidad de conocer la estructura y reparto competencial de la Administración. Artículo 5. Catálogo de Información Pública reutilizable. 1. La Secretaría de Estado para la Función Pública del Ministerio de Política Territorial y Administración Pública y la Secretaría de Estado de Telecomunicaciones y para la Sociedad de la Información del Ministerio de Industria, Turismo y Comercio mantendrán un catálogo de información pública reutilizable correspondiente, al menos, a la Administración General del Estado y a los demás organismos y entidades a que se refiere el artículo 1.2, que permita acceder, desde un único punto, a los distintos recursos de información pública reutilizable disponibles. 2. Este catálogo será accesible, al menos, desde el punto de acceso general previsto en el artículo 8 de la Ley 11/2007, de 22 de junio, de acceso electrónico de los ciudadanos a los Servicios Públicos, y podrá enlazar e interoperar con iniciativas similares de la propia Administración General del Estado o de otras Administraciones Públicas en las condiciones que se convengan por ambas partes y en el marco de lo previsto en el presente real decreto. 3. Los órganos de la Administración General del Estado y los restantes organismos y entidades enumerados en el artículo 1.2 colaborarán con los departamentos ministeriales mencionados en el apartado 1 para la confección y el mantenimiento de dicho catálogo y asimismo serán responsables de la actualización constante de la información sobre los documentos reutilizables correspondiente a los mismos contenida en el citado catálogo, asegurando la plena coherencia del mismo con la información facilitada conforme al apartado 1 del artículo 4 de este real decreto. RD 1495/2011 El Catálogo es de libre acceso y puede consultarlo cualquier usuario desde la sección Catálogo de datos del portal datos.gob.es, mediante un buscador de texto libre y los filtros disponibles. Además, también se permite la descarga masiva de todo el Catálogo en los siguientes formatos: - Excel (.xlsx) FEDERADOR - Manual de Usuario 3

4 - ATOM 1.0 extendido. - RDF/XML. Este Catálogo contiene una ficha descriptiva para cada recurso de información formada por los metadatos especificados en el Anexo III de la Norma Técnica de Interoperabilidad de Reutilización de recursos de información. Los recursos de información se encuentran alojados en los sistemas de información del organismo responsable, en datos.gob.es se almacenan únicamente los metadatos que describen los recursos de información, entre los que se encuentra la URL pública que permite el acceso al volcado o consulta del recurso de información. FEDERADOR - Manual de Usuario 4

5 V. Descripción de la información reutilizable 1. Para la descripción de los documentos y recursos de información reutilizables puestos a disposición pública se asociarán los metadatos mínimos recogidos en el anexo III; para los valores de ciertos metadatos se tendrá en cuenta lo establecido en los anexos IV y V. NTI de Reutilización de recursos de información FEDERADOR - Manual de Usuario 5

6 FEDERADOR - Manual de Usuario 6

7 Los órganos de la Administración General del Estado y demás entes, organismos y entidades pertenecientes al sector público estatal son responsables del alta y actualización constante de la información sobre los recursos de información reutilizables de su competencia en el Catálogo. Además, estos organismos deben informar de manera estructurada y usable sobre qué recursos de información son susceptibles de ser reutilizados, preferiblemente desde un espacio dedicado en su sede electrónica. Artículo 4. Información sobre los documentos susceptibles de reutilización. 1. Los órganos de la Administración General del Estado y los demás organismos y entidades a que se hace referencia en el artículo 1.2 informarán de manera estructurada y usable, preferentemente a través de un espacio dedicado de su sede electrónica con la ubicación «sede.gob.es/datosabiertos», sobre qué documentación es susceptible de ser reutilizada, los formatos en que se encuentra disponible, las condiciones aplicables a su reutilización, indicando la fecha de la última actualización de los documentos reutilizables, proporcionando, cuando esté disponible, la información complementaria precisa para su comprensión y procesamiento automatizado y facilitando al máximo la identificación, búsqueda y recuperación de los documentos disponibles para su reutilización mediante mecanismos tales como listados, bases de datos o índices de información reutilizable. RD 1495/2011 Por tanto, los organismos del sector público estatal deben informar por dos vías diferentes sobre los recursos de información reutilizables que poseen: desde datos.gob.es y desde su espacio web de datos abiertos, asegurando la plena coherencia entre la información presenten en ambos espacios web. Con el objetivo de garantizar la coherencia de la información y simplificar el trabajo de los técnicos a la hora de informar sobre los recursos de información reutilizable, se ha incorporado a datos.gob.es la herramienta Federador que permite la agregación y publicación automática de los metadatos de recursos de información a partir de los conjuntos de datos publicados por los organismos en su propio espacio de datos abiertos. La herramienta Federador permite también enlazar e interoperar datos.gob.es con las iniciativas de Datos Abiertos de las Comunidades Autónomas y de las Entidades Locales que ya estén en marcha. FEDERADOR - Manual de Usuario 7

8 El presente documento ofrece información de cómo funciona el Federador y las pautas a seguir para uso por cualquier organismo público. FEDERADOR - Manual de Usuario 8

9 2 Descripción del Federador El Catálogo de Información Pública reutilizable, alojado en datos.gob.es, permite que las personas designadas por cada organismo gestionen los recursos de información; incorporando, modificando o eliminando los metadatos que describen cada conjunto de datos o recurso de información. Para poder realizar esta labor es necesario contar con una cuenta de usuario válida con rol organismo. La solicitud de cuenta de usuario se realiza desde el portal datos.gob.es, accediendo al Área de gestión, pulsar en Registrarse como Organismo Público y pulsando en el botón Crear nueva cuenta. La cuenta tiene que tener el visto bueno del responsable operativo RISP, interlucutor del organismo válido con datos.gob.es sobre los temas RISP del organismo. El Catálogo de datos, ubicado en datos.gob.es, permite publicar los metadatos de los conjuntos de datos registrados manualmente de los diferentes organismos asociados. Estos metadatos son registrados y actualizados por un usuario correctamente registrado en el portal datos.gob.es y con un perfil con los permisos adecuados. El sistema de federación de metadatos de conjuntos de datos de datos.gob.es (Federador), permite la agregación y publicación automática de los metadatos de los conjuntos de datos publicados por los organismos en su propio portal. El Federador de datos.gob.es, accederá a esta información en los portales de los organismos mediante un feed previamente publicado en su web en formato ATOM o RDF. FEDERADOR - Manual de Usuario 9

10 Esta guía contiene explicaciones detalladas de cómo componer feeds a partir de esquemas definidos para la federación. Dichos esquemas se basan en las especificaciones de la Norma Técnica de Interoperabilidad para la Reutilización de Información del Sector Público ( Así pues, los principales aspectos que se recogen en esta guía, relativos al federador, son: Catálogo de Organismo Generación Feed Configuración Federador Ejecución Proceso FEDERADOR - Manual de Usuario 10

11 3 Utilización del Federador 3.1 Catálogo del Organismo El objetivo del Federador es la agregación automática de los catálogos particulares de cada uno de los organismos asociados. Por ello, el punto de partida debe ser el catálogo propio del organismo donde se publiquen los conjuntos de datos (conjunto de datos) ofrecidos. A su vez, los conjuntos de datos estarán asociados a una descripción mediante metadatos basados en los especificados dentro del anexo III de la Norma Técnica de Interoperabilidad RISP y taxonomías e identificadores del anexo IV y V respectivamente dentro de la misma NTI. Estos metadatos, taxonomías e identificadores se detallan en esta guía dentro del Listado de metadatos y Listas de valores válidos por tipo de metadato. El catálogo consistirá, habitualmente, en un portal en el sitio web del organismo donde los usuarios podrán realizar consultas. Para ello cada organismo utilizará las tecnologías más adecuadas en función de sus infraestructuras existentes y capacidades. Aún en el caso de que el Organismo no disponga de Catálogo de conjunto de datos propio, se podría realizar la integración con el Federador generando un feed tal y como se detalla más adelante. 3.2 Generación del feed Como se ha comentado, el mecanismo de integración entre el catálogo del organismo y datos.gob.es se realizará mediante un feed de metadatos. La generación de este feed se realizará a partir de un fichero que contendrá la información del Catálogo del Organismo y sus conjuntos de datos. Básicamente, hay dos normas principales a seguir por un organismo a la hora de publicar su feed de metadatos: 1. El feed construido debe ser publicado a través de una URL estable que no cambie en el tiempo: Una vez construido el fichero del feed en el formato elegido, independientemente de si ha sido generado de forma manual o automática, debe ser FEDERADOR - Manual de Usuario 11

12 posicionado en una URL. Típicamente esta URL formará parte del dominio web del organismo en cuestión como parte de su portal. La URL de publicación del feed no deberá cambiar en el tiempo. Será la URL que se configure en datos.gob.es para recuperar los metadatos. Por tanto, si esta URL cambia en el futuro, habría que reconfigurar los datos en el catálogo. Se recomienda establecer una URL clara y entendible (semántica) para posicionar el feed del federador. Si ya existe una sección del dominio web del organismo dedicada a feeds rss, una buena opción sería situar también el feed ahí. Un par de ejemplos de URLs podrían ser las siguientes: El feed debe ser actualizado con la frecuencia necesaria para que sus metadatos se actualicen con la misma frecuencia que los conjunto de datos publicados por un organismo: De forma independiente de cómo se genere el fichero del feed, manual o automáticamente, el organismo debe asegurarse de que los metadatos del feed se actualizan de forma adecuada para reflejar con exactitud la información de los conjuntos de datos publicados por el organismo. Para los organismos cuyos metadatos cambien semanal o diaria se recomienda algún sistema automatizado para la generación del fichero del feed ( sin cambiar su URL de publicación!). Nota: para el correcto funcionamiento del Federador el fichero debe ser inferior a 15Mb. Si su fichero es mayor de este tamaño pónganse en contacto con soporte@datos.gob.es Formatos El Federador da soporte a feeds en los siguientes dos formatos: - ATOM 1.0 extendido FEDERADOR - Manual de Usuario 12

13 - DCAT/RDF A continuación se presentan las particularidades de ambos formatos Feeds en formato Atom 1.0 extendido El primer formato propuesto para la publicación, o sindicación, de los metadatos de los conjunto de datos por parte de los organismos ha sido Atom ATOM es la tecnología de sindicación más avanzada actualmente, entre otras cosas por su modularidad y extensibilidad, lo que incluye el uso de un namespace propio que permite la validación de los feeds. Además, la especificación de Atom ha sido diseñada para la fácil extensión de feeds mediante el uso de elementos de otros namespaces. En el caso de la federación de metadatos con datos.gob.es se hace un gran uso de los términos de la iniciativa Dublin Core Metadata Initiative 2. Como Atom no cuenta con elementos adecuados para representar algunos metadatos necesarios en el modelo de datos de datos.gob.es, ni tampoco otros esquemas de metadatos como Dublin Core los tienen, se ha creado un esquema XML adicional que extiende el esquema original ATOM. A este esquema se le ha asignado el namespace y el prefijo fed. En el anexo Anexo III se puede consultar el detalle de los esquemas utilizados así como una plantilla que se puede utilizar como base para la generación del Feed en formato ATOM 1.0 extendido Formato DCAT/RDF Aparte de la publicación de sus metadatos a través de un feed en formato Atom extendido, el proceso de federación del Catálogo ofrece a un organismo la posibilidad de hacerlo en otro formato: DCAT/RDF. 1 Atom 1.0: 2 Dublin Core Metadata Initiative (DCMI): FEDERADOR - Manual de Usuario 13

14 RDF 3 es el modelo de datos estándar para el intercambio de información en la web. Su especificación ha sido desarrollada por el W3C 4. RDF es, entre otras cosas, un framework semántico que permite el desarrollo y estandarización de vocabularios que describan dominios de información muy específicos. En el ámbito de los catálogos de datos y los conjuntos de datos de organismos oficiales se ha especificado el vocabulario estándar Data Catalog Vocabulary (DCAT) 5. Por tanto, un feed de metadatos para la federación con el portal del Catálogo podrá ser publicado en formato RDF empleando un subconjunto de los términos definidos por DCAT. La descripción formal de los términos de la ontología se encuentra publicada en los formatos RDF/Turtle 6 y RDF/XML Validación de feeds en formato DCAT/RDF En el framework RDF no existe una solución de validación de esquemas estándar tal como lo es XSD para XML. Las tecnologías RDFS y OWL permiten definir las ontologías que dan semántica (significado mediante clases y atributos) a documentos RDF. Pero la suposición de mundo abierto en RDF no permite inferir y/o chequear restricciones sobre la información publicada. Por otro lado, RDF sí cuenta con validadores formales que permiten chequear la validez de documentos RDF: W3C RDF Validation Service 8. Chequea la validez de un documento listando los errores encontrados y devuelve la lista de tripletas RDF parseadas. 3 RDF: 4 W3C: 5 DCAT: FEDERADOR - Manual de Usuario 14

15 Otros validadores no oficiales. Por ejemplo, el RDF Validator and Converter 9 en además del chequeo de validación permite convertir los documentos entre las serializaciones RDF/XML y RDF/Turtle (o N3). Si se opta por la federación de metadatos a través de este formato, se recomienda por tanto el uso de alguno de estos validadores para comprobar que el feed publicado es correcto. 3.3 Configuración del Federador para un Organismo Una vez que un organismo ha publicado un feed de metadatos de sus conjuntos de datos publicados ya puede participar en el programa de federación de metadatos del portal datos.gob.es. Para ello debe contar con un usuario de tipo 'Organismo' en el portal que debe estar previamente validado y activo. No todos los usuarios de organismos tienen por qué tener un feed de metadatos asociado, los usuarios pueden seguir actualizando las descripciones de los conjunto de datos del catálogo y dando otros de alta in situ en el propio datos.gob.es. Para los usuarios de organismo que quieren establecer la federación automática de sus conjuntos de datos mediante un feed de metadatos se ha creado un nuevo apartado en el portal: "Federador (Usuarios de organismos)". Podemos acceder a este nuevo apartado de configuración desde los datos de la cuenta del Organismo: Mi cuenta Editar Federador (Usuarios de organismos) 9 FEDERADOR - Manual de Usuario 15

16 Desde esta pantalla el usuario puede establecer su feed: Los datos que debe rellenar el usuario son: FEDERADOR - Manual de Usuario 16

17 Dato Habilitar federación mediante un feed de metadatos. URL del feed Descripción Checkbox que debe ser marcado para que el feed del usuario sea incluido en los procesos de federación. URL donde se encuentra el feed de metadatos. Nota: si se cambia esta URL se borrarán todos los conjuntos de datos asociados a ese usuario y se cargarán, como nuevos, todos los disponibles en la nueva dirección. Recibir notificación del proceso de federación Tipo del feed de matadatos Frecuencia de actualización del feed de matadatos Checkbox que debe ser marcado si se desea recibir un correo electrónico con el resumen de la federación una vez haya concluido el proceso. Selector para identificar el tipo de feed: puede ser ATOM o DCAT(RDF) Selector para establecer el periodo con que se actualiza el feed del organismo. Puede tomar cuatro valores: {1,2,7,15} días. Una vez establecidos estos datos, el feed del usuario ya entraría en el grupo de feeds procesador por el módulo. Con el fin de facilitar la gestión de la federación, se recomienda que un usuario de organismo no actualice de forma manual los conjuntos de datos si ya tiene asociado a su cuenta y en funcionamiento un feed de metadatos (salvo ajuste puntual). Si es necesario que un mismo organismo gestione algunos de sus conjuntos de datos de forma manual, mientras que otros se actualicen de forma automática a través de un feed, debe tener en cuenta que un conjunto de datos dado de alta de forma manual, no se borra ni actualiza via federación (aun estándo gestionado por el mismo usuario). Una vez establecida la configuración del feed podemos lanzar de forma manual el proceso para comprobar que los datos introducidos son correctos. Para ello accedemos a la opción FEDERADOR - Manual de Usuario 17

18 Federador del menú superior morado: Desde aquí podemos lanzar el proceso a través del botón Lanzar proceso de federador ahora y consultar posteriormente el informe generado para comprobar que se han procesado los conjuntos de datos que hemos incluido en el feed. El último informe se colocará como primera entrada de la tabla con los informes. Para consultar los detalles de un determinado informe hay que pulsar sobre el ID o fecha del informe y aparecerá una nueva pantalla con toda la información de la federación realizada: FEDERADOR - Manual de Usuario 18

19 Los distintos campos que podemos encontrar en el informe del proceso de federación son: Dato Descripción Identificador Fecha Tipo de ejecución Usuario Resumen URL del feed Total datasets Datasets nuevos Datasets eliminados Nª que identifica el proceso de federación dentro del sistema. Fecha y hora en la que concluyó el proceso de federación Manual o automática ID del usuario que lanzó la federación, junto con el nombre de usuario y la indicación de si se envió un al usuario con el resumen del proceso. Principales cifras del proceso de federación URL en la que se encuentra accesible el feed federado Número total de conjuntos de datos que hay en el feed Número de conjuntos de datos nuevos, que se han federado con respecto a los que estaban previamente cargados en datos.gob.es Conjuntos de datos que son eliminados cuando el federador está configurado de manera que borra FEDERADOR - Manual de Usuario 19

20 previamente todos los conjuntos de datos del usuario y despues genera como nuevos todos los conjuntos de datos presentes en el feed (ver apartado Configuración del modo de federación). Datasets actualizados Datasets no actualizados Datasets erróneos Datasets eliminados en origen Número de cojuntos de datos que ya existían pero que han sido actualizados debido a que tienen cambios en alguno de sus campos Número de cojuntos de datos que ya estaban en el catálogo y no han sufrido cambios con respecto a federaciones previas Número de conjuntos de datos con errores que requieren la revisión por parte del organismo Número de conjuntos de datos que en federaciones anteriores estaban en el feed pero que ahora han sido eliminados Una vez validada la correcta ejecución del proceso con el lanzamiento manual no es necesario volverlo a lanzar manualmente ya que este se lanzará de forma periódica con la frecuencia que hayamos indicado en la configuración del feed. No obstante, es preciso comentar que el administrador de datos.gob.es tiene la postestad de fijar el periodo mínimo de ejecución de la federación automática. De manera que si el administrador fija un periodo de 2 días, aunque el usuario del organismo indique que la federación se realice cada día, no se ejecutará más que cada 2 días. De igual forma, si el usuario del organismo ha fijado un periodo de 5 días y el administrador de datos.gob.es un periodo mínimo de un día, el organismo no se federará hasta que no se cumplan los 5 días estipulados. FEDERADOR - Manual de Usuario 20

21 3.4 Configuración del Federador por el administrador de datos.gob.es Los administradores de datos.gob.es tienen opciones adicionales para ayudarles a gestionar el funcionamiento del Federador. A continuación, en este apartado, se muestran cuales son estas opciones: Configuración del modo de federación El Federador puede configurarse para que permita la publicación de contenido directamente tras federarse o por el contrario, sea necesaria una validación posterior a la federación para publicar los conjuntos de datos federados. Cuando está configurado de manera que es necesaria la validación, los contenidos federados sólo serán visibles por el usuario del organismo y el administrador de datos.gob.es hasta que sean validados. Además, en los apartados anteriores hemos comentado que el federador actualiza el contenido existente en el portal con la información que se encuentra en el feed pero también permite la opción de que la federación elimine todos los conjuntos de datos que tenía el usuario asociados y cree de nuevo todo el contenido que encuentre en el feed. Esta última opción, de borrar el contenido y volverlo a cargar, está reservada para circustancias puntuales donde sea neceario realizar así la federación, será acordada entre el usuario y el administrador y se utilizará cuando no interfiera al resto de federaciones. FEDERADOR - Manual de Usuario 21

22 3.4.2 Desactivar las federaciones El usuario administrador podrá detener puntualmente la federación automática de todos los usuarios cuando sea necesario por causas del servicio. Igualmente, el administrador podrá desactivar la posibilidad de que se lancen federaciones de forma manual Configuración cuando se realizan las federaciones automáticas Cómo ya se ha comentado anteriormente el administrador fijará la frecuencia máxima de las federaciones. Además, podrá configurar la hora de ejecución de las federaciones automáticas para hacer las coincidir con horas de menor de actividad en los sistemas y el nº de días que desea que se almace la información de las federaciones realizadas en el sistema Informes de las federaciones realizadas El administrador tiene acceso a los informes de todas las federaciones realizadas en el sistema, tnato automáticas como manuales lanzadas por los usuarios. FEDERADOR - Manual de Usuario 22

23 3.4.5 Listado de organismos con la federación activa El usuario adminsitrador de datos.gob.es tiene acceso a una pantalla que muestra todos los usuarios que tiene activa la federación y al URL del feed que tiene configurado Listado de federaciones en curso El usuario de administración de datos.gob.es puede consultar si está en curso algún proceso de federación en un momento determinado y tiene acceso a los logs del sistema donde puede consultar el detalle de todos los pasos del proceso y detectar posibles problemas. Adicionalmente, conociendo el identificador que el sistema asigna a cada conjunto de datos, puede consultar el detalle de cómo se ha procesado cada campo: Esto es gran utilizad a la hora de detactar errores en la información que los organismos incluyen en el feed. FEDERADOR - Manual de Usuario 23

24 Anexo I. Listado de metadatos Las siguientes tablas describen cada uno de los metadatos definidos por la NTI RISP y que pueden/deben formar parte de los feeds publicados por los organismos. Debajo del nombre de cada metadato aparece entre llaves clave que identifica ese metadato en las plantillas propuestas posteriormente. Las columnas 'R' y 'M' en cada tabla marcan si el dato es requerido y múltiple respectivamente. Esta primera tabla se lista los metadatos generales del catálogo del organismo. Catálogo general (datos del organismo) {dominio dcat:catalog} Metadato Descripción Propiedad R M Identificador Identificador único de este catálogo. Es opcional, dct:identifier pero se recomienda que sea la propia URL del feed donde se recogen los metadatos. Nombre Título o descripción corta de este catálogo del organismo. Elemento obligatorio. dct:title Descripción Descripción textual larga de este catálogo del organismo. Elemento obligatorio. dct:description Órgano publicador URL del organismo que publica el catálogo de dct:publisher datos. Elemento obligatorio, debe seguir el formato establecido por la NTI. (ver Anexo II.Anexo II. c) Tamaño del catálogo Entero que especifica el número de conjunto de dct:extent datos publicados por este feed. Es opcional. Fecha de creación Fecha de creación del catálogo. Elemento dct:issued obligatorio, indicará la fecha en que se creó el feed. (ver Anexo II.Anexo II. d) Fecha de actualización Fecha de actualización del catálogo. Elemento dct:modified FEDERADOR - Manual de Usuario 24

25 obligatorio, indicará la fecha en que se actualizó el feed. (ver Anexo II.Anexo II. d) Temáticas Enlace (URL) a la taxonomía de temáticas usada dct:themetaxon por los conjunto de datos. La NTI recomienda especificar: omy Idiomas Idiomas en los que se encuentran los datos del dc:language catálogo. Se deben usar los códigos del estándar RFC 1766 (Ver Anexo II.Anexo II. f). Se pueden indicar varios códigos de idioma. Cobertura geográfica Cobertura geográfica que abarca los datos del dct:spatial catálogo. Se deberá indicar mediante identificadores a nivel nacional, regional o provincial. (ver Anexo II.Anexo II. g) Página web Enlace (URL) a la página web con la descripción del catálogo y sus conjuntos de datos. foaf:homepage Términos de uso Enlace (URL) a una página web con los términos de uso generales del catálogo. dct:license Un catálogo está compuesto de uno o más conjunto de datos. En esta segunda tabla se describen los metadatos de cada conjunto de datos del feed: Conjunto de datos (datos de cada conjunto de datos o entrada en el registro del Catálogo Nacional) {dominio dcat:dataset} Metadato Descripción Propiedad R M TAMAÑO Identificador Identificador único de un conjunto de datos del dct:identifier Máximo organismo. Es obligatorio y se recomienda que 60 sea una URL basada en la URL del feed {cat- caracteres identificador}. No debe ser modificado en el FEDERADOR - Manual de Usuario 25

26 tiempo. Nombre Título o nombre de este conjunto de datos. dct:tittle Máximo 255 caracteres Descripción Descripción textual larga del conjunto de datos. dct:description Sin límite Fecha de creación Fecha de creación del conjunto de datos. Es la dct:issued fecha inicial de publicación, no la fecha de actualización o modificación de los datos. (ver Anexo II.Anexo II. d) Fecha de última Fecha de actualización de los datos del conjunto dct:modified actualización de datos, la fecha en que se modificaron sus datos. (ver Anexo II.Anexo II. d) Frecuencia de Frecuencia aproximada en que se producen dct:accrualperi Ver Anexo actualización actualizaciones de los datos del conjunto de odicity II.h datos. Se recomienda especificar periodos normalizados con formato ISO (ver Anexo II.Anexo II. d) Temáticas Temáticas o materias sobre las que tratan los dcat:theme Ver Anexo datos del conjunto de datos. Puede tener varios valores de entre los definidos por los términos en II.e la NTI (ver Anexo II.Anexo II. e). Etiquetas Palabras clave asociadas a los datos del conjunto dcat:keyword Máximo de datos. Pueden especificarse varias. 255 caracteres Idiomas Idiomas en los que se encuentran los datos del dc:language Ver Anexo conjunto de datos. Se deben usar los códigos del estándar RFC 1766 (Ver Anexo II.Anexo II. f). Se II.f pueden indicar varios códigos de idioma. FEDERADOR - Manual de Usuario 26

27 Órgano que expone y URL del organismo que publica el conjunto de dct:publisher Anexo II.b publica los datos datos. Elemento obligatorio, debe seguir el formato establecido por la NTI. (ver Anexo y II.c II.Anexo II. c) Condiciones de uso Enlace (URL) a una página web con información dct:license Máximo detallada acerca de la licencia (condiciones de reutilización) aplicables al conjunto de datos. La 255 caracteres URL debe cumplir la RFC3986 para ser válida. Normativa Enlaces (URLs) a documentos normativos (en dct:conformsto Máximo algunos casos legales) con información relativa a los datos del conjunto de datos. La URL debe 255 caracteres cumplir la RFC3986 para ser válida. Cobertura geográfica Cobertura geográfica que abarca los datos de los dct:spatial Ver Anexo conjunto de datos. Se deberá indicar mediante identificadores a nivel nacional, regional o II.g provincial. (ver Anexo II.Anexo II. g) Cobertura temporal Cobertura temporal que abarcan los datos del conjunto de datos. (ver Anexo II.Anexo II. d) dct:temporal Vigencia del recurso Fecha de valided de los datos del conjunto de dct:valid datos, la fecha en que se estima una modificaron o actualización de sus datos. (ver Anexo II.Anexo II. d) Recurso(s) relacionado(s) Enlaces a recuros relacionados con el conjunto de dct:references Máximo datos. Las URLs deben cumplir la RFC3986 para ser válidas. 255 caracteres Por último, un conjunto de datos o conjunto de datos puede tener asociadas una o varias distribuciones de los datos que lo forman, cada una en un formato diferente. Esta tercera tabla FEDERADOR - Manual de Usuario 27

28 lista los metadatos de cada distribución de un conjunto de datos: Distribución (datos de cada fichero de datos de un conjunto de datos) {dominio dcat:distribution} Metadato Descripción Propiedad R M Tamaño Identificador Identificador único de la distribucción. Se recomienda que sea una URL basada en la URL del feed {catidentificador}. No debe ser modificado en el tiempo. dct:identifier Máximo 255 caracteres Nombre Título o nombre de la distribucción dct:tittle Máximo 255 caracteres URL de acceso URL de acceso al fichero con los datos del conjunto de dcat:accessurl Máximo 255 datos de esta distribución. Debe ser una URL bien caracteres formada y cumplir la RFC3986 para ser válida. Formato Formato (MIME media type) de la distribución de datos. (ver 0) dcat:mediatype Ver Anexo II.i Tamaño Tamaño en bytes del fichero de la distribución. dcat:bytesize Máximo 255 caracteres Información Enlaces (URLs) a documentos relacionados con la dct:relation Máximo adicional sobre el formato distribución (por ejemplo, documentos explicando los esquemas o tipos de datos usados). 255 caracteres FEDERADOR - Manual de Usuario 28

29 Anexo II. Listas de valores válidos por tipo de metadato Algunos de los metadatos descritos en las tablas anteriores cuentan con ciertas consideraciones adicionales que hay que tener en cuenta. Anexo II. a. Valores válidos para los identificadores Como se ha comentado se recomienda el uso de URLs para los identificadores tanto del propio catálogo del organismo como de cada conjunto de datos. El identificador (código unívoco) que identifica el feed en cualquiera de los dos formatos propuestos es un metadato opcional para la federación. Esto es así porque el portal sólo lee un feed por usuario y sabe siempre a priori a qué organismo pertenece cada feed. Por otro lado el identificador de cada conjunto de datos dentro del feed sí es un metadato requerido. Así por ejemplo, un organismo podría designar la URL X.org/feeds/federador para colgar el feed con los metadatos para datos.gob.es Se recomienda que esa misma URL sea el identificador del catálogo dentro del feed. A partir de esa URL base se podrían formar los identificadores para cada conjunto de datos añadiendo al final un código alfanumérico: de datos-01 Los metadatos de un conjunto de datos de un organismo, deben estar asociadas en el feed mediante un identificador de conjunto de datos único y que se mantenga inalterado en el tiempo. Solo de esta manera el portal puede realizar las modificaciones sobre un conjunto de datos que ha sido previamente creado a través del proceso de federación. FEDERADOR - Manual de Usuario 29

30 Anexo II. b. Valores válidos para los nombres Varios conjuntos de datos de un mismo publicador no pueden tener los 90 primeros caracteres iguales porque estos caracteres se usan para componer un identificador interno en la herramienta junto con el código del publicador. Si los 90 primeros caracteres del título de varios datasets de un mismo publicador coinciden, la herramienta federador cree que son el mismo y mantiene sólo uno. Nota: la 90º carácter no debe ser una letra con tilde ya que en UTF-8 se corresponden con 2 caracteres y el identificador partiría por la mitad el carácter provocando un error. Anexo II. c. Valores válidos para los organismos publicadores Para especificar este metadato se recomienda seguir la norma que marca la NTI RISP. Se especificará el URI correspondiente a un organismo público diferenciados por un código alfanumérico único para cada órgano/unidad/oficina, que será extraído del Directorio Común gestionado por el MINHAP según el esquema siguiente: Anexo II. d. Valores válidos para las fechas Los valores para los metadatos de tipo fecha/hora deben ser introducidos en el mismo formato que el tipo datetime de la especificación XML Schema, basado en la norma ISO Así, algunos ejemplos de valores correctos que podrían tomar metadatos serían: T18:30:02Z Nota: La Z indica que el uso horario corresponde con el UTC+/-00:00 Anexo II. e. Términos de las categorías (sectores) La categoría de un conjunto de datos debe indicarse con uno de los identificadores de la siguiente tabla: 10 FEDERADOR - Manual de Usuario 30

31 Sector Ciencia y tecnología Comercio Cultura y ocio Demografía Deporte Economía Educación Empleo Energía Hacienda Industria Legislación y justicia Medio ambiente Medio Rural Salud Sector público Seguridad Sociedad y bienestar Transporte Turismo Urbanismo e infraestructuras Vivienda Identificador ciencia-tecnologia comercio cultura-ocio demografia deporte economia educacion empleo energia hacienda industria legislacion-justicia medio-ambiente medio-rural-pesca salud sector-publico seguridad sociedad-bienestar transporte turismo urbanismo-infraestructuras vivienda Anexo II. f. Valores válidos para los idiomas FEDERADOR - Manual de Usuario 31

32 Los identificadores de los idiomas deben seguir el estándar RFC Para identificar los idiomas del territorio nacional usar: Sector Identificador Español Catalán Euskera Gallego Valenciano Inglés es ca eu gl va en Anexo II. g. Términos de la cobertura geográfica La cobertura geográfica que abarcan los datos de un conjunto de datos ({data-geo-cobertura}) debe ser especificado con uno o varios (separándolos por comas) de los identificadores siguientes: País Identificador España espana Autonomía Identificador Andalucía Aragón Principado de Asturias Illes Balears Canarias Cantabria Castilla y León andalucia aragon principado-asturias illes-balears canarias cantabria castilla-leon FEDERADOR - Manual de Usuario 32

33 Castilla-La Mancha Cataluña Comunitat Valenciana Extremadura Galicia Comunidad de Madrid Región de Murcia castilla-la-mancha cataluna comunitat-valenciana extremadura galicia comunidad-madrid region-murcia C. Foral de Navarra comunidad-foral-navarra País Vasco La Rioja Ceuta Melilla pais-vasco la-rioja ceuta melilla Autonomía Provincia Identificador Andalucía Almería almeria Cádiz Córdoba Granada Huelva Jaén Málaga Sevilla cadiz cordoba granada huelva jaen malaga sevilla Aragón Huesca huesca Teruel teruel FEDERADOR - Manual de Usuario 33

34 Zaragoza zaragoza Principado de Asturias Asturias asturias Illes Balears Illes Balears illes-balears Canarias Las Palmas las-palmas Santa Cruz de Tenerife santa-cruz-tenerife Cantabria Cantabria cantabria Castilla y León Ávila avila Burgos León Palencia Salamanca Segovia Soria Valladolid Zamora burgos leon palencia salamanca segovia soria valladolid zamora Castilla-La Mancha Albacete albacete Ciudad Real Cuenca Guadalajara Toledo ciudad-real cuenca guadalajara toledo Cataluña Barcelona barcelona Girona Lleida Tarragona girona lleida tarragona FEDERADOR - Manual de Usuario 34

35 Comunitat Valenciana Alicante/Alacant alicante Castellón/Castelló Valencia/València castellon valencia Extremadura Badajoz badajoz Cáceres caceres Galicia A Coruña a-coruna Lugo Ourense Pontevedra lugo ourense pontevedra Comunidad de Madrid Madrid madrid Región de Murcia Murcia murcia C. Foral de Navarra Navarra navarra País Vasco Álava alava Guipúzcoa Vizcaya guipuzcoa vizcaya La Rioja La Rioja la-rioja Ceuta Ceuta ceuta Melilla Melilla melilla Por ejemplo, para un conjunto de datos con datos a nivel de toda España se indicará con el valor: Un conjunto de datos que abarque datos de una provincia lo indicaría así: FEDERADOR - Manual de Usuario 35

36 Anexo II. h. Valores válidos para la frecuencia de actualización Frecuencia de actualización se expresa mediente la estructura <time:xxx rdf:datatype= o XXX se corresponde con la unidad de medida en inglés: days, weeks, months, years, hours, debe ser un número entero que indique los elementos de la unidad anterior. Valores admitidos: o Para años (years): 5 (Quinquenal), 3 (Trienal), 2 (Bienal), 1 (Anual). o Para meses (months): 6 (Semestral), 4 (Cuatrimestral), 3 (Trimestral), 2 o (Bimestral), 1 (Mensual). Para semanas (weeks): 2 (Bimensual), 1 (Semanal). o Para días (days): 15 (Quincenal), 10 (Trimensual), 7 (Semanal), 3 (Bisemanal), 2 o o (Trisemanal), 1 (Diaria). Para horas: incluir hours como unidad de medida. Para minutos: incluir minutes como unidad de medida. Anexo II. i. Valores válidos para los formatos de las distribuciones El formato de una distribución se identifica mediante el código de su tipo MIME. Los tipos soportados actualmente son: Formato API ASCII Atom Calendar CSV DBF DGN DjVu DOC Tipo MIME application/api text/ascii application/atom+xml text/calendar text/csv application/dbf image/vnd.dgn image/vnd.djvu application/msword FEDERADOR - Manual de Usuario 36

37 FEDERADOR - Manual de Usuario 37 DOCX application/vnd.openxmlformatsofficedocument.wordprocessingml.document DWG image/vnd.dwg DXF application/dxf ECW application/ecw ELP application/elp epub application/epub+zip GBD x-lml/x-gdb geojson application/vnd.geo+json georss application/rss+xml GML application/gml+xml GPX application/gpx+xml GZIP application/gzip HTML text/html IMG application/img JPG image/jpeg JSON application/json JSON-LD application/ld+json KML application/vnd.google-earth.kml+xml KMZ application/vnd.google-earth.kmz MDB application/msaccess MPP application/vmd.ms-project MP4 application/mp4 OCTET STREAM application/octet-stream ODP application/vnd.oasis.opendocument.presentation ODS application/vnd.oasis.opendocument.spreadsheet ODT application/vnd.oasis.opendocument.text PC-Axis text/pc-axis PDF application/pdf PGP application/pgp-signature plain text/plain PNG image/png Postscript application/postscript PPT application/vms.ms-powerpoint RASTER application/vnd.cups-raster RDF-N3 text/n3 RDF-Turtle text/turtle RDF-XML application/rdf+xml RSS application/rss+xml RTF text/rtf SCORM application/scorm SHP application/x-zipped-shp SMIL application/smil+xml SOAP application/soap+xml Solr application/solr SPARQL application/sparql-query SPARQL-JSON application/sparql-results+json SPARQL-XML application/sparql-results+xml TIFF image/tiff TSV text/tab-separated-values

38 vcard-texto vcard-xml Visio VoiceXML WCS WFS WMS XBRL XHTML XLS XLSX XML XML ZIP text/vcard application/vcard+xml application/vnd.visio application/voicexml+xml text/wcs text/wfs text/wms application/xbrl application/xhtml+xml application/vnd.ms-excel application/vnd.openxmlformatsofficedocument.spreadsheetml.sheet application/xml text /xml application/zip FEDERADOR - Manual de Usuario 38

39 Anexo III. Formato ATOM Anexo III. a. Esquema XML extendido ATOM Schema.xsd <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns=" xmlns:dct=" xmlns:fed=" xmlns:dc=" xmlns:xs=" targetnamespace=" <xs:import namespace=" schemalocation="schema2.xsd"/> <xs:import namespace=" schemalocation="schema1.xsd"/> <xs:import namespace=" schemalocation="schema4.xsd"/> <xs:element name="id" type="xs:anyuri"/> <xs:element name="feed"> <xs:complextype> <xs:sequence> <xs:element ref="id" minoccurs="0" maxoccurs="1"/> <xs:element ref="title" minoccurs="1" maxoccurs="unbounded"/> <xs:element ref="dct:description" minoccurs="1" maxoccurs="unbounded"/> <xs:element ref="dct:publisher" minoccurs="1" maxoccurs="1"/> <xs:element ref="dct:extent" minoccurs="0" maxoccurs="1"/> <xs:element ref="published" minoccurs="1" maxoccurs="1"/> <xs:element ref="updated" minoccurs="1" maxoccurs="1"/> <xs:element ref="dc:language" minoccurs="1" maxoccurs="unbounded"/> <xs:element ref="dct:spatial" minoccurs="0" maxoccurs="unbounded"/> <xs:element ref="category" minoccurs="1" maxoccurs="unbounded"/> <xs:element ref="foaf:homepage" minoccurs="1" maxoccurs="1"/> <xs:element ref="dct:license" minoccurs="0" maxoccurs="1"/> <xs:element ref="entry" minoccurs="1" maxoccurs="unbounded"/> </xs:sequence> </xs:complextype> </xs:element> <xs:element name="entry"> <xs:complextype> <xs:sequence> <xs:element ref="id" minoccurs="0" maxoccurs="1"/> <xs:element ref="title" minoccurs="1" maxoccurs="unbounded"/> <xs:element ref="summary" minoccurs="1" maxoccurs="unbounded"/> <xs:element ref="category" minoccurs="1" maxoccurs="unbounded"/> <xs:element ref="fed:keyword" minoccurs="0" maxoccurs="unbounded"/> <xs:element ref="published" minoccurs="0" maxoccurs="1"/> FEDERADOR - Manual de Usuario 39

40 <xs:element ref="updated" minoccurs="0" maxoccurs="1"/> <xs:element ref="dct:accrualperiodicity" minoccurs="0" maxoccurs="1"/> <xs:element ref="dc:language" minoccurs="0" maxoccurs="unbounded"/> <xs:element ref="dct:publisher" minoccurs="1" maxoccurs="1"/> <xs:element ref="dct:license" minoccurs="0" maxoccurs="1"/> <xs:element ref="dct:spatial" minoccurs="0" maxoccurs="unbounded"/> <xs:element ref="dct:temporal" minoccurs="0" maxoccurs="unbounded"/> <xs:element ref="dct:valid" minoccurs="0" maxoccurs="1"/> <xs:element ref="dct:references" minoccurs="0" maxoccurs="unbounded"/> <xs:element ref="dct:conformsto" minoccurs="0" maxoccurs="unbounded"/> <xs:element ref="fed:distribution" minoccurs="1" maxoccurs="unbounded"/> </xs:sequence> </xs:complextype> </xs:element> <xs:element name="title" type="xs:string"/> <xs:element name="summary" type="xs:string"/> <xs:element name="updated" type="datetimewithtimezone"/> <xs:element name="category"> <xs:complextype> <xs:attribute name="term" type="sectortype" use="required"/> </xs:complextype> </xs:element> <xs:simpletype name="sectortype"> <xs:restriction base="xs:anyuri"> <xs:enumeration value=" <xs:enumeration value=" <xs:enumeration value=" <xs:enumeration value=" <xs:enumeration value=" <xs:enumeration value=" <xs:enumeration value=" <xs:enumeration value=" <xs:enumeration value=" <xs:enumeration value=" <xs:enumeration value=" <xs:enumeration value=" <xs:enumeration value=" <xs:enumeration value=" <xs:enumeration value=" FEDERADOR - Manual de Usuario 40

41 <xs:enumeration value=" <xs:enumeration value=" <xs:enumeration value=" <xs:enumeration value=" <xs:enumeration value=" <xs:enumeration value=" <xs:enumeration value=" <xs:enumeration value=" </xs:restriction> </xs:simpletype> <xs:element name="link"> <xs:complextype> <xs:attribute name="href" type="xs:anyuri" use="required"/> </xs:complextype> </xs:element> <xs:element name="published" type="datetimewithtimezone"/> <xs:simpletype name="datetimewithtimezone"> <xs:restriction base="xs:token"> <xs:pattern value="[0-9]{4}-[01][0-9]-[0-3][0-9]( T)[0-2][0-9]:[0-5][0-9]:[0-6][0-9](Z TZD)?"/> </xs:restriction> </xs:simpletype> </xs:schema> Schema1.xsd <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns=" xmlns:fed=" xmlns:dct=" xmlns:xs=" targetnamespace=" <xs:import namespace=" schemalocation="schema2.xsd"/> <xs:element name="keyword" type="xs:string"/> <xs:element name="distribution"> <xs:complextype> <xs:sequence> <xs:element ref="dct:identifier" minoccurs="0" maxoccurs="1"/> FEDERADOR - Manual de Usuario 41

42 <xs:element ref="dct:title" minoccurs="0" maxoccurs="unbounded"/> <xs:element ref="fed:link" minoccurs="1" maxoccurs="1"/> <xs:element ref="dct:relation" minoccurs="0" maxoccurs="unbounded"/> </xs:sequence> </xs:complextype> </xs:element> <xs:element name="link"> <xs:complextype> <xs:attribute name="href" type="xs:anyuri" use="required"/> <xs:attribute name="type" type="xs:string" use="required"/> <xs:attribute name="length" type="xs:decimal" use="optional"/> </xs:complextype> </xs:element> </xs:schema> Schema2.xsd <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns=" xmlns:time=" xmlns:xs=" targetnamespace=" <xs:import namespace=" schemalocation="schema3.xsd"/> <xs:element name="identifier" type="xs:anyuri"/> <xs:element name="title" type="xs:string"/> <xs:element name="relation" type="xs:anyuri"/> <xs:element name="description" type="xs:string"/> <xs:element name="publisher"> <xs:simpletype> <xs:restriction base="xs:anyuri"> <xs:pattern value=" </xs:restriction> </xs:simpletype> </xs:element> <xs:element name="extent" type="xs:integer"/> <xs:element name="issued" type="datetimewithtimezone"/> <xs:element name="modified" type="datetimewithtimezone"/> <xs:element name="spatial"> <xs:simpletype> <xs:restriction base="xs:anyuri"> <xs:enumeration value=" <xs:enumeration value=" <xs:enumeration value=" FEDERADOR - Manual de Usuario 42