linee-guida-cataloghi-dati-profilo-dcat-ap-it-2.pdf

Type: Document | Status: ready
← All sources

Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 5 6 7 1 2 3 4 5 70018 43.5963597132668</gml:lowerCorner><gml:upperCorner>10. ˓→0879518636137 44.849579861466</gml:upperCorner></gml:Envelope></locn:geometry> </dct:Location> RDF/Turtle <http://dati.gov.it/resource/CoperturaSpaziale/LocalizzazioneLineaCosta_r_liguri:D. ˓→658> a dct:Location ; locn:geometry "<gml:Envelope srsName="http://www.opengis.net/def/EPSG/0/4326">gml:lowerCorner7. ˓→48820862370018 43.5963597132668</gml:lowerCorner>gml:upperCorner10.0879518636137 44. ˓→849579861466</gml:upperCorner></gml:Envelope>"^^gsp:gmlLiteral . Elementi opzionali Nome geografico locn:geographicName elemento valore Cardinalità 0..1 Stato Opzionale Descrizione Nome proprio associato all’oggetto spaziale. Riferimento http://www.w3.org/ns/locn#geographicName“ Nota: Da indicare solo se non è disponibile un identificativo geografico o non sono note le coordinate. Geometria loc:Geometry elemento valore Cardinalità 0..1 Stato Opzionale Descrizione La Geometria dell’oggetto spaziale.. Riferimento http://www.w3.org/ns/locn#Geometry Nota: Le proprietà indicate, nella pratica, possono essere specificate attraverso diverse codifiche. La specifica GeoDCAT-AP prevede che debba essere utilizzata almeno una delle seguenti: GML o WKT. Elementi obbligatori della geometria I seguenti elementi sono obbligatori se la geometria dell’oggetto spaziale che descrive la copertura geografica del dataset viene specificata. Capitolo 1. Indice dei contenuti 64

Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 CRS elemento valore Cardinalità 1 Stato Obbligatorio Descrizione L’indicazione del sistema di riferimento spaziale in cui sono rappresentati i dati. Secondo quanto indicato in GeoDCAT-AP, nelle codifiche GML o WKT il CRS deve essere specificato come definito in GeoSPARQL Coordinate elemento valore Cardinalità 1 Stato Obbligatorio Descrizione Le coordinate dell’area geografica coperta dal Dataset. Nota: Fornire le coordinate relative alla latitudine e longitudine, espresse nel sistema di riferimento WGS84, del riquadro di delimitazione (bounding box) dell’area geografica coperta dal dataset descritto. Se è stato già indicato un identificativo geografico come URI della classe Localizzazione, le coordinate possono essere omesse. Tipo di geometria elemento valore Cardinalità 1 Stato Obbligatorio Descrizione Il tipo di geometria che caratterizza l’oggetto spaziale utilizzato per la localizzazione del Dataset (es., punto (point)). Standard dcatapit:Standard Uno standard è definito mediante la specifica della classe Standard identificata univocamente da un URI (Uniform Resource Identifier). 1.3. Profilo metadatazione DCAT-AP_IT 65

Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 elemento valore URI dcatapit:Standard Sottoclasse dct:Standard Descrizione Uno standard al quale il dataset è conforme Cardinalità 0..N Stato Opzionale Riferimento http://www.dati.gov.it/onto/dcatapit#Standard Esempi Esempi di uso di dcatapit:Standard JSON-LD 1 { 2 "@id": "http://dati.gov.it/resource/Standard/standard-org", 3 "@type": [ 4 "dcterms:Standard", 5 "http://dati.gov.it/onto/dcatapit#"Standard" 6 ], 7 "dcterms:description": { 8 "@language": "en", 9 "@value": "The ontology of the organizations" 10 }, 11 "dcterms:title": { 12 "@language": "en", 13 "@value": "W3C Org organization ontology" 14 }, 15 "http://dati.gov.it/onto/dcatapit#"referenceDocumentation": [ 16 { 17 "@type": "xsd:anyURI", 18 "@value": "https://www.w3.org/TR/vocab-org/" 19 }, 20 { 21 "@type": "xsd:anyURI", 22 "@value": "https://www.w3.org/ns/org.rdf" 23 } 24 ] 25 }, RDF/XML 1 <!-­ http://dati.gov.it/resource/Standard/standard-org --> 2 <dcatapit:Standard rdf:about="http://dati.gov.it/resource/Standard/standard-org"> 3 <rdf:type rdf:resource="&dct;Standard"/> 4 <dcatapit:referenceDocumentation rdf:datatype="&xsd;anyURI">https://www.w3.org/ ˓→TR/vocab-org/</dcatapit:referenceDocumentation> 5 <dcatapit:referenceDocumentation rdf:datatype="&xsd;anyURI">https://www.w3.org/ ˓→ns/org.rdf</dcatapit:referenceDocumentation> 6 <dct:title xml:lang="en">W3C Org organization ontology</dct:title> 7 <dct:description xml:lang="en">The ontology of the organizations</ ˓→dct:description> 8 </dcatapit:Standard> RDF/TURTLE Capitolo 1. Indice dei contenuti 66

1 http://dati.gov.it/resource/Standard/standard-org 2 a dcatapit:Standard , dct:Standard 3 dct:title "W3C Org organization ontology"@en 4 dct:description "The ontology of the organizations"@en 5 dcatapit:referenceDocumentation "https://www.w3.org/ns/org.rdf"^^xsd:anyURI 6 dcatapit:referenceDocumentation "https://www.w3.org/TR/vocab-org/"^^xsd:anyURI Elementi obbligatori Identificativo dello standard dct:identifier Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 ; ; ; ; . elemento valore Cardinalità 1 Stato Obbligatorio Descrizione L’identificativo dello standard. Riferimento http://purl.org/dc/terms/identifier Nota: Inserire l’URL di riferimento dello Standard. Nel caso di riferimenti normativi, includere il link permanente di­ sponibile presso la gazzetta ufficiale (e.g., www.gazzettaufficiale.it/eli/id/2005/05/16/005G0104/sg). E’ obbligatorio specificare l’identificativo qualora si scelga di descrivere standard riferibili al dataset. Elementi opzionali Titolo dello standard dct:title elemento valore Cardinalità 0..N (può esistere più di un’istanza, in diverse lingue, della stessa proprietà) Stato Opzionale Descrizione Il titolo dello standard. Riferimento http://purl.org/dc/terms/title Nota: Indicare un titolo dello standard comprensibile in quanto il metadato potrebbe essere utilizzato nella ricerca e nelle indicizzazioni (evitare acronimi, evitare codici non esaustivi). Nel caso di riferimenti normativi, indicare per esempio la tipologia di norma il numero e l’anno e inserire il titolo ufficiale della norma. Descrizione dello standard dct:description elemento valore Cardinalità 0..N (può esistere più di un’istanza, in diverse lingue, della stessa proprietà) Stato Opzionale Descrizione La descrizione dello standard. Riferimento http://purl.org/dc/terms/description Nota: Indicare una descrizione per lo standard. Evitare di utilizzare un linguaggio ricco di riferimenti normati­ vi. Utilizzare invece un linguaggio semplice che possa aiutare qualsiasi utente a identificare lo standard riferibile al dataset. Si ricorda che nessun tag HTML è consentito, 1.3. Profilo metadatazione DCAT-AP_IT 67

Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 Documentazione di riferimento dcatapit:referenceDocumentation elemento valore Cardinalità 0..N Stato Opzionale Descrizione URL attraverso i quali viene fornito l’accesso a documenti di dettaglio relativi allo Standard indicato. Riferimento http://www.dati.gov.it/onto/dcatapit# referenceDocumentation Nota: Indicare uno o più URL della documentazione di riferimento relativa allo standard. Ad esempio, nel caso della raccomandazione DCAT, alcuni URL relativi alla documentazione di riferimento sono: https://www.w3.org/TR/ vocab-dcat/ e https://www.w3.org/ns/dcat.rdf Identificativo alternativo del Dataset adms:Identifier L’identificativo alternativo del dataset può essere specificato mediante la classe adms:Identifier specificata mediante un URI (Uniform Resource Identifier) elemento valore URI adms:Identifier Descrizione Un identificativo alternativo per il dataset. Cardinalità 0..N Stato Opzionale Riferimento http://www.w3.org/ns/adms#Identifier Esempi Esempi d’uso di adms:Identifier JSON-LD 1 2 3 4 5 6 7 { "@id": "http://dati.gov.it/resource/AltroIdentificativo/ ˓→altroidentificativoDataset1", "@type": "adms:Identifier", "skos:notation": { "@value": "doi:10.1109/5.771073" } } RDF/XML 1 2 <!-­ http://dati.gov.it/resource/AltroIdentificativo/altroidentificativoDataset1 ˓→> <adms:Identifier rdf:about="http://dati.gov.it/resource/AltroIdentificativo/ ˓→altroidentificativoDataset1"> -­ Capitolo 1. Indice dei contenuti 68

Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 3 skos:notation"doi:10.1109/5.771073"</skos:notation> 4 </adms:Identifier> RDF/Turtle 1 hhttp://dati.gov.it/resource/AltroIdentificativo/altroidentificativoDataset1 2 a adms:Identifier ; 3 skos:notation "doi:10.1109/5.771073" ; Elementi raccomandati Notazione skos:notation elemento valore Cardinalità 0..N Stato Raccomandato Descrizione Un identificativo, nel contesto dello schema di identificazione, a cui fa riferimento il suo tipo. Riferimento http://www.w3.org/2004/02/skos/core#notation Errori comuni nell’uso di DCAT-AP_IT Gestione degli URI L’errore più diffuso riguarda la gestione degli URI. Si ricorda che oggetti di tipo diverso devono avere URI differenti. Per esempio, NON è corretto utilizzare lo stesso URI per definire il soggetto o organizzazione che ha un certo ruolo (titolare, editore, creatore) su un catalogo o dataset, e per definire il punto di contatto del dataset. I due concetti sono diversi e devono avere URI diversi. Ci si riferisca agli esempi di uso di Soggetto o Organizzazione e di Punto di Contatto per maggiori dettagli. Differenza tra Literal (valore) e URI Molto spesso, soprattutto in presenza di dati serializzati in RDF/XML si tende a confondere il concetto di URI http://.... con una stringa che all’interno contiene un URI “http://....”. In quest’ultimo caso non si sta definendo un URI ma un valore (detto Literal nel contesto RDF). Per esempio il seguente codice è corretto: <dcatapit:Dataset rdf:about="http://dati.gov.it/resource/Dataset/ContrattiSPC_agid"> <rdf:type rdf:resource="&dcat;Dataset"/> <dcat:theme rdf:resource="http://publications.europa.eu/resource/authority/data­ ˓→theme/ECON"/> ... </dcatapit:Dataset> Errore: Il seguente codice definirebbe il tema come una stringa che include un URI e NON è corretto rispetto alle specifiche riguardanti il tema del Dataset: <dcatapit:Dataset rdf:about="http://dati.gov.it/resource/Dataset/ ˓→ContrattiSPC_agid"> <rdf:type rdf:resource="&dcat;Dataset"/> dcat:theme"http://publications.europa.eu/resource/authority/data­ ˓→theme/ECON"</dcat:theme>
...
</dcatapit:Dataset>
1.3. Profilo metadatazione DCAT-AP_IT 69

Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 Temi dei dati
Nota: I temi utilizzati per classificare i dati si basano sull’uso del vocabolario controllato come indicato nella sezione “Temi del dataset dcat:theme”. Sulla base della valutazione dei diversi temi per i dati discussa nell’ambito del gruppo Europeo DCAT-AP, nel seguito si offre un possibile mapping di domini applicativi rispetto ai temi del suddetto vocabolario controllato.

  1. Agricoltura, pesca, silvicoltura e prodotti alimentari In questo tema rientra tutto ciò che riguarda il settore agricoltura, pesca, politiche forestali e alimentari. URI da utilizzare : http://publications.europa.eu/resource/authority/data-theme/AGRI
  2. Economia e Finanze In questo tema rientra tutto ciò che riguarda la tassazione, l’industria, il manifatturiero, il bilancio dello stato, la crescita economica, il commercio. URI da utilizzare: http://publications.europa.eu/resource/authority/data-theme/ECON
  3. Istruzione, cultura e sport In questo tema rientra tutto ciò che riguarda la cultura, il turismo, l’istruzione e le attività sportive, eventi culturali e locali. URI da utilizzare: http://publications.europa.eu/resource/authority/data-theme/EDUC
  4. Energia In questo tema rientra tutto ciò che concerne il settore dell’energia e dell’estrazione mineraria. URI da utilizzare: http://publications.europa.eu/resource/authority/data-theme/ENER
  5. Ambiente In questo tema rientra tutto ciò che riguarda l’ambiente (rifiuti, consumo del suolo, oceani, ecc.) e il clima/meteo. URI da utilizzare: http://publications.europa.eu/resource/authority/data-theme/ENVI
  6. Governo e settore pubblico In questo tema rientra tutto ciò che riguarda le politiche di governo, gli affari istituzionali, la trasparenza del settore pubblico (dati relativi ad amministrazione trasparente). URI da utilizzare: http://publications.europa.eu/resource/ authority/data-theme/GOVE
  7. Salute In questo tema rientra tutto ciò che concerne le attività sulla salute e tutto ciò che riguarda gli animali. URI da utilizzare: http://publications.europa.eu/resource/authority/data-theme/HEAL Capitolo 1. Indice dei contenuti 70

Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 8. Tematiche internazionali In questo tema rientra tutto ciò che concerne le relazioni internazionali, la cooperazione internazionale, i diritti uma­ nitari, le organizzazioni internazionali e gli affari esteri. URI da utilizzare: http://publications.europa.eu/resource/ authority/data-theme/INTR 9. Giustizia, sistema giuridico e sicurezza pubblica In questo tema rientra tutto ciò che riguarda le frodi, i crimini, la giustizia, le norme. Rientra anche tutto ciò che riguarda la difesa e gli aspetti legati alle attività del ministero dell’interno. URI da utilizzare: http://publications. europa.eu/resource/authority/data-theme/JUST 10. Regioni e città In questo tema rientra tutto ciò che riguarda le strade urbane e i numeri civici. Il tema ha una forte sovrapposizione con ambiente perché potrebbe anche contenere tutto ciò che concerne la geografia del territorio (e.g., montagne, laghi, fiumi, ecc.). URI da utilizzare: http://publications.europa.eu/resource/authority/data-theme/REGI 11. Popolazione e società In questo tema rientra tutto ciò che concerne lo sviluppo della società, le condizioni della società, la cittadinanza, la demografia, il welfare. URI da utilizzare: http://publications.europa.eu/resource/authority/data-theme/SOCI 12. Scienza e tecnologia In questo tema rientra tutto ciò che riguarda la ricerca, l’innovazione, la tecnologia, la banda larga e ultralarga, la psi­ cologia, le scienze umane, lo spazio. URI da utilizzare: http://publications.europa.eu/resource/authority/data-theme/ TECH 13. Trasporti In questo tema rientra tutto ciò che riguarda i trasporti e le relative infrastrutture, la mobilità. URI da utilizzare: http://publications.europa.eu/resource/authority/data-theme/TRAN Vocabolari Controllati La tabella seguente riepiloga i vocabolari controllati da utilizzare. 1.5. Vocabolari Controllati 71

Page 9 of 10