Deelprogramma Digitaal Stelsel Omgevingswet

Transcriptie

1 Deelprogramma Digitaal Stelsel Omgevingswet Testrapport (leveranciers) Aansluittest Gelderland Landelijke voorziening Bekendmaken en Beschikbaarstellen Versie 1.01 Definitief

2 Colofon Titel : Testrapport (leveranciers) aansluittest Gelderland Aansluittest Gelderland Landelijke voorziening Bekendmaken en Beschikbaarstellen (PR30 - Registreren, Bekendmaken en Consolidatie Omgevingsdocumenten) Versie : 1.01 Definitief Datum : Auteurs : Gert-Jan Tamboer, ketentestmanager PR30 Opdrachtgever : Lennert Luik en Arie Duindam, product owners LVBB (PR30) Opdrachtnemer : Gert-Jan Tamboer, ketentestmanager LVBB Contactpersonen : Gert-Jan Tamboer, ketentestmanager LVBB Gertjan.tamboer@kadaster.nl Gebaseerd op : Startoverleg aansluittest Gelderland LVBB d.d. 13 juli

3 Versiehistorie Versie Status Datum Auteur(s) Toelichting 0.1 Concept G.J. Tamboer Initiële versie 0.2 Concept G.J. Tamboer Opmerkingen Lennert en Arie verwerkt 0.8 Concept Arie Duindam Kleine inhoudelijke aanpassingen 0.85 Concept G.J. Tamboer Leerpunten opgenomen en reactie Jolanda en Kees verwerkt 1.0 Definitief G.J. Tamboer Akkoord Product owners 1.01 Definitief Arie Duindam PDF gemaakt met apart bestand testgegevens Goedkeuring Functie Naam Versie Datum Product owner LVBB (Kadaster) Arie Duindam Product owner LVBB (KOOP) Lennert Luik Distributie Functie/Orgaan Versie Opmerkingen Leveranciers van decentrale software t.b.v. Omgevingswet 1.01 Geen Bob Ranzijn, Integratie Testmanager DSO 1.01 Geen Rene Dawson en Kaj Brouwer, Projectmanagers LVBB 1.01 Geen Review Naam Versies Arie Duindam (Kadaster) 0.1, 0.85, 1.0 Lennert Luik (KOOP) 0.1, 0.85 Jolanda van Gils (Provincie Gelderland) 0.8 Kees Kersten (Tercera) 0.8 2

4 Inhoudsopgave Inhoudsopgave 1 LEESWIJZER INLEIDING Doel Scope Beperkingen Betrokkenen Aanpak BERICHTEN EN RESULTATEN Inleiding Validatieverzoek goed situatie Algemeen Inhoud bericht Tercera Adapter en Ontvangstbevestiging Validatierapport Validatieverzoek fout situatie: dubbele id Algemeen Inhoud bericht Tercera Adapter en Ontvangstbevestiging Validatierapport Validatieverzoek fout situatie: meerdere validatiefouten Algemeen Inhoud bericht Tercera Adapter en Ontvangstbevestiging Validatierapport Validatieverzoek fout situatie: eind en begin ongelijk Algemeen Inhoud bericht Tercera Adapter en Ontvangstbevestiging Validatierapport LEERPUNTEN EN TOEKOMSTIGE AANSLUITINGEN

5 4.1 Leerpunten Toekomstige aansluitingen

6 1 Leeswijzer Dit document is een verslag van de aansluittest tussen provincie Gelderland in de rol van bevoegd gezag en de Landelijke Voorziening Bekendmaken en Beschikbaarstellen (LVBB). Tevens zijn de testresultaten beschreven. In hoofdstuk 2 wordt ingegaan op de doelstelling, scope, betrokkenen en aanpak van de aansluittest. In hoofdstuk 3 wordt aangegeven welke berichten zijn verstuurd en zijn schermafdrukken opgenomen van verschillende resultaten. In hoofdstuk 4 worden de evaluatieresultaten beschreven. Tevens worden de werkzaamheden op hoofdlijnen beschreven voor toekomstige aansluitingen. 5

7 2 Inleiding Binnen het programma Digitaal Stelsel Omgevingswet (DSO) wordt er gewerkt met Program Increments (PI) van 12 weken. In PI-3 en PI-4 (juli t/m december 2017) lag de focus voor LVBB op Epic 07: Bekendmaken en beschikbaar stellen van omgevingsdocumenten. Epic 07 kent onder meer de volgende features: Ontvangen van een verzoek om een initieel omgevingsdocument te valideren via ebms koppelvlak; Valideren van een initieel omgevingsdocument; Validatie van het bericht en aanwezigheid vereiste bestanden Schemavalidatie op de structuur van het omgevingsdocument Controleren begrippen op bestaan in Stelselcatalogus a.d.h.v. uri Validatie op geometrie Verzenden van een validatierapport via ebms. In PI-3 en PI-4 zijn deze features getest door middel van een aansluittest tussen provincie Gelderland en LVBB. Provincie Gelderland is daarbij technisch ondersteund door haar leverancier Tercera. Op 13 juni 2017 is op de ICT marktdag aangegeven dat deze aansluittest plaats zou gaan vinden. Daarbij is toen tevens toegezegd dat de resultaten gedeeld zullen worden met alle geïnteresseerde leveranciers, zodat alle partijen over dezelfde informatie beschikken. Deze rapportage, plus een hierop aansluitend bestand met technische berichten, is hiervoor bedoeld. 2.1 Doel De doelstellingen van de aansluittest Gelderland LVBB zijn: 1. Een eerste bevoegd gezag aansluiten op de validatieservice van de LVBB via Digikoppeling ebms op een productie-like omgeving. 2. Input leveren voor tijdelijk beheer, om volgende aansluitingen te realiseren. 3. Lessons learned delen (onder andere infrastructuur, Digikoppeling ebms, certificaten, samenwerking). 6

8 2.2 Scope 1. Hoofdlijnen 2. Gedetailleerd 3. Berichten zijn verstuurd vanaf een cliënt applicatie binnen de Tercera infrastructuur via een ingerichte Digikoppeling adapter op een Tercera productie-like omgeving. 4. Berichten zijn verstuurd op basis van Digikoppeling 2.0 volgens het patroon Grote Berichten

9 2.3 Beperkingen Er is gewerkt met een omgevingsverordening op basis van STOP v0.75. De inhoudelijke codering / modellering van de omgevingsverordening is dus niet definitief. Vanuit de scope van aansluiten via Digikoppeling is dit slechts een kleine beperking, omdat het berichtenverkeer niet afhangt van de modellering van de omgevingsdocumenten zelf. De standaarden voor het berichtenverkeer worden in de komende periode nog verder vastgelegd en moeten nog worden vastgesteld. Er is dus gewerkt met een specificatie die mogelijk nog niet volledig stabiel is. Anderzijds vormt deze aansluittest wel een belangrijke input voor de verdere specificatie van het LVBB aanleverkoppelvlak. Daarbij is uitwisseling op basis van Digikoppeling ebms voor dit soort berichten een vaststaand gegeven. 2.4 Betrokkenen De volgende partijen zijn betrokken bij de aansluittest: Naam Organisatie Rol Jolanda van Gils Provincie Gelderland Vertegenwoordiger provincie Gelderland Kees Kersten Tercera Leverancier van provincie Gelderland Lennert Luik KOOP Product owner LVBB Arie Duindam Kadaster Product owner LVBB Gert-Jan Tamboer KOOP / Kadaster Ketentestmanager LVBB 2.5 Aanpak De aansluittest is gestructureerd en op een projectmatige wijze uitgevoerd. In juli 2017 is er met betrokkenen een startbijeenkomst georganiseerd. In deze bijeenkomst zijn de doelen overeengekomen en zijn de werkafspraken gemaakt. In de fase voorbereiding zijn de technische omgevingen ingericht en op elkaar afgestemd tussen het LVBB en provincie Gelderland. Ook zijn de berichten samengesteld in overleg met provincie Gelderland. In de fase uitvoering zijn er technische en functionele testen uitgevoerd. De resultaten van de functionele testen zijn beschreven in dit rapport. Gedurende de verschillende fases is er op diverse niveaus intensief gecommuniceerd en periodiek de voortgang besproken. 8

10 3 Berichten en Resultaten 3.1 Inleiding In dit rapport worden de berichten en resultaten met betrekking tot de volgende situaties benoemd: 1. Goed situatie; het omgevingsdocument van Gelderland is valide volgens STOP. 2. Fout situatie; het omgevingsdocument bevat twee structuurelementen met hetzelfde id. Dit is volgens STOP niet valide. 3. Fout situatie; het omgevingsdocument bevat meerdere structuurfouten, die volgens STOP niet valide zijn. 4. Fout situatie; het omgevingsdocument bevat een geometrie die niet gesloten is, d.w.z. het eindpunt komt niet overeen met het beginpunt. Dit is volgens STOP niet valide. Het betreft in alle gevallen validatieverzoeken (dat zijn de XML berichten waarin gecodeerd is aangegeven het verzoek om een omgevingsdocument te valideren) voor verschillende versies van omgevingsverordeningen van Gelderland. Deze zijn gebaseerd op de voorbeeld omgevingsverordening die is opgeleverd door PR04, het project dat verantwoordelijk is voor de STOP standaarden. Alle gegevens zijn gebaseerd op de STOP standaard versie De provincie Gelderland heeft per geval de volgende acties uitgevoerd: Verzenden validatieverzoek Ontvangen validatierapport. De LVBB heeft per testgeval de volgende acties uitgevoerd: Ontvangen validatieverzoek Uitvoeren validaties (schema, begrippen, geo) Samenstellen validatierapport met resultaten Verzenden validatierapport. Per validatieverzoek is het volgende vastgelegd: 1. Algemeen; naam zip en datum van aanmaak 2. Ophaalbericht conform Digikoppeling Grote Berichten 3. Zipfile met de inhoudelijke bestanden die via Grote Berichten asynchroon worden opgehaald: a. Omgevingsverordening in XML b. Opdracht.xml met de technische opdracht dat er gevalideerd moet worden c. Manifest.xml als pakbon van de zipfile 4. Tercera Adapter en Ontvangstbevestiging; schermafdruk van de variabelen van de Tercera Adapter en schermafdruk van de ontvangstbevestiging van verzending van het bericht aan LVBB door Gelderland 5. Validatierapport; de inhoud van het validatierapport met de validatiemeldingen in een rapport dat ontvangen wordt door Gelderland. Validatie rapport: - In XML formaat zoals die door LVBB primair wordt opgeleverd. - Een voorbeeld van een transformatie van het LVBB XML rapport naar een meer menselijk leesbare versie in HTML. (Binnen de plansoftware van de leveranciers zal de informatie uit het validatierapport op een gebruikersvriendelijke manier gepresenteerd dienen te worden.) 9

11 N.B. Bij dit testrapport is een separaat bestand beschikbaar dat alle testgegevens (berichten) bevat. 3.2 Validatieverzoek goed situatie Algemeen Naam zip: pi4-validatie-succes Datum aangemaakt: 12 december Inhoud bericht Opdracht voor het valideren van een omgevingsverordening van Gelderland met idlevering: 6d8314e3-c5e7-438b-bd86-01d87f1230a6 Besluit is valide volgens STOP Tercera Adapter en Ontvangstbevestiging Screenshot van de ebms instellingen: Toelichting: Het grote berichten bericht wordt via de Tercera ebms adapter naar het LVBB endpoint gestuurd ter validatie. De CPA bevat het certificaat en zorgt voor de versleuteling en bevat de afspraken (acties die kunnen en mogen worden uitgevoerd). Gelderland maakt zich kenbaar op basis van OIN en geeft aan wat de opdracht is 10

12 (valideren). Er wordt door de adapter eerst een bericht gestuurd met de downloadlocatie van de payload, daarna download de LVBB adapter de payload. De afhandeling van dit proces verloopt asynchroon. In de Tercera adapter is zichtbaar dat het bericht is verstuurd. 11

13 Aan de hand van de status kan gezien worden dat het bericht verzonden wordt en dat er een verbinding is met het LVBB. Na ontvangst verandert de status in Received. Het bericht is ontvangen en wordt nu door het LVBB gevalideerd. 12

14 Uit LVBB Validatierapport Meer gebruikersvriendelijke opmaak 13

15 3.3 Validatieverzoek fout situatie: dubbele id Algemeen Naam zip: pi4-validatie-dubbeleid Datum aangemaakt: 12 december Inhoud bericht Opdracht voor het valideren van een omgevingsverordening van Gelderland met idlevering: f63d7bdc-2feb-427a-8e bb7580d8 Besluit bevat twee structuurelementen met hetzelfde id. Dit is volgens het STOPschema niet valide. Inhoud bericht zie H Tercera Adapter en Ontvangstbevestiging De schermen en stappen in dit proces zijn genoemd in H Uit LVBB Validatierapport 14

16 Meer gebruikersvriendelijke opmaak 15

17 3.4 Validatieverzoek fout situatie: meerdere validatiefouten Algemeen Naam zip: pi4-validatie-meerderevalidatiefouten Datum aangemaakt: 12 december Inhoud bericht Opdracht voor het valideren van een omgevingsverordening van Gelderland met idlevering: d5a c77-977f1708f37e Besluit bevat meerdere fouten in de structuur. Inhoud bericht zie H Tercera Adapter en Ontvangstbevestiging De schermen en stappen in dit proces zijn genoemd in H Uit LVBB Validatierapport 16

18 Meer gebruikersvriendelijke opmaak 17

19 3.5 Validatieverzoek fout situatie: eind en begin ongelijk Algemeen Naam zip: pi4-validatie-eindbeginongelijk Datum aangemaakt: 12 december Inhoud bericht Opdracht voor het valideren van een omgevingsverordening van Gelderland met idlevering: 9986f435-39e0-46a4-aa4a-2f fc Besluit bevat een contour gecodeerd in GML die niet sluitend is, d.w.z. het eindpunt komt niet overeen met het beginpunt. Inhoud bericht zie H Tercera Adapter en Ontvangstbevestiging De schermen en stappen in dit proces zijn genoemd in H Uit LVBB Validatierapport 18

20 Meer gebruikersvriendelijke opmaak 19

21 4. Leerpunten en toekomstige aansluitingen 4.1 Leerpunten De resultaten van de evaluatie met betrokkenen, die op 16 januari 2018 is uitgevoerd, zijn hieronder weergegeven. Tussen haakjes staat de partij, die verantwoordelijk is voor het oppakken van het leerpunt. 1. Het in huis en beschikbaar hebben van de juiste expertise op het gebied van infra en digikoppeling bij leveranciers/bg, helpt in de voortgang van het aansluitproces (Leveranciers/BG). Het in huis en beschikbaar hebben van de juiste expertise is van belang, omdat er veel technische en infrastructurele aspecten betrokken zijn bij het aansluiten. Denk aan onder andere: Firewalls intern Firewall extern Loadbalancer configuratie Certificaten Tls-terminatie (op webserver of op SSL-offloader) Intrusion detection/protection system Authenticatie en autorisatie (LDAP, juiste configuratie) 2. Zo snel mogelijk beginnen met het voorbereiden en realiseren van de technische aansluiting. Besef dat het aansluitproces voorbereiden en inrichten tijd en doorlooptijd gaat kosten. Je loopt altijd tegen meer problemen aan dan je denkt! Begin uiterlijk een jaar, voordat de wet in werking treedt met het starten van de werkzaamheden voor het aansluitproces (Leveranciers BG). 3. Maken van een implementatieplan voor toekomstige aansluitingen (welke leveranciers willen wanneer aansluiten en welke capaciteit is nodig bij LVBB)(PO LVBB). 4. Maken van een CPA o.b.v. het certificaat van de overheidsinstantie, moet de leverancier voor elke klant (Leveranciers/BG). 4.2 Toekomstige aansluitingen Om toekomstige aansluitingen voor andere bevoegde gezagen te realiseren wordt in PI-5 (januari t/m maart 2018) gewerkt aan de voorbereidingen zoals het schrijven van technische documentatie. Het plan is om in PI-6 (april t/m juni 2018) te kunnen aansluiten met een beperkte groep leveranciers van bevoegd gezagen. Voor elke aansluiting wordt er een apart traject gestart tussen LVBB en de leverancier voor de uit te voeren aansluitwerkzaamheden. 20