XML-schema voor Woo-metadata in een sitemap
Deze pagina beschrijft versie 0.9.4 van de Woo-metadata-standaard, het XML-schema en bijbehorende documentatie. Aan dit document kunnen geen rechten worden ontleend.
Deze versie is bedoeld voor de bestuursorganen die meedoen met het referentietraject voor het aansluiten op de Woo-harvester.
Op basis van de ervaringen uit dat referentietraject kunnen nog wijzigingen in de inhoud van het schema en bijbehorende documentatie plaatsvinden.
Het aanleveren van metadata in het TOOI-formaat is een aanbeveling om de vindbaarheid
te verbeteren. Als er gekozen wordt voor het aanleveren van metadata in het TOOI-formaat,
dan specificeert het XML-Schema (XSD) diwoo-metada.xsd de verplichte en optionele metadata om tot een geldige aanlevering volgens TOOI te
komen.
De namespace van dit schema is https://standaarden.overheid.nl/diwoo/metadata/. De aanbevolen prefix voor deze namespace is diwoo.
Gebruik van de XSD
Het XML-schema kan gebruikt worden om de sitemap in TOOI-formaat te valideren op correct gebruik van de daarin vastgelegde regels. Een dergelijke validatie van de sitemaps tegen de XSD toont aan dat de sitemap-XML correct is gestructureerd en voldoet aan de vereiste gegevensindeling en -regels. Dit voorkomt fouten en inconsistenties.
Het wordt aanbevolen validatiestappen te integreren in het sitemap-creatieproces. De pagina Gebruik van de XSD geeft meer informatie hoe dergelijke validaties kunnen worden uitgevoerd.
Relatie met TOOI
De metadata in deze XSD zijn zoveel mogelijk gemodelleerd volgens het kennismodel TOOI.
Het volledig uitdrukken van het TOOI-model in syntactisch correcte RDF/XML zou echter tot ongewenste complexiteit leiden voor samenstellers van sitemaps en voor ontwikkelaars van systemen die sitemaps genereren. Er is daarom gekozen voor een versimpeling van de syntaxis. Wel is de naamgeving van TOOI zo goed mogelijk gevolgd. De technische documentatie bevat verwijzingen naar de relevante TOOI-definities (meestal in de vorm van zogenaamde "property shapes" volgens SHACL, zie voor gedetailleerde informatie de TOOI-ontologie-documentatie). De transformatie naar RDF/XML conform TOOI is triviaal en wordt hier niet verder beschreven.
Downloads
De diwoo-XSD is gesplitst in twee XML-schema-documenten:
diwoo-metadata.xsdbeschrijft de elementen, complex en simple types om de metadata te structureren;diwoo-metadata-lijsten.xsdbevat de waardelijsten die voor een aantal attributen in de XSD gelden; deze waardelijsten zijn te beschouwen als een XSD-representatie van de TOOI-waardelijsten.
De generieke sitemap.xsd beschrijft de overkoepelende en generieke structuur van sitemaps en is als service
beschikbaar als download.
Er is ook een "OASIS catalog" beschikbaar, daarover meer op pagina Gebruik van de XSD.
Naar deze XSD's kan worden verwezen via URLs.
Voorbeelden
Op pagina Sitemap-voorbeelden zijn enkele sitemap voorbeelden opgenomen met Woo-metadata.
Technische documentatie
De referentiedocumentatie en de onderliggende pagina's beschrijven de technische aspecten van alle onderdelen van de XSD.