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

Type: Document | Status: ready

Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 Esempi di uso di dct:language 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:language": { 7 "@id": "http://publications.europa.eu/resource/authority/language/ITA" 8 }, 9 10 altri elementi del 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:language rdf:resource="http://publications.europa.eu/resource/authority/ ˓→language/ITA"/> 5 [altri elementi del dataset] 6 </dcatapit:Dataset> RDF/Turtle 1 http://dati.gov.it/resource/Dataset/ContrattiSPC_agid 2 a dcatapit:Dataset , dcat:Dataset ; 3 dct:language http://publications.europa.eu/resource/authority/language/ITA ; 4 5 [altri elementi del dataset] Parole chiave dataset dcat:keyword elemento valore Cardinalità 0..N Stato Opzionale Descrizione La parole chiave associate al Dataset Riferimento https://www.w3.org/ns/dcat#keyword Nota: inserire una o più parole chiave che consentono di identificare l’oggetto principale del dataset. Se si è scelto di inserire un tema più specifico per il dataset (soggetto o sotto tema) assicurarsi che le parole chiave siano allineate ai temi e sotto temi usati, derivanti dai relativi vocabolari controllati. Si ricorda che nella definizione delle parole chiave non sono ammessi alcuni caratteri come la virgola, l’apostrofo, la “/” e altri caratteri non alfanumerici. Pertanto NON sono ammesse parole chiave come “controllo della qualità dell’aria” oppure “cave dismesse, cave” oppure “legge 190/2012”. In questi casi si suggerisce di sostituirle rispettivamente con “controllo qualità aria” ovvero togliendo testo superfluo, “cave dismesse” “cave” ovvero separando le diverse parole chiave, “legge 190-2012” ovvero inserendo un “-”, ecc. Esempi di uso di dcat:keyword JSON-LD 1.3. Profilo metadatazione DCAT-AP_IT 39

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 "dcat:keyword": [ 7 "Contratto pubblico", 8 "SPC", 9 "Acquisizione" 10 ], 11 12 altri elementi del 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:keywordAcquisizione</dcat:keyword> 5 dcat:keywordSPC</dcat:keyword> 6 dcat:keywordContratto pubblico</dcat:keyword> 7 [altri elementi del dataset] 8 </dcatapit:Dataset> RDF/Turtle 1 http://dati.gov.it/resource/Dataset/ContrattiSPC_agid 2 a dcatapit:Dataset , dcat:Dataset ; 3 dcat:keyword "Acquisizione" , "Contratto pubblico" , "SPC" ; 4 [altri elementi del dataset] Dataset correlato dct:isVersionOf elemento valore Cardinalità 0..N Stato Opzionale Descrizione Un Dataset correlato che è una versione, un’edizione o un adattamento del Dataset descritto. La proprietà lega l’oggetto (dominio) Dataset a uno o più oggetti (codominio) di tipo Dataset (specificato mediante un URI- Uniform Resource Identifier) Riferimento http://purl.org/dc/terms/isVersionOf Nota: Utilizzare l’URI del dataset correlato, ovvero il riferimento a una versione, un’edizione, un adattamento del dataset descritto. Per esempio, se si vuole inserire una nuova versione 2.0 di un dataset già presente nel catalogo (con versione 1.0) si richiede di indicare il riferimento al dataset già incluso nel catalogo. Si sconsiglia fortemente comunque di creare nuovi dataset per piccoli cambiamenti. E’ invece consigliato definire nuovi dataset solo in Capitolo 1. Indice dei contenuti 40

Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 presenza di cambiamenti significativi rispetto a precedenti versioni (e.g., nuovi elementi inclusi, adattamenti significativi di alcuni elementi, ecc). Esempi d’uso di dct:isVersionOf 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:isVersionOf": { 7 "@id": "http://dati.gov.it/resource/Dataset/ContrattiSPC_agid01" 8 }, 9 10 altri elementi del 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:isVersionOf rdf:resource="http://dati.gov.it/resource/Dataset/ContrattiSPC_ ˓→agid01"/> 5 [altri elementi del dataset] 6 </dcatapit:Dataset> RDF/Turtle 1 <http://dati.gov.it/resource/Dataset/ContrattiSPC_agid 2 a dcatapit:Dataset , dcat:Dataset ; 3 dct:isVersionOf http://dati.gov.it/resource/Dataset/ContrattiSPC_agid01 ; 4 5 [altri elementi del dataset] Estensione temporale del dataset dct:temporal elemento valore Cardinalità 0..N Stato Opzionale Descrizione Un periodo temporale coperto dal Dataset. La proprietà lega l’oggetto (dominio) Dataset a uno o più oggetti (codominio) di tipo Periodo di Tempo (specificato mediante un URI- Uniform Resource Identifier) Riferimento http://purl.org/dc/terms/temporal 1.3. Profilo metadatazione DCAT-AP_IT 41

Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 Nota: Questo metadato è utilizzato per rappresentare, per esempio, casi quali “il dataset sul censimento della po­ polazione residente del 2011” oppure “il dataset sulla spesa pubblica dal 2000 al 2015”. Per l’uso pratico di questa proprietà si vedano gli esempi d’uso per la copertura temporale del Dataset. Esempi d’uso di dct:temporal 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:temporal": { 7 "@id": "http://dati.gov.it/resource/PeriodoTemporale/periodTimeContrattiSPC" 8 }, 9 10 altri elementi del 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:temporal rdf:resource="http://dati.gov.it/resource/PeriodoTemporale/ ˓→periodTimeContrattiSPC"/> 5 [altri elementi del dataset] 6 </dcatapit:Dataset> RDF/Turtle 1 <http://dati.gov.it/resource/Dataset/ContrattiSPC_agid 2 a dcatapit:Dataset , dcat:Dataset ; 3 dct:temporal <http://dati.gov.it/resource/PeriodoTemporale/ ˓→periodTimeContrattiSPC> ; 4 5 [altri elementi del dataset] Copertura geografica del dataset dct:spatial elemento valore Cardinalità 0..N Stato Opzionale Descrizione Un’area geografica coperta dal Dataset. La proprietà lega l’oggetto (dominio) Dataset a uno o più oggetti (codominio) di tipo Localizzazione (specificato mediante un URI- Uniform Resource Identifier) Riferimento http://purl.org/dc/terms/spatial Capitolo 1. Indice dei contenuti 42

Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 Nota: Per l’uso pratico di questa proprietà si vedano gli esempi d’uso per la copertura geografica del Dataset Esempi d’uso di dct:spatial 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:spatial": { 7 "@id": "http://www.geonames.org/3169070" 8 }, 9 10 altri elementi del 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:spatial rdf:resource="http://www.geonames.org/3169070"/> 5 [altri elementi del dataset] 6 </dcatapit:Dataset> RDF/Turtle 1 http://dati.gov.it/resource/Dataset/ContrattiSPC_agid 2 a dcatapit:Dataset , dcat:Dataset ; 3 dct:spatial http://www.geonames.org/3169070 ; 4 5 [altri elementi del dataset] Conformità del dataset dct:conformsTo elemento valore Cardinalità 0..N Stato Opzionale Descrizione Una regola implementativa o altra specifica (e.g., una norma) a cui il Dataset è conforme. La proprietà lega l’oggetto (dominio) Dataset a un o più oggetti (codominio) di tipo Standard (specificato mediante un URI- Uniform Resource Identifier) Riferimento http://purl.org/dc/terms/conformsTo 1.3. Profilo metadatazione DCAT-AP_IT 43

Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 Nota: Specificare uno o più standard riferibili al dataset. Si possono specificare sia standard tecnici (anche de-facto) come per esempio DCAT, ISO/IEC 25012, CSW, ecc., sia riferimenti normativi (e.g., Decreto legislativo n.82/2005 ­ Codice dell’Amministrazione Digitale). Per l’uso pratico di questa proprietà si vedano gli esempi d’uso per lo Standard del Dataset Esempi di uso di dct:conformsTo 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:conformsTo": { 7 "@id": "http://dati.gov.it/resource/Standard/standard-org" 8 }, 9 10 altri elementi del 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:conformsTo rdf:resource="http://dati.gov.it/resource/Standard/standard-org"/ ˓→> 5 [altri elementi del dataset] 6 </dcatapit:Dataset> RDF/Turtle 1 <http://dati.gov.it/resource/Dataset/ContrattiSPC_agid 2 a dcatapit:Dataset , dcat:Dataset ; 3 dct:conformsTo http://dati.gov.it/resource/Standard/standard-org ; 4 5 [altri elementi del dataset] Capitolo 1. Indice dei contenuti 44

Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 Altro identificativo del dataset adms:identifier elemento valore Cardinalità 0..N Stato Opzionale Descrizione Un eventuale identificativo secondario del Dataset (e.g., DOI, ISBN, W3ID, ecc.). La proprietà lega l’oggetto (dominio) Dataset a uno o più oggetti (codominio) di tipo Altro Identificativo (specificato mediante un URI- Uniform Resource Identifier) Riferimento http://www.w3.org/ns/adms#identifier Nota: Specificare uno o più identificativi secondari per il dataset. Per esempio, un identificativo secondario può essere un identificativo DOI (e.g., doi:10.10.1038/nphys1170) oppure un identificativo permanente per il Web W3ID (e.g., http://w3id.org/food) oppure un identificativo stabile utilizzato in cataloghi locali. Per l’uso pratico di questa proprietà si vedano gli esempi d’uso per l’Identificativo Alternativo del Dataset Esempi di uso di adms: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 "adms:identifier": { 7 "@id": "http://dati.gov.it/resource/Identifier/ContrattiSPC_agid_altroID" 8 }, 9 10 altri elementi del 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 <adms:identifier rdf:resource="http://dati.gov.it/resource/Identifier/ ˓→ContrattiSPC_agid_altroID"/> 5 [altri elementi del dataset] 6 </dcatapit:Dataset> RDF/Turtle 1 <http://dati.gov.it/resource/Dataset/ContrattiSPC_agid 2 a dcatapit:Dataset , dcat:Dataset ; 3 adms:identifier <http://dati.gov.it/resource/Identifier/ContrattiSPC_agid_ ˓→altroID> ; 1.3. Profilo metadatazione DCAT-AP_IT 45

Agenzia per l'Italia Digitale datipubblici - linee guida cataloghi dati, Release 1.0 4 5 [altri elementi del dataset] Distribuzione dcatapit:Distribution Una distribuzione è definita mediante la classe Distribution (Distribuzione) identificata univocamente da un URI (Uniform Resource Identifier). elemento valore URI dcatapit:Distribution Sottoclasse dcat:Distribution Descrizione La distribuzione del dataset da descrivere Cardinalità 1..N (se in presenza di dati aperti) Stato Obbligatorio (se in presenza di dati aperti) Riferimento http://www.dati.gov.it/onto/dcatapit#Distribution Esempi Esempi d’uso per dcatapit:Distribution JSON-LD 1 { 2 "@id": "http://dati.gov.it/resource/Distribuzione/SPCContratti_agid-N3", 3 "@type": [ 4 "http://dati.gov.it/onto/dcatapit#"Distribution", 5 "dcat:Distribution" 6 ], 7 "dcat:accessURL": { 8 "@id": "http://spcdata.digitpa.gov.it:8899/sparql" 9 }, 10 "dcat:downloadURL": { 11 "@id": "http://spcdata.digitpa.gov.it/data/contrattiLotto1.nt" 12 }, 13 "dcterms:description": { 14 "@language": "it", 15 "@value": "Questa è la distribuzione N3 del dataset Linked Open Data ˓→relativo ai contratti del Sistema Pubblico di Connettività" 16 }, 17 "dcterms:format": { 18 "@id": "http://publications.europa.eu/resource/authority/file-type/RDF" 19 }, 20 "dcterms:license": { 21 "@id": "http://creativecommons.org/licenses/by/4.0/" 22 }, 23 "dcterms:title": "Distribuzione Turtle di LOD SPC Contratti" 24 }, RDF/XML 1 <!-­ http://dati.gov.it/resource/Distribuzione/SPCContratti_agid-N3 --> 2 3 <dcatapit:Distribution rdf:about="http://dati.gov.it/resource/Distribuzione/ ˓→SPCContratti_agid-N3"> 46 Capitolo 1. Indice dei contenuti