Kruimelpad- Home
- Overheidsinformatie
- Zoeken
- Verwijzing
Wet- en regelgeving
Instellingen (nu: volledige regeling), opent een nieuw vensterRegeling informatie-uitwisseling ondergrondse netten
Geldend op 09-02-2012
De regeling die nu getoond wordt is dermate groot van omvang dat automatisch is overgeschakeld naar artikelsgewijze weergave. Klik op de knop hiernaast om over te schakelen naar complete weergave van de regeling.
Let op: voor navigatie door de tekst in artikelsgewijze weergave maakt u gebruik van in de balk hierboven.
Bijlage 2. , behorend bij artikel 1, onderdeel e
Concernstaf IT-Services
BKML
Berichtenmodel Kabels en Leidingen
1. Inleiding
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.
1.1. Context
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-online is functioneel van aard. De grondroerder levert zijn aanvraag-informatie aan via vastgestelde schermen van Klic-online en ontvangt de gegevens die de netbeheerders leveren door deze te downloaden van de site van het Kadaster.
De uitwisseling tussen Klic-online en de netbeheerders verloopt volgens een strak gedefinieerd protocol. Omdat daarvoor een eenduidige ICT-afstemming vereist is, zal de rest van dit document zich verder volledig richten op deze kant van de berichtenuitwisseling.
1.2. Referenties
Nummer
Titel
1
IMKL Informatiemodel Kabels en Leidingen versie 1.1
2
Sofware Architecture Document Klic-online versie 0.9
3
Visiedocument Klic-online Vision v1.2.doc: Graafmeldingen en oriëntatieverzoeken
4
Presentatie en verslag BMKL workshop d.d. 23-04-2007
2. Berichtdefinities
2.1. Afbakening
Onderstaand diagram (Figuur 1: Afbakening BMKL) toont een eenvoudige weergave van de berichtenuitwisseling zoals die plaats moet gaan vinden in het kader van de WION. In dit document wordt al het berichtenverkeer tussen Klic-online en de netbeheerders beschreven. Het gaat dus om het Graafbericht (van Klic-online naar Netbeheerder), en de gevraagde Beheerdersinformatie (van Netbeheerder naar Klic-online).
Toelichting:
Klic-online vraagt de beheerdersinformatie over een bepaald gebied aan m.b.v. het Graafbericht (dit gebeurt op basis een graafmelding of oriëntatieverzoek van een grondroerder). Dit graafbericht wordt verstuurd d.m.v. het aanroepen van een webservice bij de netbeheerder. Deze webservice geeft alleen een technische bevestiging (ACK) dat het graafbericht is ontvangen. De netbeheerder gaat dan de beheerdersinformatie samenstellen (meestal kaartmateriaal plus bijlagen). Op het moment dat deze gereed is, stuurt de netbeheerder de beheerdersinformatie naar Klic-online, middels het aanroepen van een webservice bij het Kadaster, die hierop weer reageert met een technische bevestiging (ACK) dat de gegevens zijn ontvangen.
In de diverse berichten die worden gedefinieerd in de volgende paragrafen worden velden aangeduid als Verplicht (V), Conditioneel (C) of Optioneel (O). Ook Conditioneel betreft een verplichting, deze geldt echter slechts als de bijbehorende conditie aan de orde is; is dit niet het geval dan is deze informatie Optioneel. Verplichtingen (V en C) vinden in principe hun wettelijke basis in de WION. Het – naast het ordernummer – in de berichten meenemen van het Klic-nummer en het beheerdervolgnummer, zijn verplichtingen voor het Kadaster ten behoeve van een ordentelijke administratieve afhandeling bij netbeheerders. Daarnaast is er een aantal verplichtingen dat technisch noodzakelijk wordt zodra van een geboden optie gebruik wordt gemaakt (bijvoorbeeld het meesturen van Huisaansluitschetsen); wanneer dit de basis is voor een verplichting dan zal dit in de bijbehorende toelichting zijn aangegeven met een (T).
2.2. Graafbericht en ontvangstbevestiging netbeheerder
Het graafbericht is het bericht dat Klic-online verstuurt aan alle netbeheerders waarvan het belang (de beheerpolygoon) overlapt met de opgegeven graafpolygoon. Netbeheerders kunnen de beheerdersinformatie van hun kabels en leidingen digitaal door middel van een webservice op aanvraag leveren.1
Het graafbericht wordt in XML (eXtensible Markup Language ) formaat verstuurd aan de webservices van de betrokken netbeheerders. Hiervoor wordt het bericht verpakt in een SOAP (Simple Object Access Protocol) envelop en daarna verzonden middels een aanroep van de vooraf bepaalde webservices. De webservice van de netbeheerder ontvangt het graafbericht en antwoordt binnen maximaal 30 seconden door middel van een technische bevestiging (ACK). De WSDL (webservice definitie) en de bijbehorende XML schemas (XSD) van het graafbericht en de ontvangstbevestiging zijn te vinden op www.kadaster.nl/klic. Wijzigingen op deze definities zullen worden doorgevoerd via de technische commissie met een vastgesteld protocol.
Voor de duidelijkheid: elke betrokken netbeheerder ontvangt één graafbericht, ongeacht het aantal thema’s waarvan hij een belang heeft in de graafpolygoon, tenzij de netbeheerder expliciet anders heeft geregistreerd. Waar in de WION wordt gesproken over de functie van een net, wordt ditzelfde binnen het BMKL aangeduid als het thema. De diverse thema’s zijn beschreven in het IMKL (paragraaf 6.4.21).
2.2.1. Inhoud van het graafbericht
In het graafbericht wordt de volgende informatie meegegeven:
Tabel 1: Inhoud van het graafbericht Veld
Type
Verplicht?
Aantal
Toelichting
DatumTijdAanvraag
DateTime
V
1
Datum en tijd waarop de melding bij Klic-online is ontvangen
DatumTijdVerzending
DateTime
V
1
Datum en tijd waarop de melding door Klic-online is verzonden aan de netbeheerder
Meldingsoort
String
V
1
(Graaf, Oriëntatie, Calamiteit)
AanvangWerkzaamheden
Date
C*
0..1
Datum waarop met de graafwerkzaamheden wordt aangevangen.
(* Alleen verplicht in geval van een graafmelding)
EindWerkzaamheden
Date
C*
0..1
Geschatte datum waarop de graafwerkzaamheden worden beëindigd.
(* Alleen verplicht in geval van een graafmelding)
Relatienummer netbeheerder
String(10)
V
1
Klantnummer waaronder de netbeheerder bij het Kadaster bekend is
Ordernummer
String(10)
V
1
Het (SAP) Ordernummer waaronder de aanvraag binnen Klic-online bekend is
KlicNummer
String(9)
V
1
Het KlicNetnummer waaronder de aanvraag binnen Klic-online bekend is (oude formaat,
YYX999999, bijv. 08G0123456)
Beheerdervolgnummer
Integer
V
1
Oplopend nummer per netbeheerder per jaar, zodat deze kan controleren of geen aanvragen gemist zijn
Aanvrager
Complextype
V
1
Naam en adresgegevens van de grondroerder/aanvrager
Naam
String
V
1
Bedrijfsnaam
String
V
1
Adres
Complextype
V
1
Adresgegevens van de aanvrager
Straat
String
V
1
Huisnummer
String
V
1
Huisnummertoevoeging
String
C*
0..1
*Verplicht indien aanwezig
Postcode
String
V
1
Woonplaats
String
V
1
Land
String
C*
1
Alleen verplicht bij niet-Nederlands adres
Telefoon
String
V
1..2*
*Minstens één telefoonnummer, regulier of mobiel, moet ingevuld zijn
Email
String
V
1..2*
*Grondroerder geeft minimaal één e-mail adres op. Voor maximale bereikbaarheid kan bij een calamiteitmelding kan ook nog een tweede adres worden opgegeven.
Fax
String
O
0..1
Opdrachtgever
Complextype
C*
1
Naam en adresgegevens van de opdrachtgever (*Alleen verplicht in geval van een graafmelding)
Naam
String
V
1
Bedrijfsnaam
String
V
1
Adres
Complextype
V
1
Adresgegevens van de opdrachtgever
Straat
String
V
1
Huisnummer
String
V
1
Huisnummertoevoeging
String
C*
0..1
*Verplicht indien aanwezig
Postcode
String
V
1
Woonplaats
String
V
1
Land
String
C*
1
Alleen verplicht bij niet-Nederlands adres
Telefoon
String
V
1..2
*Minstens één telefoonnummer, regulier of mobiel, moet ingevuld zijn
Email
String
V
1
Fax
String
O
0..1
SoortWerk
String
C*
0..n
Geeft het type werkzaamheden aan dat verricht gaat worden. Dit kunnen er meer zijn.
(* Alleen verplicht in geval van een graafmelding of oriëntatieverzoek)
Notitie
String2000
O
0..1
Veld voor extra opmerkingen/notities
Dichtstbijzijndadres
Complextype
V
1
Dichtstbijzijnde adres binnen de gemeente waar gegraven wordt ten opzichte van het midden van de graafpolygoon. met minimaal plaatsnaam en straat
Woonplaats
String
V
1
Straat
String
V
1
Postcode
String
C
0..1
Verplicht indien in de woonplaats-straat een postadres aanwezig is.
Huisnummer
String
O
0..1
Huisnummertoevoeging
String
O
0..1
Locatie
Gml:Polygoontype
V
1
Gebied waarvoor informatie gevraagd wordt (polygoon)
Pngformaat
Complextype
V
1
Geeft het formaat aan waaraan de geleverde .png’s moeten voldoen
OmsluitendeRechthoek
Gml:Rectangletype
V
1
Geo-gerefereerde rechthoek van het gebied dat de polygoon precies omsluit
PixelsBreed
Integer
V
1
Breedte in pixels van de te leveren .png
PixelsHoog
Integer
V
1
Hoogte in pixels van de te leveren .png
Huisaansluitschetsen
Complextype
O
0..n
Adresgegevens waarvan huisaansluitschetsen gevraagd worden
Adres
Complextype
V
1
Adres waarvan de huisaansluitschets wordt opgevraagd
Straat
String
V
1
(T)
Huisnummer
String
V
1
(T)
Huisnummertoevoeging
String
C*
0..1
(T) *Verplicht indien van toepassing
Postcode
String
V
1
(T)
Plaats
String
V
1
(T)
2.3. Leveren Beheerdersinformatie
Wanneer de netbeheerder de beheerdersinformatie heeft verzameld kan deze aan Klic-online aangeboden worden. Dit gebeurt door het aanroepen van een webservice van Klic-online.
Alle informatie die een netbeheerder heeft verzameld (ligging van de kabels/leidingen, annotatie, maatvoering, voorzorgmaatregelen, huisaansluitschetsen etc.) wordt via de webservice in XML formaat aangeboden aan Klic-online. De beschrijving van de laatste versies van de webservice (WSDL) en het bijbehorende XML schema (XSD) zijn te vinden op www.Kadaster.nl/klic.
2.3.1. Inhoud van de beheerdersinformatie
Tabel 2: Inhoud van de beheerdersinformatie Veld
Type
Verplicht?
Aantal
Toelichting
Ordernummer
String(10)
V
1
Ordernummer waaronder de aanvraag bij Klic-online bekend is
KlicNummer
String(9)
V
1
Het KlicNetnummer waaronder de aanvraag binnen Klic-online bekend is (oude formaat,
YYX999999, bijv. 08G0123456)
DatumTijdVerzending
DateTime
V
1
Datum en tijd waarop de melding door netbeheerder is verzonden aan Klic-online
Netbeheerder
String
V
1
Naam van de netbeheerder
Relatienummer
String(10)
V
1
Klantnummer waaronder de netbeheerder bij het Kadaster bekend is
Contact
Complextype
V
1
Klic contactpersoon bij de netbeheerder
Naam
String
O
0..1
Naam van de Klic-contactpersoon
Telefoon
String
C*
0..1
*Telefoon óf E-mail moet ingevuld zijn
Email
String
C*
0..1
*Telefoon óf E-mail moet ingevuld zijn
Storingsnummer
String
O
0..1
Algemeen storingsnummer van de netbeheerder dan wel een bepaalde groep van netbeheerders.
Beschadigingsnummer
String
O
0..1
Nummer van de netbeheerder dat gebeld moet worden indien er sprake is van schade, zonder dat de levering is onderbroken (Bijv. alleen mantel stuk).
BelangAanwezig
Boolean
V
1
Indien binnen de gevraagde polygoon géén kabels/leidingen liggen, en er daarom geen beheerdersinformatie geleverd kan worden, wordt deze indicator op ‘Nee’ gezet, in alle andere gevallen is deze ‘Ja’
Thema’s
Complextype
C*
0..1
Alle beheerdersinformatie uitgesplitst per thema conform IMKL. *Verplicht als er beheerdersinformatie geleverd moet worden (BelangAanwezig = ‘Ja’)
Thema
Complextype
V
1..n
Beheerdersinformatie voor een thema
Themanaam
String
V
1
Naam van het thema (vlgs IMKL)
Toezichthouder
Complextype
O
0..n
Opsomming van toezichthouders per thema.
Naam
String
O
0..1
Naam van de contactpersoon
Telefoon
String
C*
1
Telefoonnummer toezichthouder
*Óf telefoon óf email is verplicht
Email
String
C*
1
E-mail adres van de toezichthouder
*Óf telefoon óf email is verplicht
EisVoorzorgmaatregel
Boolean
V
1
Is er sprake van een eis voorzorgmaatregel bij dit thema (J/N)
Ligging
Complextype
V
1
Rasterplaatje van de ligging van het thema in .png formaat
Bestandsnaam
String
V
1
Naam van het .png bestand
PngBestand
base64Binary
V
1
Het .png bestand zelf
PngHash
String(32)
O
0..1
Hash waarde ter controle van het .png bestand. Hexadecimale presentatie (string van 32 karakters) van een 128 bit hash getal.
Maatvoering
Complextype
O
0..1
Rasterplaatje van de maatvoering bij het thema in .png formaat
Bestandsnaam
String
V
1
Naam van het .png bestand
PngBestand
base64Binary
V
1
(T) Het .png bestand zelf, verplicht indien Maatvoering wordt meegeleverd
PngHash
String(32)
O
0..1
Hash waarde ter controle van het .png bestand. Hexadecimale presentatie (string van 32 karakters) van een 128 bit hash getal.
Annotatie
Complextype
O
0..1
Rasterplaatje met de annotatie bij dit thema in .png formaat
Bestandsnaam
String
V
1
Naam van het .pgn bestand
PngBestand
base64Binary
V
1
(T) Het .png bestand zelf, verplicht indien annotatie wordt meegeleverd
PngHash
String(32)
O
0..1
Hash waarde ter controle van het .png bestand. Hexadecimale presentatie (string van 32 karakters) van een 128 bit hash getal.
Detailkaart
Complextype
O
0..n
Optioneel kunnen er detailkaarten in PDF formaat worden meegeleverd
Bestandsnaam
String
V
1
Naam van het .pdf bestand
PdfBestand
base64Binary
V
1
Het .pdf bestand zelf
Huisaansluitschets
Complextype
O
0 ..n
Optioneel kunnen er gevraagde huisaansluitschetsen geleverd worden in PDF formaat
Bestandsnaam
String
V
1
Naam van het .pdf bestand
PdfBestand
base64Binary
V
1
Het .pdf bestand zelf
Themabijlage
Complextype
O
0..n
Optioneel kunnen er nog bijlagen voor het specifieke thema (o.a. ook de eisvoorzorgmaatregelen) in PDF formaat worden meegeleverd
Bestandsnaam
String
V
1
Naam van het .pdf bestand
PdfBestand
base64Binary
V
1
Het .pdf bestand zelf
Bijlage
Complextype
O
0..n
Optioneel kunnen er detailkaarten in pdf formaat worden meegeleverd
Bestandsnaam
String
V
1
Naam van het .pdf bestand
PdfBestand
base64Binary
V
1
Het .pdf bestand zelf
Eigentopografie
Complextype
O
0..1
Optioneel kan een eigentopografie meegeleverd worden, in rasterformaat .png
Bestandsnaam
String
V
1
Naam van het .png bestand
PngBestand
base64Binary
V
1
(T) Het .png bestand zelf, verplicht indien Eigentopo wordt meegeleverd
PngHash
String(32)
O
0..1
Hash waarde ter controle van het .png bestand. Hexadecimale presentatie (string van 32 karakters) van een 128 bit hash getal.
Plantopografie
Complextype
O
0..1
Optioneel kan een plantopografie meegeleverd worden, in rasterformaat .png
Bestandsnaam
String
V
1
Naam van het .png bestand
PngBestand
base64Binary
V
1
(T) Het .png bestand zelf, verplicht indien Plantopo wordt meegeleverd
PngHash
String(32)
O
0..1
Hash waarde ter controle van het .png bestand. Hexadecimale presentatie (string van 32 karakters) van een 128 bit hash getal.
Het in tabel 2 genoemde storingsnummer dient niet verward te worden met het in de regelgeving genoemde calamiteitennummer. Het calamiteitennummer maakt – in elk geval indien wettelijk verplicht – onderdeel uit van de belangenregistratie; om die reden komt het niet voor in bovengenoemde beheerdersinformatie.
2.3.2. Naamgeving meegeleverde bestanden
In de XML van de beheerdersinformatie worden een aantal (binaire) bestanden (in .png en PDF formaat) meegeleverd. Om deze voor de grondroerder duidelijk onderscheidbaar te maken, moeten de namen van deze bestanden aan onderstaande conventies voldoen, waarbij de <naam_thema> exact gelijk moet zijn aan de namen die in het IMKL zijn gedefinieerd:
Tabel 3: Naamgeving meegeleverde bestanden Bestand
Naamgeving
Ligging
LG_<naam_thema>_<naam_netbeheerder>_< klicnummer >.png
Maatvoering
MV_<naam_thema>_<naam_netbeheerder>_< klicnummer >.png
Annotatie
AN_<naam_thema>_<naam_netbeheerder>_< klicnummer >.png
Detailkaart
DK_<naam_thema> _<naam_netbeheerder>_< klicnummer >_<naam>.PDF
Huisaansluitschets
HA_<naam_thema>_<naam_netbeheerder>_< klicnummer >_<postcode>_<huisnummer>_<evt huisnummer toevoeging>.PDF
Themabijlage
TB_<naam_thema>_<naam_netbeheerder>_< klicnummer >_<naam >.PDF
Voor een eis-voorzorgmaatregel bijlage geldt een afwijkende (dus opvallende) naamgeving
EV_<naam_thema>_<naam_netbeheerder>_< klicnummer >.PDF
(algemene) Bijlage
BL_<naam_netbeheerder>_< klicnummer >_<naam>.PDF
EigenTopo
ET_<naam_netbeheerder>_< klicnummer >.png
PlanTopo
PT_<naam_netbeheerder>_< klicnummer >.png
3. Berichtenverkeer
Het in hoofdstuk 2 getoonde sequence diagram is een sterk vereenvoudigde weergave van het berichtenverkeer dat zich gaat afspelen. Er kan namelijk van alles mis gaan in de communicatie, waardoor berichten opnieuw moeten worden verzonden. In onderstaand sequence diagram is dit weergegeven.
Toelichting:
Het model in Figuur 2 gaat uit van een gescheiden verantwoordelijkheid: Klic-online (Kadaster) is ervoor verantwoordelijk dat een geldig en tegen schema gevalideerd, met certificaat beveiligd, Graafbericht (1a) wordt verstuurd én aankomt bij de netbeerder(s). Pas wanneer een technische bevestiging (ACK) is ontvangen, is zeker dat het Graafbericht is afgeleverd. Op dat moment ligt de verantwoordelijkheid bij de netbeheerder, die op basis van het ontvangen bericht de beheerdersinformatie moet samenstellen en deze verzenden naar Klic-online. Dit doet hij door het aanroepen van een webservice aan de kant van Klic-online met een geldig en gevalideerd Beheerdersinformatie bericht (2a). Pas wanneer deze webservice met een technische bevestiging (ACK) terugkomt, kan de netbeheerder zijn beheerdersinformatie als geleverd beschouwen.
Hieronder wordt de procedure nog eens stap voor stap beschreven:
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).2
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).2[3]
4. Beveiliging
Om te voorkomen dat de webservices bij de netbeheerder worden bevraagd door andere partijen dan Klic-online, moeten de webservices kunnen controleren dat het echt Klic-online is, dat de aanvraag doet. Kadaster zal derhalve het bericht versleutelen met een certificaat.
Het beheerdersinformatie-bericht van de netbeheerder naar Kadaster/Klic-Online 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.
(Zie ook de korte werkinstructie t.b.v. de netbeheerders in hoofdstuk 5).
Om te kunnen controleren of er na versturen van de beheerdersinformatie gemanipuleerd is met de kaartbestanden (png) kan de netbeheerder ervoor kiezen een hashwaarde mee te zenden met ieder png-bestand. Hiervoor is in het berichtenverkeer een voorziening opgenomen. Indien deze hashwaarde wordt meegestuurd dient deze te worden berekend m.b.v. het standaard MD5 algorithme.
5. Korte werkinstructie
Hieronder volgt nog een korte uiteenzetting van de feitelijke gang van zaken aangaande de omgang met de (gis-)systemen en webservices van de netbeheerders teneinde succesvol aan te kunnen sluiten bij het digitale informatie-uitwisselingsproces van Klic-online:
• 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.
Aandachtspunten:
• 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.
6. Begrippen en afkortingen
Begrip
Omschrijving
ACK
Acknowledgement, signaal dat bericht op netwerkniveau goed is ontvangen.
BMKL
Berichtenmodel Kabels en Leidingen
BPM
Business Process Management. Geautomatiseerd systeem dat de interne processen binnen het Kadaster aanstuurt en bewaakt.
Graafpolygoon
Weergave van het gebied waarin de graaflocatie zich bevindt. Zie ook polygoon.
Informatiemodel Kabels en Leidingen
Klic-online
Geautomatiseerd informatie-uitwisselingssysteem voor het uitwisselen van beheerdersinformatie tussen grondroerders en netbeheerders
MD5 algorithme
Message Digest Algorithm 5. is een veelgebruikte cryptografische hashfunctie met een 128-bit hashwaarde. MD5 is als internetstandaard gebruikt in vele veiligheidstoepassingen en wordt ook gebruikt om de integriteit van bestanden te controleren.
.PNG
Portable Network Graphics, grafisch bestandsformaat dat georeferentie en transparantie ondersteunt
Polygoon
Een veelhoek of polygoon is een gesloten stelsel lijnsegmenten die samen een plat vlak omsluiten. Met hetzelfde woord polygoon wordt ook het vlak binnen deze lijnstukken aangeduid, of de combinatie van de lijnstukken en het vlak.
SOAP
Simple Object Access Protocol, een computerprotocol dat wordt gebruikt voor de communicatie tussen verschillende software componenten (meestal webservices)
Webservice
Softwarecomponent die toegankelijk is via standaard webprotocollen zoals SOAP en XML.
Wet Informatie uitwisseling Ondergrondse Netten
WSDL
Web Service Description Language, een XML-taal waarmee de interfaces van webservices kunnen worden beschreven
XML
eXtensible Markup Language. Een standaard voor het definiëren van formele markup-talen voor de representatie van gestructureerde gegevens in de vorm van platte tekst. Deze representatie is zowel machineleesbaar als leesbaar voor de mens.
XSD
XML Schema Definition. Beschrijft de structuur van een XML document.
- 1
Deze informatie is vastgelegd in de belangendatabase, waarmee Klic-online bepaalt welke netbeheerders bij een aanvraag benaderd moeten worden.
- 2
Deze twee uitzonderingen zijn vanwege de leesbaarheid niet in het sequencediagram opgenomen.
- ^ [3]
Deze twee uitzonderingen zijn vanwege de leesbaarheid niet in het sequencediagram opgenomen.