Werkafspraak Grondwatergebruiksysteem (GUF) “Correctie onvolkomenheden”

Titel

Deze werkafspraak beschrijft een aantal gegevensinhoudelijke aanpassingen die al zijn doorgevoerd in de LV BRO naar aanleiding van geconstateerde onvolkomenheden tijdens de zgn. Bouwfase van de LV BRO.

Behorende bij

Basisregistratie Ondergrond Catalogus Grondwatergebruiksysteem (GUF): Geonovum Informatiemodel, Versie ter vaststelling 23 juni 2021

Doelgroep

Softwareontwikkelaars die GUF software producten van de Landelijke voorziening BRO gaan implementeren.

Aanleiding en samenvatting

Tijdens de bouwfase van de LV BRO zijn de volgende onvolkomenheden vastgesteld

Een aantal elementen waren zowel optioneel/conditioneel (‘Kardinaliteit’ = ‘0..X’), als ‘nillable’ (‘Mogelijk geen waarde’ = ‘Ja’). ‘Nillable’ betekent dat een element mogelijkerwijs geen c.q. een lege (Null) waarde krijgt. Omdat niet (duidelijk) was aangegeven wanneer het element mocht/moest ontbreken (optioneel/conditioneel) danwel geen waarde mocht krijgen, was sprake van enige ambiguïteit. Het gaat o.a. om;
- Gegevensgroep energiekenmerken van Entiteit Ontwerpinstallatie
Bij het Attribuut eindGeldigheid van Entiteit TijdvakGeldigheid (i) én het Attribuut eindtijd van Entiteit Tijdvaklevensduur (ii) was sprake van twee onvolkomenheden;
1. Net als het voorgaande punt, ook hier sprake van ambiguïteit tussen het optioneel/conditioneel (‘Kardinaliteit’ = ‘0..X’), als ‘nillable’ (‘Mogelijk geen waarde’ = ‘Ja’) zijn van het element.
2. De toelichting van eindGeldigheid en eindtijd waren per ongeluk verwisseld.
De associatie relatie ‘gerelateerd aan’ naar de Entiteit Verkenning, vanuit zowel de Entiteit Gerealiseerde bodemlus (i) als de Entiteit Gerealiseerde put (ii) had de kardinaliteit 0..*, terwijl ook het Attribuut BRO-ID (iii) van de Entiteit Verkenning (iv) de kardinaliteit 0..* had. De optionaliteit én de onbegrensdheid waren in deze dus ambigu gemodelleerd.
Het Attribuut geometrie van zowel Entiteit Ontwerpbodemlus (i) als van Entiteit Gerealiseerde Bodemlus (ii) is ‘nillable’ (‘Mogelijk geen waarde’ = ‘Ja’).
De optie ‘Mogelijk geen waarde’ voor een geometrie was nog niet eerder voorgekomen in de BRO. Het implementeren hiervan bleek lastig, waarna is uitgeweken naar een alternatieve modelleerconstructie.

In deze werkafspraak zijn de gebouwde alternatieve oplossingen en tekstuele verbeteringen beschreven.

Ingangsdatum en afloopdatum

Met ingang van de inwerkingtreding van de 1.0 versie van de catalogus GUF per 1-7-2022 is deze van kracht tot de volgende versie van de catalogus in werking treedt (datum nog niet gepland).

Werkafspraak

Deze lichte variant van een werkafspraak komt met een verwijzing naar de gebruiksvriendelijke versie van de GUF catalogus: https://broprogramma.github.io/GUF/ waarin de werkafspraak is verwerkt. Huidige catalogus ter vaststelling is aangeboden en staat op https://docs.geostandaarden.nl/bro/guf/.

De gekozen oplossing is, na overleg met team LVBRO/BHP en standaardisatie, als afgesproken:

Gegevensgroep energiekenmerken van Entiteit Ontwerpinstallatie

Wijzigingen

Mogelijk geen waarde
- Was: ‘Ja’
- Wordt: Vervalt
Reden geen waarde
- Was: ‘Voor IMBRO/A-gegevens mag de waarde ontbreken.’
- Wordt: Vervalt
Regels IMBRO/A:
- Was: Niet aanwezig
- Wordt: ‘Voor IMBRO/A gegevens mag de gegevensgroep ontbreken wanneer de waarde van het attribuut installatiefunctie gelijk is aan openBodemenergiesysteem of geslotenBodemenergiesysteem.’

Was

Wordt

Attribuut eindGeldigheid van Entiteit TijdvakGeldigheid (i) en Attribuut eindtijd van Entiteit Tijdvaklevensduur (ii)

Wijzigingen (i)

Mogelijk geen waarde
- Was: ‘Ja’
- Wordt: ‘Nee’ (deze default waarde wordt niet getoond in de tabel)
Definitie
- Was: ‘Einde van de periode waarop deze instantie van het object geldig is in de werkelijkheid. Wanneer deze waarde niet is ingevuld is de instantie nog geldig.’
- Wordt: ‘Einde van de periode waarop deze instantie van het object geldig is in de werkelijkheid. De instantie is nog geldig als het attribuut niet aanwezig is.’
Toelichting

- Was: Niet aanwezig
- Wordt: ‘Het gegeven staat niet in een brondocument maar wordt automatisch door de basisregistratie ondergrond gegenereerd.’

Wijzigingen (ii)

Mogelijk geen waarde
- Was: ‘Ja’
- Wordt: ‘Nee’ (deze default waarde wordt niet getoond in de tabel)
Definitie
- Was: ‘Tijdstip waarop het object in de werkelijkheid niet meer geldig is.’
- Wordt: ‘Tijdstip waarop het object in de werkelijkheid niet meer geldig is. Het object is nog geldig als het attribuut niet aanwezig is.’

Toelichting
- Was: ‘Het gegeven staat niet in een brondocument maar wordt automatisch door de basisregistratie ondergrond gegenereerd.’
- Wordt: Niet aanwezig

Was (i)

Wordt (i)

Was (ii)

Wordt (ii)

De associatie relatie naar de Entiteit Verkenning, vanuit zowel de Entiteit Gerealiseerde bodemlus (i) als de Entiteit Gerealiseerde put (ii)

Wijzigingen (i) én (ii)

Kardinaliteit
- Was: ‘0..*’
- Wordt: ‘0..1’

Was (i) én (ii)

Wordt (i) én (ii)

Merk op: In bovenstaand diagram is behalve de gewijzigde kardinaliteit van het Attribuut BRO-ID van de Entiteit Verkenning, ook de gewijzigde kardinaliteit van het Attribuut geometrie van de Entiteit Gerealiseerde bodemlus terug te zien.

Attribuut BRO-ID van de Entiteit Verkenning