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?