Convención - Descripción de dcat:Catalog recomendada para nutrir la información de iniciativas de datos abiertos

[Admindatosgobes]

Contexto

Actualmente, la información sobre las iniciativas de datos abiertos incluye múltiples campos que recopilan información sobre la iniciativa y su catálogo de datos. Sin embargo, no está claro hasta qué punto estos campos pueden ser rellenados automáticamente a partir de las propiedades de dcat:Catalog definidas en los propios RDF de federación en DCAT-AP-ES.

El objetivo de esta Issue es analizar la alineación entre los metadatos de dcat:Catalog y los campos de la iniciativa para determinar si se pueden rellenar automáticamente la mayoría de los campos y, adicionalmente, si el dcat:contactPoint es semánticamente correcto, y normativo, en este contexto.

Propuesta

Aplicabilidad

• Recomendada (SHOULD): Se recomienda su cumplimiento, aunque puede haber excepciones justificadas.

Mapeo de campos

Campo del formulario	Propiedad DCAT-AP-ES	Comentarios
Nombre de la iniciativa	No hay una propiedad exacta	Puede no coincidir con el título del catálogo
Enlace al portal de la iniciativa	foaf:homepage	Dirección web pública de acceso al catálogo de datos
Organización que promueve la iniciativa	dct:publisher	Organización responsable del catálogo
Tipo de organización/nivel administración	No hay una propiedad exacta	Se podría inferir a partir de dct:publisher.
Enlace a la estrategia de apertura de datos	No hay una propiedad exacta	Se podría considerar agregar una propiedad personalizada si es relevante.
Geoposition (Latitud, Longitud)	dct:spatial	Aunque existe el ámbito geográfico cubierto por el catálogo, este elemento es más particular y es un dcat:centroid.
Enlace al catálogo de datos abiertos	dcat:Catalog	URI del catálogo
Licencia (URL)	dct:license	Coincide con la URL de los términos de uso
Canal de solicitud	dcat:contactPoint (si aplica)	Si este contacto es para solicitudes sobre los datos, es correcto
Temáticas de los datos	-	A priori sería un mapeo directo con categorías del catálogo, pero dcat:theme no se contempla para catálogos.
Catálogo de aplicaciones	No hay una propiedad exacta	Se puede evaluar si puede representarse con dct:relation la URL en la que el usuario encontrará ejemplos de soluciones desarrolladas a partir del uso de los datos.
Recursos formativos	No hay una propiedad exacta	Podría representarse con dct:relation la URL en la que el usuario encontrará materiales formativos relacionados con los datos abiertos.
Nombre y Apellidos	dcat:contactPoint	Si es el contacto del catálogo, se puede mapear. ¡Datos públicos!
Correo electrónico	dcat:contactPoint	Si es el contacto del catálogo, se puede mapear. ¡Datos públicos!
Teléfono	dcat:contactPoint	Si es el contacto del catálogo, se puede mapear. ¡Datos públicos!

Convención propuesta

## Convención para la descripción de una iniciativa de datos abiertos con `dcat:Catalog` {#dcat-catalog-initiative}

Con el fin de facilitar información sobre el catálogo y la iniciativa de datos que le da soporte, se plantea la alineación de las propiedades del catálogo con la información de los mapas de iniciativas.

!!! must semantic "Convención XX"
    Un `dcat:Catalog` **DEBERÍA** describirse con las siguientes propiedades para permitir la interoperabilidad:
    
   1. **`foaf:homepage`**: para proporcionar la URL pública de la iniciativa o del catálogo.
   2. **`dct:publisher`**: para identificar a la organización responsable de la iniciativa mediante una URI de una taxonomía oficial, como DIR3.
   3. **`dct:license`**: para contener la URL de la licencia bajo la cual se publican los datos.
   4. **`dct:spatial`**: complementar el ámbito geográfico cubierto por la iniciativa con un `dcat:centroid`.
   5. **`dcat:contactPoint`**: para proporcionar la información de contacto de la iniciativa, utilizando `vcard:Kind`.
   6. **`dcat:theme`**: para indicar las categorías temáticas de los datos de la iniciativa.
   7. **`dct:relation`**: para enlazar recursos relacionados, como estrategias de apertura de datos, catálogos de aplicaciones o materiales formativos.
    
!!! info "Ejemplo de un `dcat:Catalog` recomendado"
    ```turtle
    @prefix dcat: <http://www.w3.org/ns/dcat#> .
    @prefix dct: <http://purl.org/dc/terms/> .
    @prefix locn: <http://www.w3.org/ns/locn#> .
    @prefix geo: <http://www.opengis.net/ont/geosparql#> .
    @prefix foaf: <http://xmlns.com/foaf/0.1/> .
    @prefix vcard: <http://www.w3.org/2006/vcard/ns#> .

    <http://datos.gob.es/catalogo/ejemplo>
        a dcat:Catalog ;
        dct:title "Catálogo de Datos Abiertos de Ejemplo"@es ;
        foaf:homepage <https://datos.ejemplo.org> ;
        dct:publisher <http://datos.gob.es/recurso/sector-publico/org/Organismo/EA0000000> ;
        dct:license <https://datos.ejemplo.org/licencia> ;
        dct:spatial <http://datos.gob.es/recurso/territorio/Espana> ;
        dct:spatial [
            a dct:Location ;
            dcat:centroid "POINT(3.765087 40.090843)"^^geo:wktLiteral
        ] ;
        dcat:theme <http://datos.gob.es/kos/sector-publico/sector/educacion> ;
        dcat:contactPoint [
            a vcard:Kind ;
            vcard:fn "Oficina de Datos Abiertos"@es ;
            vcard:hasEmail <mailto:contacto@ejemplo.org> ;
            vcard:hasTelephone <tel:+34-912345678>
        ] ;
        dct:relation <https://datos.ejemplo.org/formacion> .
    ```

!!! warning "Importante"
   - **No omitir `dct:publisher`**: Siempre debe estar presente y referenciarse correctamente.
   - **Consistencia en las relaciones**: `dct:relation` debe usarse solo para enlaces relevantes.

Consideraciones adicionales

1. Posible redundancia: Algunos campos del formulario parecen solaparse (ej. "Enlace a la iniciativa" y "Enlace al catálogo").
2. Falta de equivalencias directas: Algunos campos no tienen una propiedad exacta en dcat:Catalog y requieren evaluación adicional.
3. Validación semántica: Se debe confirmar si dcat:contactPoint es adecuado para contactos generales o si está pensado solo para aspectos técnicos del catálogo.

[mjanez]

Estoy de acuerdo con la convención propuesta para la descripción de iniciativas mediante la inclusión de propiedades recomendadas en dcat:Catalog, sí puede facilitar la extracción de información.

• Respecto a la posible redundancia, si el "enlace a la iniciativa" y el "enlace al catálogo" son el mismo, basta con uno; si no, se recomienda documentar ambos indicando su propósito.
• Para los campos que no tienen equivalencia directa en DCAT-AP-ES, pueden representarse opcionalmente como recursos relacionados (dct:relation) o documentarse su uso a partir de atributos de DCAT/DCAT-AP, el tipo de organización puede ser un atributo del objeto publisher, el agente, (dct:type basado en http://purl.org/adms/publishertype/1.0) y extraer la necesidad de describirlo en el catálogo.
• Sobre la validación semántica de dcat:contactPoint, es adecuado tanto para contactos generales como técnicos siempre que se utilice la estructura vCard y se trate de información pública e institucional.