Dit document beschrijft een applicatieprofiel, in dit geval Metadata DCAT. Dit applicatieprofiel beantwoordt de vraag over hoe het corresponderende domeinmodel in de praktijk kan toegepast worden. Daarbij worden de beperkingen (kardinaliteit, codelijsten) toegelicht en de overeenkomstige (RDF) termen opgelijst.
Samenvatting
Het applicatieprofiel “metadata dcat”. Dit is een applicatieprofiel gebaseerd op DCAT en richt zich op het verzamelen van informatie over generieke datasets, distributies en services die door een overheid beschikbaar gesteld worden. De datasets en services omvatten zowel publiek toegankelijke als afgeschermde data en diensten (ontwikkeld in en voor eender welk technisch perspectief). Het samenbrengen van al deze informatie in een catalogus laat toe om de vindbaarheid van deze datasets en services te verhogen. Dit applicatieprofiel is het generieke basisprofiel. Afgeleide profielen kunnen zeker aangemaakt worden voor specifieke domeinen of communities. Bijvoorbeeld is DCAT-AP-VL zo’n afgeleid applicatieprofiel, specifiek voor het Open data domein en bijhorende community.
Status van dit document
Dit applicatieprofiel heeft status Erkende Standaard en werd uitgegeven op 2022-04-21.
Informatie over het gevolgde proces en de beslissingen om tot deze specificatie te komen zijn beschikbaar in het standaardenregister.
Licentie
Deze specificatie van Informatie Vlaanderen is gepubliceerd onder de "Modellicentie Gratis Hergebruik - v1.0".
Conformiteit
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.
Om conform te zijn met dit applicatieprofiel, geldt voor een implementatie dat ze:
- MOET conform zijn aan de verplichtingen van DCAT.
- MOET voor elke klasse steeds de eigenschappen bevatten die als minimum kardinaliteit 1 hebben.
- MAG NIET meer dan 1 instantie bevatten van eigenschappen die 1 als maximum kardinaliteit hebben.
- MAG terminologie (klassen en eigenschappen) gebruiken op een manier die consistent is met haar semantiek (definitie, gebruik, domein en bereik).
- MAG uitgebreid worden met klassen en eigenschappen van andere datamodellen (vocabularia) die niet overlappen met terminologie vermeld in dit document of in DCAT, DCAT-AP.
- PAST maximaal de algemene en specifieke gebruiksadviezen toe.
Algemene gebruikadviezen
- Zorg voor stabiele identificatoren voor datasets en dataservices, en waar mogelijk ook voor alle andere vermelde entiteiten.
- Gebruik enkel absolute URLs. Dan blijft onder alle verwerkingsoperaties van de catalogus de URL identiek en is er geen kwaliteitsverlies voor de gebruiker.
- Voor temporele informatie wordt verwacht dat de tijdzone wordt meegegeven.
- Indien gekozen wordt om de geografische beschrijving als een geometrie mee te geven, dan wordt best gekozen voor een beschrijving met expliciete vermelding van het gebruikte Coordinaten Referentie Systeem (CRS).
- Beschrijvende informatie zoals titels en beschrijvingen zijn taalafhankelijk. Voorzie voor elke taal slechts één waarde.
Informatieveiligheid
Een semantische specificatie richt zich in de eerste plaats op het maken van afspraken rond de betekenis van termen. Dit is bij uitstek het doel van een vocabularium. Applicatieprofielen zijn gericht op afspraken in een brede gebruikscontext. Daardoor omvatten zij meer en specifieke beperkingen die het gebruik ten goede komen.
Een van de aspecten voor het gebruik van de specificatie is informatieveiligheid. Het merendeel van de bezorgdheden i.v.m. informatieveiligheid hebben geen directe invloed op een applicatieprofiel. Ze zijn dikwijls van technische aard die buiten de semantische afspraken vallen zoals het encrypteren van datastromen. Bij voorkeur worden deze twee werelden zoveel mogelijk gescheiden en enkel samengevoegd in een implementatie.
Echter sommige afspraken zijn beïnvloedbaar door informatieveiligheid. Voorbeelden hiervan zijn het al dan niet verplichten van een eigenschap of de range van een eigenschap (een identificator versus een string). Het is aan de opstellers van de specificatie om de juiste balans te vinden.
Voor metadata voor services is een belangrijke gebruikscontext het aggregeren van catalogi komende van verschillende organisaties. Het doel is om deze aggregatie als geheel ter beschikking te stellen van het publiek. Omdat entiteiten van de ene catalogus kunnen verwijzen naar entiteiten van andere catalogi, is het zo goed als onmogelijk om een verschillende informatieveiligheidspolitiek te voeren per ter aggregeren catalogus. Daarom wordt dit niet opgenomen als onderdeel van de specificatie. Indien dit gewenst is, dan zal dit een implementatieafspraak worden.
Omdat de basis van de usecase het publiekelijk delen van informatie is, wordt aangenomen dat de informatiestructuur zoals die in de specificatie opgenomen is ook in die vorm kan gedeeld worden. Informatie waarvan kennis is genomen die omwille van een of andere reden niet publiek kan gemaakt worden, zal dus niet verplicht worden. Dikwijls zal die informatie via een andere eigenschap, via een toegangspagina, te vinden zijn voor de gebruiker van de geaggregeerde catalogus.
Service beschrijving en de payload beschrijving
Indien een data service beschreven wordt dan is er meestal ook de noodzaak om informatie te geven over de data die ontsloten wordt via de dataservice. Om dit onderscheid eenduidig vast te leggen wordt de volgende ontwerpbeslissing gevolgd. Eigenschappen die rechtstreeks te maken hebben met de dataservice zijn eigenschappen van de dataservice. Eigenschappen die slaan op de ontsloten data zijn eigenschappen van de verbonden aangeboden dataset (of datasets). Bijvoorbeeld, de eigenschap taal voor een dataservice: de service kan in het Engels geschreven zijn waarbij deze antwoordt op queries in het Engels, terwijl de data uit de dataset die aangeboden wordt in die dataservice Nederlandstalig is. Echter indien men wil aangeven dat de informatie ontsloten wordt slechts beschikbaar is in het Nederlands, dan wordt dat aangegeven als waarde voor de taal eigenschap van de aangeboden dataset.
Onderscheid distributie en dataservice
In een dagdagelijks gesprek over datasets en hun onsluitingsvormen wordt de term distributie gebruikt in een brede zin. Een distributie is daarin de aanduiding van eender welke vorm van ontsluiting. DCAT heeft ervoor gekozen om een service als een onafhankelijke entiteit op te nemen. Hierdoor ontstaat een spanningsveld tussen de dagdagelijkse terminologie en de formele terminologie van DCAT. Echter zelfs op basis van de definities in DCAT kan men geen precies afgelijnd onderscheid maken tussen een distributie en een dataservice.
Om de catalogusbeheerders in Vlaanderen een uniformere aanpak te geven, wordt het volgende afgesproken. Een distributie zal voornamelijk gebruikt worden om een afgerond geheel van data aan te duiden. Iets dat downloadbaar is als een file. Een dataset is een abstracte entiteit (een naam voor een geheel aan data); een distributie van de dataset is een concrete vorm die de afnemer van de dataset lokaal kan gebruiken zonder enige andere systeemtoegang. Een distributie zal dus niet bestaan zonder een dataset.
Alle andere vormen zullen als een dataservice beschreven worden. Een dataservice heeft dikwijls een hoge mate van onafhankelijkheid van een distributie (effectieve data) van een dataset; het kan zelfs niet gebonden zijn aan één dataset. Of het biedt een slimme toegang tot de data (bv. via een query interface).
Overzicht
In dit document wordt correct gebruik van de volgende entiteiten toegelicht:
|
Agent |
Catalogus |
Catalogus Record |
Catalogus Resource |
Dataservice |
Dataset |
Distributie |
Herkomst Verklaring |
Juridische bepaling |
Licentie Document |
Plaats |
Relatie Qualificatie |
Standaard |
Voorbeeldweergave |
In dit document worden de volgende datatypes toegelicht:
|
Contactinfo |
Contactpunt |
Identificator |
Entiteiten
Agent
- Beschrijving
- Iemand die of iets dat kan handelen of een effect kan teweeg brengen.
- Gebruik
- Een agent kan op verschillende wijzen interageren met de beschreven entiteiten. Voorbeelden zijn beheerder, uitgever, maker, enz.
- Eigenschappen
- Voor deze entiteit zijn de volgende eigenschappen gedefinieerd: naam.
Eigenschap | Verwacht Type | Kardinaliteit | Beschrijving | Gebruik | Codelijst |
---|---|---|---|---|---|
naam
|
TaalString | 1..n | De naam van de agent. | Omwille van de meertaligheid kunnen er meerdere waarden zijn. De gewenste interpretatie van de cardinaliteit is: per taal slechts 1 waarde. |
Catalogus
- Beschrijving
- Een beheerde verzameling van metadata over resources (zoals datasets en dataservices in de context van een datacatalogus).
- Gebruik
- [Zie DCAT]
- Eigenschappen
- Voor deze entiteit zijn de volgende eigenschappen gedefinieerd: alternatieve identificator, beschrijving, contactinformatie, heeft DataService, heeft Dataset, identificator, licentie, record, titel, uitgever.
Eigenschap | Verwacht Type | Kardinaliteit | Beschrijving | Gebruik | Codelijst |
---|---|---|---|---|---|
alternatieve identificator
|
Identificator | 0..n | Een alternatieve identificator (dan de unieke identificator) voor de catalogus kan hier beschreven worden. | [Zie DCAT-AP] | |
beschrijving
|
TaalString | 1..n | Een bondige tekstuele omschrijving van de catalogus. | [Zie DCAT] Omwille van de meertaligheid kunnen er meerdere waarden zijn. De gewenste interpretatie van de cardinaliteit is: per taal slechts 1 waarde. | |
contactinformatie
|
Contactinfo | 1 | De relevante contactinformatie waarmee een eindgebruiker in contact kan treden met de verantwoordelijken van de catalogus. | [Zie DCAT] | |
heeft DataService
|
Dataservice | 0..n | Een dataservice die deel uitmaakt van de catalogus. | [Zie DCAT] | |
heeft Dataset
|
Dataset | 0..n | Een dataset die deel uitmaakt van de catalogus. | [Zie DCAT] | |
identificator
|
Literal | 1 | De unieke identificator voor de catalogus. | [Zie DCAT] | |
licentie
|
Licentie Document | 0..1 | De licentie van de catalogus. | [ Zie DCAT ]
De licentie voor het Vlaams Open Data Portaal is vastgelegd op https://data.vlaanderen.be/id/licentie/creative-commons-zero-verklaring/v1.0 .
Meer informatie zie hieronder. |
|
record
|
Catalogus Record | 0..n | Een record beschrijft de registratie van één enkele dataset of dataservice die onderdeel is van de catalogus. | [Zie DCAT] | |
titel
|
TaalString | 1..n | De naam van de catalogus. | [Zie DCAT] Omwille van de meertaligheid kunnen er meerdere waarden zijn. De gewenste interpretatie van de cardinaliteit is: per taal slechts 1 waarde. | |
uitgever
|
Agent | 1 | De uitgever, de entiteit die verantwoordelijk is voor het beschikbaar stellen, van de catalogus. | [Zie DCAT] |
Catalogus Record
- Beschrijving
- Een record in een catalogus beschrijft de registratie van één resource in de catalogus.
- Gebruik
- [Zie DCAT]
- Eigenschappen
- Voor deze entiteit zijn de volgende eigenschappen gedefinieerd: aanmaakdatum, alternatieve identificator, bron metadata record landingspagina, bron metadatarecord, conform, hoofdonderwerp, identificator, titel, wijzigingsdatum.
Eigenschap | Verwacht Type | Kardinaliteit | Beschrijving | Gebruik | Codelijst |
---|---|---|---|---|---|
aanmaakdatum
|
DateTime | 0..1 | De datum van (formele) opname van de bijbehorende dataset of dataservice in de catalogus. | [Zie DCAT] | |
alternatieve identificator
|
Identificator | 0..n | Een alternatieve identificator (dan de unieke identificator) voor een record in de catalogus kan hier beschreven worden. | [Zie DCAT-AP] | |
bron metadata record landingspagina
|
URi | 0..1 | Een webpagina in een menselijk leesbare vorm van de bron metadata record. | Bij voorkeur, zet in op de eigenschap bron metadata record, om een machine leesbare vorm te delen. | |
bron metadatarecord
|
URi | 0..1 | De record in een andere catalogus waarvan deze record en de beschrijvingen van het bijhorende hoofdonderwerp van afgeleid zijn. | ||
conform
|
Standaard | 0..n | De (metadata) standaard volgens welke regels het hoofdonderwerp waarnaar de Catalogus Record verwijst, beschreven wordt. | Eén van de URIs voor erkende metadata standaarden: metadata DCAT, DCAT-AP Vlaanderen of GeoDCAT-AP Vlaanderen. | |
hoofdonderwerp
|
Catalogus Resource | 1 | De resource (dataset of dataservice) beschreven in het record. | [Zie DCAT] | |
identificator
|
Literal | 1 | De unieke identificator van het record in de catalogus. | [Zie DCAT] | |
titel
|
TaalString | 0..n | De naam van het record in de catalogus. | [Zie DCAT] Omwille van de meertaligheid kunnen er meerdere waarden zijn. De gewenste interpretatie van de cardinaliteit is: per taal slechts 1 waarde. | |
wijzigingsdatum
|
DateTime | 1 | De meest recente datum waarop de record in de catalogus is gewijzigd, bijgewerkt of aangepast. | [Zie DCAT] |
Dataservice
- Beschrijving
- Een verzameling van operaties die ofwel toegang bieden tot één of meer datasets ofwel een dataverwerkingsdoel hebben.
- Gebruik
- [Zie DCAT]
- Subklasse van
- Catalogus Resource
- Eigenschappen
- Voor deze entiteit zijn de volgende eigenschappen gedefinieerd: alternatieve identificator, beschrijving, biedt informatie aan over, conform aan protocol, contactinformatie, creatiedatum, endpointbeschrijving, endpointURL, identificator, landingspagina, landingspagina voor authenticatie, landingspagina voor gebruiksinformatie, landingspagina voor statusinformatie, levensfase, licentie, ontwikkelingstoestand, publicatiedatum, rechten, statuut, thema, titel, toegankelijkheid, trefwoord, versie, wijzigingsdatum.
Eigenschap | Verwacht Type | Kardinaliteit | Beschrijving | Gebruik | Codelijst |
---|---|---|---|---|---|
alternatieve identificator
|
Identificator | 0..n | Een alternatieve identificator (dan de unieke identificator) voor een dataservice kan hier beschreven worden. | [Zie DCAT-AP] | |
beschrijving
|
TaalString | 0..n | Een bondige tekstuele omschrijving van de dataservice. | [Zie DCAT] Omwille van de meertaligheid kunnen er meerdere waarden zijn. De gewenste interpretatie van de cardinaliteit is: per taal slechts 1 waarde. | |
biedt informatie aan over
|
Dataset | 0..n | De data die via deze dataservice worden aangeboden. | [Zie DCAT] | |
conform aan protocol
|
Standaard | 0..n | Een protocol waaraan de dataservice voldoet. | [Zie DCAT] Deze eigenschap capteert de technische specificatie waaraan de service voldoet. Voorbeelden zijn WFS, SPARQL, SOAP, | Link |
contactinformatie
|
Contactinfo | 1 | De relevante contactinformatie waarmee een eindgebruiker in contact kan treden met de verantwoordelijken van de dataservice. | [Zie DCAT] | |
creatiedatum
|
DateTime | 0..1 | Het tijdsmoment waarop de dataservice voor het eerst werd geactiveerd. | [Zie GeoDCAT-AP] | |
endpointbeschrijving
|
URi | 1 | Een beschrijving van de diensten die beschikbaar zijn via de end-points, met inbegrip van hun operaties, parameters, enz. | [Zie DCAT] | |
endpointURL
|
URi | 0..1 | De rootlocatie of het primaire endpoint van de dienst (een web-resolvable URI). | [Zie DCAT] | |
identificator
|
Literal | 1 | De unieke identificator van de dataservice. | [Zie DCAT] | |
landingspagina
|
URi | 0..n | Een algemene webpagina waarnaar kan worden genavigeerd in een webbrowser, met algemene aanvullende informatie over de dataservice. | [Zie DCAT] | |
landingspagina voor authenticatie
|
URi | 0..1 | Een verwijzing naar de landingspagina met de specifieke informatie over de authenticatie voor de dataservice. | Deze eigenschap capteert een onderdeel van de beschrijvende informatie over de service beschreven in de landingspagina. Enkel te gebruiken indien men kan verwijzen naar een sectie of een aparte pagina waar deze specifieke informatie beschikbaar is. | |
landingspagina voor gebruiksinformatie
|
URi | 0..1 | Een verwijzing naar de landingspagina met de specifieke informatie over het gebruik van de dataservice. | Deze eigenschap capteert een onderdeel van de beschrijvende informatie over de service beschreven in de landingspagina. Enkel te gebruiken indien men kan verwijzen naar een sectie of een aparte pagina waar deze specifieke informatie beschikbaar is. | |
landingspagina voor statusinformatie
|
URi | 0..1 | Een verwijzing naar de statuspagina van de dataservice | Deze eigenschap capteert een onderdeel van de beschrijvende informatie over de service beschreven in de landingspagina. Enkel te gebruiken indien men kan verwijzen naar een sectie of een aparte pagina waar deze specifieke informatie beschikbaar is. | |
levensfase
|
Code | 0..1 | De levensfase waarin de dataservice zich bevindt. | Het gebruik hiervan is voornamelijk belangrijk wanneer men de data service wil uit dienst nemen. Het tijdig aangeven dat een dienst op zijn einde loopt en dat de gebruiker moet overschakelen op de nieuwe dienst is een onderdeel van goed service management. | Link |
licentie
|
Licentie Document | 0..1 | De licentie van de dataservice. | [Zie DCAT] | |
ontwikkelingstoestand
|
Code | 0..1 | De ontwikkelingstoestand waarin de dataservice is gedeployed. | Op verschillende momenten tijdens de ontwikkeling van een data service wordt de data service geëvalueerd. | Link |
publicatiedatum
|
DateTime | 0..1 | Het tijdsmoment waarop de service werd gepubliceerd door de uitgever. | [Zie DCAT] | |
rechten
|
Juridische bepaling | 0..n | Bepalingen van juridische aard die gelden op de dataservice. | [Zie DCAT] Met deze eigenschap kunnen rechten uitgedrukt worden zoals copyright of specifieke gebruiksbepalingen. Ook SLA en SLO informatie kan hier opgenomen worden. Indien deze rechten reeds opgenomen zijn in de licentie dan moeten ze niet hier herhaald worden. | |
statuut
|
Code | 0..n | Een aanduiding van op welke basis de catalogusresource beschikbaar is. | Link | |
thema
|
Code | 0..n | De hoofdcategorie waartoe de dataservice behoort. | [Zie DCAT] | Link |
titel
|
TaalString | 1..n | De naam van de dataservice. | [Zie DCAT] Omwille van de meertaligheid kunnen er meerdere waarden zijn. De gewenste interpretatie van de cardinaliteit is: per taal slechts 1 waarde. | |
toegankelijkheid
|
Code | 1 | De toegankelijkheid voor de dataservice. | [Zie DCAT] Gebruik enkel de waarden PUBLIC en NON_PUBLIC uit de codelijst, waarbij PUBLIC staat voor het gebruiken van de dataservice is zonder voorwaarden, terwijl NON_PUBLIC betekent dat het gebruiken van de service gebonden is aan voorwaarden. De condities die enkel als doel hebben om de correcte werking van de dataservice te ondersteunen (vermijden van DDOS aanvallen, vermijden van oneigenlijk gebruik, ...) zoals het toepassen van authenticatie en authorisatie worden beschouwd als zonder voorwaarden. Indien echter dit leidt tot een een toetsing (bv. is de organisatie gekend, is er een betalingscontract afgesloten, ...) voorafgaand aan de verlening van de toegang dan zijn dit wel toegangsbeperkende voorwaarden. | Link |
trefwoord
|
TaalString | 0..n | Een trefwoord of tag die de resource beschrijft. | [Zie DCAT] De meertaligheid is hier verschillend als voor een beschrijvende eigenschap. De taal van elk trefwoord moet aangeduidt worden. Echter het is niet de verwachting dat elk trefwoord in elke taal vertaald wordt. Ook is het niet zo dat er slecht 1 trefwoord per taal is. Er kunnen (zullen) er meerderen zijn. | |
versie
|
String | 0..1 | Een unieke aanduiding van een variant van de dataservice door middel van een versienummer of -naam van de dataservice. | [Zie DCAT] Voor dataservices wordt dikwijls semantisch versioneren gebruikt. Bij het deployen van services wordt aangeraden om enkel de major version op te nemen in de endpointurl. De versieinformatie die hier opgegeven wordt komt best overeen met de versie die beschikbaar is in de endpointurl. | |
wijzigingsdatum
|
DateTime | 0..1 | Het tijdsmoment waarop de dataservice werd gewijzigd | [Zie DCAT] |
Dataset
- Beschrijving
- Een verzameling gegevens, gepubliceerd of samengesteld door één agent, en beschikbaar voor toegang of download in één of meerdere voorstellingswijzen.
- Gebruik
- [Zie DCAT]
- Subklasse van
- Catalogus Resource
- Eigenschappen
- Voor deze entiteit zijn de volgende eigenschappen gedefinieerd: alternatieve identificator, beschrijving, conform, contactinformatie, creatiedatum, distributie, eigenaar, geografische dekking, herkomst, identificator, landingspagina, publicatiedatum, statuut, thema, titel, toegankelijkheid, trefwoord, versie, voorbeeldweergave, wijzigingsdatum.
Eigenschap | Verwacht Type | Kardinaliteit | Beschrijving | Gebruik | Codelijst |
---|---|---|---|---|---|
alternatieve identificator
|
Identificator | 0..n | Een alternatieve identificator (dan de unieke identificator) voor een dataset kan hier beschreven worden. | [Zie DCAT-AP] | |
beschrijving
|
TaalString | 1..n | Een bondige tekstuele omschrijving van de dataset. | [Zie DCAT] Omwille van de meertaligheid kunnen er meerdere waarden zijn. De gewenste interpretatie van de cardinaliteit is: per taal slechts 1 waarde. | |
conform
|
Standaard | 0..n | Een standaard, schema, applicatieprofiel, vocabularium, CRS, ... waaraan de dataset voldoet. | [Zie DCAT] | |
contactinformatie
|
Contactinfo | 1 | De relevante contactinformatie waarmee een eindgebruiker in contact kan treden met de verantwoordelijken van de dataset. | [Zie DCAT] | |
creatiedatum
|
DateTime | 0..1 | Het tijdsmoment waarop de dataset ontstaan is. | [Zie GeoDCAT-AP] | |
distributie
|
Distributie | 0..n | Een beschikbare distributie van de dataset. | [Zie DCAT] | |
eigenaar
|
Agent | 0..n | de agent die de eigendomsrechten heeft | [Zie GeoDCAT-AP] | |
geografische dekking
|
Plaats | 0..n | Het geografische gebied waarover de dataset informatie heeft. | [Zie DCAT] | |
herkomst
|
Herkomst Verklaring | 0..n | De ontstaansgeschiedenis van een dataset. | De verwachte waarde is een webpagina (URL) die de ontstaansgeschiedenis van de dataset beschrijft. | |
identificator
|
Literal | 1 | De unieke identificator van de dataset. | [Zie DCAT] | |
landingspagina
|
URi | 0..n | Een algemene webpagina waarnaar kan worden genavigeerd in een webbrowser, met algemene informatie over de dataset, zijn distributies en/of aanvullende informatie. | [Zie DCAT] De mapping zal de landingspagina invullen met de URL naar de metadata voorstelling waarvan de dataset is afgeleid. | |
publicatiedatum
|
DateTime | 0..1 | Het tijdsmoment waarop de dataset werd gepubliceerd door de uitgever. | [Zie DCAT] | |
statuut
|
Code | 0..n | Een aanduiding van op welke basis de catalogusresource beschikbaar is. | Link | |
thema
|
Code | 0..n | De hoofdcategorie waartoe de dataset behoort. | [Zie DCAT] | Link |
titel
|
TaalString | 1..n | De naam van de dataset. | [Zie DCAT] Omwille van de meertaligheid kunnen er meerdere waarden zijn. De gewenste interpretatie van de cardinaliteit is: per taal slechts 1 waarde. | |
toegankelijkheid
|
Code | 1 | De toegankelijkheid voor de dataset. | [Zie DCAT] Gebruik enkel de waarden PUBLIC en NON_PUBLIC uit de codelijst. Deze waarden geven een invulling weer voor "Openbaarheid van Bestuur". De waarde NON_PUBLIC geeft aan dat er (wettelijke) beperkingen zijn die verhinderen dat er vrije toegang tot de informatie gegeven wordt. Voorbeelden van zulke beperkingen zijn staatsgeheimen, persoonsgebonden informatie, economische concurrentie, ... | Link |
trefwoord
|
TaalString | 0..n | Een trefwoord of tag die de resource beschrijft. | [Zie DCAT] De meertaligheid is hier verschillend als voor een beschrijvende eigenschap. De taal van elk trefwoord moet aangeduidt worden. Echter het is niet de verwachting dat elk trefwoord in elke taal vertaald wordt. Ook is het niet zo dat er slecht 1 trefwoord per taal is. Er kunnen (zullen) er meerderen zijn. | |
versie
|
String | 0..1 | Een unieke aanduiding van een variant van de dataset door middel van een versienummer of -naam van de dataset. | [Zie DCAT-AP] | |
voorbeeldweergave
|
Voorbeeldweergave | 0..n | Een verkleinde weergave van een afbeelding die de dataset illustreert.? | Een voorbeeldweergave of thumbnail heeft als doel de vindbaarheid van de dataset te verhogen. Het is geen accurate weergave van de data die de dataset bevat. | |
wijzigingsdatum
|
DateTime | 0..1 | Het tijdsmoment waarop de dataset werd geactualiseerd | [zie DCAT] |
Distributie
- Beschrijving
- Een specifieke voorstellingswijze van een dataset, gekenmerkt door één of meerdere eigenschappen zoals taal, media-type of formaat, schematische organisatie, temporele en ruimtelijke resolutie, granulariteit, ...
- Gebruik
- [Zie DCAT]
- Eigenschappen
- Voor deze entiteit zijn de volgende eigenschappen gedefinieerd: alternatieve identificator, conform, downloadURL, formaat, identificator, licentie, rechten, titel, toegangsURL, verdeler, wordt aangeboden door.
Eigenschap | Verwacht Type | Kardinaliteit | Beschrijving | Gebruik | Codelijst |
---|---|---|---|---|---|
alternatieve identificator
|
Identificator | 0..n | Een alternatieve identificator (dan de unieke identificator) voor een distributie kan hier beschreven worden. | [Zie DCAT-AP] | |
conform
|
Standaard | 0..n | Een standaard, schema, implementatie- model, applicatieprofiel, vocabularium waaraan de distributie voldoet. | [Zie DCAT] | |
downloadURL
|
URi | 0..1 | De URL waar de data gedownload kan worden. | [ Zie DCAT ] De URL start het downloaden van de distributie. | |
formaat
|
Code | 0..1 | Het bestandsformaat waarin de data wordt gedeeld. | Link | |
identificator
|
Literal | 1 | De unieke identificator van de distributie. | [Zie DCAT] | |
licentie
|
Licentie Document | 0..1 | De licentie van de distributie. | [Zie DCAT] | |
rechten
|
Juridische bepaling | 0..n | Bepalingen van juridische aard die gelden op de distributie. | [Zie DCAT] Met deze eigenschap kunnen rechten uitgedrukt worden zoals bronvermeldingen, copyright of specifieke gebruiksbepalingen. Indien deze rechten reeds opgenomen zijn in de licentie dan moeten ze niet hier herhaald worden. | |
titel
|
TaalString | 0..n | De naam van de distributie. | [Zie DCAT] Omwille van de meertaligheid kunnen er meerdere waarden zijn. De gewenste interpretatie van de cardinaliteit is: per taal slechts 1 waarde. | |
toegangsURL
|
URi | 1 | Een URL waar de data kan gevonden worden. | [ Zie DCAT] Deze url kan zowel verwijzen naar een beschrijvende pagina over hoe toegang tot de data kan verkregen worden als naar een directe link waarmee het downloaden van de distributie gestart kan worden. In het tweede geval wordt ook de eigenschap downloadURL bijkomend ingevuld. | |
verdeler
|
Agent | 0..1 | de agent die instaat voor de verdeling | [Zie GeoDCAT-AP] | |
wordt aangeboden door
|
Dataservice | 0..n | Een dataservice die deze distributie aanbiedt. | [Zie DCAT] |
Herkomst Verklaring
- Beschrijving
- Informatie over ontstaansgeschiedenis van een resource
- Gebruik
- De ontstaansgeschiedenis kan één enkele stap of een sequentie van stappen omvatten. De opdeling in een aaneengeschakeling van stappen werd buiten scope gehouden. Daarom is elke instantie van deze klasse een web toegankelijke pagina die de ontstaansgeschiedenis beschrijft.
- Eigenschappen
- Voor deze entiteit zijn geen eigenschappen gedefinieerd.
Juridische bepaling
- Beschrijving
- Een uitspraak of uitdrukking i.v.m. een recht dat verleend wordt bij het gebruiken van een resource.
- Gebruik
- In de context van dit applicatieprofiel moet deze klasse gezien worden als een hulpinstrument. Implementaties kunnen (moeten) het gebruik van deze klasse zelf invullen. Het kan de vorm nemen van een codelijst, maar ook van een entiteit met bijkomende eigenschappen.
- Eigenschappen
- Voor deze entiteit zijn geen eigenschappen gedefinieerd.
Licentie Document
- Beschrijving
- Een wettelijk document dat de voorwaarden waaronder men een resource mag gebruiken.
- Gebruik
- Het Decreet Hergebruik definieert een aantal licenties. PURIs voor de verschillende mogelijkheden zijn te vinden hier: https://data.vlaanderen.be/doc/licentie/
- Eigenschappen
- Voor deze entiteit zijn geen eigenschappen gedefinieerd.
Plaats
- Beschrijving
- Een ruimtelijk gebied dat geïdentificeerd wordt door zijn benaming of geografische beschrijving.
- Eigenschappen
- Voor deze entiteit zijn de volgende eigenschappen gedefinieerd: bounding box, centroïde, geometrie, plaatsnaam.
Eigenschap | Verwacht Type | Kardinaliteit | Beschrijving | Gebruik | Codelijst |
---|---|---|---|---|---|
bounding box
|
Literal | 0..n | de afgrenzing van een plaats als een geografische rechthoek | [Zie DCAT] | |
centroïde
|
Literal | 0..n | het geografische middelpunt van een plaats | [Zie DCAT] | |
geometrie
|
Literal | 0..n | de geografische beschrijving van een plaats | [Zie DCAT] | |
plaatsnaam
|
TaalString | 0..n | een eenduidige, beknopte beschrijving die de plaats benoemt. | Omwille van de meertaligheid kunnen er meerdere waarden zijn. De gewenste interpretatie van de cardinaliteit is: per taal slechts 1 waarde. |
Relatie Qualificatie
- Beschrijving
- Gebruik
- [Zie DCAT en DCAT]
- Eigenschappen
- Voor deze entiteit zijn de volgende eigenschappen gedefinieerd: Catalogus Resource (source), Catalogus Resource (target), rol.
Eigenschap | Verwacht Type | Kardinaliteit | Beschrijving | Gebruik | Codelijst |
---|---|---|---|---|---|
Catalogus Resource (source)
|
Catalogus Resource | 1 | Referentie naar verbonden klasse. | ||
Catalogus Resource (target)
|
Catalogus Resource | 1 | Referentie naar verbonden klasse. | ||
rol
|
Code | 1 | De functie hoe de entiteiten zich tot elkaar verhouden. | [Zie DCAT en DCAT] |
Standaard
- Beschrijving
- Een specificatie of document dat een referentie vormt waartegen men een entiteit, of het gebruik ervan kan aftoetsen.
- Gebruik
- In de context van dit applicatieprofiel moet deze klasse gezien worden als een hulpinstrument. Implementaties kunnen (moeten) het gebruik van deze klasse zelf invullen. Het kan de vorm nemen van een codelijst, maar ook van een entiteit met bijkomende eigenschappen.
- Eigenschappen
- Voor deze entiteit zijn de volgende eigenschappen gedefinieerd: beschrijving, publicatiedatum, specificatie URL, titel, type, versie, voorkeurslabel.
Eigenschap | Verwacht Type | Kardinaliteit | Beschrijving | Gebruik | Codelijst |
---|---|---|---|---|---|
beschrijving
|
TaalString | 0..n | Een bondige tekstuele omschrijving van de standaard | Omwille van de meertaligheid kunnen er meerdere waarden zijn. De gewenste interpretatie van de cardinaliteit is: per taal slechts 1 waarde. | |
publicatiedatum
|
DateTime | 0..1 | De datum waarop de standaard werd gepubliceerd | ||
specificatie URL
|
URi | 0..1 | Een URL waarop men de specificatie kan vinden | ||
titel
|
TaalString | 0..n | naam van de standaard | Omwille van de meertaligheid kunnen er meerdere waarden zijn. De gewenste interpretatie van de cardinaliteit is: per taal slechts 1 waarde. | |
type
|
Code | 0..n | Een categorisatie van de standaard | ||
versie
|
String | 0..1 | De versie van de standaard | ||
voorkeurslabel
|
String | 0..1 | Een afkorting, of notatie waaronder de standaard bekend is. | Bijvoorbeeld voor ISO standaarden kan dit het nummer zijn. |
Voorbeeldweergave
- Beschrijving
- Een afbeelding ter illustratie van de geassocieerde data.
- Eigenschappen
- Voor deze entiteit zijn de volgende eigenschappen gedefinieerd: beschrijving, downloadURL, mediatype, titel.
Eigenschap | Verwacht Type | Kardinaliteit | Beschrijving | Gebruik | Codelijst |
---|---|---|---|---|---|
beschrijving
|
TaalString | 0..n | Een bondige tekstuele omschrijving van de afbeelding | Ter ondersteuning van WCAG. Omwille van de meertaligheid kunnen er meerdere waarden zijn. De gewenste interpretatie van de cardinaliteit is: per taal slechts 1 waarde. | |
downloadURL
|
URi | 1 | De URL waar de afbeelding gedownload kan worden. | ||
mediatype
|
Code | 0..1 | Het voorstellingsvorm van de afbeelding | Ter ondersteuning van een portaal ontwikkelaar. Een waarde uit de IANA media types lijst. | Link |
titel
|
TaalString | 0..n | naam van de afbeelding | Ter ondersteuning van WCAG. Omwille van de meertaligheid kunnen er meerdere waarden zijn. De gewenste interpretatie van de cardinaliteit is: per taal slechts 1 waarde. |
Datatypes
Contactinfo
- Beschrijving
- Een beschrijving van contactinformatie.
- Gebruik
- De DCAT contact informatie is gebaseerd op vCard. In het applicatieprofiel generiek basis volgt men de Europese Core Vocabularies. Deze overlappen elkaar en omdat de metadata voor doelgroepen die het ene of het andere verwachten, zal de mapping beide aanmaken. Om het verband tussen beiden zichtbaar te maken in het UML model, is de generiek-basis Contactinfo als generalisatie van de vCard Contactinfo (DCAT perspectief) opgenomen.
- Subklasse van
- Contactpunt
- Eigenschappen
- Voor dit datatype zijn de volgende eigenschappen gedefinieerd: contactpagina, e-mail.
Eigenschap | Verwacht Type | Kardinaliteit | Beschrijving | Gebruik | Codelijst |
---|---|---|---|---|---|
contactpagina
|
URi | 0..1 | Een webpagina die ofwel toelaat om contact op te nemen (via b.v. een webformulier) of die informatie bevat hoe men contact kan opnemen. | B.v. de webpagina van de servicedesk van de organisatie | |
e-mail
|
URi | 0..1 | Het e-mailadres waarmee een gebruiker contact kan opnemen voor informatie. | Een e-mail adres in de vorm van een mailto URI volgens de standaard https://tools.ietf.org/html/rfc6068 . |
Contactpunt
- Beschrijving
- Eigenschappen
- Voor dit datatype zijn geen eigenschappen gedefinieerd.
Identificator
- Beschrijving
- Eigenschappen
- Voor dit datatype zijn de volgende eigenschappen gedefinieerd: gestructureerde identificator, notatie, toegekend door, toegekend door (String), toegekend op.
Eigenschap | Verwacht Type | Kardinaliteit | Beschrijving | Gebruik | Codelijst |
---|---|---|---|---|---|
gestructureerde identificator
|
GestructureerdeIdentificator | 0..1 | Identificator vh object opgesplitst in zijn onderdelen. | ||
notatie
|
GetypeerdeString | 0..1 | String gebruikt om het object uniek te identificeren. | Type vd string slaat op het identifierscheme (incl de version ervan), de string zelf op de eigenlijke identifier. Zie definitie Identificator. | |
toegekend door
|
Agent | 0..1 | Link naar de agent die de identificator heeft uitgegeven. | ||
toegekend door (String)
|
String | 0..1 | Naam vd agent die de identificator heeft toegekend. | ||
toegekend op
|
DateTime | 0..1 | Tijdstip waarop de identificator werd uitgegeven. |
JSON-LD context
(niet normatief)Een herbruikbare JSON-LD context definitie voor dit applicatieprofiel is terug te vinden op: /doc/applicatieprofiel/metadata-dcat/erkendestandaard/2022-04-21/context/metadata-voor-services-ap.jsonld
SHACL template
(niet normatief)Een herbruikbare SHACL template definitie voor dit applicatieprofiel is terug te vinden op: /doc/applicatieprofiel/metadata-dcat/erkendestandaard/2022-04-21/shacl/metadata-voor-services-ap-SHACL.ttl