Inhoud

Register Externe Veiligheid

Vanuit OpenWave kunnen gegevens periodiek worden aangeleverd aan het Register Externe Veiligheid (REV). Daartoe is het Informatiemodel Externe Veiligheid (IMEV) ingepast in de OpenWave database.

Zie voor synchronisatie van gegevens uit het REV naar OpenWave: REV-synchroniseren

Beheer

Aan de beheerkant van OpenWave is het IMEV zichtbaar in de volgende structuur:

Via beheerportaal Inrichtingenbeheer zijn onder de kolom Registratie en Veiligheid deze tabellen terug te vinden, waarbij datatypes in OpenWave vertaald zijn naar (D): string op basis van Doorkieslijst, (I)nteger, (F)loat, (S)tring op basis van invoer en (B)oolean.

De kardinaliteit is terug te zien in het aanvinkvakje Overnemen en de daaraan gekoppelde verplichting om een waarde te vullen.

Definitietabel tbmilcodebkl

Achter de tegel REV BKL-activiteiten bevindt zich de (gevulde) tabel met de EV-activiteiten uit het IMEV model. De meeste EV-activiteiten horen bij de hoofdgroep LocatieActiviteit (andere mogelijkheden zijn BuisleidingStelsel, Wegen en LocatieBasisnet). Bij elke EV-activiteit zijn de attributen uit het IMEV-model overgenomen (0 of maximaal 5) met het kolomtype dat daar bij hoort. Indien het type Doorkieslijst is, dan is de naam van de bijbehorende waardelijst uit het IMEV-model gevuld.

Met het aanvinkvakje overnemen wordt geregeld dat wanneer de betreffende activiteit aan een inrichting wordt toegekend (in de tabel tbmilbklactiviteiten), dan het betreffende attribuut aldaar wordt overgenomen met de verplichting om dit attribuut van een waarde te voorzien alvorens de activiteit naar het REV geëxporteerd kan worden. Het IMEV heeft en aantal attributen verplicht gesteld. Het aanvinkvakje overnemen is voor deze attributen initieel gevuld in OpenWave. Ook de attributen die van invloed zijn op het automatisch toekennen van EV-contouren (zie hieronder bij de tabel tbrevafstanden) zijn initieel aangevinkt.

Bij elk attribuut kan een omschrijving worden opgegeven bijvoorbeeld ten behoeve van de gevraagde eenheid. Deze beschrijvingen zijn aan de voorkant bij de invoer van de betreffende attribuutwaardes zichtbaar te maken. Zoveel mogelijk zijn de beschrijvingen alvast uit het IMEV overgenomen. Aanpassing hiervan heeft geen consequentie voor de programmalogica.

Waarschuwing

LET OP: de objectbenamingen, de attribuutnamen en types en waardelijstnamen moeten WEL exact zo zijn als in het IMEV-model zijn opgegeven.

Definitietabel tbrevrefcontour

Achter de tegel REV Referentie EV contouren bevindt zich de (gevulde) tabel met de Referentiecontouren uit het IMEV model. Bij elke referentiecontour zijn de attributen uit het IMEV-model overgenomen (0 of maximaal 16) met het kolomtype dat daar bij hoort. Indien het type doorkieslijst is, dan is de naam van de bijbehorende waardelijst uit het IMEV-model gevuld.

Met het aanvinkvakje overnemen wordt geregeld dat wanneer de betreffende referentiecontour aan een EV-activiteit bij een inrichting wordt toegekend (in de tabel tbmilopslag), dan het betreffende attribuut aldaar wordt overgenomen met de verplichting om dit attribuut van een waarde te voorzien alvorens de referentiecontour naar het REV geëxporteerd kan worden. Het IMEV heeft een aantal attributen verplicht gesteld. Het aanvinkvakje overnemen is voor deze attributen initieel gevuld in OpenWave. Ook de attributen die van invloed zijn op het automatisch toekennen van EV-contouren (zie hieronder bij de tabel tbrevafstanden) zijn initieel aangevinkt.

Bij elk attribuut kan een omschrijving worden opgegeven bijvoorbeeld ten behoeve van de gevraagde eenheid. Deze beschrijvingen zijn aan de voorkant bij de invoer van de betreffende attribuutwaardes zichtbaar te maken. Zoveel mogelijk zijn de beschrijvingen alvast uit het IMEV overgenomen. Aanpassing hiervan heeft geen consequentie voor de programmalogica.

Waarschuwing

LET OP: de objectbenamingen, de attribuutnamen en types en waardelijstnamen moeten WEL exact zo zijn als in het IMEV-model zijn opgegeven.

Koppeltabel activiteit/referentiecontour

In het IMEV-model is vastgelegd welke referentiecontouren bij welke EV-activiteiten mogelijk zijn. In OpenWave vindt dit zijn weerslag in de koppeltabel tbkoppelbklactrefcontour. Zichtbaar in het blok Gekoppelde referentiecontouren op de detailkaart van de definitietabel tbmilcodebkl.

Definitietabel tbrevevcontour

Achter de tegel REV EV contouren bevindt zich de (gevulde) tabel met de EV-contouren uit het IMEV model. Bij elke EV-contour zijn de attributen uit het IMEV-model overgenomen (0 of maximaal 10) met het kolomtype dat daar bij hoort. Indien het type Doorkieslijst is, dan is de naam van de bijbehorende waardelijst uit het IMEV-model gevuld.

Met het aanvinkvakje overnemen wordt geregeld dat wanneer de betreffende EV-contour aan een referentiecontour bij een inrichting wordt toegekend (in de tabel tbmilopslagevcontour), dan het betreffende attribuut aldaar wordt overgenomen met de verplichting om dit attribuut van een waarde te voorzien alvorens de EV-contour naar het REV geëxporteerd kan worden. Het IMEV heeft een aantal attributen verplicht gesteld. Het aanvinkvakje overnemen is voor deze attributen initieel gevuld in OpenWave.

Bij elk attribuut kan een omschrijving worden opgegeven bijvoorbeeld ten behoeve van de gevraagde eenheid. Deze beschrijvingen zijn aan de voorkant bij de invoer van de betreffende attribuutwaardes zichtbaar te maken. Zoveel mogelijk zijn de beschrijvingen alvast uit het IMEV overgenomen. Aanpassing hiervan heeft geen consequentie voor de programmalogica.

Waarschuwing

LET OP: de objectbenamingen, de attribuutnamen en types en waardelijstnamen moeten WEL exact zo zijn als in het IMEV-model zijn opgegeven.

Koppeltabel activiteit/EV-contour

In het IMEV-model is vastgelegd welke EV-contouren bij welke EV-activiteiten mogelijk zijn. In OpenWave vindt dit zijn weerslag in de koppeltabel tbkoppelbklactevcontour. Zichtbaar in het blok Gekoppelde EV-contouren op de detailkaart van de definitietabel tbmilcodebkl.

Waardelijsten

De in te vullen attributen van de activiteiten, referentiecontouren, EV-contouren en kwetsbare gebouwen/locaties kunnen gekoppeld zijn aan dwingende waardelijsten. In OpenWave krijgt in dat geval het type attribuut de waarde 'D' (van Doorkieslijst) en wordt het attribuut direct gekoppeld aan de naam van de betreffende waardelijst. Die waardelijsten zijn gevuld aangeleverd in de tabellen tbrevwaardelijsten en tbrevitemswaardelijsten achter de tegel REV-waardelijsten.

Waarschuwing

LET OP: de waardelijstnamen en items-benamingen moeten exact zo zijn als in het IMEV-model zijn opgegeven.

Definitietabel Kwetsbare gebouwen/locaties

Achter de tegel REV Kwetsbare gebouwen locaties bevindt zich de (gevulde) tabel tbrevkwetsbaargebouwlocatie met de twee kwetsbaarheidsdefinities uit het IMEV model. Bij de twee kwetsbaarheidsdefinities zijn de attributen uit het IMEV-model overgenomen (0 of maximaal 7) met het kolomtype dat daar bij hoort. Indien het type Doorkieslijst is, dan is de naam van de bijbehorende waardelijst uit het IMEV-model gevuld.

Met het aanvinkvakje overnemen wordt geregeld dat wanneer het betreffende kwetsbare gebouw-of locatie definitie bij een inrichting wordt toegekend (in de tabel tbmilbklkwetsbgebloc), dan het betreffende attribuut aldaar wordt overgenomen met de verplichting om dit attribuut van een waarde te voorzien alvorens het gebouw of locatie naar het REV geëxporteerd kan worden. Het IMEV heeft een aantal attributen verplicht gesteld. Het aanvinkvakje overnemen is voor deze attributen initieel gevuld in OpenWave.

Bij elk attribuut kan een omschrijving worden opgegeven bijvoorbeeld ten behoeve van de gevraagde eenheid. Deze beschrijvingen zijn aan de voorkant bij de invoer van de betreffende attribuutwaardes zichtbaar te maken. Zoveel mogelijk zijn de beschrijvingen alvast uit het IMEV overgenomen. Aanpassing hiervan heeft geen consequentie voor de programmalogica.

Waarschuwing

LET OP: de objectbenamingen, de attribuutnamen en types en waardelijstnamen moeten exact zo zijn als in het IMEV-model zijn opgegeven.

TbRevJsonMallen

Deze tabel met voorbeelden van JSON exportdefinities per EV-activiteit wordt gevuld aangeleverd en wordt door OpenWave gebruikt voor de opmaak van de JSON export files. Niet aankomen dus.

TbREVAfstanden: regels voor automatisch invoegen van een of meer EV-contouren

Deze tabel is gevuld. Niet op grond van IMEV, naar op grond van aangeleverde regels van een omgevingsdienst. De bedoeling van deze tabel is vast te leggen welke EV-contouren bij een bepaalde referentiecontour (die op zijn beurt - per definitie - gekoppeld is aan een EV-activiteit) automatisch kunnen worden aangemaakt op grond van de ingevulde attributen bij de activiteit en of referentiecontour.

Bovenstaand voorbeeld betekent dat indien bij een referentiecontour (tbmilopslag) met de definitie OpslagReferentie waarbij:

DAN zal het gebruik van de wizardknop Haal EV-contouren uit afstandentabel onder aan het lijstje van EV-contouren binnen de detailkaart van die tbmilopslagkaart (referentiecontour) resulteren in de aanmaak van de volgende EV-contourkaarten in de tabel tbmilopslagevcontour:

Voor alle aangemaakte EV-contour-kaarten geldt bovendien dat de beginGeldigheid als waarde datum van vandaag krijgt.

Activiteiten, contouren, kwetsbare gebouwen/locaties bij een inrichting

De groene blokken slaan op tabellen van de OpenWave database die ook buiten het REV om bestaan: Er zijn veel inrichtingen die geen Locatie-EVactiviteit zijn (dus geen EV-activiteiten hebben) en een tbmilopslagkaart hoeft geen referentiecontour te zijn (dat wil zeggen hoeft niet gekoppeld te zijn aan een EV-activiteit).

Inrichtingen (locatie-EV-activiteiten)

Op de detailkaart van een inrichting is het blok REV opgenomen.

Een locatie-EVactivteit in het IMEV (een locatie waar de activiteit met externe veiligheidsrisico’s wordt verricht) is in OpenWave een inrichting van een bepaald type. Dit type is bepalend voor welke EV-activiteiten (zie hieronder) bij een inrichting kunnen worden gedefinieerd:

Indien het blok Polygoon of Lijn gevuld moet zijn, maar leeg is, zal OpenWave bij de export naar REV proberen de benodigde gegevens uit de kolom dvgmlpolygoon van het bijbehorende perceeladres van de inrichting te halen. Is die ook leeg of van verkeerd Geotype dan volgt een foutmelding.

Indien het blok Polygoon of Lijn leeg is, dan is onder het menu opties de keuzes Teken vlak op kaart zichtbaar.

De datum Datum laatste preview ok (ddrevpreviewok) wordt alleen gevuld indien de preview export JSON, die gestart wordt met de knop achter deze kolom, geen fouten heeft opgeleverd. Indien datum laatste wijziging kleiner is dan deze previewdatum, zou deze inrichting met activiteiten, referentie- en EV-contouren probleemloos geëxporteerd kunnen worden.

Voor de daadwerkelijke export dient echter ook de kolom Klaargezet voor Export (ddmagexport) gevuld te zijn. Deze datumkolom kan alleen gevuld worden door iemand met het recht: mag inrichting klaarzetten voor export REV (tbmedewerkers.dlmagrevexportzetten) op de medewerkerskaart. Onder water wordt bij het vullen of leeghalen van deze datum de kolom Door: (dvcodemwmagexport) gevuld met de medewerkerscode.

Deze datumkolom wordt automatisch leeggemaakt indien een wijziging plaatsvindt op één van de te exporteren REV-attributen of onderliggende activiteiten/contouren. De kolom Door: (dvcodemwmagexport) wordt bij het automatisch leegmaken van ddmagexport gevuld met de medewerkerscode van de inlogger die een attribuut heeft gewijzigd.

De REV identificatiecode van de locatie EV-activiteit wordt automatisch berekend bij het wijzigen van de beginGeldigheid datum, mits de identificatiecode een lege waarde heeft. De waarde wordt opgebouwd met de kolom Tekst van de instelling Sectie: Inrichtingen en Item: revnamespaceidentificatie gevolgd door een punt gevolgd door het inrichtingsnummer gevolgd door een underscore gevolgd door de dnkey van de inrichting. Dus zoiets als NL.IMEV.00002.4567_123.

Alleen indien de datum ExportnaarREV nog leeg is EN de inlogger het recht Wijzigen van REV-identificatiecode van tbmilinrichtingen (tbmilrechten.dlbmilinrrevidedt) heeft, kan de inlogger hier zelf een code toekennen.

De kolom OW-identificatie (dvrevbronobjectid) kan gebruikt worden om de locatie-EVactiviteit zowel in het REV als in OpenWave met een eigen codering te vullen. Toepassing: zie REV-synchroniseren.

De beginGeldigheid slaat hier op de begin geldigheid van de Locatie-EVactiviteit. Een wijziging op beginGeldigheid wordt niet geaccepteerd indien de datum ExportNaarREV reeds is gevuld. Een beginGeldigheid moet - op het moment van export - kleiner zijn dan vandaag. Indien de Locatie-EVactiviteit voor het eerst wordt geëxporteerd (met een POST, wanneer de exportdatum dus nog leeg is) dan moet deze kleiner of gelijk zijn - dus eerder gestart zijn - dan de beginGeldigheid van de onderliggende EV-activiteiten (in tbmilbklactiviteiten). Bij een succesvol geaccepteerd wijzigingsbericht (een PUT), wanneer een of meer attributen van waarde zijn veranderd, zal de beginGeldigheid automatisch met de datum van de export worden vervangen.

De eindGeldigheid slaat hier op de eindgeldigheid van de Locatie-EVactiviteit. Een wijziging wordt alleen geaccepteerd bij een gevulde begingeldigheidsdatum. De eindGeldigheid moet groter zijn dan de beginGeldigheid. Een eindeGeldigheid mag niet in de toekomst liggen. Indien de datum ExportNaarREv is gevuld en de oude waarde van ddeindGeldiheid was ook gevuld met een waarde kleiner dan de exportdatum, dan wordt de wijziging niet geaccepteerd. Bij een wijziging die wel wordt geaccepteerd zullen alle onderliggende eindGeldigheidsdatums van EV-activiteiten en contouren (voor zover die voorzien zijn van een gevulde beginGeldigheid) zo nodig worden aangepast naar deze datum.

De datum laatst gewijzigd wordt automatisch gevuld met het moment, waarop een van de volgende inrichtingskolommen een nieuwe waarde krijgt: polygoon, kvknr, handelsnaam, inrichtingsnaam, of de REV-Kolommen: dvroutebasisnetwegen, dvvervoerstypebasisnet, dveigenaarbuislst, dvlocatieevactiviteit en ddbeginGeldigheid, ddeindGeldigheid, dvrevbagnummerid, dvrevbronobjectid en dvrevlocatieomschrijving.

De datum laatste wijziging set is een berekend veld en belangrijk voor de automatische geschedulede export naar het REV. De set van contouren en activiteiten van een inrichting worden opnieuw geëxporteerd indien deze datum laatste wijziging set groter is dan de datum exportnaarREV. De datum laatste wijziging set (in de view vwfrmmilinrichtingen de kolom ddmaxlaatstgewijzigd) is de hoogste waarde (max()) van de datums laatst gewijzigd bij de inrichting en de bijbehorende EV-activiteiten (tbmilbklactiviteiten) en de bijbehorende referentiecontouren (tbmilopslag) en de bijbehorende EV-contouren (tbmilopslagevcontour).

De datum geëxporteerd naar REV (ddexportnaarREV) wordt automatisch gevuld op het moment dat een gehele set - dus: inrichting (locatie-EVactiviteit) met alle onderliggende objecten (EV-activiteiten, referentie- en EV-contouren) - succesvol is geëxporteerd naar het REV. De geschedulede export naar REV (zie verderop) loopt alle inrichtingskaarten af waarvoor onder meer geldt dat de datum laatste wijziging set groter is dan deze datum geëxporteerd naar REV.

Eenmaal geëxporteerd betekent dat de locatie-EVactiviteit ook bestaat in het REV. Dat kan alleen ongedaan worden gemaakt met een gevulde eindeGeldigheid die dan opnieuw geëxporteerd moet worden.

Met de schermknop preview export Json wordt de gehele set - dus: inrichting (locatie-EVactiviteit) met alle onderliggende objecten (EV-activiteiten, referentie- en EV-contouren) - omgezet naar een JSON exportfile en aangeboden aan het REV ter validatie (validate only) zonder dat het REV de wijzigingen doorzet naar het register.

Algemeen Endpoint (kolom Tekst van Sectie: REV en Item: AlgemeenEndpoint) en Token Endpoint (kolom Tekst van Sectie: REV en Item: TokenEndpoint) en client_id (kolom Tekst van Sectie: REV en Item: Client_id) en client_secret (kolom Tekst van Sectie: REV en Item: Client_secret ) en bronhouderscode dienen gevuld te zijn ( kolom Tekst van Sectie: REV en Item: Bronhouder. Deze gegevens worden door Rijkswaterstaat uitgegeven. Bij ontbreken komt een leeg scherm.

OpenWave controleert of (de gevuld aangeleverde) JSON-mallen (zie hierboven bij beheer) nog compleet gevuld zijn. De preview controleert zoveel mogelijk op voorhand of de te exporteren set van objecten aan alle voorwaarden voldoet. Bijv.

Indien een controle faalt wordt dit in tekst op scherm vertoont en gaat er geen bericht naar het REV.

Bij succes wordt de JSON file (van die ene inrichting met alle onderliggende objecten) naar het REV geëxporteerd ter validatie. Deze exportfile wordt in het scherm getoond alsmede het retourbericht van het REV.

Retourcode 200 of 201 betekent dat het bericht succesvol geaccepteerd is door de validatieprocedure van het REV. Bij succes wordt Datum laatste preview ok (ddrevpreviewok) op de inrichtingskaart automatisch gevuld.

Voor de daadwerkelijke export - dus die loopt via de taskscheduler - dient echter ook de kolom Klaargezet voor Export (ddmagexport) gevuld te zijn. Deze datumkolom kan alleen gevuld worden door iemand met het recht: mag inrichting klaarzetten voor export REV (tbmedewerkers.dlmagrevexportzetten) op de medewerkerskaart. Onder water wordt bij het vullen of leeghalen van deze datum de kolom Door: (dvcodemwmagexport) gevuld met de medewerkerscode.

De schermknop Toon gegevens REV is alleen zichtbaar indien de datum geëxporteerd naar REV (ddexportnaarREV) gevuld is. De gehele set aan objecten zoals die geregistreerd staan in het REV wordt opgehaald en getoond (als JSON) op basis van de REV-identificatiecode van de inrichting.

De locatieomschrijving wordt doorgegeven aan het REV in de JSON-tag locatieomschrijving met de hier ingevoerde waarde. Indien leeg dan wordt het locatie-adres uit tbperceeladressen gebruikt om de tag locatieomschrijving te vullen.

De BAG-nummerid kan gevuld worden met de BAG nummeraanduiding-identifier van de locatie. Indien gevuld wordt deze in de JSON-tag adres doorgegeven. Deze doublure is helaas nodig omdat anders bij synchronisatie het REV bepalend zou zijn voor de officiële nummeraanduiding in tbperceeladressen.

TbMilBklActiviteiten (EV-activiteiten)

Te benaderen via de tegel REV BKL-activiteiten op het inrichtingportaal.

Het inzien, wijzigen en insert van gegevens is verder gekoppeld aan de SBI/MBA/BKL rechten bij een inrichting (tbmilrechten.dlcmilinrsbivsb).

Aan een inrichting kunnen meerdere EV-activiteiten worden gedefinieerd. De codelijst op basis van de definitietabel tbmilcodebkl wordt gefilterd op de locatie-EVactiviteit van de inrichting.

De activiteit heeft op de detailpagina een aantal standaardkolommen + een aantal - per activiteit verschillende - attributen.

De geometrie is dezelfde als die van de bovenliggende inrichting.

De identificatiecode wordt automatisch toegekend. De waarde wordt opgebouwd met de kolom Tekst van de instelling Sectie: Inrichtingen en Item: revnamespaceidentificatie gevolgd door een punt gevolgd door de naam van de activiteit gevolgd door een underscore gevolgd door de dnkey van de activiteit. Dus zoiets als NL.IMEV.00002.AmmoniakKoelinstallatie_TeBerekenenAfstand_12.

De beginGeldigheid slaat hier op de begin geldigheid van de EV-activiteit. Een wijziging op beginGeldigheid wordt niet geaccepteerd indien de datum ExportNaarREV reeds is gevuld. Een beginGeldigheid moet op het moment van export kleiner zijn dan vandaag. Indien de EV-Activiteit voor het eerst wordt geëxporteerd (met een POST, wanneer de exportdatum dus nog leeg is) dan moet deze kleiner of gelijk zijn - dus eerder gestart zijn - dan de beginGeldigheid van de onderliggende referentiecontouren (in tbmilopslag).

Omgekeerd geldt dus dat de beginGeldigheid bij een POST groter of gelijk moet zijn aan de beginGeldigheid van de bovenliggende Locatie-EVactiviteit (de inrichting). Bij een succesvol geaccepteerd wijzigingsbericht (een PUT, wanneer de exportdatum reeds gevuld is), waarbij een of meer wijzigingen op attributen worden doorgegeven, zal de beginGeldigheid automatisch met de datum van de export worden vervangen.

De eindGeldigheid slaat hier op de eindgeldigheid van de EV-activiteit. Een wijziging wordt alleen geaccepteerd bij een gevulde begingeldigheidsdatum. De eindGeldigheid moet groter zijn dan de beginGeldigheid. Een eindeGeldigheid mag niet in de toekomst liggen. Indien de datum ExportNaarREv is gevuld en de oude waarde van ddeindGeldiheid was ook gevuld met een waarde kleiner dan de exportdatum, dan wordt de wijziging niet geaccepteerd. Bij een wijziging die wel wordt geaccepteerd zullen alle onderliggende eindGeldigheidsdatums van referentie- en EV-contouren (voor zover die voorzien zijn van een gevulde beginGeldigheid) zo nodig worden aangepast naar deze datum.

De datum laatst gewijzigd wordt automatisch gevuld met het moment, waarop een van de kolommen een nieuwe waarde krijgt.

De datum geëxporteerd naar REV (ddexportnaarREV) wordt automatisch gevuld op het moment dat een gehele set - dus: inrichting (locatie-EVactiviteit) met alle onderliggende objecten (EV-activiteiten, referentie- en EV-contouren) - succesvol is geëxporteerd naar het REV. Eenmaal geëxporteerd betekent dat de EV-activiteit ook bestaat in het REV. Dat kan alleen ongedaan worden gemaakt met een gevulde eindeGeldigheid die dan opnieuw geëxporteerd moet worden.

De kolom vergunningplicht heeft default de waarde (F)alse.

De kolommen vergunningsnummer, bevoegdgezag en kvknrAanvrager mogen leeg blijven (zij krijgen in dat geval in het Register de waarde: waardeOnbekend).

In het blok Notitie kan een eigen notitie worden opgegeven. Deze tekst heeft geen referentie in het REV.

In het blok Kenmerken zijn de attributen overgenomen uit de definitietabel tbmilcodebkl (zie hierboven) waarbij het vakje Overnemen aangevinkt is. Deze attributen moeten een gevulde waarde krijgen alvorens de activiteit geëxporteerd kan worden. Het vraagtekenschermknopje toont de omschrijving van het attribuut zoals gedefinieerd in de definitietabel tbmilcodebkl. Deze omschrijving heeft geen invloed op de export.

Onderaan in het detailscherm van de activiteit is in het blok referentiecontouren een lijstje van gekoppelde referentiecontouren (tbmilopslagkaarten) te zien. Zie voor de insert hieronder bij tbmilopslag (referentiecontouren).

TbMilOpslag (Referentiecontouren)

De referentiecontouren zijn onderdelen van de bestaande tbMilOpslagkaarten in OpenWave.

Het inzien, wijzigen en insert van gegevens is verder gekoppeld aan de bestaande opslagrechten bij een inrichting (tbmilrechten.dlcmilinropsvsb).

In de detailkaart van tbmilopslag zijn de blokken REV activiteit referentie contour en Kenmerken referentiecontour toegevoegd. Dat laatste blok is alleen zichtbaar indien de opslagkaart aan een EV-activiteit is gekoppeld. De blokken met de geometriegegevens zijn verplaatst naar de plek onder deze nieuwe blokken.

Om een bestaande tbmilOpslagkaart als referentiecontour te koppelen aan een EV-activiteit (tbmilbklactiviteiten) kan in het blok REV activiteit referentie contour de schermknop Kies activiteit en referentiecontour worden gebruikt. De inlogger dient dan een EV-activiteit te kiezen (uit de set die reeds gekoppeld is aan de bovenliggende inrichting) en vervolgens op basis van de koppeltabel activiteit/referentiecontour (zie beheer) een referentiecontour.

Om direct een nieuwe opslagkaart met referentiecontour toe te voegen kan de insertknop worden gebruikt onderaan het lijstje van gekoppelde referentiecontouren in het detailscherm van de EV-activiteit. Ook hier wordt de keuze van de mogelijke referentiecontouren beperkt door de koppeltabel activiteit/referentiecontour.

De opslagkaart kent van oudsher een aantal verplichte kolommen die bij een insert moeten worden gevuld. Een aantal daarvan is eigenlijk dubbelop met betrekking tot de REV-data. Onder het kopje Nieuwe Opslagkaart van Opslagtabel bij inrichtingen wordt uitgelegd hoe hiertoe defaultwaardes in te stellen.

De geometrie van de referentiecontour is vastgelegd in een punt (in het blok Geometrie punt) of door een vlak of lijn (in het blok Geometrie lijn of vlak). Zie ook hieronder bij attribuut geometrie.

Indien de x en y coördinaat van het blok Geometrie punt leeg zijn, dan is onder het menu Opties de keuze Wijs punt aan op kaart zichtbaar.

Indien het blok Geometrie lijn of vlak leeg is, dan zijn onder het menu Opties de keuzes Teken vlak op kaart en Teken lijn op kaart zichtbaar.

Het blok Kenmerken referentiecontour op de detailpagina van de opslagkaart heeft een aantal standaardkolommen + een aantal - per referentiecontour verschillende - attributen.

De identificatiecode wordt automatisch toegekend. De waarde wordt opgebouwd met de kolom Tekst van de instelling Sectie: Inrichtingen en Item: revnamespaceidentificatie gevolgd door een punt gevolgd door de naam van de EV-activiteit gevolgd door een underscore gevolgd door de naam van de referentiecontour gevolgd door een underscore gevolgd door de dnkey van de referentiecontour (tbmilopslag.dnkey). Dus zoiets als NL.IMEV.00002.TankenLPG_Tankzuil_3243

De beginGeldigheid slaat hier op de begin geldigheid van de Referentiecontour. Een wijziging op beginGeldigheid wordt niet geaccepteerd indien de datum ExportNaarREV reeds is gevuld. Een beginGeldigheid moet op het moment van export kleiner zijn dan vandaag. Indien de referentiecontour voor het eerst wordt geëxporteerd (met een POST, wanneer de exportdatum dus nog leeg is) dan moet deze kleiner of gelijk zijn - dus eerder gestart zijn - dan de beginGeldigheid van de onderliggende EV-contouren (in tbmilopslagevcontouren).

Omgekeerd geldt dus dat de beginGeldigheid bij een POST groter of gelijk moet zijn aan de beginGeldigheid van de bovenliggende EV-Activiteit. Bij een succesvol geaccepteerd wijzigingsbericht (een PUT, wanneer de exportdatum reeds gevuld is), waarbij een of meer wijzigingen op attributen worden doorgegeven, zal de beginGeldigheid automatisch met de datum van de export worden vervangen.

De eindGeldigheid slaat hier op de eindgeldigheid van de Referentiecontour. Een wijziging wordt alleen geaccepteerd bij een gevulde begingeldigheidsdatum. De eindGeldigheid moet groter zijn dan de beginGeldigheid. Een eindeGeldigheid mag niet in de toekomst liggen. Indien de datum ExportNaarREv is gevuld en de oude waarde van ddeindGeldiheid was ook gevuld met een waarde kleiner dan de exportdatum, dan wordt de wijziging niet geaccepteerd. Bij een wijziging die wel wordt geaccepteerd zullen alle onderliggende eindGeldigheidsdatums van de EV-contouren (voor zover die voorzien zijn van een gevulde beginGeldigheid) zo nodig worden aangepast naar deze datum.

De datum laatst gewijzigd wordt automatisch gevuld met het moment, waarop een van de kolommen een nieuwe waarde krijgt.

De datum geëxporteerd naar REV (ddexportnaarREV) wordt automatisch gevuld op het moment dat een gehele set - dus: inrichting (locatie-EVactiviteit) met alle onderliggende objecten (EV-activiteiten, referentie- en EV-contouren) - succesvol is geëxporteerd naar het REV. Eenmaal geëxporteerd betekent dat de referentiecontour ook bestaat in het REV. Dat kan alleen ongedaan worden gemaakt met een gevulde eindeGeldigheid die dan opnieuw geëxporteerd moet worden.

Het blok wordt verder aangevuld met de attributen overgenomen uit de definitietabel tbrevrefcontour (zie hierboven) waarbij het vakje Overnemen aangevinkt is. Deze attributen moeten een gevulde waarde krijgen alvorens de referentiecontour geëxporteerd kan worden. Het vraagtekenschermknopje toont de omschrijving van het attribuut zoals gedefinieerd in de definitietabel tbrevrefcontour. Deze omschrijving heeft geen invloed op de export.

Het attribuut geometrie geeft aan welke type geometrie van toepassing is op de referentiecontour (punt, vlak of lijn). Indien de onderliggende EV-contouren een gevuld attribuut Afstand hebben, dan moet het geotype van de referentiecontour een Punt zijn.

Onder het blok geometrie in het detailscherm van de referentiecontour is in het blok EV-contouren een lijstje van gekoppelde EV-contouren (tbmilopslagevcontour-kaarten) te zien. Zie voor de insert hieronder bij TbMilOpslagEvContour (EV-contouren).

TbMilOpslagEvContour (EV-contouren)

Rechten: opslagrechten: tbmilrechten.dlcmilinropsvsb).

Er zijn twee manieren om een EV-contour te definiëren bij een referentiecontour. Beiden vanuit het detailscherm van de bovenliggende referentiecontour in het blok EV-contouren.

Het blok Kenmerken EV-contour op de detailpagina van de EV-contourkaart heeft een aantal standaardkolommen + een aantal - per EV-contour verschillende - attributen.

De identificatiecode wordt automatisch toegekend. De waarde wordt opgebouwd met de kolom Tekst van de instelling Sectie: Inrichtingen en Item: revnamespaceidentificatie gevolgd door een punt gevolgd door de naam van de EV-activiteit gevolgd door een underscore gevolgd door de naam van de referentiecontour gevolgd door een underscore gevolgd door de naam van de EV-contour gevolgd door een underscore en de dnkey van de EV-contour (tbmilopslagevcontour.dnkey). Dus zoiets als NL.IMEV.00002.OpslagMeststof_OpslagReferentie_PRContour_190.

De beginGeldigheid slaat hier op de begin geldigheid van de EV-contour. Een wijziging op beginGeldigheid wordt niet geaccepteerd indien de datum ExportNaarREV reeds is gevuld. Indien de EV-contour voor het eerst wordt geëxporteerd (met een POST, wanneer de exportdatum dus nog leeg is) moet de beginGeldigheid groter zijn dan de beginGeldigheid van de bovenliggende Referentiecontour. Bij een succesvol geaccepteerd wijzigingsbericht (een PUT, wanneer de exportdatum reeds gevuld is), waarbij een of meer wijzigingen op attributen worden doorgegeven, zal de beginGeldigheid automatisch met de datum van de export worden vervangen.

De eindGeldigheid slaat hier op de eindgeldigheid van de EV-contour. Een wijziging wordt alleen geaccepteerd bij een gevulde begingeldigheidsdatum. De eindGeldigheid moet groter zijn dan de beginGeldigheid. Een eindeGeldigheid mag niet in de toekomst liggen. Indien de datum ExportNaarREv is gevuld en de oude waarde van ddeindGeldiheid was ook gevuld met een waarde kleiner dan de exportdatum, dan wordt de wijziging niet geaccepteerd.

De datum laatst gewijzigd wordt automatisch gevuld met het moment, waarop een van de kolommen een nieuwe waarde krijgt.

De datum geëxporteerd naar REV (ddexportnaarREV) wordt automatisch gevuld op het moment dat een gehele set - dus: inrichting (locatie-EVactiviteit) met alle onderliggende objecten (EV-activiteiten, referentie- en EV-contouren) - succesvol is geëxporteerd naar het REV. Eenmaal geëxporteerd betekent dat de EV-contour ook bestaat in het REV. Dat kan alleen ongedaan worden gemaakt met een gevulde eindeGeldigheid die dan opnieuw geëxporteerd moet worden.

Het blok wordt verder aangevuld met de attributen overgenomen uit de definitietabel tbrevevcontour (zie hierboven) waarbij het vakje Overnemen aangevinkt is. Deze attributen (met uitzondering van afstand) moeten een gevulde waarde krijgen alvorens de EV-contour geëxporteerd kan worden. Het vraagtekenschermknopje toont de omschrijving van het attribuut zoals gedefinieerd in de definitietabel tbrevevcontour. Deze omschrijving heeft geen invloed op de export.

Het attribuut geometrie geeft aan welke type geometrie van toepassing is op de EV-contour (punt of vlak). Indien het attribuut afstand gevuld is, dan is het geotype per definitie Punt. Het betreffende punt waaraan de afstand gelieerd is dat van de bovenliggende referentiecontour!!!!

De puntcoördinaten in het blok Geometrie;punt Ref.Cont zijn hier niet muteerbaar en komen uit de bovenliggende referentiecontour.

Bij de export van de JSON naar REV redeneert OpenWave qua geometrie en afstand als volgt:

Onderaan de detailkaart is de knop Teken en vervang vlak op kaart zichtbaar (mits opslagrechten: tbmilrechten.dlcmilinropsedt).

TbMilBklKwetsbGebLoc (Kwetsbare gebouwen en locaties)

Hoewel er in het IMEV model geen relatie bestaat tussen een kwetsbaar gebouw/locatie en een locatie-EVactiviteit (inrichting) zijn deze in OpenWave wel toegankelijk gemaakt op het inrichtingsportaal via de tegel REV kwetsbare geb/locaties.

In OpenWave is een kwetsbaar gebouw/locatie vanuit beheer oogpunt dus gekoppeld aan een inrichting. Niet alle organisaties zullen kwetsbare gebouwen en locaties aanleveren aan het REV via OpenWave. De tegel is daarom onzichtbaar te maken door de instelling Sectie: REV en Item: Kwetsgebzichtbaar uit te vinken.

Het inzien, wijzigen en insert van gegevens is verder gekoppeld aan de SBI/MBA/BKL rechten bij een inrichting (tbmilrechten.dlcmilinrsbivsb).

Bij een inrichting kunnen meerdere kwetsbare gebouwen of locaties worden gedefinieerd op basis van definitietabel Kwetsbare gebouwen/locaties.

Het gebouw/locatie heeft op de detailpagina een aantal standaardkolommen + een aantal attributen (de attributen zijn voor locatie en gebouw verschillend).

Het blok Geometrie Vlak moet gevuld moet zijn: onderaan de detailpagina is hiertoe de knop Teken vlak op kaart zichtbaar.

De datum Datum laatste preview ok (ddrevpreviewok) wordt alleen gevuld indien de preview export JSON, die gestart wordt met de knop achter deze kolom, geen fouten heeft opgeleverd. Indien datum laatste wijziging kleiner is dan deze previewdatum, zou deze kwetsbare gebouw/locatie probleemloos geëxporteerd kunnen worden.

De REV identificatiecode van de kwetsbare gebouw/locatie wordt automatisch toegekend. De waarde wordt opgebouwd met de kolom Tekst van de instelling Sectie: Inrichtingen en Item: revnamespaceidentificatie gevolgd door een punt gevolgd door ofwel KwetsbaarGebouw dan wel KwetsbareLocatie gevolgd door een underscore gevolgd door de dnkey van de kaart in TbMilBklKwetsbGebLoc. Dus zoiets als NL.IMEV.00002.KwetsbareLocatie_5.

De beginGeldigheid slaat hier op de begin geldigheid van het gebouw of locatie. Een wijziging op beginGeldigheid wordt niet geaccepteerd indien de datum ExportNaarREV reeds is gevuld. Een beginGeldigheid mag niet in de toekomst liggen.

De eindGeldigheid slaat hier op de eindgeldigheid van het gebouw of locatie. Een wijziging wordt alleen geaccepteerd bij een gevulde begingeldigheidsdatum. De eindGeldigheid moet groter zijn dan de beginGeldigheid. Een eindeGeldigheid mag niet in de toekomst liggen. Indien de datum ExportNaarREv is gevuld en de oude waarde van ddeindGeldiheid was ook gevuld met een waarde kleiner dan de exportdatum, dan wordt de wijziging niet geaccepteerd.

De datum laatst gewijzigd wordt automatisch gevuld met het moment, waarop een van de kolommen van de kaart in TbMilBklKwetsbGebLoc een nieuwe waarde krijgt. De datum laatst gewijzigd is belangrijk voor de automatische geschedulede export naar het REV. De kwetsbare gebouwen en locaties worden opnieuw geëxporteerd indien deze datum groter is dan de datum exportnaarREV.

De datum geëxporteerd naar REV (ddexportnaarREV) wordt automatisch gevuld op het moment dat een kwetsbare gebouw/locatie - succesvol is geëxporteerd naar het REV. De geschedulede export naar REV (zie verderop) loopt alle kaarten in TbMilBklKwetsbGebLoc af waarvoor onder meer geldt dat de datum laatste wijziging set groter is dan deze datum geëxporteerd naar REV.

Eenmaal geëxporteerd betekent dat het gebouw/locatie ook bestaat in het REV. Dat kan alleen ongedaan worden gemaakt met een gevulde eindeGeldigheid die dan opnieuw geëxporteerd moet worden.

Met de schermknop preview export Json wordt een gebouw/locatie omgezet naar een JSON exportfile en aangeboden aan het REV ter validatie (validate only) zonder dat het REV de wijzigingen doorzet naar het register.

Algemeen Endpoint (kolom Tekst van Sectie: REV en Item: AlgemeenEndpoint) en Token Endpoint (kolom Tekst van Sectie: REV en Item: TokenEndpoint) en client_id (kolom Tekst van Sectie: REV en Item: Client_id) en client_secret (kolom Tekst van Sectie: REV en Item: Client_secret) en bronhouderscode dienen gevuld te zijn ( kolom Tekst van Sectie: REV en Item: Bronhouder. Deze gegevens worden door Rijkswaterstaat uitgegeven. Bij ontbreken komt een leeg scherm.

OpenWave controleert of (de gevuld aangeleverde) JSON-mallen (zie hierboven bij beheer) m.b.t. gebouw/locatie nog compleet gevuld zijn.

De preview controleert zoveel mogelijk op voorhand of het te exporteren gebouw/locatie aan alle voorwaarden voldoet. Bijv.

Indien een controle faalt wordt dit in tekst op scherm vertoont en gaat er geen bericht naar het REV.

Bij succes wordt de JSON file (van die ene kwetsbare gebouw/locatie) naar het REV geëxporteerd. Deze exportfile wordt in het scherm getoond alsmede het retourbericht van het REV.

Retourcode 200 of 201 betekent dat het bericht succesvol geaccepteerd is door de validatieprocedure van het REV. Bij succes wordt Datum laatste preview ok (ddrevpreviewok) op de gebouw/locatiekaart automatisch gevuld.

De schermknop Toon gegevens REV is alleen zichtbaar indien de datum geëxporteerd naar REV (ddexportnaarREV) gevuld is. Het kwetsbare gebouw/locatie zoals die geregistreerd staat in het REV wordt opgehaald en getoond (als JSON) op basis van de REV-identificatiecode.

In het blok Kenmerken zijn de attributen overgenomen uit de definitietabel Kwetsbare gebouwen/locaties (zie hierboven) waarbij het vakje Overnemen aangevinkt is. Deze attributen moeten een gevulde waarde krijgen alvorens het gebouw/locatie geëxporteerd kan worden. Het vraagtekenschermknopje toont de omschrijving van het attribuut zoals gedefinieerd in de definitietabel. Deze omschrijving heeft geen invloed op de export.

Het attribuut geometrie geeft aan welke type geometrie van toepassing is op het gebouw/locatie (multivlak of vlak). OpenWave ondersteunt voorlopig alleen Vlak.

Export naar REV

Algemeen Endpoint (kolom Tekst van Sectie: REV en Item: AlgemeenEndpoint) en Token Endpoint (kolom Tekst van Sectie: REV en Item: TokenEndpoint) en client_id (kolom Tekst van Sectie: REV en Item: Client_id) en client_secret (kolom Tekst van Sectie: REV en Item: Client_secret) en bronhouderscode dienen gevuld te zijn ( kolom Tekst van Sectie: REV en Item: Bronhouder. Deze gegevens worden door Rijkswaterstaat uitgegeven.

De export wordt gescheduled verzorgd door de Taskscheduler. In deze tabel (beheer: Service centrum-portaal, tegel: Taskscheduler) moet een kaart aangemaakt worden met als Action: ExportREV, aangevinkt, een geplande startdatum/tijd en bijvoorbeeld een ophoging van 1440 minuten (= dagelijks).

Wanneer de taak gaat draaien wordt eerst een kaart aangemaakt in tboperationslog met code = ExportREV en begintijd = timestamp en als medewerker het robotaccount dat geïnstalleerd is bij de implementatie van de cronjob (vaak TASKS).

De taskscheduler doet eerst een controle of de vorige uitvoer van ExportREV al is afgelopen. Dat is het geval indien Getal1 van de instelling Sectie: Operations en Item: ExportREV de waarde 0 heeft. Zo niet dan wordt de task afgesloten met status 2 (niet succesvol afgerond).

Indien de task ExportREV kan worden gestart wordt de status in de taskcheduler kaart op 1 gezet (ben bezig…) en krijgt Getal1 van de instelling Sectie: Operations en Item: ExportREV de waarde 1.

De taskscheduler voert de action ExportREV in twee loops uit:

Omdat voor elke wijziging altijd de gehele set vanaf de locatie-EVactiviteit moet worden aangeleverd is binnen de loop van inrichtingen een subloop EV-activiteiten: tbmilbklactiviteiten:

En binnen de loop van tbmilbklactiviteiten een subloop referentiecontouren: tbmilopslag:

En binnen de loop van tbmilopslag een subloop EV-contouren: tbmilopslagevcontour:

Bij elke te evalueren kaart wordt dezelfde controle uitgevoerd als plaatsvindt bij de hierboven beschreven preview-schermknop op de detailschermen inrichtingen en kwetsbare gebouwen/locaties. Indien probleem dan wordt dit in de operationslog gemeld en wordt de volgende kaart bekeken.

Indien de instelling Sectie: REV en Item: ExportTest NIET aangevinkt is dan

Exporttest aan of uit en succes of geen succes: elke kaart krijgt een evaluatie-regel in operationslog. Dus indien de instelling Sectie: REV, Item: ExportTest WEL aangevinkt is, wordt alleen de operationslog gevuld, en dus geen export naar REV en geen wijzigingen in de export- en geldigheidsdatums.

Zijn alle kaarten van beide loops doorlopen, dan wordt de status in de taskcheduler kaart op 0 gezet (succesvol uitgevoerd) en en krijgt Getal1 van de instelling Sectie: Operations, Item: ExportREV de waarde 0.