Verkeerde waarden werkzaamheden bij gebruik BMKL-API

herman-vandenberg commented 5 years ago

API-gebruikers van VodafoneZiggo en Gasunie hebben geconstateerd dat er onjuistheden in de lijst van soorten werkzaamheden.

Een analyse levert het volgende op: Op een aantal plaatsen in de KLIC-software wordt gebruik gemaakt van een tabel met soorten werkzaamheden. In deze tabel worden zowel de waarden benoemd zoals deze in BMKL1.2 waren vastgelegd en waarden die voor BMKL2.0 zijn gedefinieerd. Bij vastlegging van de laatstgenoemde waarden zijn in de loop van de tijd fouten gemaakt omdat oudere waarden niet waren geactualiseerd. Dit betreft

camelCase-gebruik voor de volgende (correcte) IMKL1.2-waarden

	waarde
	bomenRooienOfPlanten
	CAIkabelLeggen
	diepploegen
	grondwerkBouwrijpMaken
	HDPEbuisLeggen
	hovenierswerkzaamheden
	OVwerkzaamheden
	reconstructiewerkzaamheden
	rioleringswerkzaamheden
	ruilverkaveling
	sloopwerkzaamheden
	telefoonkabelsLeggen
	trafostationPlaatsen

link naar (correcte) IMKL1.2-waardelijst , te weten http://definities.geostandaarden.nl/imkl2015/id/waarde/SoortWerkzaamhedenValue/{waarde}

Deze onjuistheden hebben gevolg voor de volgende functionaliteiten:

het opvragen van de werkzaamheden van een specifieke gebiedsinformatie-aanvraag met de BMKL-API: Get gebiedsinformatieAanvragen{giAanvraagId}; dit geldt voor zowel de NTD als de productie, omdat gebruik wordt gemaakt van dezelfde API
de API-testfaciliteit (Swagger-functie en –documentatie)

Voor zover we nu kunnen overzien, heeft dit geen gevolg (gehad) voor andere functionaliteit. Hierbij hebben we met name gelet op

registratie van soorten werkzaamheden bij het aanvragen van gebiedsinformatie (KLIC-online, NTD, B2Baanvraag)
actualiseren van EV-beslissingsregels met soorten werkzaamheden (NTD, productie)
EV-bepaling waarbij soort werkzaamheden een rol speelt
uitgeleverde producten (ontvangstbevestiging, GebiedsinformatieLevering in zipbestand)

herman-vandenberg commented 5 years ago

Het verdient aanbeveling om z.s.m. deze bevinding op te lossen. Dat betekent wel dat netbeheerders die - op basis van deze API - de werkzaamheden van een aanvraag gebruiken in hun eigen proces, met een wijziging worden geconfronteerd.

herman-vandenberg commented 4 years ago

Voor dit issue is een KLIC-issue aangemaakt (intern: https://dev.kadaster.nl/jira/browse/KLCW-1797).

PeterSchmidtSE commented 4 years ago

Is er een update te geven over of/wanneer deze bevinding opgelost wordt?

herman-vandenberg commented 4 years ago

Beste Peter, Dit issue is samen met diverse andere (IMKL)-issues momenteel in behandeling bij de TCS. Hier wordt een afweging gemaakt welke wijzigingen, wanneer en volgens welk scenario worden geïmplementeerd. Zodra hierover meer duidelijkheid is, wordt hier breed over gecommuniceerd.

herman-vandenberg commented 4 years ago

TCS: akkoord

JustinRoodenburg commented 2 years ago

Toelichting op implementatie van het Kadaster: De waarden die gebruikt worden bij de SoortWerkzaamheden in de BMKL-API zijn gelijkgetrokken (m.n. hoofdlettergebruik) met de waarden in de waardelijst. Tevens wordt er gebruik gemaakt van een gewijzigde URI. (zie issue #94 en issue #91 )

Voor een compleet overzicht van de gebruikte waarden, zie de waardelijst op: https://register.geostandaarden.nl/waardelijst/imkl/2.0.0/IMKL-Waardelijsten-2.0.xml

Voor een compleet overzicht en voorbeelden van de BMKL-API versie 2.1 zie onderstaande links: De nieuwe versie van het berichtenmodel (BMKL versie 2.1) vindt u op deze GitHub pagina van het Kadaster. Een toelichting op en en voorbeelden van de wijzigingen van de BMKL-standaarden vindt u op deze GitHub pagina van het Kadaster.

kadaster / klic-win

Verkeerde waarden werkzaamheden bij gebruik BMKL-API #64