ADMS Toepassingsprofiel voor productbeschrijvingen
ADMS is de W3C standaard voor het beschrijven van ‘semantic assets’ die worden gebruikt binnen de eOverheid. In een stelselcatalogus gaat het concreet om herbruikbare metadata van
- taxonomieën of woordenboeken die het begrippenkader bevatten met de ‘onderwerpen van gesprek’ van een dataset (algemeen).
- referentiedata en waardelijsten van bij een dataset (algemeen) die kunnen worden hergebruikt in andere domeinen.
- informatiemodellen van een dataset (versie) of van een dataset (product).
Iedere metadatabeschrijving, in ADMS termen een asset kan een eigen webpagina hebben.
Een metadatabeschrijving kan op verschillende manieren te beschikking worden gesteld, bijvoorbeeld als pdf download, als ttl beschrijving of als html beschrijving. Voor waardelijsten is ook csv en xml/gc (genericode) gangbaar. Voor informatiemodellen is XMI als uitwisselingsstandaard voor UML representaties gangbaar. Iedere vorm waarin een metadatabeschrijving (adms:Asset) beschikbaar wordt gesteld, kan expliciet worden beschreven als distirbutie (adms:Distribution).
Van metadatabeschrijvingen en distributies kan provenance worden bijgehouden.
- Voor begrippenkaders en voor referentiedata of waardelijsten geldt dat die meestal in een ‘continious delivery’ proces worden beheerd. Dat wil zeggen dat de metadatabeschrijving 1 keer wordt gepubliceerd en vervolgens de begrippen en referentiedata per begrip respectievelijk referentiegegeven worden beheerd. De provenance wordt dan op het niveau van begrip respectievelijk referentiegegeven beheerd.
- Voor waardelijsten kan daarnaast worden gekozen om deze periodiek te releasen. Iedere release wordt dan een nieuwe versie van de metadatabeschrijving.
- Informatiemodellen worden altijd in zijn geheel in 1 keer gepubliceerd, c.q. gereleased. Iedere release krijgt een nieuwe versie van de metadatabeschrijving.
Asset
!form data#Asset!Klasse |
Asset |
Uitleg |
Een asset is een set van herbruikbare metadata en referentiegegevens die worden gebruikt voor de ontwikkeling van e-overheidssystemen. |
Voorbeeld |
De waardelijst met Kadastrale gemeenten. |
Eigenschappen en relaties |
heeft distributie, naam, heeft webpagina, onderdeel van, herkomst |
Eigenschappen
!form data#Asset_label!Eigenschap |
naam |
Gebruikte term |
rdfs:label |
Datatype |
Tekst |
Uitleg |
Een asset heeft een naam. |
Voorbeeld |
Landenlijst |
Min card. |
1 |
Max card. |
1 |
Relaties
!form data#Asset_distribution!Eigenschap |
heeft distributie |
Gebruikte term |
dcat:distribution |
Relatie met |
Distributie |
Uitleg |
De wijze waarop een asset wordt gepubliceerd kan worden aangegeven. |
Voorbeeld |
De lijst met Kadastrale gemeenten kan worden gepubliceerd in genericode. |
!form data#Asset_landingPage!Eigenschap |
heeft webpagina |
Gebruikte term |
dcat:landingPage |
Relatie met |
Webpagina |
Uitleg |
De webpagina waarop een asset vindbaar is kan worden gespecificeerd. |
Voorbeeld |
kadaster.nl/waardelijsten. |
Max card. |
1 |
!form data#Asset_provenance!Eigenschap |
herkomst |
Gebruikte term |
foaf:isPrimaryTopicOf |
Verwijst naar |
prov:Entity |
Uitleg |
Van een asset kan de herkomst worden beschreven. |
Voorbeeld |
Op basis van de nieuwe wet op de BAG is een een nieuw informatiemodel opgesteld |
Min card. |
1 |
Asset distributie
Relaties
!form data#AssetDistribution_accessURL!Eigenschap |
toegang url |
Gebruikte term |
dcat:accessURL |
Uitleg |
Een distributie kan vindbaar zijn via een toegang url. |
Voorbeeld |
kadaster.nl/waardelijsten/gc |
!form data#AssetDistribution_downloadURL!Eigenschap |
download url |
Gebruikte term |
dcat:downloadURL |
Relatie met |
Download formaat |
Uitleg |
Een download kan vindbaar zijn via een download url. |
Voorbeeld |
kadaster.nl/waardelijsten/downloads |
!form data#AssetDistribution_provenance!Eigenschap |
herkomst |
Gebruikte term |
foaf:isPrimaryTopicOf |
Verwijst naar |
prov:Entity |
Uitleg |
Van een distributie kan de herkomst worden beschreven. |
Voorbeeld |
De metadata van de reSpec beschrijving van het nieuwe informatiemodel voor de BAG |
Min card. |
1 |
Webpagina
!form data#LandingPage!Klasse |
Webpagina |
Uitleg |
De webpagina van welke een asset vindbaar is. |
Voorbeeld |
kadaster.nl/waardelijsten. |
!form data#DownloadFormat!Klasse |
Download formaat |
Uitleg |
De download kan een bestand zijn of een webpagina met informatie. |
Voorbeeld |
het csv bestand met de waardelijst Kadastrale gemeenten. |
Eigenschappen en relaties |
is formaat van |
Relaties
Uri strategie
Assets en asset distributies krijgen een uri volgens het patroon:
- http://{domain}/id/{asset-type}/{UpperCamelCase(rdfs:label)} voor assets
- http://{domain}/id/{asset-type}/{UpperCamelCase(rdfs:label)}.{extension} voor asset distributies
Daarbij geldt dat {asset-type}
de volgende waarden kan hebben, afhankelijk van het type asset:
codelist
voor waardelijsten;
scheme
voor begrippenkaders;
model
voor informatiemodellen.
En voor {extension}
geldt dat hiervoor de standaard bestandsformaat extensies worden gebruikt, zoals:
ttl
voor turtle bestanden;
pdf
voor pdf bestanden;
xml
voor xml bestanden.