Skip to content

Dataservice

Jan Meijer edited this page Dec 2, 2021 · 8 revisions

Class: DataService

Een dataservice biedt toegang tot informatie om gegevens te verkrijgen of toe te voegen via een vraag query waarop na verwerking een antwoord gegeven wordt, met daarin gegevens of statusinformatie.

Er lijkt overlap te bestaan tussen een distributie die toegankelijk is via een dcat:accessURL en een dataservice die wordt ontsloten via dcat:endpointURL. Mogelijk is dcat:accessURL nog beschikbaar om backwards compatible te blijven met DCAT 1. Dataservice is immers pas beschikbaar vanaf DCAT 2. In DCAT-AP-DONL-2 moet wel duidelijk worden gespecificeerd hoe nieuwe dataservices moeten worden geregistreerd.

Een dataservice beschrijft de toegang tot gegevens (van een dataset) speciaal voor geautomatiseerde toegang. Hiermee verschilt het van distributies, waarbij de gegevens via dcat:downloadURL ook handmatig kunnen worden verkregen.

Dataservices worden ook beschreven op https://developer.overheid.nl. Het kan interessant zijn om over en weer relaties te leggen tussen de dataservice op data.overheid.nl en die op developer.overheid.nl. Op die manier kunnen bezoekers gebruikmaken van de toegevoegde waarde die elk van deze platforms te bieden hebben.

Properties van Dataservice

Property: endpoint URL

Deze eigenschap verwijst naar de locatie of het endpoint van de webservice (a Web-resolvable IRI)

RDF Property: dcat:endpointURL
Bereik rdfs:Resource
Cardinaliteit 1..*, Verplicht

Property: endpoint description

Deze eigenschap beschrijft de services die via het endpoint beschikbaar zijn, incl. parameters en functies.

RDF Property: dcat:endpointDescription
Bereik xsd:string
Cardinaliteit 0..1, Aanbevolen
DONL Op dit punt zouden data.overheid.nl en developer.overheid.nl kunnen samenwerken. Eindgebruikers zijn hier gebaat bij een duidelijke uitleg en voorbeelden. Het heeft niet zoveel zin om deze 2x te bedenken.

Property: serves dataset

Deze eigenschap verwijst naar de dataset die dit endpoint beschikbaar stelt.

RDF Property: dcat:servesDataset
Bereik dcat:Dataset
Cardinaliteit 0..*, Aanbevolen
Opmwerking Volgens DCAT-AP kan een dataservice voorkomen zonder bijbehorende dataset, maar kan een dataservice ook gerelateerd zijn met meerdere datasets. Verder overlappen de gegevens van dataset en dataservice elkaar grotendeels, omdat het beide "resources" zijn en dus de eigenschappen overerven van dcat:CatalogResource.
DONL Als een dataset alleen gedistribueerd wordt via een dataservice (endpoint) dan wordt deze geregistreerd als dcat:DataService. Als de dataset daarnaast ook andere distributies heeft, dan wordt ook een instantie dcat:Dataset aangemaakt. In dat geval worden de eigenschappen van de superklasse van catalog resource dubbel vastgelegd, dus zowel in de dataset als in de bijbehorende dataservice.

Clone this wiki locally