Bijlage 2 Regeling informatie-uitwisseling ondergrondse netten: , behorend bij artikel 1, onderdeel e

Regeling informatie-uitwisseling ondergrondse netten

Dit document beschrijft het Berichtenmodel voor Kabels en Leidingen (BMKL). Dit berichtenmodel betreft de op het Informatiemodel Kabels en Leidingen (IMKL) gebaseerde informatie-uitwisseling tussen Grondroerders en Netbeheerders (deze partijen worden in de WION aangeduid als ‘beheerder’), waarbij het Kadaster als intermediair fungeert. Het IMKL vormt daarbij de basis voor de gehele informatie-uitwisseling en beschrijft welke beheerdersinformatie in welke vorm uitgewisseld dient te worden. Het BMKL beschrijft op meer technische wijze de berichten die uitgewisseld dienen te worden tussen m.n. netbeheerders en het Kadaster. De Wet Informatie-uitwisseling Ondergrondse Netten (WION) vormt de wettelijke basis voor zowel IMKL als BMKL. Voor het plannen en uitvoeren van graafwerk of ter oriëntatie van een bepaald gebied hebben aanvragers (in dit document verder grondroerders genoemd) informatie nodig over locatie en aard van in de grond aanwezige netwerken. Deze informatie bevindt zich bij diverse netbeheerders. Het systeem Klic-online wordt opgezet als centraal punt voor ontsluiting van deze informatie. Grondroerders doen bij Klic-online een aanvraag door middel van opgave van een gebied waar men informatie over nodig heeft. Klic-online verzoekt en krijgt van de verschillende netbeheerders deze informatie aangeleverd. Voor de integratie van informatie van verschillende partijen is het noodzakelijk dat er een gemeenschappelijk begrippenkader bestaat. Het IMKL (Informatiemodel Kabels en Leidingen) beschrijft de wijze waarop de gegevens over kabels en leidingen eenduidig kan worden vastgelegd, inclusief visualisatie afspraken voor zover het de presentatie van geo-informatie over kabels en leidingen betreft. Het BMKL, dat in dit document wordt gepresenteerd, beschrijft de inhoud van de berichten (gebaseerd op de gegevens uit het IMKL) en de wijze van uitwisseling tussen netbeheerders en grondroerders via Klic-online. De informatie-uitwisseling tussen Grondroerders en Klic-onli

• 1. Het graafbericht (1a) wordt door Klic-online (Kadaster Business Process Management) verstuurd naar de webservice bij de netbeheerder(s). Er zijn nu twee mogelijkheden:
• a. Wanneer het graafbericht (1a) goed is aangekomen, ontvangt Klic-Online een technische bevestiging ACK(1b).
• b. Er komt geen antwoord binnen een vast te stellen time-out periode. In dat geval wacht Klic-online een nog vast te stellen periode en stuurt het (ongewijzigde) graafbericht opnieuw. Indien nodig wordt dit een aantal keer herhaald. Als dan nog geen antwoord is ontvangen, dan wordt de (technisch) beheerder bij de netbeheerder gewaarschuwd (Via telefoon, SMS of e-mail, waarvan het nummer/adres is geregistreerd in de belangendatabase).Zolang er geen reactie is van de netbeheerder blijft Klic-online pogingen doen, met telkens een periode daartussen, in elk geval totdat de wettelijke termijn van één werkdag wordt overschreden. Zijn de problemen dermate ernstig, dan kan in onderling overleg tussen de technisch beheerders in dat geval besloten worden de communicatie met de betreffende beheerder tijdelijk stop te zetten.
• 2. Wanneer (evt. na meerdere pogingen) de technische bevestiging gekomen is, gaat Klic-online wachten op de beheerdersinformatie. Deze dient door de netbeheerder binnen één werkdag te worden verstuurd (d.m.v. het aanroepen van de webservice van Klic-Online). Wanneer de werkdag verstreken is zal de (technisch) beheerder bij de netbeheerder worden gewaarschuwd (via telefoon, SMS of e-mail). Klic-online blijft ondertussen in afwachting van de levering van beheerdersinformatie, totdat de geldigheidsduur van de aanvraag is verstreken (20 werkdagen).
• 3. De beheerdersinformatie is door de netbeheerder samengesteld en wordt d.m.v. het aanroepen van de webservice van Klic-online verzonden (2a). Er zijn nu twee mogelijkheden:
• a. Wanneer het bericht met de beheerdersinformatie (2a) goed is aangekomen, ontvangt de netbeheerder een technische bevestiging ACK (2b). Hiermee is de communicatie afgehandeld.
• b. De webservice van Klic-online antwoordt niet binnen een vast te stellen time-out periode. In dat geval wacht de netbeheerder een nog vast te stellen periode en stuurt de (ongewijzigde) beheerdersinformatie opnieuw. Indien nodig wordt dit een aantal keer herhaald. Als dan nog geen antwoord is ontvangen, dan wordt door de netbeheerder de (technisch) beheerder van Klic-online gewaarschuwd (via telefoon, SMS of e-mail, waarvan het nummer/adres gepubliceerd zal worden op www.kadaster.nl/klic. Zolang er geen reactie is van Klic-online, blijft de netbeheerder een nog vast te stellen maximaal aantal pogingen doen, met telkens een periode daartussen. Blijven de problemen voortduren dan kan in onderling overleg tussen de technisch beheerders in dat geval besloten worden de communicatie met de webservice van Klic-online tijdelijk stop te zetten.
• 4. Wanneer het graafbericht van Klic-online goed is aangekomen bij de netbeheerder (er is een technische ACK gegeven), dan zal de netbeheerder starten met de verwerking ervan. Mochten er tijdens die verwerking problemen ontstaan, die te maken hebben met de inhoud van het graafbericht (dit kan alleen optreden bij een echte systeemfout), dan wordt dit via een administratieve procedure kenbaar gemaakt aan Klic-online (bijv. door contact op te nemen met de technisch beheerder van Klic-online).2Deze twee uitzonderingen zijn vanwege de leesbaarheid niet in het sequencediagram opgenomen.
• 5. Wanneer de beheerdersinformatie van de netbeheerder goed is aangekomen bij Klic-online, dan zal Klic-online starten met de verwerking ervan. Mochten er tijdens de verwerking ervan problemen ontstaan, die te maken hebben met de inhoud van de beheerdersinformatie (dit kan alleen optreden als er sprake is van een echte systeemfout), dan wordt dit via een administratieve procedure kenbaar gemaakt aan de netbeheerder (bijv. door contact op te nemen met de technisch beheerder van de netbeheerder).2Deze twee uitzonderingen zijn vanwege de leesbaarheid niet in het sequencediagram opgenomen.
• • De netbeheerder registreert zijn belangen (beheerpolygonen) bij Kadaster (Klic-WAB). Daarbij worden ook e-mail adres en telefoonnummer geregistreerd die bij niet beschikbaar zijn van de webservice voor verwerking van Klic-meldingen, benaderd kunnen worden,
• • De netbeheerder publiceert een webservice (https/soap, op basis van de voorgeschreven wsdl (te publiceren op www.kadaster.nl/klic), die graafberichten kan ontvangen.
• • Op basis van het ontvangen graafbericht (beveiligd met een certificaat op basis waarvan de netbeheerder kan verifiëren dat het echt van Kadaster/Klic-online afkomstig is) gaan de achterliggende (gis) systemen bij de netbeheerders aan het werk, om de gevraagde gegevens bij elkaar te zoeken en de volledige beheerdersinformatie samen te stellen.
• • Wanneer het bovenstaand proces is afgerond, roept de netbeheerder de Klic-online webservice aan waarop de beheerdersinformatie kan worden aangeboden. Het formaat van het bericht wordt door het Kadaster voorgeschreven en zal worden gepubliceerd op www.kadaster.nl/klic.Het bericht moet worden beveiligd met een certificaat op basis waarvan Kadaster/Klic-Online kan verifiëren dat het echt van de betreffende netbeheerder afkomstig is. Kadaster zal de manier waarop dit certificaat verkregen wordt (welke leverancier) en hoe het eruit moet zien (evt. extra attributen) voorschrijven op www.kadaster.nl/klic.
• • De webservice van de netbeheerder moet voldoen aan de definitie zoals die door Kadaster is opgesteld. Deze definitie voldoet op zijn beurt weer aan de wereldwijde WS-I Basic Profile 1.1 standaard.
• • Berichten dienen te worden samengesteld m.b.v. de UTF8 karakterset.
• • De uiteindelijke schema’s (wsdl’s en xsd’s) zoals die door Kadaster gepubliceerd worden, kunnen om technische redenen velden bevatten (zoals bijv. een versienummer) die in dit document niet genoemd worden.
• • Correllatie tussen graafbericht (de vraag) en beheerdersinformatie (het antwoord) gebeurt op basis van het Kadaster ordernummer dat in beide berichten is opgenomen.
• • Hier wordt nog eens extra opgemerkt dat de verantwoordelijkheid voor de juistheid van het te versturen bericht ligt bij de zendende partij. De netbeheerder accepteert alleen juiste en gevalideerde Graafberichten en Klic-online accepteert alleen juiste en gevalideerde beheerdersinformatie. Bij onvoorziene afwijkingen/fouten wordt altijd wederzijds contact opgenomen.
• • Beide webservices (zowel die aan de kant van Klic-online als die aan de kant van de netbeheerder) moeten om kunnen gaan met een bericht dat (door welke oorzaak dan ook) meerdere malen wordt verstuurd.
• • De webservices van de netbeheerders zullen af en toe (bijv. vanwege onderhoud) niet beschikbaar zijn. Sommige (kleine netbeheerders) zullen zelfs alleen tijdens werkdagen/kantooruren beschikbaar zijn. Klic-online zal daarom blijven proberen het graafbericht te versturen. Pas wanneer de wettelijke termijn van één werkdag overschreden dreigt te worden, zal de netbeheerder een waarschuwing krijgen. Dit is ook de reden waarom er in dit model geen vast aantal pogingen en intervaltijden genoemd worden.
• • Er zullen vast en zeker wijzigingen in de bestaande interface komen. Om hierin te kunnen voorzien wordt (binnen het BMKL) uitgegaan van de mogelijkheid dat er maximaal 2 versies van de interface tegelijk in productie actief zijn. Bij het in productie gaan van een nieuwe versie wordt een uiterste geldigheidsdatum afgesproken voor de oude versie. Na die tijd moeten alle netbeheerders over zijn naar de nieuwe webservice interface.