GMW Aanlevering

Inhoudsopgave

• Wat is GMW
• IMBRO vs IMBRO/A
• Welke metadata is nodig binnen de portal?
• Hoe maak ik een constructie aan voor een meetpunt?
• Hoe kan je gemakkelijk een constructie aanmaken voor een groep aan meetpunten?
• Help ik heb verschillen tussen mijn put en mijn transacties

Wat is GMW
 

Een Grondwatermonitoring Put wordt binnen de Basis Registratie Ondergronds (BRO) een GMW object genoemd.
Wanneer een put over een periode van ten minste een jaar wordt bemeten is deze per definitie BRO plichtig. Een BRO plichtige put moet worden aangeleverd aan de BRO, zowel de metadata als de waterstanden moeten worden aangeleverd. Als men het heeft over een GMW object dan spreekt men puur over de metadata van een put.

De metadata van een put kan naar de bro worden aangeleverd met een constructie transactie in de portal. Hier vul je in principe alle metadata van een put in en sla je dit op.
Vervolgens kun je een XML genereren die je bij de BRO kan inleveren in het Bronhouder portaal. In de toekomst is het ons streven om deze stappen te automatiseren.

Dit artikel vertelt welke metadata er nodig is om een constructie transactie aan te maken in de portal en welke stappen je moet ondernemen om je eerste aanleveringen te doen voor de metadata van een put.
 

Wil je meer informatie over het domein GMW dan heeft de BRO hier ook uitgebreide documentatie over.
Deze documentatie is hier te vinden: BRO - Catalogus GMW

IMBRO vs IMBRO/A

Binnen de BRO zijn twee kwaliteits regimes aanwezig. IMBRO/A is minder strict en laat ruimte over voor gegevens die niet aanwezig of bekend zijn. Is dit een oude put waar je niet alles over weet? Dan valt deze waarschijnlijk onder het IMBRO/A regime.

Alle putten die gemaakt zijn na 2017 vallen per definitie onder het strengere IMBRO regime. Hier zijn minder opties over voor gegevens die je niet weet. De BRO wetgeving was toen immers al actief en om die reden verwacht de BRO dat je al deze gegevens hebt.

Welke metadata is nodig binnen de portal?

Voor het aanmaken van een constructie is dus veel metadata nodig. Van de constructie datum tot het materiaal waarvan de put gemaakt is, hoe diep deze is etc. In de tabellen hieronder zijn al deze velden te vinden.

Er wordt aangegeven of deze velden verplicht zijn om aan te leveren, welke waardes de put een IMBRO/A put zouden maken. Hoe het veld bij ons intern heet (dit wordt gebruikt voor import doeleinden) en mocht het veld gebaseerd zijn op een waardelijst bepaald in de BRO dan staat er een verwijzing naar waar je deze waardelijst kan vinden.

Mocht je gebruik willen maken van het importeren is het belangrijk om deze waarde as is (let op hoofdletters) over te nemen. Als je gebruik maakt van de UI in de portal kun je deze waardes direct selecteren uit een dropdown.

Put Veld	Verplicht	Deze waardes maken het punt IMBRO/A	Veld naam binnen ons Munisense systeem (voor import doeleinden)	Notes
Quality Regime	ja	IMBRO/A	quality_regime	IMBRO of IMBRO/A
Bronhouder	ja		delivery_accountable_party_id	kvk nummer
Onderhoudende partij	ja		maintenance_responsible_party_id	kvk nummer
Eigenaar	nee	Als het punt IMBRO/A is mag deze leeg blijven	owner_id	kvk nummer
ObjectId Bronhouder	ja		description	(dit is de beschrijving van een Put in de portal)
NITG-code / Dino ID	nee		dino_id	Alleen aanwezig als het punt geregistreerd was in de registratie DINO
Maaiveld stabiel	ja	Onbekend	ground_level_stable	ja/nee/onbekend
Put stabiliteit	ja	Onbekend	well_stability	Enkel aanwezig als het maaiveld niet stabiel of onbekend is
Kader aanlevering	ja	Archiefoverdracht	delivery_context	moet een element uit de codelijsten zijn https://www.bro-productomgeving.nl/bpo/latest/catalogus-gmw#id-(release-2.4_2024_Q3)CatalogusGMW-Codelijsten
	ja	Onbekend	construction_standard	moet een element uit de codelijsten zijn https://www.bro-productomgeving.nl/bpo/latest/catalogus-gmw#id-(release-2.4_2024_Q3)CatalogusGMW-Codelijsten
Initiële functie	ja	Onbekend	initial_function	moet een element uit de codelijsten zijn https://www.bro-productomgeving.nl/bpo/latest/catalogus-gmw#id-(release-2.4_2024_Q3)CatalogusGMW-Codelijsten
Beschermconstructie	ja	Onbekend	well_head_protector	moet een element uit de codelijsten zijn https://www.bro-productomgeving.nl/bpo/latest/catalogus-gmw#id-(release-2.4_2024_Q3)CatalogusGMW-Codelijsten
Locatie (RD X,Y of GPS Lat, Long)	ja		loc_x_rd, loc_y_rd
Horizontale Positiebepaling Methode	ja	onbekend	horizontal_positioning_method	moet een element uit de codelijsten zijn https://www.bro-productomgeving.nl/bpo/latest/catalogus-gmw#id-(release-2.4_2024_Q3)CatalogusGMW-Codelijsten
Maaiveld positie	nee	Als het punt IMBRO/A is mag deze leeg blijven	well_covering_surface_level	Maaiveld in meters ten opzichte van NAP
Maaiveld Positiebepaling Methode	ja	onbekend	ground_level_positioning_method	moet een element uit de codelijsten zijn https://www.bro-productomgeving.nl/bpo/latest/catalogus-gmw#id-(release-2.4_2024_Q3)CatalogusGMW-Codelijsten
Verticaal Referentievlak	ja	Mag enkel NAP zijn	well_covering_altitude_reference
Constructie Datum	ja		well_properties_drill_survey_date	dd/mm/YYYY HH:ii:ss

Buis/Filter veld	Verplicht	Deze waardes maken het punt IMBRO/A	Veld naam binnen ons Munisense systeem (voor import doeleinden)	Notes
Buis nummer	ja		tube_number	Wordt standaard door onze portal ingevuld
Buis Type	ja	standaardbuis	tube_type	moet een element uit de codelijsten zijn https://www.bro-productomgeving.nl/bpo/latest/catalogus-gmw#id-(release-2.4_2024_Q3)CatalogusGMW-Codelijsten
Artesische drukdop	ja	onbekend	artesian_well_cap_present	ja/nee/onbekend
Zandvang aanwezig	ja	onbekend	-	Wordt binnen ons systeem bepaald door de aanwezigheid van de lengte. Niet aanwezig is onbekend, de waarde 0 voor de lengte is nee, groter dan 0 is ja.
Zandvang lengte	nee		sediment_sump_length	Waarde in meters.   Is er GEEN zandvang aanwezig? Dan moet deze waarde 0 zijn. Zie ook `Zandvang aanwezig` hierboven!
Diameter bovenkant buis	nee	Als het punt IMBRO/A is mag deze leeg blijven	tube_top_diameter	Het gaat hier om de binnen diameter
Variabele Diameter	nee	onbekend	variable_diameter	ja/nee/onbekend
Buis Status	ja	onbekend	tube_status	moet een element uit de codelijsten zijn https://www.bro-productomgeving.nl/bpo/latest/catalogus-gmw#id-(release-2.4_2024_Q3)CatalogusGMW-Codelijsten
Kop Peilbuis / positie bovenkant buis	ja		well_properties_well_head
Methode positiebepaling bovenkant buis	ja	onbekend	tube_top_positioning_method	moet een element uit de codelijsten zijn https://www.bro-productomgeving.nl/bpo/latest/catalogus-gmw#id-(release-2.4_2024_Q3)CatalogusGMW-Codelijsten
Buis materiaal	ja	onbekend	tube_material	moet een element uit de codelijsten zijn https://www.bro-productomgeving.nl/bpo/latest/catalogus-gmw#id-(release-2.4_2024_Q3)CatalogusGMW-Codelijsten
Lijm	ja	onbekend	glue	moet een element uit de codelijsten zijn https://www.bro-productomgeving.nl/bpo/latest/catalogus-gmw#id-(release-2.4_2024_Q3)CatalogusGMW-Codelijsten
Aanvulmateriaal	ja	onbekend	tube_packing_material	moet een element uit de codelijsten zijn https://www.bro-productomgeving.nl/bpo/latest/catalogus-gmw#id-(release-2.4_2024_Q3)CatalogusGMW-Codelijsten
Stijgbuis Lengte	ja		plain_tube_part_length	Moet 0 zijn wanneer het gaat om een volledigFilter
Filter lengte	ja		screen_length	Moet 0 zijn wanneer het gaat om een filterlozeBuis
Filter materiaal	ja	onbekend	sock_material	moet een element uit de codelijsten zijn https://www.bro-productomgeving.nl/bpo/latest/catalogus-gmw#id-(release-2.4_2024_Q3)CatalogusGMW-Codelijsten

Hoe maak ik een constructie aan voor een meetpunt?

Binnen de Munisense portal kan je gemakkelijk een put en buis aanmaken via de Nieuwe Put knop links onderin op het Groep Dashboard.

Bij het aanmaken van deze put zul je zowel de put als de buis van een naam (omschrijving) moeten voorzien. Dit is over het algemeen de naam die de put in je eigen administratie heeft. Tevens is het belangrijk om gelijk de locatie van de put goed te zetten. Dit zou je eventueel ook kunnen doen door middel van een import, zie: https://munisense.zendesk.com/hc/en-us/articles/360011490053.
 

Nadat dit gedaan is kun je beginnen aan het maken van de constructie transactie. Op het Dashboard van de net aangemaakte put zie je verschillende gegevens. Waar we naar op zoek zijn is het Logboek. Hier kan je namelijk nieuwe acties bij selecteren en de eerste actie die we gaan doen is het aanmaken van de constructie transactie. De constructie transactie omvat alle gegevens van de put die bekend zijn bij het maken van de put.

 

Je komt in een invulformulier waarbij alle al in de put bekende gegevens voor je worden ingevuld (dit is handig mocht je de gegevens door middel van een import hebben ingevoegd in de portal); bij een nieuwe put zal er veel op onbekend worden gezet.

De gegevens die we hier in deze constructie transactie gaan zetten zullen naar de BRO gestuurd worden. Zorg er dus voor dat je deze secuur controleert.

Nadat alle gegevens zijn ingevuld en opgeslagen wordt je terug gestuurd naar het dashboard. Als je nu naar het logboek kijkt zal daar een constructie transactie zichtbaar zijn.

Als je op deze transactie drukt krijg je de door jou ingevulde gegevens te zien. Tevens is er aan de rechter kant een BRO Status widget te zien. Hier kun je aangeven of je deze transactie geleverd hebt aan de BRO, of deze geaccepteerd of afgewezen is. Ook kun je hier de XML file downloaden die door het Bronhouder portaal van de BRO kan worden geaccepteerd.

Zodra het XML bestand is geleverd aan de BRO, is goedgekeurd en doorgeleverd door de Bronhouder, zal je vanuit de BRO een BRO GMW-ID krijgen. Deze moet worden geïmporteerd of via de UI worden ingevuld bij een put. Vanaf dat moment is het object een BRO object voor de portal en kunnen (BRO relevante) gegevens enkel nog gewijzigd worden door middel van transacties in het logboek.

Hoe kan je gemakkelijk een constructie aanmaken voor een groep aan meetpunten?

De makkelijkste manier om constructies aan te maken voor een groep meetpunten is door eerst alle BRO relevante metadata te importeren. Bijgevoegd aan dit artikel is een CSV bestand waarmee je voor meerdere meetpunten de data kan importeren. Belangrijk is om te weten dat je hiermee zowel nieuwe meetpunten aan kan maken als bestaande meetpunten kan updaten. Maak hiervoor gebruik van het PK vinkje in de import tool. PK staat voor Primary Key en moet een uniek beschrijvend veld zijn. Dit zou de put beschrijving kunnen zijn mits die uniek is in jouw groepen. Ook is het mogelijk om bijvoorbeeld een combinatie te pakken van de beschrijving en de project code. De import tool zal vervolgens zijn best doen om een matchende combinatie te vinden.

voorbeeld-import-bro-velden.csv

Let op dat het belangrijk is om waardes uit codelijsten goed over te nemen (let op hoofdletters), een datum het juiste formaat moet hebben dd-mm-yyyy.

Als je het import bestand hebt ingevuld en de import hebt gedaan is alle metadata aan de meetpunten toegevoegd. Hiermee heb je echter nog geen constructie transacties. Omdat de meetpunten wel alle gegevens hebben kunnen we deze transacties in 1x aanmaken.
 

Om dit te doen gaan we naar het Dashboard tabje op de lijst pagina van het water dashboard.

Hier zal een widget verschijnen waar je de constructie transacties in bulk kan aanmaken.

Tevens zul je op deze pagina het BRO status widget vinden. Hier kun je alle niet-gesynchroniseerde XML's downloaden. Dit levert je een zip bestand op van alle transacties die de BRO status onbekend hebben.

Meer inzicht op de transacties en hun statussen is te vinden op de detail pagina van de BRO status widget:

Ik heb mijn constructies aangemaakt. En nu?

Alle constructies voor de groep in kwestie zijn aangemaakt. Nu is het een kwestie van alle XML's downloaden dit kan per buis, maar ook op groepsniveau. Deze XML's kunt u aanleveren in het Bronhouder portaal van de BRO. Hier kunt u een levering aanmaken en de XML's uploaden.
Als de XML's door de BRO zijn geverifieerd zal de Bronhouder deze nog goed moeten keuren. 

Zodra dit laatste gebeurd is zal alles doorgeleverd worden en komen de BRO GMW-IDs terug. 
Deze ID's moeten in de portal terug worden geïmporteerd. Dit kan via de importtool, of door deze in de metadata van de put te updaten.

Help, ik heb verschillen tussen mijn put en mijn transacties!

Om het goed inzichtelijk te houden of er verschillen zijn tussen de transacties (de gegevens die in de BRO staan) en het huidige object hebben wij een verschillen widget gemaakt.

Op deze pagina wordt weergegeven welke velden anders zijn dan de combinatie van alle transacties. 
Wat er eigenlijk gebeurt is dat de huidige staat van de put en buizen wordt vergeleken met de staat van een nieuw object waarop alle transacties zijn uitgevoerd. Die zouden eigenlijk altijd gelijk moeten zijn.

In de volgende UI kun je gemakkelijk zien wat er anders is en dit op lossen door te zeggen, ik wil dat het object reflecteert wat de transacties zeggen. OF door te stellen dat het object klopt (je zou dan de juiste transactie toe moeten voegen aan het object en deze moeten sturen naar de BRO om de gegevens gelijk te krijgen).