Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 5 6 1 2 3 4 [altri elementi per specificare la distribuzione] </dcatapit:Distribution> RDF/Turtle http://dati.gov.it/resource/Distribuzione/SPCContratti_agid-N3 a dcatapit:Distribution , dcat:Distribution ; dcat:byteSize "3000"^^xsd:float ; [altri elementi per specificare la distribuzione] Soggetto o Organizzazione dcatapit:Agent Un soggetto/organizzazione è definito mediante la specifica della classe Agente (Agent) identificata univocamente da un URI (Uniform Resource Identifier). elemento valore URI dcatapit:Agent Sottoclasse foaf:Agent Descrizione Un soggetto/organizzazione che gioca un certo ruolo sul catalogo e sui dataset del catalogo Cardinalità 1..N Stato Obbligatorio Riferimento http://www.dati.gov.it/onto/dcatapit#Agent Esempi esempi d’uso per dcatapit:Agent JSON-LD 1 { 2 "@id": "http://dati.gov.it/resource/Amministrazione/agid", 3 "@type": [ 4 "foaf:Agent", 5 "http://dati.gov.it/onto/dcatapit#"Agent" 6 ], 7 "dcterms:identifier": "agid", 8 "foaf:name": { 9 "@language": "it", 10 "@value": "Agenzia per l'Italia Digitale" 11 } 12 }, RDF/XML 1 <!- http://dati.gov.it/resource/Amministrazione/agid --> 2 3 <rdf:Description rdf:about="http://dati.gov.it/resource/Amministrazione/agid"> 4 <rdf:type rdf:resource="http://dati.gov.it/onto/dcatapit#"Agent"/> 5 <rdf:type rdf:resource="&foaf;Agent"/> 6 dct:identifieragid</dct:identifier> 7 <foaf:name xml:lang="it">Agenzia per l'Italia Digitale</foaf:name> 8 </rdf:Description> 1.3. Profilo metadatazione DCAT-AP_IT 55
Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 RDF/TURTLE 1 2 3 4 http://dati.gov.it/resource/Amministrazione/agid a dcatapit:Agent , foaf:Agent ; dct:identifier "agid" ; foaf:name "Agenzia per l'Italia Digitale" Elementi obbligatori Identificativo del soggetto dct:identifier elemento valore Cardinalità 1 Stato Obbligatorio Descrizione L’identificativo del soggetto (organizzazione) Riferimento http://purl.org/dc/terms/identifier Nota: Nel caso di pubbliche amministrazioni, l’identificativo è rappresentato dal codice IPA (Indice della Pubblica Amministrazione). Per organizzazioni private, l’identiticativo è rappresentato dalla Partita IVA. Si consiglia di far riferimento all’organizzazione e non a singoli uffici. Esempi –> “agid” oppure “r_lazio”. Nome del soggetto foaf:name elemento valore Cardinalità 1 Stato Obbligatorio Descrizione Il nome del soggetto (organizzazione) Riferimento http://xmlns.com/foaf/0.1/name Nota: Specificare il nome ufficiale della pubblica amministrazione così come riportato nell’Indice della Pubblica Amministrazione. Nel caso di oganizzazione privata, specificare il nome ufficiale della stessa così come riportato nel Registro Imprese. Esempio –> “Agenzia per l’Italia Digitale”. Licenza dcatapit:LicenseDocument La licenza è definita mediante la specifica della classe dcatapti:LicenseDocument identificata univocamente da un URI (Uniform Resource Identifier). elemento valore URI dcatapit:LisenceDocument Sottoclasse dct:LicenseDocument Descrizione La licenza della distribuzione del dataset. Cardinalità 1 Stato Obbligatorio Riferimento http://www.dati.gov.it/onto/dcatapit#LicenseDocument Capitolo 1. Indice dei contenuti 56
Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 Esempi Esempi d’uso per dcatapit:LicenseDocument JSON-LD 1 { 2 "@id": "http://creativecommons.org/licenses/by/4.0/", 3 "@type": [ 4 "http://dati.gov.it/onto/dcatapit#"LicenseDocument", 5 "dcterms:LicenseDocument" 6 ], 7 "dcterms:type": { 8 "@id": "http://purl.org/adms/licencetype/Attribution" 9 }, 10 "foaf:name": "CC BY", 11 "owl:versionInfo": "4.0" 12 }, RDF/XML 1 <!- http://creativecommons.org/licenses/by/4.0/ --> 2 <dcatapit:LicenseDocument rdf:about="http://creativecommons.org/licenses/by/4.0/"> 3 <rdf:type rdf:resource="&dct;LicenseDocument"/> 4 <dct:type rdf:resource="http://purl.org/adms/licencetype/Attribution"/> 5 owl:versionInfo4.0</owl:versionInfo> 6 foaf:nameCC BY</foaf:name> 7 </dcatapit:LicenseDocument> RDF/Turtle 1 http://creativecommons.org/licenses/by/4.0/ 2 a dcatapit:LicenseDocument , dct:LicenseDocument ; 3 dct:type http://purl.org/adms/licencetype/Attribution ; 4 foaf:name "CC BY" ; 5 owl:versionInfo "4.0" . Elementi raccomandati Tipo licenza dct:type elemento valore Cardinalità 0..1 Stato Raccomandato Descrizione Il tipo di licenza associata alla distribuzione del dataset. La proprietà lega l’oggetto (dominio) Licenza a un oggetto (codominio) di tipo skos:Concept (specificato mediante un URI - Uniform Resource Identifier) Riferimento http://purl.org/dc/terms/type 1.3. Profilo metadatazione DCAT-AP_IT 57
Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 Nota: Indicare il tipo di licenza. Esempi –> “pubblico dominio”, “richiesto pagamento diritti”. I valori da utilizzare per questa proprietà sono gli URI dei concetti del vocabolario ADMS licence type vocabulary. Elementi opzionali Nome licenza foaf:name elemento valore Cardinalità 0..N (possono esistere più istanze di questa proprietà, una per ogni lingua Stato Opzionale Descrizione Il nome della licenza Riferimento http://xmlns.com/foaf/0.1/name Nota: Indicare il nome della licenza associata alla distribuzione. Esempi –> “CC_BY” oppure “Creative Commons Attribution (CC-BY)”. Versione licenza owl:versionInfo elemento valore Cardinalità 0..1 Stato Opzionale Descrizione La versione della licenza Riferimento http://www.w3.org/2002/07/owl#versionInfo Nota: Indicare la versione della licenza. Esempi –> “4.0” oppure “3.0” Punto di contatto dcatapit:Organization Il punto di contatto è definito mediante la specifica della classe dcatapti:Organization identificata univocamente da un URI (Uniform Resource Identifier). elemento valore URI dcatapit:Organization Sottoclasse vcard:Organization, a sua volta sotto classe di vcard:Kind Descrizione Un ufficio/organizzazione che agisce come punto di contatto per il dataset Cardinalità 0..N Stato Raccomandato Riferimento http://www.dati.gov.it/onto/dcatapit#Organization Esempi Esempi d’uso per dcatapit:Organization JSON-LD Capitolo 1. Indice dei contenuti 58
Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 1 { 2 "@id": "http://dati.gov.it/resource/PuntoContatto/contactPointLODIPA", 3 "@type": [ 4 "vcard:Organization", 5 "vcard:Kind", 6 "http://dati.gov.it/onto/dcatapit#"Organization" 7 ], 8 "vcard:fn": "banche dati e open data", 9 "vcard:hasEmail": { 10 "@id": "mailto:[email protected]" 11 }, 12 "vcard:hasTelephone": { 13 "@id": ":N423506244f6e46028ea51a957fe407f3" 14 }, 15 "vcard:hasURL": { 16 "@id": "http://spcdata.digitpa.gov.it/contattaci.html" 17 } 18 { 19 "@id": ":N423506244f6e46028ea51a957fe407f3", 20 "@type": "vcard:Voice", 21 "vcard:value": "06123456" 22 }, 23 }, RDF/XML 1 <!- http://dati.gov.it/resource/PuntoContatto/contactPointLODIPA --> 2 <dcatapit:Organization rdf:about="http://dati.gov.it/resource/PuntoContatto/ ˓→contactPointLODIPA"> 3 <rdf:type rdf:resource="&vcard;Kind"/> 4 <rdf:type rdf:resource="&vcard;Organization"/> 5 <vcard:hasEmail rdf:resource="mailto:[email protected]"/> 6 vcard:fnbanche dati e open data</vcard:fn> 7 <vcard:hasTelephone rdf:parseType="Resource"> 8 vcard:value06123456</vcard:value> 9 <rdf:type rdf:resource="http://www.w3.org/2006/vcard/ns#Voice"/> 10 </vcard:hasTelephone> 11 <vcard:hasURL rdf:resource="http://spcdata.digitpa.gov.it/contattaci.html"/> 12 </dcatapit:Organization> RDF/Turtle 1 http://dati.gov.it/resource/PuntoContatto/contactPointLODIPA 2 a dcatapit:Organization , vcard:Organization, vcard:Kind ; 3 vcard:fn "banche dati e open data" ; 4 vcard:hasEmail mailto:[email protected] ; 5 vcard:hasTelephone [ a vcard:Voice ; vcard:value "06123456" ] ; 6 vcard:hasURL http://spcdata.digitpa.gov.it/contattaci.html . 1.3. Profilo metadatazione DCAT-AP_IT 59
Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 Elementi obbligatori Nome punto di contatto vcard:fn elemento valore Cardinalità 1 Stato Obbligatorio Descrizione Il nome del contatto stabile per il dataset Riferimento http://www.w3.org/2006/vcard/ns#fn Nota: E’ fortemente raccomandato indicare il nome di uno specifico ufficio (unità organizzativa) responsa bile della raccolta delle richieste/commenti e della predisposizione delle relative risposte. Solo se non è pos sibile individuare il riferimento dell’ufficio, si può indicare l’organizzazione nel suo complesso. Sono da evitare comunque nomi di singole persone. Questo metadato deve essere specificato qualora si inseriscano informazio ni di contatto per il dataset. Per esempio, per il dataset LOD dell’Indice della Pubblica amministrazione il nome dell’ufficio/organizzazione è “banche dati e open data”. Email punto di contatto vcard:hasEmail elemento valore Cardinalità 1 Stato Obbligatorio Descrizione L’indirizzo email del punto di contatto per il Dataset. La proprietà lega l’oggetto (dominio) Punto di Contatto a un oggetto (codominio) di tipo vcard:Email (specificato mediante un URI - Uniform Resource Identifier) Riferimento http://www.w3.org/2006/vcard/ns#hasEmail Nota: Indicare l’indirizzo email primario dell’ufficio (o gestito dall’ufficio) identificato come punto di contatto per il dataset. Se non è possibile identificare l’ufficio, si può inserire l’indirizzo email principale dell’organizzazio ne. Evitare in ogni caso di specificare indirizzi email di singole persone fisiche. Questo metadato deve essere specificato qualora si inseriscano informazioni di contatto per il dataset. Esempio –> “mailto:[email protected]“ Capitolo 1. Indice dei contenuti 60
Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 Elementi opzionali Telefono punto di contatto vcard:hasTelephone elemento valore Cardinalità 0..1 Stato Opzionale Descrizione Il telefono del contatto stabile per il dataset. La proprietà lega l’oggetto Punto di Contatto a un oggetto (codominio) di tipo vcard:TelephoneType (specificato mediante un URI - Uniform Resource Identifier). Riferimento http://www.w3.org/2006/vcard/ns#hasTelephone Nota: Indicare il numero di telefono dell’ufficio (o gestito dall’ufficio) identificato come punto di contat to per il dataset. Se non è possibile identificare l’ufficio, si può indicare il numero di telefono del centralino dell’amministrazione. Evitare in ogni caso di specificare numeri di telefono di singole persone. Sito punto di contatto vcard:hasURL elemento valore Cardinalità 0..1 Stato Opzionale Descrizione La pagina di contatto per il Dataset. La proprietà lega l’oggetto (dominio) Punto di Contatto a un oggetto (codominio) di tipo owl:Thing (specificato mediante un URI - Uniform Resource Identifier) Riferimento http://www.w3.org/2006/vcard/ns#hasURL Nota: Se esiste, inserire l’URL primario di una pagina di contatto o di un form di contatto. Evitare il più possibile di indicare l’URL dell’home page dell’organizzazione. Un esempio di possibile valore per questo metadato è il seguente “http://spcdata.digitpa.gov.it/contattaci.html (NON dovrebbe essere per esempio “http://www.agid.gov.it”). Nel caso in cui si abbia la necessità di indicare ulteriori URL di interesse per la risorsa descritta, oltre a quello principale, si possono aggiungere più istanze della proprietà foaf:page. Copertura temporale dct:PeriodOfTime La copertura (o estensione) temporale del dataset è definita mediante la specifica della classe PeriodOfTime (Periodo di Tempo) identificata univocamente da un URI (Uniform Resource Identifier). 1.3. Profilo metadatazione DCAT-AP_IT 61
Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 elemento valore URI dct:PeriodOfTime Descrizione L’estensione temporale del dataset Cardinalità 0..N Stato Opzionale Riferimento http://purl.org/dc/terms/PeriodOfTime Esempi Esempi d’uso per dct:PeriodOfTime JSON-LD 1 { 2 "@id": "http://dati.gov.it/resource/PeriodoTemporale/periodTimeLinkedOpenIPA", 3 "@type": "dcterms:PeriodOfTime", 4 "http://dati.gov.it/onto/dcatapit#"startDate": { 5 "@type": "xsd:date", 6 "@value": "2016-01-01" 7 } 8 } RDF/XML 1 <!- http://dati.gov.it/resource/PeriodoTemporale/periodTimeLinkedOpenIPA --> 2 <dct:PeriodOfTime rdf:about="http://dati.gov.it/resource/PeriodoTemporale/ ˓→periodTimeLinkedOpenIPA"> 3 <dcatapit:startDate rdf:datatype="&xsd;date">2016-01-01</dcatapit:startDate> 4 </dct:PeriodOfTime> RDF/Turtle 1 http://dati.gov.it/resource/PeriodoTemporale/periodTimeContrattiSPC 2 a dct:PeriodOfTime ; 3 dcatapit:startDate "2007-01-01"^^xsd:date ; 4 dcatapit:endDate "2012-12-31"^^xsd:date . Elemento obbligatori Data inizio dcatapit:startDate elemento valore Cardinalità 1 Sottoproprietà schema:startDate Stato Obbligatorio Descrizione La data di inizio del Periodo di tempo (estensione temporale) Riferimento http://dati.gov.it/onto/dcatapit#startDate Nota: Qualora si indichi una copertura temporale per il dataset è obbligatorio specificare almeno la data di inizio Capitolo 1. Indice dei contenuti 62
Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 Elemento opzionali Data inizio dcatapit:endDate elemento valore Cardinalità 0..1 Sottoproprietà schema:endDate Stato Opzionale Descrizione La data di fine del Periodo di tempo (estensione temporale) Riferimento http://dati.gov.it/onto/dcatapit#endDate Nota: Indicare la data di fine del periodo temporale qualora il periodo temporale complessivo è ultimato. Nel caso di periodi temporali ancora aperti alla data corrente, si può evitare di specificare questo metadato. Copertura geografica dct:Location La copertura geografica del dataset è definita mediante la specifica della classe Location (Localizzazione) identificata univocamente da un URI (Uniform Resource Identifier). elemento valore URI dct:Location: Descrizione La copertura geografica del dataset. Cardinalità 0..N Stato Opzionale Riferimento http://purl.org/dc/terms/Location Esempi Esempi d’uso di dct:Location e locn:Geometry JSON-LD 1 { 2 "@id": "http://dati.gov.it/resource/CoperturaSpaziale/ ˓→LocalizzazioneStudiMedici_r_liguri:D.658", 3 "@type": "dcterms:Location", 4 "locn:geometry": { 5 "@type": "gsp:gmlLiteral", 6 "@value": "<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>" 7 } 8 }, RDF/XML 1 <!- http://dati.gov.it/resource/CoperturaSpaziale/LocalizzazioneLineaCosta --> 2 <dct:Location rdf:about="http://dati.gov.it/resource/CoperturaSpaziale/ ˓→LocalizzazioneLineaCosta_r_liguri:D.658"> 3 <locn:geometry rdf:datatype="&gsp;gmlLiteral"><gml:Envelope 4 srsName="http://www.opengis.net/def/EPSG/0/4326">< ˓→gml:lowerCorner>7.488208623 1.3. Profilo metadatazione DCAT-AP_IT 63