Geonovum ontwikkelt en beheert de Nederlandse metadata profielen. Deze profielen zijn een verbijzondering van de internationale metadata standaarden van ISO en DCAT en zijn bedoeld om de interoperabiliteit binnen Nederland te bevorderen.
Dit document beschrijft de verdere specificatie van het toepassingsprofiel van [DCAT-AP-3.0] van de EU voor uitwisseling tussen gegevenscatalogi in Nederland. Het is een doorontwikkeling van [DCAT-AP-DONL-2.0].
Ten behoeve van de Europese High Value Dataset is de "usage guidelines of DCAT-AP for High-Value Datasets" opgezet, als aanvulling op [DCAT-AP-2.1.1] . De vereisten uit de "usage guidelines of DCAT-AP for High-Value Datasets" zijn opgenomen in dit Nederlandse profiel, zodat door te voldoen aan het Nederlandse profiel tevens aan de Europese vereisten voor Open data en High-Value Datasets kan worden voldaan.
Dit profiel wordt aangeboden voor opname op de Pas-toe-of-leg-uit-lijst van het College Standaardisatie.
Het Nederlandse profiel voor DCAT is niet statisch. Dit document wordt daarom onder beheer gebracht om wijzigingen naar behoefte en op basis van voorstellen gestructureerd door te voeren. Geonovum, als voorgestelde beherende instantie, zal de wijzigingen registreren.
Status van dit document
Dit is een werkversie die op elk moment kan worden gewijzigd, verwijderd of vervangen door andere documenten.
Conformiteit
De termen MOET, BEHOORT en MAG in dit document moeten worden geïnterpreteerd als in BCP 14 [RFC2119] [RFC8174] als, en alleen als deze in hoofdletters zijn weergegeven, zoals hier getoond.
Inleiding
Dit onderdeel is niet normatief.
Om gestandaardiseerd metadata uit te wisselen tussen verschillende dataportalen heeft Europa het [DCAT-AP-3.0] ontwikkeld. [DCAT-AP-3.0] is gebaseerd op de "Data Catalog Vocabulary" (DCAT) -specificatie [DCAT-3.0], die wordt ontwikkeld door de Dataset Exchange Working Group. DCAT is een RDF-vocabulaire die ontworpen is om de interoperabiliteit tussen op het web gepubliceerde datacatalogi te vergemakkelijken. Dit profiel faciliteert de uitwisseling van metadata van verschillende domeinen tussen Nederlandse datacatalogi van (semi)overheidsorganisaties op lokaal, regionaal en landelijk nivo en tussen Nederlandse datacatalogi en EU datacatalogi, Het definieert het schema en geeft voorbeelden voor het gebruik ervan.
DCAT stelt een dataprovider in staat om datasets en dataservices in een catalogus te beschrijven met behulp van een standaardmodel en vocabulaire dat het gebruik en de aggregatie van metadata uit meerdere catalogi vergemakkelijkt. Dit kan de vindbaarheid van datasets en dataservices vergroten. Het maakt het ook mogelijk om een gedecentraliseerde benadering te hebben voor het publiceren van datacatalogi en maakt federatief zoeken naar datasets in catalogi op meerdere sites mogelijk met behulp van hetzelfde querymechanisme en dezelfde structuur.
In DCAT worden klassen en eigenschappen van andere gevestigde vocabulaires (ADMS, FOAF) hergebruikt. DCAT maakt gebruik van een bewezen set gemeenschappelijke metadata genaamd "Dublin Core", die in 2009 als ISO 15836-standaard werd gepubliceerd.
Dit document beschrijft het Nederlandse applicatieprofiel op [DCAT-AP-3.0]. Dit Nederlandse applicatieprofiel - DCAT-AP NL- beantwoordt de vraag over hoe [DCAT-AP-3.0] in de praktijk wordt toegepast Nederland.
Uitgangspunten
Bij het opstellen zijn van het applicatie profiel zijn volgende uitgangspunten gehanteerd:
Toepassingsbereik
DCAT-AP-NL faciliteert:
de uitwisseling van metadata tussen Nederlandse datacatalogi van (semi-) overheidsorganisatie en overige organisaties die maatschappelijke relevante data willen delen.
de uitwisseling van metadata tussen Nederlandse datacatalogi en EU datacatalogi
de uitwisseling van metadata van primair open data, maar is hier niet toe beperkt
de specifieke Nederlandse behoeften van metadata in datacatalogi
als je voldoet aan DCAT-AP NL voldoe je ook aan [DCAT-AP-3.0]
bevat alle verplichte en aanbevolen eigenschappen [DCAT-AP-3.0], waarbij de gebruiksvoorwaarden van DCAT-AP-NL gelden
introduceert geen uitbreidingen, als die al uitgedrukt kunnen worden in [DCAT-AP-3.0] of [DCAT-3.0] ,
tenzij er een hele sterke behoefte / aanleiding toe is, en het [DCAT-AP-3.0] of [DCAT-3.0] vocabulary hierin NIET voorziet
is zo generiek mogelijk van opzet en ligt zo dicht mogelijk bij [DCAT-AP-3.0]
is opgesteld in het Nederlands
Relatie andere profielen
Dit profiel is een verdere specificatie van het toepassingsprofiel van de Europa [DCAT-AP-3.0]. Hierbij zijn aanpassingen gedaan op basis van ervaring met DCAT-AP-DONL 1.1, 2.0 en onderzoek en discussies in de werkgroep DCAT-AP-NL en is aansluiting gezocht bij metadata standaarden uit het geo en statistische domein. DCAT-AP-NL is compatible met [DCAT-3.0] en [DCAT-AP-3.0] .
Figuur 1DCAT-AP-NL positionering, nog aanpassen met DCAT 3 als basis DCAT-AP-NL
Om zoveel mogelijk scenario's te ondersteunen, verplichten de originele [DCAT-3.0] van het W3C en het toepassingsprofiel van de EU [DCAT-AP-3.0] weinig.
Op dit moment zijn [DCAT-3.0] en [DCAT-AP-3.0] als kandidaat release versie beschikbaar. Na het vaststellen van deze standaarden zal er gekeken worden of het DCAT-AP-NL profiel ook bijgewerkt moet worden.
1. Termen en definities
Een applicatieprofiel is een specificatie voor gegevensuitwisseling dat bijkomende beperkingen introduceert voor het toepassen van vocabularia. Dergelijke bijkomende beperkingen kunnen de volgende elementen bevatten:
verfijning van de terminologie (klassen en eigenschappen) consistent met de semantiek uit de betreffende specificaties met een welbepaald gebruik als doel;
externe terminologie (klassen en eigenschappen) gebruikt voor nieuwe/extra termen die niet in de bestaande vocabularia voorkomen.
meer nauwkeurigheid kan worden bereikt door klassen en klasse-attributen (eigenschappen) als verplicht, aanbevolen of optioneel te classificeren voor een bepaalde toepassing
Een dataportaal is een op het web gebaseerd systeem dat een gegevenscatalogus bevat waarin datasets worden beschreven met behulp van metadata. Bovendien biedt een dataportaal diensten aan om het vinden en het hergebruik van de datasets te bevorderen en/of te faciliteren.
Een dataset is een zinvolle verzameling van samenhangende gegevens, die beheerd of gepubliceerd wordt door één organisatie, en in één of meer formaten beschikbaar of downloadbaar is.
Een dataset is de weerslag van een conceptuele entiteit welke de collectie is van één of meerdere distributies. Elke distributie is de werkelijke data van de dataset in een bepaald formaat of een bepaalde aanbiedingsvorm.
Services die toegang geven tot een of meer datasets of processing functies, zijn een dataservice.
Een dataset serie is een verzameling van datasets met dezelfde productspecificaties. Productspecificaties zijn thema, resolutie en methodologie.
Een aanbieder is een gegevensaanbieder (bijvoorbeeld een dataportaal dat metadata verstrekt).
Een ontvanger is een gebruiker van gegevens (bijvoorbeeld een toepassing die metadata van een dataportaal verwerkt).
1.1 Namespaces
Dit toepassingsprofiel maakt gebruik van de namespaces zoals weergegeven in de onderstaande tabel.`
Het toepassingsprofiel in dit document is gebaseerd op de specificatie van de Data Catalog Vocabulary (DCAT), ontwikkeld onder verantwoordelijkheid van de Government Linked Data Working Group bij W3C. DCAT is een RDF-vocabulaire dat is ontworpen om interoperabiliteit tussen gegevenscatalogi gepubliceerd op het web te vergemakkelijken. Waar nodig worden aanvullende klassen en eigenschappen uit andere bekende vocabulaires hergebruikt.
Het DCAT vocabulaire bestaat uit klassen en eigenschappen.
Klassen zijn dingen op het internet:
Ze hebben niet allemaal een URI, maar het wordt aanbevolen om ze van een URI te voorzien. Het zijn complexe dingen zoals een persoon, een organisatie, een dataset, een website of een downloadbaar databestand.
Klassen hebben eigenschappen: De eigenschappen zijn de attributen die deze dingen beschrijven. Sommige eigenschappen komen in meer dan één klasse voor, een titel bijvoorbeeld is een veel voorkomend attribuut. Andere eigenschappen zijn zeer gespecialiseerd, zoals een bestandsformaat dat alleen zinvol is voor een gegevensbestand.
Eigenschappen kunnen eenvoudig of complex zijn: sommige eigenschappen zijn klassen. Een organisatie kan bijvoorbeeld een website hebben. Of een dataset kan een data-uitgever hebben. Over het algemeen kan een klasse herkend worden aan de schrijfwijze: De naam van een eigenschap begint met een kleine letter zoals dcat:dataset <M], terwijl de naam van een klasse begint met een hoofdletter zoals dcat:Dataset.
Klassen en eigenschappen worden gebruikt om de metadata op een gestructureerde manier aan te leveren.
2.2 Overzicht Klassen
Het volgende diagram geeft een overzicht van de basis functionaliteit van [DCAT-3.0] en dient als startblok voor het begrijpen van de constructie. LET OP, er zijn dus meer klassen, eigenschappen en relaties dan weergegeven zoals te zien in Klassen.
Figuur 2[DCAT-3.0] In het kort. Hier moet nog DatasetSeries worden toegevoegd.
2.3 Optionaliteit
DCAT-AP NL definieert vier niveaus van vereisten voor ontvangers en aanbieders van gegevens. Daarbij geldt dat de niveaus alleen gelden voor de aanbieders. Ontvangers MOETEN altijd in staat zijn om informatie over alle instanties van alle klassen en al hun eigenschappen te verwerken. In de volgende secties worden klassen en eigenschappen aangeduid als "verplicht", "aanbevolen", "optioneel" of conditioneel. Deze termen hebben de volgende betekenis:
Verplichte eigenschap: een ontvanger MOET de informatie voor die eigenschap kunnen verwerken; een aanbieder MOET de informatie voor die eigenschap verstrekken.
Aanbevolen eigenschap: een ontvanger MOET de informatie voor die eigenschap kunnen verwerken; een aanbieder BEHOORT de informatie voor die eigenschap te verstrekken indien deze beschikbaar is.
Optionele eigenschap: een ontvanger MOET de informatie voor die eigenschap kunnen verwerken; een aanbieder MAG de informatie voor die eigenschap verstrekken, maar is daartoe niet verplicht.
Conditionele eigenschap: een ontvanger MOET de informatie voor die eigenschap kunnen verwerken; een aanbieder MOET de informatie voor die eigenschap verstrekken, indien de conditie van toepassing is.
In de gegeven context betekent de term "verwerken" dat ontvangers binnenkomende gegevens MOETEN accepteren en deze gegevens op transparante wijze aan applicaties en diensten moeten leveren. Het impliceert noch schrijft voor wat applicaties en diensten uiteindelijk met de gegevens doen (parseren, converteren, opslaan, doorzoekbaar maken, weergeven aan gebruikers, etc.).
De termen MOET, BEHOORT en MAG in dit document moeten worden geïnterpreteerd als in BCP 14 [RFC2119] [RFC8174] als, en alleen als deze in hoofdletters zijn weergegeven, zoals hier getoond.
2.4 Waardelijsten
In de metadata dienen de waarden uit de waardelijsten waarnaar verwezen wordt bij de element beschrijving, gehanteerd te worden. Dit zijn vaak de door de EU verplichte waardelijsten.
Deze waardelijsten zijn opgenomen in een apart hoofdstuk Waardelijsten.
2.5 Omschrijving eigenschappen
Eigenschap: Dit is de originele engelstalige naam zoals gebruikt in de W3C specificatie van [DCAT-3.0] en [DCAT-AP-3.0].
Definitie: Dit is de Nederlandstalige definitie van de eigenschap.
RDF-eigenschap (URI): Dit is de (technische) naam van de eigenschap die van toepassing is voor de uitwisseling van de DCAT data.
Bereik: Beschrijft de mogelijke waarden van de eigenschap.
Kardinaliteit: Geeft aan of de eigenschap 0, 1 of meerdere keren mag voorkomen. Hierbij wordt gebruik gemaakt van de schrijfwijze x..y, waarbij x het minimaal aantal voorkomens aangeeft en y het maximaal aantal. Bijvoorbeeld 1..n geeft aan dat de eigenschap een of meer keer mag voorkomen.
Optionaliteit: Geeft aan of een eigenschap verplicht, aanbevolen, optioneel of conditioneel is.
Conditie: Geeft de conditie aan in het geval de optionaliteit Conditioneel is. Bijvoorbeeld HighValueData set.
Waardelijst: Verwijzing naar de codelijsten die van toepassing zijn.
2.6 Ondersteuning voor meertaligheid
Eigenschappen als dct:title , dct:description, en dcat:keyword kunnen waardes in verschillende talen bevatten. Voor elke vertaling wordt de eigenschap herhaalt met de toevoeging van een language tag om aan te geven in welke taal de waarde geschreven is. Elke taal mag slechts één keer voorkomen.
Het wordt aanbevolen om eigenschappen met het Bereik rdf:Literal en teksten bevat, een language tag te gebruiken, zoals gedefinieerd in BCP 47 [[rfc5646]]
3. Klassen
In dit hoofdstuk worden de belangrijkste klassen van het applicatieprofiel benoemd en beschreven. Deze klassen vormen de kern van het applicatieprofiel. De eigenschappen en de bijbehorende beperkingen die van toepassing zijn in de context van dit profiel worden in tabelvorm weergegeven. Elke rij komt overeen met één eigenschap. De eigenschappen worden in sub paragrafen verder toegelicht.
De niet beschreven klassen en eigenschappen behoren conform [DCAT-AP-3.0] toegepast te worden.
3.1 Dataset - dcat:Dataset
Een dataset is een zinvolle verzameling van samenhangende gegevens, die beheerd of gepubliceerd wordt door één organisatie, en in één of meer formaten beschikbaar of downloadbaar is.
Deze eigenschap bevat de wetgeving die de creatie of het beheer van de dataset verplicht stelt.
Er kunnen meerdere wetgevingen op de dataset van toepassing zijn. Denk aan HVD, INSPIRE, kaderrichtlijn water etc.
Gebruik de referentie naar de officiële publicatie van de wetgeving.
Deze eigenschap bevat een verwijzing naar de vastgestelde standaard of specificatie waaraan de beschreven dataset voldoet. Hierbij kan worden gedacht aan het informatie model, dataspecificatie of schema.
Gebruik de referentie naar de officiële publicatie van de standaard of specificatie.
Deze eigenschap bevat de contactinformatie waar eindgebruikers contact kunnen opnemen met vragen over de dataset. Dit element bevat het e-mail adres of link (URL) naar het contactformulier van de verantwoordelijke organisatie van de dataset. Het e-mail adres is een functioneel e-mailadres van de organisatie of organisatie onderdeel.
De organisatie die verantwoordelijk is voor het creëren van de beschreven dataset. Gebruik bij voorkeur een URI of anders een waarde uit een organisatienamenlijst. Als dat niet mogelijk is, gebruik de volledig uitgeschreven naam van de verantwoordelijke organisatie. De afkorting kan toegevoegd worden aan de organisatienaam.
Een distributie is de werkelijke data van de dataset in een bepaald formaat of een bepaalde aanbiedingsvorm. Een dataset kan meerdere distributies hebben, bijvoorbeeld via een API of directe download in verschillende formaten.
Deze eigenschap bevat een beschrijving van de inhoud van de dataset. Deze is bij voorkeur minimaal drie zinnen en maximaal één alinea lang (2000 karakters). De vindbaarheid van de dataset wordt bepaald door de kwaliteit van de tekst. Denk hierbij aan verschillende gebruikers, vakgenoten maar ook anderen, waarvoor de tekst begrijpelijk moet zijn.
Zie meertaligheid voor het omgaan met verschillende talen.
Het geografische gebied waarop de gegevens in de dataset betrekking hebben. Het veld kan worden gevuld met de benaming van een gebied in de vorm van een URI of de coördinaten ervan.
De coördinaten zijn de meest westelijke, oostelijke, noordelijke en zuidelijke coördinaat uit de horizontale dekking van de dataset weergegeven in latitude en longitude in decimale graden (noord en oost als positieve waarden). De coördinaten dienen te worden weergegeven volgens referentiesysteem WGS 84.
Voor de invulling van deze eigenschap met een gebiedsnaam, wordt vereist dat een van de onderstaande als mogelijk gebruik wordt gemaakt van https://vocabs.cbs.nl/nl/ of anders van
GeoNames.org
Identifier wordt gebruikt voor de unieke identificatie van de dataset. Dit is bij voorkeur een persistente URI die via HTTP raadpleegbaar is (resolvable). Hier wordt de oorspronkelijke identificatie van de dataset overgenomen zoals de data-eigenaar deze gepubliceerd heeft. De identifier mag niet door afnemers aangepast worden.
De eventuele andere identifiers worden in de eigenschap other identifier opgenomen, zoals bijvoorbeeld identifiers die door een catalog worden toegekend.
Identifier heeft de beperking (ten opzichte van DCAT-AP) dat deze eigenschap alleen de waarde kan bevatten die de eerste eigenaar heeft gegeven.
Deze eigenschap bevat in het algemeen gebruikte woorden of geformaliseerde zinnen om een dataset, dataservice of datasetserie te beschrijven, die niet uit een controlled vocabulary komen.
Het is mogelijk om meerdere keywords toe te kennen aan een dataset. Deze waarden moeten in afzonderlijke voorkomens van deze eigenschap worden aangeleverd.
Theme wordt gebruikt voor trefwoorden die uit een controlled vocabulary komen.
De webpagina die toegang geeft tot de dataset en aanvullende informatie verschaft over de dataset. Het gaat hierbij om de originele webpagina van de data-eigenaar.
Language heeft de beperking (ten opzichte van DCAT-AP) dat deze eigenschap alleen de waarde kan bevatten van de taal van de tekstuele waardes in de dataset.
In de eigenschap other identifier, kunnen eventuele overige identifiers in aanvulling op de identifier worden opgenomen, zoals identifiers die door een catalog worden toegekend. Eventueel kan naast de waarde van de identifier zelf, ook worden opgenomen wie deze toevoeging gedaan heeft. Hierdoor ontstaat een lijst met equivalente identifiers.
Het gebruik van other identifier wordt (ten opzichte van DCAT-AP) verder gespecificeerd, secundaire identifiers, zijn ook alle identifiers die aan de dataset zijn toegewezen tijdens het verwerken en delen van die dataset in het catalogusnetwerk.
Een verklaring van alle wijzigingen in eigendom en bewaring van een dataset sinds de creatie ervan, die van belang zijn voor de authenticiteit, integriteit en interpretatie ervan.
De meest precieze ruimtelijke resolutie in de dataset, gemeten in meters. Bij het publiceren van meerdere distributies van dezelfde dataset, elk met een verschillende resolutie - bijvoorbeeld de NUTS.status, kan deze eigenschap meerdere keren voorkomen.
De meest precieze tijdsperiode in de dataset. Bij het publiceren van meerdere distributies van dezelfde dataset, elk met een verschillende resolutie kan deze eigenschap meerdere keren voorkomen.
Deze eigenschap bevat de categorie van de dataset. De waarde die voor deze eigenschap moeten worden gebruikt, is in ieder geval één URI van een concept uit Dataset Theme Vocabulary
Aanbevolen wordt om naast een waarde uit de Europese Dataset Theme Vocabulary ook in meerdere thema's waarden op te nemen uit domeinspecifieke vocabulaires.
keyword word gebruikt voor trefwoorden die niet uit een controlled vocabulary komen.
Op Europees niveau is nog een discussie gaande of naast een waarde uit Dataset Theme Vocabulary, waarden uit andere controlled vocabulary in deze of een andere eigenschap opgenomen kunnen worden.
https://github.com/SEMICeu/DCAT-AP/issues/316: Add guidance on usage of additional themes for datasets
Aanbevolen schrijfwijze voor deze eigenschap is: (projectkenmerk) onderwerp (locatiekenmerk) (tijdskenmerk) (versie). Hierbij zijn de onderdelen tussen haakjes niet verplicht, de andere wel. Afkortingen zijn in de titel enkel toegestaan indienen deze tevens zijn uitgeschreven bijvoorbeeld: “Grootschalige Basiskaart Nederland (GBKN)”.
Hieronder enkele voorbeelden voor verschillende klassen. De voorbeelden worden nog verplaatst naar de juiste Klasse.
3.2 Distribution - dcat:Distribution
Een distributie beschrijft hoe een (deel van) een dataset te verkrijgen is. Een distributie levert rechtstreeks een dataset in een specifiek formaat op, Verschillende distributies van dezelfde dataset verschillen van elkaar in o.a. taal, formaat, data-schema's en nauwkeurigheid (resolutie).
De aanbieder van een dataset kan distributies aanbieden in meerdere verschillende formaten en/of samenstellingen die zijn afgestemd op de behoeften van afnemers. Deze worden elk als afzonderlijke distributie beschreven en gerelateerd aan de dataset.
Als een dataset (ook) wordt aangeboden in de vorm van een dataservice of API kunnen hierover aanvullende gegevens worden opgenomen in een dcat:DataService. Deze kan worden gerelateerd aan de bijbehorende distributie.
De eigenschap access service beschrijft een dataservice. Een dataservice is een verzameling operaties die toegang biedt tot een of meer datasets of gegevens verwerkingsfuncties.
Deze eigenschap bevat de URL die toegang verschaft tot een distributie van de dataset.
De eigenschap access URL is verplicht in DCAT-AP, maar is niet altijd aanwezig, bijvoorbeeld als er alleen een rechtstreekse download link beschikbaar is, of alleen een access service of landingpage.. In die gevallen zal de inhoud van die eigenschappen ook opgenomen moeten worden in de access URL. De definitie van access URL wordt hierdoor in de meest ruime zin toegepast.
Deze eigenschap bevat de wetgeving die de creatie of het beheer van de dataset verplicht stelt.
Er kunnen meerdere wetgevingen op de distributie van toepassing zijn. Denk aan HVD, INSPIRE, kaderrichtlijn water etc.
De omvang van de distributie (het feitelijke bestand) in bytes.
Deze eigenschap is verplicht, als de dataset onder de DGA uitvoeringsverordening valt.
De grootte wordt als een geheel, niet-negatief getal opgegeven, en kan eventueel worden benaderd als de precieze grootte niet bekend is, maar wel opgegeven moet worden.
De eigenschap checksum bevat de informatie waarmee een afnemer kan vaststellen of een gedownload bestand identiek is aan het aangeboden bestand (en er dus geen problemen zijn ontstaan bij het downloaden of wijzigingen zijn geweest aan de data zelf).
De URL van het downloadbare bestand in een bepaald formaat. Bijvoorbeeld een CSV-bestand of een RDF-bestand. Dit formaat wordt aangegeven in de distributie in eigenschap dct:format.
De licentie waaronder de Distributie beschikbaar wordt gesteld.
Licenties zijn een aanvulling op dct:accessRights. Als de data (publiek) toegankelijk zijn, staan in de licentie de voorwaarden voor het (her)gebruik daarvan.
Gebruik van Creative Commons Licenties is vereist. Aanbevolen wordt om steeds de meest recente versie van een licentie te gebruiken.
In het geval geen (her)gebruik volgens een CC licentie mogelijk is, mag de waarde ‘niet-open' gebruikt worden. Dat laatste kan bijv. voorkomen als een dataset alleen onder voorwaarden toegankelijk is.
Gebruik dcterms:rights voor alle andere typen voorwaarden – indien die niet gedekt worden door dcterms:license en dcterms:accessRights, zoals copyright-verklaringen.
Bijhorende waardelijst moet nog worden toegevoegd
Een verklaring waarin de rechten die verband houden met de distributie worden gespecificeerd. Hierin worden alleen de overige rechten opgenomen die niet gedekt worden door license of acces rights.
Aanbevolen schrijfwijze voor deze eigenschap is: (projectkenmerk) onderwerp (locatiekenmerk) (tijdskenmerk) (versie). Hierbij zijn de onderdelen tussen haakjes niet verplicht, de andere wel. Afkortingen zijn in de titel enkel toegestaan indienen deze tevens zijn uitgeschreven bijvoorbeeld: “Grootschalige Basiskaart Nederland (GBKN)”.
Onderstaand voorbeeld beschrijft een dcat:Distribution met enkel de verplichte eigenschappen. Dit is de meest minimale representatie van een dcat:Distribution.
3.3 DataService - dcat:DataService
Een gegevensdienst of dataservice is een computer service waar gegevens opgevraagd worden aan de hand van specificaties in een aanvraag. De gegevens die voldoen aan de meegegeven specificatie worden als antwoord teruggestuurd. Webservices zoals REST/JSON, WMS of XML interfaces zijn voorbeelden van dcat:DataService. Merk op dat als de specificatie slechts een deel van de gegevens beschrijft, alleen desbetreffende subset wordt opgestuurd. Ook is het mogelijk dat een dataservice niet één, maar meerdere datasets ontsluit.
Dataservice zijn speciaal bedoeld voor geautomatiseerde koppelingen tussen systemen, hoewel ze ook door - meestal technisch onderlegde - mensen gebruikt kunnen worden.
De dataservice klasse is geïntroduceerd in versie 2 van DCAT. Het biedt uitgebreidere mogelijkheden om geautomatiseerde toegang tot gegevens te beschrijven dan mogelijk is in de klasse dcat:Distributie. In deze nieuwe versie van het toepassingsprofiel is de dataservice klasse optioneel. Dat betekent dat het mogelijk blijft om dataservices te beschrijven met de klasse Distributie.
Deze eigenschap bevat de wetgeving die de creatie of het beheer van de dataservice verplicht stelt.
Er kunnen meerdere wetgevingen op de dataset van toepassing zijn. Denk aan HVD, INSPIRE, kaderrichtlijn water etc.
Gebruik de referentie naar de officiële publicatie van de wetgeving.
Deze eigenschap bevat een verwijzing naar een (technische) vastgestelde standaard of specificatie waaraan de beschreven dataservice voldoet. Bijvoorbeeld een API features standaard http://www.opengis.net/def/interface/ogcapi-features.
Gebruik de referentie naar de officiële publicatie van de standaard of specificatie.
Deze eigenschap is verplicht, als de dataservice onder de HVD uitvoeringsverordening valt.
De standaard waarnaar hier wordt verwezen, behoort de dataservice te beschrijven en niet de bijbehorende dataset. De dataservice voldoet bijvoorbeeld aan de OGC API-features standaard, terwijl de bijbehorende dataset voldoet aan het INSPIRE Address dataspecificatie.
Deze eigenschap bevat de contactinformatie waar eindgebruikers contact kunnen opnemen met vragen over de dataservice. Dit element bevat het e-mailadres of link (URL) naar het contactformulier van de verantwoordelijke organisatie van de dataset. Het e-mail adres is een functioneel e-mailadres van de organisatie of organisatie onderdeel.
De organisatie die verantwoordelijk is voor het creëren van de beschreven dataservice. Gebruik bij voorkeur een URI of anders een waarde uit een organisatienamenlijst. Als dat niet mogelijk is, gebruik de volledig uitgeschreven naam van de verantwoordelijke organisatie. De afkorting kan toegevoegd worden aan de organisatienaam.
Deze eigenschap bevat een beschrijving van de inhoud van de dataservice. Deze is bij voorkeur minimaal drie zinnen en maximaal één alinea lang (2000 karakters). De vindbaarheid van de dataservice wordt bepaald door de kwaliteit van de tekst. Denk hierbij aan verschillende gebruikers, vakgenoten maar ook anderen, waarvoor de tekst begrijpelijk moet zijn.
Zie meertaligheid voor het omgaan met verschillende talen.
Een pagina of document over de dataservice met aanvullende informatie.
De informatie over de kwaliteit van de dienstverlening wordt beschouwd als onderdeel van de generieke documentatie van een dataservice. Voor HVD moet dit verplicht worden opgenomen.
Deze eigenschap beschrijft de specifieke details van de dataservice, zoals de operaties die beschikbaar zijn voor deze dataservice via de end-point instanties, inclusief hun werking en parameters
Een beschrijving van een eindpunt kan worden uitgedrukt in een machine leesbare vorm, zoals een OpenAPI (Swagger) beschrijving [OpenAPI], een OGC GetCapabilities aanroep [WFS], [ISO-19142], [WMS], [ISO-19128], een [SPARQL11-SERVICE-DESCRIPTION], een [OpenSearch] of [WSDL20] document, een Hydra API beschrijving [HYDRA], anders in tekst of een andere informele vorm als een formele representatie niet mogelijk is.
In application profile wordt verwezen naar de algemene (technische) standaard of specificaties waaraan de beschreven dataservice voldoet
De hoofdlocatie of het primaire eindpunt van de service (een IRI).
De eindpunt-URL MOET persistent zijn. Dit betekent dat uitgevers er alles aan moeten doen om de waarde stabiel en bestaand te houden.
Deze eigenschap bevat de HVD-categorie waartoe de datasets die in de dataservice worden ontsloten, behoort, als die dataset onder de HVD uitvoeringsverordening valt.
Identifier wordt gebruikt voor de unieke identificatie van de dataservice. Dit is bij voorkeur een persistente URI die via HTTP raadpleegbaar is (resolvable). Hier wordt de oorspronkelijke identificatie van de dataservice overgenomen zoals de data-eigenaar deze gepubliceerd heeft. De identifier mag niet door afnemers aangepast worden.
De eventuele andere identifiers worden in de eigenschap other identifier opgenomen, zoals bijvoorbeeld identifiers die door een catalog worden toegekend.
Identifier heeft de beperking (ten opzichte van DCAT-AP) dat deze eigenschap alleen de waarde kan bevatten die de eerste eigenaar heeft gegeven.
Vraag, heeft een identifier voor dataservice meerwaarde, is dit in te vullen vanuit bestaande metadata?
Deze eigenschap bevat in het algemeen gebruikte woorden of geformaliseerde zinnen om de dataservice te beschrijven, die niet uit een controlled vocabulary komen.
Het is mogelijk om meerdere keywords toe te kennen aan een dataservice. Deze waarden moeten in afzonderlijke voorkomens van deze eigenschap worden aangeleverd.
Theme word gebruikt voor trefwoorden die uit een controlled vocabulary komen.
De webpagina die toegang geeft tot de dataservice en aanvullende informatie verschaft over de dataservice. Het gaat hierbij om de originele webpagina van de aanbieder van de dataservice.
Language heeft de beperking (ten opzichte van DCAT-AP) dat deze eigenschap alleen de waarde kan bevatten van de taal van de tekstuele waardes in de dataservice.
In https://semiceu.github.io/DCAT-AP/releases/3.0.0/#controlled-vocs is het gebruik van de EU waardelijst niet opgenomen, we verwachtten dat dit wel de bedoeling is.
De licentie waaronder de dataservice beschikbaar wordt gesteld.
Licenties zijn een aanvulling op dct:accessRights. Als de data (publiek) toegankelijk zijn, staan in de licentie de voorwaarden voor het (her)gebruik daarvan.
Gebruik van Creative Commons Licenties is vereist. Aanbevolen wordt om steeds de meest recente versie van een licentie te gebruiken.
In het geval geen (her)gebruik volgens een CC licentie mogelijk is, mag de waarde ‘niet-open' gebruikt worden. Dat laatste kan bijvoorbeeld voorkomen als een dataset alleen onder voorwaarden toegankelijk is.
Gebruik dcterms:rights voor alle andere typen voorwaarden – indien die niet gedekt worden door dcterms:license en dcterms:accessRights, zoals copyright-verklaringen.
Bijhorende waardelijst moet nog worden toegevoegd
In de eigenschap other identifier, kunnen eventuele overige identifiers in aanvulling op de identifier worden opgenomen, zoals identifiers die door een catalog worden toegekend. Eventueel kan naast de waarde van de identifier zelf, ook worden opgenomen wie deze toevoeging gedaan heeft. Hierdoor ontstaat een lijst met equivalente identifiers.
Het gebruik van other identifier wordt (ten opzichte van DCAT-AP) verder gespecificeerd, secundaire identifiers, zijn ook alle identifiers die aan de dataservice zijn toegewezen tijdens het verwerken en delen van die dataset in het catalogusnetwerk.
Een verklaring waarin de rechten die verband houden met de dataservice worden gespecificeerd. Hierin worden alleen de overige rechten opgenomen die niet gedekt worden door license of acces rights.
Deze eigenschap bevat de categorie van de dataservice. De waarde die voor deze eigenschap moeten worden gebruikt, is in ieder geval één URI van een concept uit Dataset Theme Vocabulary
Aanbevolen wordt om naast een waarde uit de Europese Dataset Theme Vocabulary ook in meerdere thema's waarden op te nemen uit domeinspecifieke vocabulaires.
keyword word gebruikt voor trefwoorden die niet uit een controlled vocabulary komen.
Op Europees niveau is nog een discussie gaande of naast een waarde uit Dataset Theme Vocabulary, waarden uit andere controlled vocabulary in deze of een andere eigenschap opgenomen kunnen worden.
https://github.com/SEMICeu/DCAT-AP/issues/316: Add guidance on usage of additional themes for datasets
In https://semiceu.github.io/DCAT-AP/releases/3.0.0/#controlled-vocs is het gebruik van de EU waardelijst niet opgenomen, we verwachtten dat dit wel de bedoeling is.
Aanbevolen schrijfwijze voor deze eigenschap is: (projectkenmerk) onderwerp (locatiekenmerk) (tijdskenmerk) (versie). Hierbij zijn de onderdelen tussen haakjes niet verplicht, de andere wel. Afkortingen zijn in de titel enkel toegestaan indienen deze tevens zijn uitgeschreven bijvoorbeeld: “Grootschalige Basiskaart Nederland (GBKN)”.
Deze eigenschap bevat de wetgeving die de creatie of het beheer van de catalogus verplicht stelt.
Er kunnen meerdere wetgevingen op de catalogus van toepassing zijn. Denk aan HVD, INSPIRE, kaderrichtlijn water etc.
Gebruik de referentie naar de officiële publicatie van de wetgeving.
Deze eigenschap bevat de contactinformatie waar eindgebruikers contact kunnen opnemen met vragen over de catalogus. Dit element bevat het e-mail adres of link (URL) naar het contactformulier van de verantwoordelijke organisatie van de dataset. Het e-mail adres is een functioneel e-mailadres van de organisatie of organisatie onderdeel.
De organisatie die verantwoordelijk is voor het creëren van de beschreven catalogus. Gebruik bij voorkeur een URI of anders een waarde uit een organisatienamenlijst. Als dat niet mogelijk is, gebruik de volledig uitgeschreven naam van de verantwoordelijke organisatie. De afkorting kan toegevoegd worden aan de organisatienaam.
Deze eigenschap bevat een beschrijving van de inhoud van de catalogus. Deze is bij voorkeur minimaal drie zinnen en maximaal één alinea lang (2000 karakters). De vindbaarheid van de catalogue wordt bepaald door de kwaliteit van de tekst. Denk hierbij aan verschillende gebruikers, vakgenoten maar ook anderen, waarvoor de tekst begrijpelijk moet zijn.
Het geografische gebied waarop de gegevens in de catalogus betrekking hebben. Het veld kan worden gevuld met de benaming van een gebied in de vorm van een URI of de coördinaten ervan.
De coördinaten zijn de meest westelijke, oostelijke, noordelijke en zuidelijke coördinaat uit de horizontale dekking van de dataset weergegeven in latitude en longitude in decimale graden (noord en oost als positieve waarden). De coördinaten dienen te worden weergegeven volgens referentiesysteem WGS 84.
Voor de invulling van deze eigenschap met een gebiedsnaam, wordt vereist dat een van de onderstaande als mogelijk gebruik wordt gemaakt van https://vocabs.cbs.nl/nl/ of anders van
GeoNames.org
Gebruik hiervoor een waarde uit EU Vocabularies Continents Named Authority List, EU Vocabularies Countries Named Authority List, EU Vocabularies Places Named Authority List, Geonames
De homepage van de catalogus. Een catalogus kan op meerdere dataportals worden gepubliceerd. Deze eigenschap verwijst naar de originele homepage. Dat is in de regel de homepage van de maker van de catalogus.
Een verklaring waarin de rechten die verband houden met de catalogus worden gespecificeerd. Hierin worden alleen de overige rechten opgenomen die niet gedekt worden door license of acces rights.
Aanbevolen schrijfwijze voor deze eigenschap is: (projectkenmerk) onderwerp (locatiekenmerk) (tijdskenmerk) (versie). Hierbij zijn de onderdelen tussen haakjes niet verplicht, de andere wel. Afkortingen zijn in de titel enkel toegestaan indienen deze tevens zijn uitgeschreven bijvoorbeeld: “Grootschalige Basiskaart Nederland (GBKN)”.
Een beschrijving van de in de catalogus opgenomen beschrijvingen van een dataset of data service. Hierin worden eigenschappen van de beschrijving zelf vastgelegd, zoals bijvoorbeeld de standaard waaraan de beschrijving voldoet. Voor High Value Datasets kan dat bijvoorbeeld ook DCAT-AP-HVD zijn, naast DCAT-AP en DCAT-AP-NL. Daarnaast kan er ook verwezen worden naar de originele metagegevens (conform een andere standaard) die zijn gebruikt bij het genereren van de beschrijving in DCAT.
Deze eigenschap bevat een verwijzing naar een (technische) vastgestelde standaard of specificatie waaraan de beschrijving van de dataset of dataservice in de catalogus voldoet.
Gebruik de referentie naar de officiële publicatie van de standaard of specificatie.
De standaard waarnaar hier wordt verwezen, behoort de metadata te beschrijven, bijvoorbeeld DCAT-AP-HVD https://semiceu.github.iodcat-ap/releases/2.2.0-hvd
Deze eigenschap bevat de taal die wordt gebruikt in de metadata beschrijving, om onder andere de titel en andere tekstuele beschrijvingen, in het catalog record vast te leggen.
Deze eigenschap bevat de wetgeving die de creatie of het beheer van de dataset serie verplicht stelt.
Er kunnen meerdere wetgevingen op de dataset serie van toepassing zijn. Denk aan HVD, INSPIRE, kaderrichtlijn water etc.
Gebruik de referentie naar de officiële publicatie van de wetgeving.
Deze eigenschap bevat de contactinformatie waar eindgebruikers contact kunnen opnemen met vragen over de dataset serie. Dit element bevat het e-mail adres of link (URL) naar het contactformulier van de verantwoordelijke organisatie van de dataset. Het e-mail adres is een functioneel e-mailadres van de organisatie of organisatie onderdeel.
Deze eigenschap bevat een beschrijving van de inhoud van de dataset serie. Deze is bij voorkeur minimaal drie zinnen en maximaal één alinea lang (2000 karakters). De vindbaarheid van de dataset serie wordt bepaald door de kwaliteit van de tekst. Denk hierbij aan verschillende gebruikers, vakgenoten maar ook anderen, waarvoor de tekst begrijpelijk moet zijn.
Het wordt aanbevolen om een indicatie te geven van de dimensies waarin de dataset serie zich ontwikkelt.
Een geografisch gebied dat wordt gedekt door de reeks gegevens.
Het geografische gebied waarop de gegevens in de dataset serie betrekking hebben. Het veld kan worden gevuld met de benaming van een gebied in de vorm van een URI of de coördinaten ervan.
De coördinaten zijn de meest westelijke, oostelijke, noordelijke en zuidelijke coördinaat uit de horizontale dekking van de dataset weergegeven in latitude en longitude in decimale graden (noord en oost als positieve waarden). De coördinaten dienen te worden weergegeven volgens referentiesysteem WGS 84.
Voor de invulling van deze eigenschap met een gebiedsnaam, wordt vereist dat een van de onderstaande als mogelijk gebruik wordt gemaakt van https://vocabs.cbs.nl/nl/ of anders van
GeoNames.org
Als de spatial coverage een dimensie is in de dataset series, dan moet de spatial coverage van elke dataset in de verzameling deel uitmaken van de dataset serie. In dat geval wordt een open waarde aanbevolen, bv. EU of een brede bounding box die de verwachte waarden omvat.
De tijdsperiode waar de dataset serie betrekking op heeft.
Als de temporal coverage een dimensie is in de dataset serie, dan moet de temporal coverage van elke dataset in de verzameling deel uitmaken van de dataset serie. In dat geval wordt een open waarde aanbevolen, die de verwachte waarden omvat.
Aanbevolen schrijfwijze voor deze eigenschap is: (projectkenmerk) onderwerp (locatiekenmerk) (tijdskenmerk) (versie). Hierbij zijn de onderdelen tussen haakjes niet verplicht, de andere wel. Afkortingen zijn in de titel enkel toegestaan indienen deze tevens zijn uitgeschreven bijvoorbeeld: “Grootschalige Basiskaart Nederland (GBKN)”.
In de metadata dienen de waarden uit de waardelijsten waarnaar verwezen wordt bij de element beschrijving, gehanteerd te worden. Dit zijn vaak de door de EU verplichte waardelijsten.
In de onderstaande tabel worden eigenschappen opgesomd met gecontroleerde waardelijsten die voor de genoemde eigenschappen MOETEN worden gebruikt.
Voor Europese instellingen en een klein aantal internationale organisaties moet de EU Vocabularies Corporate bodies Named Authority List worden gebruikt.
Bij andere soorten organisaties moeten nationale, regionale of lokale woordenlijsten worden gebruikt, zoals bijvoorbeeld Register Overheid-Organisaties, Research Organization Registry (ROR) of Core Business Vocabulary (organisaties)
De redactie is alle leden van de werkgroep dankbaar voor hun bijdragen aan dit document en tevens ook de personen die eerder een bijdrage geleverd hebben aan DCAT-AP-DONL 2.0 waarvan dankbaar gebruik gemaakt is.
DCAT-3.0. Simon Cox; Andrea Perego; Alejandra Gonzalez Beltran; Peter Winstanley; Riccardo Albertoni; David Browning. W3C. Candidate Recommendation. URL: https://www.w3.org/TR/vocab-dcat-3/
OpenAPI. Darrell Miller; Jeremy Whitlock; Marsh Gardiner; Mike Ralphson; Ron Ratovsky; Uri Sarid; Tony Tam; Jason Harmon. URL: https://www.openapis.org/
