202000520 de stelselcatalogus · presentatie finn tiebout moderator jeroen de groot 20-mei-2020...
TRANSCRIPT
Webinar Stelselcatalogus
Presentatie Finn TieboutModerator Jeroen de Groot
20-Mei-2020
Agenda
• Doel Stelselcatalogus
• Onderdelen Stelselcatalogus
• Inhoud Stelselcatalogus
• Vinden en Verbinden
• Architectuur Stelselcatalogus
• Federatief Ontsluiten
• Stelselcatalogus in gebruik
• Demo REST API Stelselcatalogus
• Demo frontend Stelselcatalogus
Doel Stelselcatalogus
• Online naslagwerk om begrippen, waardenlijsten en informatieproducten die van belang zijn voor de Omgevingswet te publiceren.
• Stelselcatalogus is onderdeel van de Landelijke Voorziening Digitaal Stelsel Omgevingswet (DSO LV)
• Overheden en andere organisatie kunnen de gegevens uit de StelselCatalogus gebruiken in hun eigen processen.
Bijvoorbeeld om Waardelijsten te gebruiken.• Middels de Stelselcatalogus willen we bereiken dat er binnen de DSO
door iedereen dezelfde taal wordt gesproken.• Harmonisatie van begrippen.
Doel Stelselcatalogus
Uitgangspunten Catalogus:• Iedereen kan gegevens ophalen uit de catalogus.• Overheidsinstellingen kunnen hun gegevens middels de catalogus
publiceren.• Catalogus ontsluiten data federatief.• Software sluit aan op de Catalogus middels API.• Data is open en voor iedereen benaderbaar middels
http://stelselcatalogus.omgevingswet.overheid.nl
Doel Stelselcatalogus
• Informatie en diensten binnen de de DSO dienen locatieonafhankelijk beschikbaar gemaakt te worden. De Catalogus vervult hierin een rol door metadata (gegevens over gegevens) gestandaardiseerd, centraal en locatieonafhankelijk te publiceren.
• In de Stelselcatalogus worden relaties tussen begrippen en gegevensverzamelingen vastgelegd, er kan gezocht worden op een begrip waarbij de gerelateerde gegevensverzamelingen worden gevonden.
• Relaties tussen wetgeving, regelgeving, begrippen, informatieproducten en services zijn in de Catalogus vastgelegd.
Onderdelen Stelselcatalogus
Website Zelfbedieningsportaal (ZBP)
Opvragen API Muteren API
CatalogusManagerStelselCatalogus
Onderdelen Stelselcatalogus: doelgroep
WebsiteEenieder die wil weten welke begrippen gebruikt worden, welke waardenlijsten er zijn en welke informatieproducten beschikbaar zijn via een grafische userinterface.
ZelfbedieningsportaalKoepels die hun begrippenset, waardelijsten of informatieproduct data via een grafische userinterface willen beheren.
Opvragen APISofwareleveranciers die begrippen, waardelijsten en informatie‐producten vanuit de DSO voor hun eigen software willen benutten
Muteren APIKoepels die vanuit hun eigen software een catalogus willen beheren welke middels de stelselcatalogus wordt gepubliceerd
Inhoud StelselCatalogus• Begrippen
Begrippen worden samen met hun definitie in de StelselCatalogusgepubliceerd.
• WaardelijstenWaardelijsten zijn lijsten met waarden (begrippen) welke eventueel gevisioneerd middels de StelselCatalogus gepubliceerd zijn.
• InformatieproductenVan informatieproducten publiceren we de metadata in de StelselCatalogus.
Begrippen• Begrippen en hun bijbehorende definities zijn afkomstig uit Juridische
bronnen zoals de Omgevingswet en de Omgevingswetbesluiten.
• Maar ook uit Standaarden, zoals AquoLex, VNGLex en de STOP/TPOD standaard.
• De onderlinge relaties tussen de begrippen worden vastgelegd in de Catalogus, bijvoorbeeld relatie tussen begrip uit de (lokale) regelgeving en wetgeving.
• Harmonisatie van begrippen voorkomt onnodig opvoeren van nieuwe begrippen en draagt bij aan duidelijkheid van regelgeving.
• Begrippen krijgen context in de catalogus, eenzelfde term kan meerdere betekenissen hebben. Denk aan Utrecht, wat zowel een Provincie als een Hoofdstad kan zijn. Of een Steiger, boot of bouw steiger.
Waardelijsten• Waardelijsten zijn lijsten met waarden welke in de Stelselcatalogus
gepubliceerd zijn.
Waarden in waardelijsten zijn begrippen uit de Catalogus. Hiervan zijn dus ook definities vastgelegd en ook weer de onderlinge relaties.
• Waardelijsten kunnen geversioneerd zijn.
History wordt in dat geval bijgehouden.
• Waardelijsten uit de STOP/TPOD standaard.
STOP/TPOD waardelijsten zijn geversioneerd.
• Waardelijst met werkzaamheden (RTR)
Waardelijst met werkzaamheden is niet geversioneerd.
informatieproductenInformatieproducten zijn verrijkte gegevens over bijvoorbeeld geluid, bodem en water. De bron van informatieproducten wordt vastgelegd in de Stelselcatalogus Omgevingswet. De gegevens komen uit lokale systemen bij overheden.
De StelselCatalogus legt relaties vast tussen begrippen en informatieproducten en maakt zo ondermeer informatieproducten beter vindbaar.
Ook API’s zullen op deze manier gepubliceerd gaan worden in de StelselCatalogus.
StelselCatalogus en URI’s• Elke resource in de Stelselcatalogus krijgt zijn eigen URI.
Uniform Resource Identifier
Dit is een unieke naam op het internet voor een ‘ding’
Bijvoorbeeld:
Het begrip Natura2000-Activiteit heeft de URI http://wetgeving.omgevingswet.overheid.nl/wetgeving/id/concept/Natura2000-
Activiteit
De waardelijst Activiteitengroep heeft de URI
http://standaarden.omgevingswet.overheid.nl/id/waardelijst/Activiteitengroep
Inhoud StelselCatalogus
Wat staat er nu al in:• Begrippen
• VNG Begrippenkader• Begrippenkader beheerd door VNG voor gemeenten.
• Wet en Regelgeving (AMvB’s)• Omgevingsbesluit• Besluit Activiteit leefomgeving (BAL)• Besluit Bouwwerken Leefomgeving (BBL)• Besluit Kwaliteit leefomgeving (BKL)
• AQUO• Open Standaard voor de watersector (Waterbeheerders)
• RTR Register Toepasbare Regels• Juridische regels vertaald in Toepasbare Regels.
• STOP/TPOD• Standaard voor publicatie van Omgevings Documenten
Stelsel Catalogus
Door de metadata van diverse resources centraal te publiceren worden onderlinge relaties zichtbaar, de Stelselcatalogus is als het ware de spin in het web om verbindingen te leggen.
Wetgeving
Werkzaamheden
Activiteiten
Regelgeving
Relatie tussen Werkzaamheden en Activiteiten
Een begrip wordt gebruikt in een wetgeving.
Een begrip komt uit een bepaalde standaard.
Begrip
Informatieproduct
Standaard
StelselCatalogus: vinden en Verbinden
Omgevingsplan
Stelselcatalogus
Werkzaamheden
toepasbare‐regels Werkzaamheid: Tankstation Starten Of Veranderen
Regelgeving Activiteit: Exploiteren Van Een Verkooppunt Voor Motor brandstoffen Niet Zijn de Lpg
wetgeving Activiteit Met Gevolgen Voor De Fysieke Leefomgeving
standaarden Milieu belastende Activiteit
Leidt tot
Is een
Valt onder
Lokale Plansoftware
StelselCatalogus: vinden en Verbinden
Stelsel Stelsel Catalogus
ZBP
Stelselcatalogus Architectuur
ManagerCatalogus Manager
2Informatieproducten
BegrippenWaardelijsten
InformatieproductenInformatieproducten
BegrippenWaardelijsten
Informatieproducten Informatieproducten
BegrippenWaardelijsten
Informatieproducten
1 3
We bieden drie mogelijkheden om Resources middels de Stelselcatalogus te publiceren.1. Resources synchroniseren naar de Stelselcatalogus, vanuit een andere Catalogus.2. Gebruik maken van de Catalogus Manager middels ons Zelf BedieningsPortaal. 3. Gebruik maken van de Catalogus Manager middels de REST API.
Stelselcatalogus.omgevingswet.overheid.nl
Diverse Catalogi
VNG Catalogus
VNG Begrippenkad
er
StelselCatalogus
Federatief ontsluiten
En meer …
…..
Register ToepasbareRegels
RTR Werkzaamheden
GeonovumCatalogus
STOP/TPOD
API
Stelselcatalogus gebruiken
1. http://stelselcatalogus.omgevingswet.overheid.nl
Browsers
2. REST API
API KEY noodzakelijk. Deze kan aangevraagd worden via de website aan de slag met de omgevingswet.
Enkel Lees Functionaliteit.
Middels de REST API kunnen andere applicaties aan sluiten op de Catalogus. Bijvoorbeeld de Plansoftware bij de bevoegde gezagen, maar ook de Viewer gaat aansluiten op de Catalogus om waardelijsten op te halen.
Stelselcatalogus REST API
Middels de REST API kunnen de volgende acties uitgevoerd worden.
• Opvragen Concept
• Opvragen Collectie
• Opvragen Dataset
• Opvragen Metadata Resource
• Opvragen Bron
• Opvragen Waardelijst
• Opvragen Waardes in een Waardelijst
• Opvragen Informatieproducten
Demo REST API
Get request om alle concepten op te halen
API‐Key opgeven
Ophalen alle concepten.
Demo REST APIRespons met alle concepten, we zien hier bijvoorbeeld het concept 24‐Uurszorg inclusief bijbehorende informatie.
Demo REST API
Get request om enkel concept 24‐Uurszorg op te halen
Ophalen één concepten.
Demo REST APIRespons met enkel het concept 24‐Uurszorg, deze output kan gebruikt worden in de programmatuur van derden, bijvoorbeeld de plansoftware bij Bevoegde Gezagen.
Demo REST APIOphalen waarden in Waardelijst Activiteitengroep
Endpoint/waardesInWaardelijst
Filter om enkel de waardelijstActiviteitengroep op te halen. Identificatie van de Waardelijst gebeurt o.b.v. de URI in dit voorbeeld.
URI: http://standaarden.omgevingswet.overheid.nl/id/waardelijst/Activiteitengroep
Demo REST API Waarde Aansluitactiviteit uit Waardelijst Activiteitengroep
Waarde Alarminstallatieactiviteit uit Waardelijst Activiteitengroep
Overzicht van Waarden in Waardelijst Activiteitengroep
Demo StelselCatalogus
http://stelselcatalogus.omgevingswet.overheid.nl
Demo StelselCatalogus
Zoeken begrip 24-uurszorg
Demo StelselCatalogus
Details begrip 24-uurszorg
Demo StelselCatalogus
Overzicht Bronnen
Bronnen welke momenteel in de Catalogus gepubliceerd zijn.
Demo StelselCatalogus
Details Bronnen
Bij het doorklikken op een bron, krijg je een overzicht van alle begrippen uit die bron. In dit voorbeeld is de bron de Omgevingswet.
Demo StelselCatalogus
Overzicht Informatieproducten
Informatieproducten welke momenteel in de Catalogus zijn opgenomen. Bij het doorklikken wordt de meta data van het Informatieproduct getoond.
Demo StelselCatalogus
Overzicht Waardelijsten
Versionering
De waardelijst zonder postfix is altijd de meest actuele
Demo StelselCatalogus
Metadata WaardelijstenEigenaar van de Waardelijst
Demo StelselCatalogus
Inhoud Waardelijst Waarden in de waardelijst, hier kan op doorgeklikt worden om de begrippen te bekijken.
Links• StelselCatalogus:
https://stelselcatalogus.omgevingswet.overheid.nl/
• OAS Specs:
https://redocly.github.io/redoc/?url=https://pre.omgevingswet.overheid.nl/knooppunt/apistore/api-docs/Kadaster/Catalogus-Opvragen/v2
• API Key aanvragen
https://aandeslagmetdeomgevingswet.nl/ontwikkelaarsportaal/formulieren/api-key-aanvragen-0/
Vragen?