Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 Nota: L’identificativo univoco del dataset è assegnato dal catalogo nazionale ed è costituito da codiceIPA:D.numeroProgressivo. Esempio–> agid:D.1 Esempi d’uso di dct:identifier JSON-LD 1 "@id": "http://dati.gov.it/resource/Dataset/ContrattiSPC_agid", 2 "@type": [ 3 "dcat:Dataset", 4 "http://dati.gov.it/onto/dcatapit#"Dataset" 5 ], 6 "dcterms:identifier": "agid:D.301", 7 8 altri elementi del dataset RDF/XML 1 <!- http://dati.gov.it/resource/Dataset/ContrattiSPC_agid --> 2 3 <dcatapit:Dataset rdf:about="http://dati.gov.it/resource/Dataset/ContrattiSPC_agid ˓→"> 4 <rdf:type rdf:resource="&dcat;Dataset"/> 5 dct:identifieragid:D.1</dct:identifier> 6 [altri elementi per specificare il dataset] 7 </dcatapit:Dataset> RDF/Turtle 1 http://dati.gov.it/resource/Dataset/ContrattiSPC_agid 2 a dcatapit:Dataset , dcat:Dataset ; 3 dct:identifier "agid:D.1" ; 4 5 [altri elementi per specificare il dataset] Titolo del dataset dct:title elemento valore Cardinalità 1..N (può esistere più di un’istanza, in diverse lingue, della stessa proprietà) Stato Obbligatorio Descrizione Il titolo del Dataset Riferimento http://purl.org/dc/terms/title Nota: Si raccomanda di inserire un testo semplice e corto. Si raccomanda di non utilizzare acronimi o abbreviazioni incomprensibili. Se si vogliono utilizzare comunque gli acronimi, riportare anche il nome esteso. Nel caso il dataset sia legato a un progetto più ampio, si consiglia di indicare, tra parentesi, il nome del progetto alla fine del titolo stesso. Si può evitare di inserire nel titolo del Dataset la distribuzione dello stesso (e.g., si può evitare di scrivere un titolo come “Luoghi ed eventi della cultura in LOD”). Esempi di titoli di dataset –> “Contratti del Sistema Pubblico di Connettività (SPC)” oppure “Luoghi ed eventi della cultura”. Capitolo 1. Indice dei contenuti 22
Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 Esempi di uso di dct:title JSON-LD 1 "@id": "http://dati.gov.it/resource/Dataset/ContrattiSPC_agid", 2 "@type": [ 3 "dcat:Dataset", 4 "http://dati.gov.it/onto/dcatapit#"Dataset" 5 ], 6 "dcterms:title": { 7 "@language": "it", 8 "@value": "Contratti del Sistema Pubblico di Connettività (SPC)" 9 }, 10 11 altri elementi del dataset RDF/XML 1 <!- http://dati.gov.it/resource/Dataset/ContrattiSPC_agid --> 2 3 <dcatapit:Dataset rdf:about="http://dati.gov.it/resource/Dataset/ContrattiSPC_agid ˓→"> 4 <rdf:type rdf:resource="&dcat;Dataset"/> 5 <dct:title xml:lang="it">Contratti del Sistema Pubblico di Connettività (SPC)</ ˓→dct:title> 6 [altri elementi per specificare il dataset] 7 </dcatapit:Dataset> RDF/Turtle 1 http://dati.gov.it/resource/Dataset/ContrattiSPC_agid 2 a dcatapit:Dataset , dcat:Dataset ; 3 dct:title "Contratti del Sistema Pubblico di Connettività (SPC)"@it ; 4 5 [altri elementi per specificare il dataset] Descrizione del dataset dct:description elemento valore Cardinalità 1..N (può esistere più di un’istanza, in diverse lingue, della stessa proprietà) Stato Obbligatorio Descrizione La descrizione del Dataset che indica cosa contiene il dataset. Riferimento http://purl.org/dc/terms/description Nota: Si raccomanda di fornire una breve descrizione dei contenuti principali del dataset. Evitare di utilizzare un linguaggio ricco di riferimenti normativi. Utilizzare invece un linguaggio semplice che possa aiutare qualsiasi utente a identificare il contenuto del dataset. Ove possibile, si possono fornire indicazioni sulla struttura dei dati che compongono il dataset. Si ricorda che nessun tag HTML è consentito. Esempi–> “Il dataset contiene i dati sui contratti del Sistema Pubblico di Connettività (SPC) relativi al Lotto 1 dell’anno 2007.” oppure “Il dataset contiene i dati relativi ai luoghi della cultura (e.g., musei, biblioteche, siti archeologici, ecc.) e i relativi eventi culturali che si tengono nei luoghi. Informazioni sugli orari di apertura per i luoghi e i relativi eventi sono incluse nel dataset”. 1.3. Profilo metadatazione DCAT-AP_IT 23
Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 Esempi di uso di dct:description JSON-LD 1 "@id": "http://dati.gov.it/resource/Dataset/ContrattiSPC_agid", 2 "@type": [ 3 "dcat:Dataset", 4 "http://dati.gov.it/onto/dcatapit#"Dataset" 5 ], 6 "dcterms:description": { 7 "@language": "it", 8 "@value": "Il dataset contiene i dati sui contratti del Sistema Pubblico di 9 Connettività (SPC) relativi al Lotto 1 dell'anno 2007" 10 }, 11 12 altri elementi per specificare il dataset RDF/XML 1 <!- http://dati.gov.it/resource/Dataset/ContrattiSPC_agid --> 2 <dcatapit:Dataset rdf:about="http://dati.gov.it/resource/Dataset/ContrattiSPC_agid ˓→"> 3 <rdf:type rdf:resource="&dcat;Dataset"/> 4 <dct:description xml:lang="it">Il dataset contiene i dati sui contratti del ˓→Sistema Pubblico di Connettività (SPC) relativi al Lotto 1 dell'anno 2007.</ ˓→dct:description> 5 [altri elementi per specificare il dataset] 6 </dcatapit:Dataset> RDF/Turtle 1 http://dati.gov.it/resource/Dataset/ContrattiSPC_agid 2 a dcatapit:Dataset , dcat:Dataset ; 3 dct:description "Il dataset contiene i dati sui contratti del Sistema Pubblico di 4 Connettività (SPC) relativi al Lotto 1 dell'anno 2007." 5 6 [altri elementi per specificare il dataset] Ultima modifica del dataset dct:modified elemento valore Cardinalità 1 Stato Obbligatorio Descrizione La data di ultima modifica del Dataset Riferimento http://purl.org/dc/terms/modified Nota: Si raccomanda di usare il formato ISO 8601, i.e., yyyy-mm-dd Esempi di uso di dct:modified JSON-LD Capitolo 1. Indice dei contenuti 24
Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 1 "@id": "http://dati.gov.it/resource/Dataset/ContrattiSPC_agid", 2 "@type": [ 3 "dcat:Dataset", 4 "http://dati.gov.it/onto/dcatapit#"Dataset" 5 ], 6 "dcterms:modified": { 7 "@type": "xsd:date", 8 "@value": "2015-05-25" 9 }, 10 11 altri elementi per specificare il dataset RDF/XML 1 <!- http://dati.gov.it/resource/Dataset/ContrattiSPC_agid --> 2 <dcatapit:Dataset rdf:about="http://dati.gov.it/resource/Dataset/ContrattiSPC_agid ˓→"> 3 <rdf:type rdf:resource="&dcat;Dataset"/> 4 <dct:modified rdf:datatype="&xsd;date">2015-05-25</dct:modified> 5 [altri elementi per specificare il dataset] 6 </dcatapit:Dataset> RDF/Turtle 1 http://dati.gov.it/resource/Dataset/ContrattiSPC_agid 2 a dcatapit:Dataset , dcat:Dataset ; 3 dct:modified "2015-05-25"^^xsd:date ; 4 5 [altri elementi per specificare il dataset] Temi del dataset dcat:theme elemento valore Cardinalità 1..N Stato Obbligatorio Descrizione I temi attraverso cui classificare il Dataset. La proprietà lega l’oggetto (dominio) Dataset a uno o più oggetti (codominio) di tipo skos:Concept (specificato mediante un URI - Uniform Resource Identifier) Riferimento http://www.w3.org/ns/dcat#theme Nota: Il metadato assume come valore un URI (NON una stringa con l’URL del tema) che deve essere necessaria mente uno tra quelli definiti nel vocabolario Europeo sui Temi per i dati. Esempio –> se il tema è Agricoltura, Pesca e Politiche Forestali e Alimentari il valore di questa proprietà è necessariamente http://publications.europa.eu/resource/ authority/data-theme/AGRI. Si veda a tal proposito la sezione “Temi dei dati” 1.3. Profilo metadatazione DCAT-AP_IT 25
Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 Esempi d’uso di dcat:theme JSON-LD 1 "@id": "http://dati.gov.it/resource/Dataset/ContrattiSPC_agid", 2 "@type": [ 3 "dcat:Dataset", 4 "http://dati.gov.it/onto/dcatapit#"Dataset" 5 ], 6 { 7 "@id": "http://publications.europa.eu/resource/authority/data-theme/ECON", 8 "@type": "skos:Concept", 9 "skos:prefLabel": { 10 "@language": "it", 11 "@value": "Economia e Finanze" 12 } 13 }, 14 15 altri elementi per specificare il dataset RDF/XML 1 <!- http://dati.gov.it/resource/Dataset/ContrattiSPC_agid --> 2 <dcatapit:Dataset rdf:about="http://dati.gov.it/resource/Dataset/ContrattiSPC_agid ˓→"> 3 <rdf:type rdf:resource="&dcat;Dataset"/> 4 <dcat:theme rdf:resource="http://publications.europa.eu/resource/authority/ ˓→data-theme/ECON"/> 5 [altri elementi per specificare il dataset] 6 </dcatapit:Dataset> 7 8 Opzionalmente si può anche specificare 9 <!- http://publications.europa.eu/resource/authority/data-theme/ECON --> 10 11 <skos:Concept rdf:about="http://publications.europa.eu/resource/authority/data ˓→theme/ECON"> 12 <skos:prefLabel xml:lang="it">Economia e Finanze</skos:prefLabel> 13 </skos:Concept> RDF/Turtle 1 http://dati.gov.it/resource/Dataset/ContrattiSPC_agid 2 a dcatapit:Dataset , dcat:Dataset ; 3 dcat:theme http://publications.europa.eu/resource/authority/data-theme/ECON ; 4 5 [altri elementi per specificare il dataset] . 6 7 Opzionalmente si può anche specificare 8 9 http://publications.europa.eu/resource/authority/data-theme/ECON 10 a skos:Concept ; 11 skos:prefLabel "Economia e Finanze"@it Capitolo 1. Indice dei contenuti 26
Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 Titolare del dataset dct:rightsHolder elemento valore Cardinalità 1 Stato Obbligatorio Descrizione Il titolare del Dataset. La proprietà lega l’oggetto (dominio) Dataset a un oggetto (codominio) di tipo Agent (Soggetto) (specificato mediante un URI - Uniform Resource Identifier) Riferimento http://purl.org/dc/terms/rightsHolder Nota: Il metadato assume come valore un URI (NON una stringa). Esso rappresenta un’organizzazione (o pubblica amministrazione) responsabile della gestione complessiva del dataset in virtù dei propri compiti istituzionali. Si rac comanda di evitare l’inserimento di nomi di singole persone. Si vedano gli esempi riportati sull’uso della classe Agent (Soggetto) Esempi di uso di dct:rightsHolder JSON-LD 1 "@id": "http://dati.gov.it/resource/Dataset/ContrattiSPC_agid", 2 "@type": [ 3 "dcat:Dataset", 4 "http://dati.gov.it/onto/dcatapit#"Dataset" 5 ], 6 "dcterms:rightsHolder": { 7 "@id": "http://dati.gov.it/resource/Amministraione/agid" 8 }, 9 altri elementi per specificare il dataset 10 11 Dove l'Organizzazione http://dati.gov.it/resource/Amministraione/agid è ˓→definita come: 12 13 "@id": "http://dati.gov.it/resource/Amministrazione/agid", 14 "@type": [ 15 "foaf:Agent", 16 "http://dati.gov.it/onto/dcatapit#"Agent" 17 ], 18 "dcterms:identifier": "agid", 19 "foaf:name": { 20 "@language": "it", 21 "@value": "Agenzia per l'Italia Digitale" 22 } 23 }, RDF/XML 1 <!- http://dati.gov.it/resource/Dataset/ContrattiSPC_agid --> 2 <dcatapit:Dataset rdf:about="http://dati.gov.it/resource/Dataset/ContrattiSPC_agid ˓→"> 1.3. Profilo metadatazione DCAT-AP_IT 27
Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 3 <rdf:type rdf:resource="&dcat;Dataset"/> 4 <dct:rightsHolder rdf:resource="http://dati.gov.it/resource/Amministraione/agid ˓→"/> 5 [altri elementi per specificare il dataset] 6 </dcatapit:Dataset> 7 8 Dove l'organizzazione 9 <!- http://dati.gov.it/resource/Amministrazione/agid --> è definita come: 10 11 <dcatapit:Agent rdf:about="http://dati.gov.it/resource/Amministrazione/agid"> 12 <rdf:type rdf:resource="&foaf;Agent"/> 13 dct:identifieragid</dct:identifier> 14 <foaf:name xml:lang="it">Agenzia per l'Italia Digitale</foaf:name> 15 </dcatapit:Agent> RDF/Turtle 1 http://dati.gov.it/resource/Dataset/ContrattiSPC_agid 2 a dcatapit:Dataset , dcat:Dataset ; 3 dct:rightsHolder http://dati.gov.it/resource/Amministraione/agid ; 4 5 [altri elementi per specificare il dataset] . 6 7 Dove l'organizzazione http://dati.gov.it/resource/Amministraione/agid è definita ˓→come 8 9 http://dati.gov.it/resource/Amministrazione/agid 10 a dcatapit:Agent , foaf:Agent ; 11 dct:identifier "agid" ; 12 foaf:name "Agenzia per l'Italia Digitale" Frequenza aggiornamento dataset dct:accrualPeriodicity elemento valore Cardinalità 1 Stato Obbligatorio Descrizione La frequenza di aggiornamento del Dataset. La proprietà lega l’oggetto (dominio) Dataset a un oggetto (codominio) di tipo dct:Frequency (specificato mediante un URI - Uniform Resource Identifier) Riferimento http://purl.org/dc/terms/accrualPeriodicity Nota: La frequenza con cui il dataset viene aggiornato assume necessariamente uno dei valori definiti nel vo cabolario Europeo sulle frequenze. Esempio –> se il dataset si aggiorna ogni trimestre il valore da indicare è http://publications.europa.eu/resource/authority/frequency/QUARTERLY. Nel caso la frequenza di aggiornamento non sia disponibile è possibile indicare una frequenza sconosciuta utilizzando il seguente URI: http://publications. europa.eu/resource/authority/frequency/UNKNOWN Capitolo 1. Indice dei contenuti 28
Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 Esempi d’uso di dct:accrualPeriodicity JSON-LD 1 "@id": "http://dati.gov.it/resource/Dataset/ContrattiSPC_agid", 2 "@type": [ 3 "dcat:Dataset", 4 "http://dati.gov.it/onto/dcatapit#"Dataset" 5 ], 6 "dcterms:accrualPeriodicity": { 7 "@id": "http://publications.europa.eu/resource/authority/frequency/ANNUAL_2" 8 }, 9 10 altri elementi per specificare il dataset RDF/XML 1 <!- http://dati.gov.it/resource/Dataset/ContrattiSPC_agid --> 2 <dcatapit:Dataset rdf:about="http://dati.gov.it/resource/Dataset/ContrattiSPC_agid"> 3 <rdf:type rdf:resource="&dcat;Dataset"/> 4 <dct:accrualPeriodicity rdf:resource="http://publications.europa.eu/resource/ ˓→authority/frequency/ANNUAL_2"/> 5 [altri elementi per specificare il dataset] 6 </dcatapit:Dataset> RDF/Turtle 1 http://dati.gov.it/resource/Dataset/ContrattiSPC_agid 2 a dcatapit:Dataset , dcat:Dataset ; 3 dct:accrualPeriodicity <http://publications.europa.eu/resource/authority/ ˓→frequency/ANNUAL_2> ; 4 5 [altri elementi per specificare il dataset] Distribuzione del dataset dcat:distribution elemento valore Cardinalità 1..N nel caso di dati aperti, 0..N negli altri casi Stato Obbligatorio nel caso di dati aperti, Opzionale negli altri casi Descrizione La distribuzione del Dataset. La proprietà lega l’oggetto (dominio) Dataset a un oggetto (codominio) di tipo Distribuzione (specificato mediante un URI - Uniform Resource Identifier) Riferimento http://www.w3.org/ns/dcat#distribution Nota: Una distribuzione è una forma attraverso cui il dataset è disponibile. Ogni dataset può essere disponibile in diverse forme, come per esempio diversi formati o differenti endpoint (e.g., SPARQL endpoint). Nel caso di serie temporali o spaziali o viste di un dataset, queste sono descritte mediante le distribuzioni. Per esempio, nel caso di un 1.3. Profilo metadatazione DCAT-AP_IT 29