Dit document beschrijft een applicatieprofiel, in dit geval DCAT-AP Vlaanderen. 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
Dit applicatieprofiel beschrijft Open Data Catalogi in Vlaanderen. DCAT-AP Vlaanderen (DCAT-AP VL) is een verdere specialisatie van DCAT-AP.
De applicatie waarop dit profiel betrekking heeft is een Open Data Portaal in Vlaanderen. Open Data portalen zijn catalogussen van Open Data datasets. Ze hebben als belangrijkste doelstelling het vindbaar maken van data en hierdoor het hergebruik ervan te stimuleren. Open Data portalen vervullen een centrale rol in de overheidsopdracht om de toegankelijkheid tot overheidsinformatie te realiseren. Met dit applicatieprofiel bevorderen we de uniformiteit van de beschikbare informatie over datasets. Tevens vereenvoudigen we het aggregatie proces van meerdere Open Data Catalogi.
Dit document bevat de verplichte elementen en bijkomende elementen waarover DCAT-AP Vlaanderen een uitspraak doet. Aanbevolen en optionele informatie waarvoor geen bijkomende afspraken in de context van DCAT-AP Vlaanderen zijn, zijn niet opgenomen in dit document. Hiervoor verwijzen we naar de DCAT-AP specificatie zelf.
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 Digitaal 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-AP.
- MOET conform zijn aan de verplichtingen van metadata 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, metadata DCAT of DCAT-AP.
- PAST maximaal de algemene en specifieke gebruiksadviezen toe. Zowel degene hier beschreven als die in metadata DCAT of DCAT-AP.
Algemene gebruikadviezen
- Zorg voor stabiele identificatoren voor datasets, en waar mogelijk ook voor alle andere vermelde entiteiten.
- Voor temporele informatie wordt verwacht dat de tijdszone wordt meegegeven.
- Gebruik enkel absolute URLs. Dan is blijft onder alle verwerkingsoperaties van de catalogus de URL identiek en is er geen kwaliteitsverlies voor de gebruiker.
- 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.
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. Het is een welomschreven collectie van data vastgelegd door de uitgever. Dit uit zich in een downloadURL (of toegangsURL) die toelaat om de data te bekomen zonder bijkomende data selectie configuratie door de gebruiker. 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. De afnemer heeft voor een distributie geen invloed op de bekomen data. Dat is vastgelegd door de uitgever van de 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 meedere gebonden zijn aan meerdere datasets. Een dataservice biedt dikwijls een slimme toegang tot de data: de gebruiker kan via een query interface of parametrisatie de data opvragen naar zijn wensen. De afnemer heeft hier dus wel invloed op de bekomen data.
Enkele voorbeelden van distributies zijn:- Een RDF-dump
- Een CSV-downloadbaar bestand
- Een Zip-bestand met de Excel-bestanden per gemeente
- Een jpeg die een heatmap weergeeft
- Een REST-API die de gegevens beschikbaar stelt
- Een SPARQL-endpoint
- Een WFS-service
- Een service die op basis van door de gebruiker gecontroleerde query-parameters een downloadbaar bestand beschikbaar stelt
Er zijn ook grensgevallen zoals Linked Data subjectpagina's. Dit is data gepubliceerd in een menselijk leesbare vorm. Men kan argumenteren dat dit een dataservice is omdat de gebuiker op een vrije wijze kan navigeren doorheen de data. Men kan het ook beschouwen als een collectie van html pagina's, die één voor één ophaalbaar is. Subjectpagina's komen dikwijls voor in de context van dereferenceable URIs. Daarin wordt via content negotatie de data aangeboden voor zowel menselijke als machinale verwerking. Voor de RDF representaties wordt vaak de gehele collectie aangeboden als één downloadbaar bestand, voor html pagina's is dit zelden het geval. Bij voorkeur wordt een consensus gezocht om zulke grensgevallen uniform aan te pakken. Wanneer dit niet beschikbaar is, dan laten is het aan de uitgever om een keuze te maken.
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 |
URI |
Entiteiten
Agent
- Beschrijving
- Iemand die of iets dat kan handelen of een effect kan teweeg brengen.
- Gebruik
- Bij voorkeur wordt de persistente identificator uit het organisatieregister gebruikt.
- 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 | 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 | 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 | 1..n | Een aanduiding van op welke basis de catalogusresource beschikbaar is. | De waarde moet minstens https://metadata.vlaanderen.be/id/GDI-Vlaanderen-Trefwoorden/VLOPENDATASERVICE bevatten. | Link |
thema
|
Code | 0..n | De hoofdcategorie waartoe de dataservice behoort. | [Zie DCAT] Gebruik bij voorkeur de Belgische dcat:theme lijst, al dan niet aanvullend t.o.v. andere codelijsten. De Belgische dcat:theme lijst is een uitbreiding van de verplichte Europese codelijst. Het is dus voldoende om enkel de Belgische lijst te gebruiken. | 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 | 1..n | Een aanduiding van op welke basis de catalogusresource beschikbaar is. | De waarde moet https://metadata.vlaanderen.be/id/GDI-Vlaanderen-Trefwoorden/VLOPENDATA zijn. | Link |
thema
|
Code | 0..n | De hoofdcategorie waartoe de dataset behoort. | [Zie DCAT] Gebruik bij voorkeur de Belgische dcat:theme lijst, al dan niet aanvullend t.o.v. andere codelijsten. De Belgische dcat:theme lijst is een uitbreiding van de verplichte Europese codelijst. Het is dus voldoende om enkel de Belgische lijst te gebruiken. | 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] Deze waarden geven een invulling weer voor "Openbaarheid van Bestuur". Voor Open Data zijn er geen beperkingen in die context en is er dus vrije toegang tot de informatie. De waarde is dus steeds PUBLIC . | 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] | |
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 | 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] | |
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 geen eigenschappen gedefinieerd.
URI
- Beschrijving
- Een URI die technisch als een klasse wordt voorgesteld in RDF,maar in het gebruik een literal is.
- Gebruik
- Een zinvolle toepassing van dit datatype is het vermijden van de introductie van placeholder klassen. Een andere toepassing is om compliancy te bekomen met de bereik definitie van eigenschappen.
- Eigenschappen
- Voor dit datatype zijn geen eigenschappen gedefinieerd.
JSON-LD context
(niet normatief)Een herbruikbare JSON-LD context definitie voor dit applicatieprofiel is terug te vinden op: /doc/applicatieprofiel/DCAT-AP-VL/erkendestandaard/2022-04-21/context/DCAT-AP-VL-20.jsonld
SHACL template
(niet normatief)Een herbruikbare SHACL template definitie voor dit applicatieprofiel is terug te vinden op: /doc/applicatieprofiel/DCAT-AP-VL/erkendestandaard/2022-04-21/shacl/DCAT-AP-VL-20-SHACL.ttl