Standard for beskrivelse av datasett med høy verdi (HVD-DCAT-AP-NO)

Dette dokumentet kan også lastes ned som PDF.

Innmelding av feil og mangler:
Dersom du finner feil eller mangler i dokumentet, ber vi om at dette meldes inn på Github Issues ⧉. Dersom du ikke allerede har bruker på Github kan du opprette bruker gratis.

Lisens: CC BY 4.0 ⧉
Status: under arbeid
Versjon: utkast til kommende v.1.0
Publisert: ikke publisert (basert på høringsversjon av 2024-08-16)
Oppdatert: løpende oppdateres
Gjeldende versjon: ingen
Forrige versjon: ingen
Redaktørens utkast: https://informasjonsforvaltning.github.io/hvd-dcat-ap-no/

Om denne versjonen

Dette er et utkast til den kommende v.1.0 av HVD-DCAT-AP-NO, som er under arbeid og som løpende oppdateres inntil den endelige v.1.0 blir ferdigstilt og publisert (tentativt i løpet av det siste kvartalet av 2024). Dette utkastet bygger på forslaget til v.1.0 (høringsversjonen) som var til høring (med høringsfrist 1. okt. 2024), og tar inn endringer som følger av høringsinnspill, etter hvert som innspillene blir håndtert av en redaksjonsgruppe ved Digdir.

Abstract in English

English speaking readers, you may click here to read what this standard is about and how you may read it.

This standard, HVD-DCAT-AP-NO, is the Norwegian application profile of EUs DCAT-AP High Value Datasets ⧉. It specifies how to describe high value datasets, and how to make the descriptions available in machine-readable RDF-based formats. This standard supplements and thus also should be used together with DCAT-AP-NO ⧉. Only HVD-specific requirements are specified in this standard.

The standard is mainly in Norwegian. However, in Chap. 3 which requires a certain level of knowledge in RDF, the specification of the classes and properties is in both Norwegian and English.

1. Om denne standarden

1.1. Innledning

Formålet med standarden er å legge til rette for utveksling av beskrivelser av datasett med høy verdi (på engelsk High Value Dataset, forkortet til HVD). HVD-forordningen (EU) 2023/138 ⧉ som p.t. er under vurdering i EØS-EFTA, spesifiserer datasett av høy verdi innenfor følgende seks tematiske kategorier: (1) geodata, (2) jordobservasjon og miljø, (3) meteorologi, (4) statistikk, (5) selskaps- og eierskapsdata, og (6) mobilitet. Forordningen stiller bl.a. også et minimumskrav til metadata i beskrivelser av HVD.

Denne standarden supplerer Standard for beskrivelse av datasett, datatjenester og datakataloger (DCAT-AP-NO) ⧉, og beskriver hvordan DCAT-AP-NO brukes til å implementere minimumskrav til metadata for HVD spesifisert i ovennevnte forordningen.

Se ellers formålet med DCAT-AP-NO ⧉ som også gjelder for denne standarden.

1.2. Omfang og avgrensing

Standarden inneholder kun spesifikasjon til hvordan DCAT-AP-NO brukes til å implementere minimumskrav til metadata for HVD spesifisert i den ovennevnte HVD-forordningen. Kravene ellers i DCAT-AP-NO gjelder også for HVD. Denne standarden skal derfor brukes sammen med, og ikke istedenfor, DCAT-AP-NO.

Standarden er ikke tenkt brukt for å beskrive fagsystem.

1.3. Forvaltningsregime

Dersom det oppdages mindre feil i standarden (stavefeil, upresis formulering, lenkefeil etc.), vil ikke korrigering av disse utløse en ny versjon. Disse korrigeringene skal imidlertid dokumenteres.

Utarbeidelse av nye versjoner av denne standarden initieres av Digitaliseringsdirektoratet. Den primære kilden til nye versjoner vil være endringer i EU-standarden DCAT-AP High Value Datasets ⧉ som denne standarden baseres på, og/eller DCAT-AP-NO ⧉ som denne supplerer.

Digitaliseringsdirektoratet vil i forbindelse med nye versjoner av ovennevnte bakenforliggende standarder avgjøre om endringene er så store at det bør nedsettes en egen arbeidsgruppe bestående av relevante aktører, eller om revisjonen kan utføres av Digitaliseringsdirektoratet selv. Forslaget til ny hovedversjon (engelsk "major release") sendes uansett på høring. De innkomne høringskommentarene behandles hos Digitaliseringsdirektoratet, og resulterer i et forslag som oversendes Arkitektur- og standardiseringsrådet ⧉. I lys av anbefalinger fra rådet vil Digitaliseringsdirektoratet fatte beslutning om den reviderte hovedversjonen av standarden skal være gjeldende eller forkastes.

Gjeldende og eventuelle tidligere versjoner av standarden skal være tilgjengelige på Digitaliseringsdirektoratets nettsider, slik at det er enkelt å finne ut når tidligere versjoner var gyldige, og hvilke endringer som er foretatt mellom to versjoner.

1.4. Om kravnivåene i denne standarden

Standarden bruker ordene «obligatorisk» («SKAL», «MÅ», "mandatory", "required", "SHALL", "MUST"), «anbefalt» («BØR», "recommended", "SHOULD") og «valgfri» («KAN», "optional", "MAY"), med de samme betydningene som er forklart i DCAT-AP-NO ⧉. Forklaringen gjentas derfor ikke her.

1.5. Krav til samsvar

1.5.1. Krav til applikasjoner som leverer metadata

For å være i samsvar med denne standarden, SKAL en applikasjon som levere metadata:

Levere en beskrivelse av katalogen, som minimum med de obligatoriske egenskapene spesifisert i klassen Katalog (dcat:Catalog) i DCAT-AP-NO ⧉.
Levere beskrivelser av datasettene som er i katalogen, som minimum med de obligatoriske egenskapene spesifisert i klassen Datasett (dcat:Dataset) i denne standarden og i DCAT-AP-NO ⧉.
Levere beskrivelser av distribusjoner, hvis noen, av datasett i katalogen, som minimum med de obligatoriske egenskapene spesifisert i klassen Distribusjon (dcat:Distribution) i denne standarden og i DCAT-AP-NO ⧉.
Levere beskrivelser av datatjenester, hvis noen, i katalogen, som minimum med de obligatoriske egenskapene spesifisert i klassen Datatjeneste (dcat:DataService) i denne standarden og i DCAT-AP-NO ⧉.
Levere informasjon om alle organisasjoner/aktører som er involvert i beskrivelsene av katalogen, datasettene osv., som minimum med de obligatoriske egenskapene spesifisert i klassen Aktør i DCAT-AP-NO ⧉.
Bruke de kontrollerte vokabularene som er beskrevet i Merknad til den enkelte egenskapen i denne standarden og i DCAT-AP-NO ⧉.

1.5.2. Krav til applikasjoner som mottar metadata

For å være i samsvar med denne standarden, SKAL en applikasjon som mottar metadata:

Prosessere informasjon for alle klasser og egenskaper som er spesifisert i denne standarden og i DCAT-AP-NO.
Prosessere informasjon for alle kontrollerte vokabularer som er eksplisitt spesifisert for de enkelte egenskapene i denne standarden og i DCAT-AP-NO.

I konteksten av denne standarden, betyr det «å prosessere» at den mottakende applikasjon aksepterer innkommende data og transparent videreformidler dataene til aktuelle applikasjoner og tjenester.

2. Forenklet fremstilling av kravene i HVD-DCAT-AP-NO

Denne standarden inneholder kun HVD-spesifikke krav. Kravene ellers i DCAT-AP-NO gjelder også for HVD. Denne standarden skal derfor brukes sammen med, og ikke istedenfor, DCAT-AP-NO.

2.1. HVD-spesifikke krav

Figur 1 viser en forenklet fremstilling av kravene i HVD-DCAT-AP-NO. Den viser kun obligatoriske og anbefalte opplysninger som skal/bør tas med i beskrivelse av datasett, datasettserier, datatjenester og distribusjoner, i konteksten HVD. HVD-DCAT-AP-NO skal brukes sammen med DCAT-AP-NO, ettersom den supplerer DCAT-AP-NO. HVD-spesifikke krav er markert i gult i tegningen.

Tegningen er ikke ment som en formell representasjon av standarden, men kun for å gi en visuell oversikt over noen av kravene. Tekniske krav til hvordan HVD-spesifikke opplysninger skal uttrykkes i RDF er spesifisert videre i standarden. Før eventuell uoverensstemmelse mellom tegningen og den tekstlige spesifikasjonen blir rettet opp, har den tekstlige spesifikasjonen forrang. Samme forrang gjelder også når det gjelder eventuelle uoverensstemmelser mellom tekstlige spesifikasjoner og tegninger i resten av standarden.

Figur 1. Forenklet fremstilling av kravene i HVD-DCAT-AP-NO, med kun obligatoriske og anbefalte krav.

I tillegg til de ikke-HVD-spesifikke obligatoriske kravene i DCAT-AP-NO som ikke gjentas i denne standarden, illustrerer figuren bl.a. følgende obligatoriske krav som er HVD-spesifikke:

Et datasett med høy verdi SKAL gjøres tilgjengelig. Se HVD-forordningen om det aktuelle datasettet skal gjøres tilgjengelig både via API (datatjeneste) og som bulknedlasting (distribusjon), eller en av de to måtene.
- Et datasett kan inngå i en datasettserie. Se også Om bruk av datasettserie i DCAT-AP-NO ⧉.
Datasett med høy verdi og relaterte distribusjoner og APIer (datatjenester), samt ev. datasettserie(r) som datasettet inngår i, SKAL oppgi HVD-forordningen ⧉ som gjeldende lovgivning.
Det SKAL oppgis HVD-kategori(er) et datasett med høy verdi tilhører. Samme krav gjelder også APIer (datatjenester) som tilgjengeliggjør datasett med høy verdi og ev. datasettserie(r) som et datasett med høy verdi inngår i. EUs kontrollerte vokabular for HVD-kategorier ⧉ SKAL brukes.
Et API (en datatjeneste) som tilgjengeliggjør datasett med høy verdi, SKAL ha dokumentasjon som beskriver bl.a. tjenestekvalitet.

2.2. Eksempel på et HVD

Eksemplet her er basert på datasettet «Virksomhetsinformasjon - i henhold til STIRDatas modell» beskrevet i Felles datakatalog (data.norge.no) ⧉. Eksemplet har kun som hensikt å illustrere bruken av standarden, og gjenspeiler ikke nødvendigvis virkeligheten. Eksemplet er heller ikke komplett. Det inneholder kun noen av de opplysningene som det stilles krav til i denne standarden. Minimumsopplysninger er uthevet, og maskinlesbare verdier oppgitt i parenteser.

gjeldende lovgivning: HVD-forordningen (http://data.europa.eu/eli/reg_impl/2023/138/oj )
HVD-kategori: selskaps- og eierskapsdata (http://data.europa.eu/bna/c_a9135398)
i samsvar med: STIRData business data model (https://stirdata.github.io/data-specification/)
datasettdistribusjon (bulknedlasting):
- gjeldende lovgivning: HVD-forordningen (http://data.europa.eu/eli/reg_impl/2023/138/oj)
- lisens: CC BY 4.0 (http://publications.europa.eu/resource/authority/licence/CC_BY_4_0)
- i samsvar med: STIRData business data model (https://stirdata.github.io/data-specification/)
datatjeneste (API):
- dokumentasjon: Enhetsregisterets dokumentasjon for åpne data (https://data.brreg.no/enhetsregisteret/api/dokumentasjon/)
- gjeldende lovgivning: HVD-forordningen (http://data.europa.eu/eli/reg_impl/2023/138/oj)
- HVD-kategori: selskaps- og eierskapsdata (http://data.europa.eu/bna/c_a9135398)
- lisens: CC BY 4.0 (http://publications.europa.eu/resource/authority/licence/CC_BY_4_0)

3. Krav til RDF-representasjon av klassene i HVD-DCAT-AP-NO

HVD-DCAT-AP-NO supplerer DCAT-AP-NO, og spesifiserer hvordan DCAT-AP-NO brukes til å implementere kravene i HVD-forordningen. HVD-DCAT-AP-NO inneholder kun krav som er HVD-spesifikke. Kravene i DCAT-AP-NO som ikke er HVD-spesifikke, gjentas ikke i HVD-DCAT-AP-NO, men de gjelder også for HVD. HVD-DCAT-AP-NO skal derfor brukes sammen med DCAT-AP-NO.

3.1. Klassen Datasett (dcat:Dataset)

Figur 2 viser klassen Datasett og dens egenskaper, samt klassene den refererer til. I figuren er differansen mellom kravene i HVD-DCAT-AP-NO og DCAT-AP-NO markert i gult. Kun kravene som er spesifikke for HVD er videre spesifisert i dette kapittelet. Kravene ellers til klassen Datasett (dcat:Dataset) i DCAT-AP-NO ⧉ gjelder også for denne klassen.

Figur 2. Klassen Datasett og klassene den refererer til.

English name

Dataset

URI

dcat:Dataset

Subklasse av / Subclass of

dcat:Resource ⧉

Anvendelse / Usage note

Klassen brukes til å representere et datasett, dvs. en konseptuell entitet som representerer publisert informasjon.

This class is used to represent a conceptual entity that represents the information published.

3.1.1. Obligatoriske egenskaper for klassen Datasett

3.1.1.1. Datasett – gjeldende lovgivning (dcatap:applicableLegislation)

English name

applicable legislation

URI

dcatap:applicableLegislation

Verdiområde / Range

eli:LegalResource ⧉

Anvendelse / Usage note

Egenskapen brukes til å referere til lovgivningen som gir mandat til opprettelse eller behandling av datasettet.

This property is used to refer to the legislation that mandates the creation or management of the dataset.

Multiplisitet / Multiplicity

1..n

Kravnivå / Requirement level

Obligatorisk / Mandatory

Merknad / Note

For HVD SKAL en av verdiene være http://data.europa.eu/eli/reg_impl/2023/138/oj.

For HVD the value MUST include the ELI http://data.europa.eu/eli/reg_impl/2023/138/oj.

Eksempel i RDF Turtle:

<aDataset> a dcat:Dataset ;
   dcatap:applicableLegislation <http://data.europa.eu/eli/reg_impl/2023/138/oj> ; .

3.1.1.2. Datasett – HVD-kategori (dcatap:hvdCategory)

English name

HVD category

URI

dcatap:hvdCategory

Verdiområde / Range

skos:Concept

Anvendelse / Usage note

Egenskapen brukes til å referere til HVD kategorien som dette datasettet tilhører.

This property is used to refer to HVD category to which this dataset belongs.

Multiplisitet / Multiplicity

1..n

Kravnivå / Requirement level

Obligatorisk / Mandatory

Merknad / Note

Verdien SKAL hentes fra EUs kontrollerte vokabular High-value dataset categories ⧉.

The value MUST be chosen from EU’s controlled vocabulary High-value dataset categories ⧉.

Eksempel i RDF Turtle:

<aDataset> a dcat:Dataset ;
   dcatap:hvdCategory <http://data.europa.eu/bna/c_a9135398> ; .

3.1.2. Anbefalte egenskaper for klassen Datasett

3.1.2.1. Datasett – datasettdistribusjon (dcat:distribution)

English name

dataset distribution

URI

dcat:distribution

Verdiområde / Range

dcat:Distribution

Anvendelse / Usage note

Egenskapen brukes til å referere til en tilgjengelig distribusjon for datasettet. Se også 4.2, “Spesielt om distribusjoner og datatjenester for datasett med høy verdi”.

This property is used to refer to an available distribution for the dataset.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Anbefalt / Recommended

Eksempel i RDF Turtle:

<aDataset> a dcat:Dataset ;
   dcat:distribution <aDistribution> ; .

3.1.3. Valgfrie egenskaper for klassen Datasett

3.1.3.1. Datasett – i samsvar med (dct:conformsTo)

English name

conforms to

URI

dct:conformsTo

Verdiområde / Range

dct:Standard ⧉

Anvendelse / Usage note

Egenskapen brukes til å referere til en implementasjonsregel eller annen spesifikasjon, som ligger til grunn for opprettelsen av datasettet.

This property is used to refer to an implementing rule or other specification.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional

Merknad / Note

Informasjonen som oppgis her bør gjøre det mulig å verifisere om detaljerte krav til den aktuelle kategori av HVD er tilfredsstilt. Se 4.3, “Spesifikke krav til data i datasett med høy verdi”.

The provided information should enable to the verification whether the detailed information requirements by the HVD is satisfied. See 4.3, “Spesifikke krav til data i datasett med høy verdi” (in Norwegian only).

Eksempel i RDF Turtle:

<aDataset> a dcat:Dataset ;
   dct:conformsTo <https://stirdata.github.io/data-specification> ; .

3.2. Klassen Datasettserie (dcat:DatasetSeries)

Figur 3 viser klassen Datasettserie og dens egenskaper, samt klassene den refererer til. I figuren er differansen mellom kravene i HVD-DCAT-AP-NO og DCAT-AP-NO markert i gult. Kun kravene som er spesifikke for HVD er videre spesifisert i dette kapittelet. Kravene ellers til klassen Datasettserie (dcat:DatasetSeries) i DCAT-AP-NO ⧉ gjelder også for denne klassen. Se også Om bruk av datasettserie i DCAT-AP-NO ⧉.

Figur 3. Klassen Datasettserie og klassene den refererer til.

English name

Dataset series

URI

dcat:DatasetSerie

Subklasse av / Subclass of

dcat:Dataset

Anvendelse / Usage note

Klassen brukes til å representere en samling av datasett som publiseres separat, men som deler noen felles egenskaper som gjør at de er gruppert sammen.

This class is used to represent a collection of datasets that are published separately, but share some characteristics that group them.

3.2.1. Obligatoriske egenskaper for klassen Datasettserie

3.2.1.1. Datasettserie – gjeldende lovgivning (dcatap:applicableLegislation)

English name

applicable legislation

URI

dcatap:applicableLegislation

Verdiområde / Range

eli:LegalResource ⧉

Anvendelse / Usage note

Egenskapen brukes til å referere til lovgivningen som gir mandat til opprettelse eller behandling av datasettserien.

This property is used to refer to the legislation that mandates the creation or management of the dataset series.

Multiplisitet / Multiplicity

1..n

Kravnivå / Requirement level

Obligatorisk / Mandatory

Merknad / Note

For HVD SKAL en av verdiene være http://data.europa.eu/eli/reg_impl/2023/138/oj.

For HVD the value MUST include the ELI http://data.europa.eu/eli/reg_impl/2023/138/oj.

Eksempel i RDF Turtle:

<aDatasetSeries> a dcat:DatasetSeries ;
   dcatap:applicableLegislation <http://data.europa.eu/eli/reg_impl/2023/138/oj> ; .

3.2.1.2. Datasettserie – HVD-kategori (dcatap:hvdCategory)

English name

HVD category

URI

dcatap:hvdCategory

Verdiområde / Range

skos:Concept

Anvendelse / Usage note

Egenskapen brukes til å referere til HVD kategorien som dette datasettserien tilhører.

This property is used to refer to HVD category to which this dataset series belongs.

Multiplisitet / Multiplicity

1..n

Kravnivå / Requirement level

Obligatorisk / Mandatory

Merknad / Note

Verdien SKAL hentes fra EUs kontrollerte vokabular High-value dataset categories ⧉.

The value MUST be chosen from EU’s controlled vocabulary High-value dataset categories ⧉.

Eksempel i RDF Turtle:

<aDatasetSeries> a dcat:DatasetSeries ;
   dcatap:hvdCategory <http://data.europa.eu/bna/c_a9135398> ; .

3.3. Klassen Datatjeneste (dcat:DataService)

Figur 4 viser klassen Datatjeneste og dens egenskaper, samt klassene den refererer til. I figuren er differansen mellom kravene i HVD-DCAT-AP-NO og DCAT-AP-NO markert i gult. Kun kravene som er spesifikke for HVD er videre spesifisert i dette kapittelet. Kravene ellers til klassen Datatjeneste (dcat:DataService) i DCAT-AP-NO ⧉ gjelder også for denne klassen.

Figur 4. Klassen Datatjeneste og klassene den refererer til.

English name

Data service

URI

dcat:DataService

Subklasse av / Subclass of

dcat:Resource ⧉

Beskrivelse

Klassen brukes til å representere en datatjeneste, dvs. en samling av operasjoner som gir tilgang til ett eller flere datasett eller databehandlingsfunksjoner.

This class is used to represent a data service, i.e., a collection of operations that provides access to one or more datasets or data processing functions.

3.3.1. Obligatoriske egenskaper for klassen Datatjeneste

3.3.1.1. Datatjeneste – dokumentasjon (foaf:page)

English name

documentation

URI

foaf:page

Verdiområde / Range

foaf:Document

Anvendelse / Usage note

Egenskapen brukes til å referere til en side eller et dokument som beskriver datatjenesten.

This property is used to refer to a page or a document that describes the data service.

Multiplisitet / Multiplicity

1..n

Kravnivå / Requirement level

Obligatorisk / Mandatory

Merknad / Note

Kvalitet på tjeneste er betraktet som en del av den generiske dokumentasjonen av en datatjeneste.

Quality of service covers a broad spectrum of aspects. The HVD regulation does not list any mandatory topic. Therefore quality of service information is considered part of the generic documentation of a Data Service.

Eksempel i RDF Turtle:

<anAPI> a dcat:DataService ;
   foaf:page <https://data.brreg.no/enhetsregisteret/api/dokumentasjon/> ; .

3.3.1.2. Datatjeneste – gjeldende lovgivning (dcatap:applicableLegislation)

English name

applicable legislation

URI

dcatap:applicableLegislation

Verdiområde / Range

eli:LegalResource ⧉

Anvendelse / Usage note

Egenskapen brukes til å referere til lovgivningen som gir mandat til opprettelse eller forvaltning av datatjenesten.

This property is used to refer to the legislation that mandates the creation or management of the data service.

Multiplisitet / Multiplicity

1..n

Kravnivå / Requirement level

Obligatorisk / Mandatory

Merknad / Note

For HVD SKAL en av verdiene være http://data.europa.eu/eli/reg_impl/2023/138/oj.

For HVD the value MUST include the ELI http://data.europa.eu/eli/reg_impl/2023/138/oj.

3.3.1.3. Datatjeneste – HVD-kategori (dcatap:hvdCategory)

English name

HVD category

URI

dcatap:hvdCategory

Verdiområde / Range

skos:Concept

Anvendelse / Usage note

Egenskapen brukes til å referere til HVD kategorien som denne datatjeneste tilhører.

This property is used to refer to HVD category to which this data service belongs.

Multiplisitet / Multiplicity

1..n

Kravnivå / Requirement level

Obligatorisk / Mandatory

Merknad / Note

Verdien SKAL hentes fra EUs kontrollerte vokabular High-value dataset categories ⧉.

The value MUST be chosen from EU’s controlled vocabulary High-value dataset categories ⧉.

Eksempel i RDF Turtle:

<anAPI> a dcat:DataService ;
   dcatap:hvdCategory <http://data.europa.eu/bna/c_a9135398> ; .

3.3.2. Anbefalte egenskaper for klassen Datatjeneste

3.3.2.1. Datatjeneste – endepunktsbeskrivelse (dcat:endpointDescription)

English name

endpoint description

URI

dcat:endpointDescription

Verdiområde / Range

rdfs:Resource

Anvendelse / Usage note

Egenskapen brukes til å oppgi en beskrivelse av tjenestene som er tilgjengelige via endepunktene, inkludert deres operasjoner, parametere osv. Egenskapen gir spesifikke detaljer om de faktiske endepunkt-instansene, mens egenskapen Datatjeneste – i samsvar med (dct:conformsTo) ⧉ brukes til å indikere den generelle standarden eller spesifikasjonen som endepunktene implementerer.

The property is used to provide specific details of the actual endpoint instances, while dct:conformsTo is used to indicate the general standard or specification that the endpoints implement.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Anbefalt / Recommended

Merknad / Note

Artikkel 3.3 i HVD-forordningen krever API-dokumentasjon i et EU- eller internasjonalt anerkjent og åpent, menneske- og maskinlesbart format.

Article 3.3 in HVD IR requires to provide API documentation in a Union or internationally recognised open, human-readable and machine-readable format.

3.3.2.2. Datatjeneste – tilgjengeliggjør datasett (dcat:servesDataset)

English name

serves dataset

URI

dcat:servesDataset

Verdiområde / Range

dcat:Dataset

Anvendelse / Usage note

Egenskapen brukes til å referere til datasett som datatjenesten kan distribuere.

This property is used to refer to a collection of data that this data service can distribute.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Anbefalt / Recommended

Merknad / Note

Selv om denne egenskapen er anbefalt og ikke obligatorisk, SKAL en datatjeneste i en HVD-katalog brukes til å gi tilgang til HVD-datasett. Se også 4.2, “Spesielt om distribusjoner og datatjenester for datasett med høy verdi”.

Although this property is recommended and not mandatory, a data service that is included in the HVD catalog MUST provide access to at least one HVD marked dataset. See 4.2, “Spesielt om distribusjoner og datatjenester for datasett med høy verdi” (in Norwegian only).

Eksempel i RDF Turtle:

<anAPI> a dcat:DataService ;
   dcat:servesDataset <aDataset> ; .

3.3.3. Valgfrie egenskaper for klassen Datatjeneste

3.3.3.1. Datatjeneste – lisens (dct:license)

English name

licence

URI

dct:license

Verdiområde / Range

dct:LicenseDocument

Anvendelse / Usage note

Egenskapen brukes til å referere til lisensen som datatjenesten blir gjort tilgjengelig under.

This property is used to refer to a licence under which the data service is made available.

Multiplisitet / Multiplicity

0..1

Kravnivå / Requirement level

Valgfri / Optional

Merknad / Note

Artikkel 3.3. i HVD-forordningen spesifiserer at brukervilkår bør oppgis. Som beskrevet under 4.1, “Spesielt om juridisk informasjon om datasett med høy verdi” kan kravet oppfylles ved å referere til en lisens ved å bruke denne egenskapen. Egenskapen 3.3.3.2, “Datatjeneste – rettigheter (dct:rights)” kan brukes som et alternativ.

Article 3.3 in HVD IR specifies that the terms of use should be provided. According to the guidelines under 4.1, “Spesielt om juridisk informasjon om datasett med høy verdi” (in Norwegian only) this is fulfilled by referring to a licence using this property. As alternative the property 3.3.3.2, “Datatjeneste – rettigheter (dct:rights)” can be used.

Eksempel i RDF Turtle:

<anAPI> a dcat:DataService ;
   dct:license <http://publications.europa.eu/resource/authority/licence/CC_BY_4_0> ; .

3.3.3.2. Datatjeneste – rettigheter (dct:rights)

English name

rights

URI

dct:rights

Verdiområde / Range

odrs:RightsStatement ⧉

Anvendelse / Usage note

Egenskapen brukes til å referere til en uttalelse som angir rettigheter knyttet til distribusjonen.

This property is used to refer to a statement that specifies rights associated with the data service.

Multiplisitet / Multiplicity

0..1

Kravnivå / Requirement level

Valgfri / Optional

Merknad / Note

Artikkel 2.2. i HVD-forordningen spesifiserer at brukervilkår bør oppgis. Som beskrevet under 4.1, “Spesielt om juridisk informasjon om datasett med høy verdi” kan kravet oppfylles ved å bruke egenskapen 3.3.3.1, “Datatjeneste – lisens (dct:license)” til å referere til en lisens. Denne egenskapen kan brukes som et alternativ.

Article 3.3 in HVD IR specifies that the terms of use should be provided. According to the guidelines under 4.1, “Spesielt om juridisk informasjon om datasett med høy verdi” (in Norwegian only) this is fulfilled by referring to a licence using the property 3.3.3.1, “Datatjeneste – lisens (dct:license)”. This property can be used as an alternative.

3.4. Klassen Distribusjon (dcat:Distribution)

Figur 5 viser klassen Distribusjon og dens egenskaper, samt klassene den refererer til. I figuren er differansen mellom kravene i HVD-DCAT-AP-NO og DCAT-AP-NO markert i gult. Kun kravene som er spesifikke for HVD er videre spesifisert i dette kapittelet. Kravene ellers til klassen Distribusjon (dcat:Distribution) i DCAT-AP-NO ⧉ gjelder også for denne klassen.

Figur 5. Klassen Distribusjon og klassene den refererer til.

English name

Distribution

URI

dcat:Distribution

Anvendelse / Usage note

Klassen brukes til å representere en fysisk representasjon av datasettet i et bestemt format.

This class is used to represent a distribution, i.e., a physical embodiment of the Dataset in a particular format.

Merknad / Note

Bulknedlastinger skal beskrives som distribusjon.

Bulk downloads should be encoded as a Distribution.

3.4.1. Obligatoriske egenskaper for klassen Distribusjon

3.4.1.1. Distribusjon – gjeldende lovgivning (dcatap:applicableLegislation)

English name

applicable legislation

URI

dcatap:applicableLegislation

Verdiområde / Range

eli:LegalResource ⧉

Anvendelse / Usage note

Egenskapen brukes til å referere til lovgivningen som gir mandat til opprettelse eller forvaltning av distribusjonen.

This property is used to refer to the legislation that mandates the creation or management of the Distribution.

Multiplisitet / Multiplicity

1..n

Kravnivå / Requirement level

Obligatorisk / Mandatory

Merknad / Note

For HVD SKAL en av verdiene være http://data.europa.eu/eli/reg_impl/2023/138/oj.

For HVD the value MUST include the ELI http://data.europa.eu/eli/reg_impl/2023/138/oj.

Eksempel i RDF Turtle:

<aDistribution> a dcat:Distribution ;
   dcatap:applicableLegislation <http://data.europa.eu/eli/reg_impl/2023/138/oj> ; .

3.4.2. Anbefalte egenskaper for klassen Distribusjon

3.4.2.1. Distribusjon – lisens (dct:license)

English name

licence

URI

dct:license

Verdiområde / Range

dct:LicenseDocument

Anvendelse / Usage note

Egenskapen brukes til å referere til lisensen som distribusjonen er gjort tilgjengelig under.

This property is used to refer to a licence under which the Distribution is made available.

Multiplisitet / Multiplicity

0..1

Kravnivå / Requirement level

Anbefalt / Recommended

Merknad / Note

Artikkel 4.3. i HVD-forordningen spesifiserer at HVD bør gjøres tilgjengelig for viderebruk. Som beskrevet under 4.1, “Spesielt om juridisk informasjon om datasett med høy verdi” kan kravet oppfylles ved å referere til en lisens ved å bruke denne egenskapen. Egenskapen 3.4.3.2, “Distribusjon – rettigheter (dct:rights)” kan brukes som et alternativ.

Article 4.3 specifies that High-value datasets should be made available for reuse. According to the guidelines under 4.1, “Spesielt om juridisk informasjon om datasett med høy verdi” (in Norwegian only) this is fulfilled by referring to a licence using this property. As alternative the property 3.4.3.2, “Distribusjon – rettigheter (dct:rights)” can be used.

Eksempel i RDF Turtle:

<aDistribution> a dcat:Distribution ;
   dct:license <http://publications.europa.eu/resource/authority/licence/CC_BY_4_0> ; .

3.4.2.2. Distribusjon – tilgangstjeneste (dcat:accessService)

English name

access service

URI

dcat:accessService

Verdiområde / Range

dcat:DataService

Anvendelse / Usage note

Egenskapen brukes til å referere til en datatjeneste som gir tilgang til distribusjonen av datasettet.

This property is used to refer to a data service that gives access to the distribution of the dataset.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Anbefalt / Recommended

Eksempel i RDF Turtle:

<aDistribution> a dcat:Distribution ;
   dcat:accessService <aDataService> ; .

3.4.3. Valgfrie egenskaper for klassen Distribusjon

3.4.3.1. Distribusjon – i samsvar med (dct:conformsTo)

English name

linked schemas

URI

dct:conformsTo

Verdiområde / Range

dct:Standard ⧉

Anvendelse / Usage note

Egenskapen brukes til å referere til et etablert skjema som distribusjonen er i samsvar med.

This property is used to refer to an established schema to which the described Distribution conforms.

Multiplisitet / Multiplicity

0..n

Kravnivå / Requirement level

Valgfri / Optional

Merknad / Note

Eksempel i RDF Turtle:

<aDistribution> a dcat:Distribution ;
   dct:conformsTo <https://stirdata.github.io/data-specification> ; .

3.4.3.2. Distribusjon – rettigheter (dct:rights)

English name

rights

URI

dct:rights

Verdiområde / Range

odrs:RightsStatement ⧉

Anvendelse / Usage note

Egenskapen brukes til å referere til en uttalelse som angir rettigheter knyttet til distribusjonen.

This property is used to refer to a statement that specifies rights associated with the Distribution.

Multiplisitet / Multiplicity

0..1

Kravnivå / Requirement level

Valgfri / Optional

Merknad / Note

Artikkel 4.3. i HVD-forordningen spesifiserer at HVD bør gjøres tilgjengelig for viderebruk. Som beskrevet under 4.1, “Spesielt om juridisk informasjon om datasett med høy verdi” kan kravet oppfylles ved å bruke egenskapen 3.4.2.1, “Distribusjon – lisens (dct:license)” til å referere til en lisens. Denne egenskapen kan brukes som et alternativ.

Article 4.3 specifies that High-value datasets should be made available for reuse. According to the guidelines under 4.1, “Spesielt om juridisk informasjon om datasett med høy verdi” (in Norwegian only) this is fulfilled by referring to a licence using the property 3.4.2.1, “Distribusjon – lisens (dct:license)”. This property can be used as an alternative.

4. Noen spesielle temaer

4.1. Spesielt om juridisk informasjon om datasett med høy verdi

HVD-forordningen krever høy metadatakvalitet for juridisk informasjon om datasett med høy verdi. Informasjonen bør være i både maskin- og menneskelesbart format, dessuten med en varig lenke.

Vi anbefaler sterkt at datasettutgiverne bruker en av lisensene fra EUs kontrollerte vokabular for lisens ⧉, f.eks. CC BY 4.0 ved å bruke den varige lenken http://publications.europa.eu/resource/authority/licence/CC_BY_4_0. Regjeringens retningslinjer ved tilgjengeliggjøring av offentlige data ⧉, under punkt 1 Bruk åpne standardlisenser, anbefaler også å bruke CC BY 4.0.

For datasettutgivere som mot formodning ikke kan bruke en av lisensene fra ovennevnte EUs kontrollerte vokabular for lisens, se Legal information ⧉ i EUs DCAT-AP HVD.

4.2. Spesielt om distribusjoner og datatjenester for datasett med høy verdi

HVD-forordningen krever at datasett med høy verdi skal være tilgjengelig.

Forordningen setter dessuten eksplisitte krav til om et HVD skal være tilgjengelig som bulknedlasting og/eller via API, avhengig av kategorien datasettet tilhører:

både via API og som bulknedlasting, f.eks. geodata (jf. Annex 1.2 i forordningen)
bare via API, f.eks. "NWP model data" i kategori meteorologiske data (jf. Annex 3.2 i forordningen)
enten via API eller som bulknedlasting, f.eks. historiske versjoner av data for jordobservasjon og vær (jf. Annex 2.2 i forordningen)

Figur 6. Datasett, Distribusjon og Datatjeneste.

Figur 6 illustrerer hvordan bulknedlastinger og API-tilgang skal beskrives:

Bulknedlastinger skal beskrives som distribusjoner, ved å bruke egenskapen 3.1.2.1, “Datasett – datasettdistribusjon (dcat:distribution)” fra datasettbeskrivelsen.
- En bulknedlasting kan gjøres tilgjengelig via API, ved å bruke egenskapen Distribusjon – tilgangstjeneste (dcat:accessService) ⧉ fra distribusjonsbeskrivelsen.
API-tilgang beskrives ved at det i beskrivelsen av det aktuelle APIet (datatjenesten) refereres til datasettet ved å bruke egenskapen 3.3.2.2, “Datatjeneste – tilgjengeliggjør datasett (dcat:servesDataset)”.

4.3. Spesifikke krav til data i datasett med høy verdi

Dette er en forkortet og fornorsket versjon av EUs Specific data requirements ⧉ i DCAT-AP HVD.

Vedlegg til HVD-forordningen inneholder krav til hvilke dataelementer (key attributes) som skal være med i et datasett med høy verdi. Ethvert datasett med høy verdi skal være i henhold til kravene i HVD-forordningen.

For å dokumentere at kravene er oppfylt, anbefales det å bruke egenskapen dct:conformsTo til å referere til et allment tilgjengelig dokument (f.eks. en datastandard/dataspesifikasjon) som beskriver den indre strukturen av datasettet (eller distribusjonen).

En alternativ tilnærming er selvdeklarasjon (self declaration of conformance), der datasettutgiveren selv deklarerer at datasettet oppfyller alle de tekniske datakravene i HVD-forordningen. Hverken EUs DCAT-AP HVD eller den norske HVD-DCAT-AP-NO foreslår noen generelle selvdeklarasjonserklæringer.

Vedlegg A - Navnerom som brukes i standarden

Prefiks

Navnerom

RDF-vokabular

dcat

http://www.w3.org/ns/dcat#

Data Catalog Vocabulary ⧉

dcatap

http://data.europa.eu/r5r/

DCAT Application Profile ⧉

dct

http://purl.org/dc/terms/

DCMI Metadata Terms ⧉

eli

http://data.europa.eu/eli/ontology#

European Legislation Identifier ⧉

foaf

http://xmlns.com/foaf/0.1/

FOAF Vocabulary ⧉

odrs

http://schema.theodi.org/odrs#

Open Data Rights Statement Vocabulary ⧉

rdfs

http://www.w3.org/2000/01/rdf-schema#

RDF Vocabulary Description Language 1.0: RDF Schema ⧉

skos

http://www.w3.org/2004/02/skos/core#

SKOS Simple Knowledge Organization System ⧉

Eksempel i RDF Turtle:

@prefix dcat: <http://www.w3.org/ns/dcat#> .
@prefix dcatap: <http://data.europa.eu/r5r/> .
@prefix dct: <http://purl.org/dc/terms/> .
@prefix eli: <http://data.europa.eu/eli/ontology#> .
@prefix foaf: <http://xmlns.com/foaf/0.1/> .
@prefix odrs: <http://schema.theodi.org/odrs#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix skos: <http://www.w3.org/2004/02/skos/core#> .