Verschillen
Dit geeft de verschillen weer tussen de geselecteerde revisie en de huidige revisie van de pagina.
Beide kanten vorige revisie Vorige revisie Volgende revisie | Vorige revisie | ||
openwave:1.32:applicatiebeheer:instellen_inrichten:register_exrterne_veiligheid [2024/11/26 06:07] – verwijderd - Externe bewerking (Ongeldige datum) 127.0.0.1 | openwave:1.32:applicatiebeheer:instellen_inrichten:register_exrterne_veiligheid [2025/04/24 16:22] (huidige) – Lonneke van Dijk | ||
---|---|---|---|
Regel 1: | Regel 1: | ||
+ | ======Register Externe Veiligheid====== | ||
+ | Vanuit OpenWave kunnen gegevens periodiek worden aangeleverd aan het Register Externe Veiligheid (REV). Daartoe is het Informatiemodel Externe Veiligheid (IMEV 2.0) ingepast in de OpenWave database met API-versie 4. | ||
+ | Op deze pagina staat beschreven wat er in het beheer in te stellen is, welke REV gegevens men bij inrichtingen/ | ||
+ | Zie voor synchronisatie van gegevens uit het REV naar OpenWave: [[openwave: | ||
+ | |||
+ | =====Beheer ==== | ||
+ | Aan de beheerkant van OpenWave is het IMEV zichtbaar in de volgende structuur: | ||
+ | |||
+ | {{: | ||
+ | |||
+ | Via beheerportaal // | ||
+ | |||
+ | De kardinaliteit is terug te zien in het aanvinkvakje // | ||
+ | |||
+ | ==== Definitietabel tbmilcodebkl ==== | ||
+ | Achter de tegel //REV BKL-activiteiten// | ||
+ | |||
+ | Met het __aanvinkvakje overnemen__ wordt geregeld dat wanneer de betreffende activiteit aan een inrichting wordt toegekend (in de tabel tbmilbklactiviteiten), | ||
+ | |||
+ | 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. | ||
+ | |||
+ | <adm warning> | ||
+ | De objectbenamingen, | ||
+ | </ | ||
+ | |||
+ | ==== 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), | ||
+ | |||
+ | 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. | ||
+ | |||
+ | <adm warning> | ||
+ | De objectbenamingen, | ||
+ | </ | ||
+ | |||
+ | ==== Koppeltabel activiteit/ | ||
+ | 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 // | ||
+ | |||
+ | ==== 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), | ||
+ | |||
+ | 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. | ||
+ | |||
+ | <adm warning> | ||
+ | De objectbenamingen, | ||
+ | </ | ||
+ | |||
+ | ==== Koppeltabel activiteit/ | ||
+ | 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 // | ||
+ | |||
+ | ====Waardelijsten ==== | ||
+ | |||
+ | De in te vullen attributen van de activiteiten, | ||
+ | |||
+ | <adm warning> | ||
+ | De waardelijstnamen en items-benamingen moeten exact zo zijn als in het IMEV-model zijn opgegeven. | ||
+ | </ | ||
+ | |||
+ | ==== Definitietabel Kwetsbare gebouwen/ | ||
+ | |||
+ | 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), | ||
+ | |||
+ | 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. | ||
+ | |||
+ | <adm warning> | ||
+ | De objectbenamingen, | ||
+ | </ | ||
+ | |||
+ | ====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: | ||
+ | |||
+ | 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) | ||
+ | * het attribuut // | ||
+ | * EN waarbij het attribuut //Inhoud// een waarde heeft tussen 5 en 13 | ||
+ | * EN waarbij attribuut // | ||
+ | * EN waarbij de referentiecontour Opslagreferentie is gekoppeld aan een EV-activiteit met definitie OpslagtankPropaanPropeen_VasteAfstandGeenVergunningplicht | ||
+ | * EN het attribuut // | ||
+ | DAN zal het gebruik van de wizardknop //Haal EV-contouren uit afstandentabel// | ||
+ | * een kaart met definitie PR-Contour met afstand 25 en typePlaatsgebondenRisico = Beperkt kwetsbaar en maatgevende stof/ | ||
+ | * een kaart met definitie PR-Contour met afstand 25 en typePlaatsgebondenRisico = Kwetsbaar en maatgevende stof/ | ||
+ | * een kaart met definitie PR-Contour met afstand 50 en typePlaatsgebondenRisico = Zeer Kwetsbaar en maatgevende stof/ | ||
+ | * een kaart met definitie Brandaandachtsgebied met afstand 20 en typeBrand = fakkelbrand en maatgevende stof/ | ||
+ | |||
+ | Voor alle aangemaakte EV-contour-kaarten geldt bovendien dat de beginGeldigheid als waarde datum van vandaag krijgt. | ||
+ | |||
+ | |||
+ | =====Activiteiten, | ||
+ | |||
+ | {{: | ||
+ | |||
+ | 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: | ||
+ | * LocatieActiviteit (locatie van een bedrijf waar de activiteit met externe veiligheidsrisico’s wordt verricht) waarbij | ||
+ | * het blok //Polygoon of Lijn// gevuld moet zijn met een polygoon dat aangeeft op welke grondgebied de EV-activiteiten plaatsvinden. | ||
+ | * Wegen (geheel van locaties voor het vervoer van gevaarlijke stoffen over de weg) waarbij | ||
+ | * het blok //Polygoon of Lijn// gevuld moet zijn met een lijn of Multilijn | ||
+ | * de kolom //Traject vervoer gev. stof (route)// gevuld moet worden. | ||
+ | * LocatieBasisnet (geheel van locaties voor het vervoer van gevaarlijke stoffen over het basisnet) waarbij | ||
+ | * het blok //Polygoon of Lijn// gevuld moet zijn met een lijn of Multilijn | ||
+ | * de kolom //Traject vervoer gev. stof (route)// gevuld moet worden | ||
+ | * de kolom //Type vervoer// gevuld moet worden. | ||
+ | * BuisleidingStelsel (een stelsel van meerdere Buisleidingen) | ||
+ | * waarbij de inhoud van het blok //Polygoon of Vlak// niet van toepassing is | ||
+ | * de kolom // | ||
+ | |||
+ | 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, | ||
+ | |||
+ | 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/ | ||
+ | |||
+ | 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// | ||
+ | |||
+ | Alleen indien de datum ExportnaarREV nog leeg is EN de inlogger het recht //Wijzigen van REV-identificatiecode van tbmilinrichtingen// | ||
+ | |||
+ | 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 [[openwave: | ||
+ | | ||
+ | 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, | ||
+ | |||
+ | De **datum laatst gewijzigd** wordt automatisch gevuld met het moment, waarop een van de volgende inrichtingskolommen een nieuwe waarde krijgt: polygoon, kvknr, handelsnaam, | ||
+ | |||
+ | 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, | ||
+ | |||
+ | 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, | ||
+ | |||
+ | Algemeen Endpoint (kolom //Tekst// van //Sectie: REV en Item: AlgemeenEndpoint// | ||
+ | |||
+ | 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. | ||
+ | * Bij een inrichting moet minimaal één geldige EV-activiteit gedefinieerd zijn, en per activiteit minimaal één geldige referentiecontour en bij de referentiecontouren minimaal één geldige EV-contour gedefinieerd zijn. | ||
+ | * De objecten moeten voldoen aan alle regels met betrekking tot de begin- en eindGeldigheid. | ||
+ | * De datum laatst gewijzigd moet groter zijn dan de datum geëxporteerd naar REV. | ||
+ | * Alle objecten moeten een gevulde identificatiecode hebben. | ||
+ | * De attributen bij elk object moeten alle een gevulde waarde hebben. | ||
+ | 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 // | ||
+ | |||
+ | De **locatieomschrijving** wordt doorgegeven aan het REV in de JSON-tag // | ||
+ | |||
+ | De **BAG-nummerid** (in IMEV: idNummeraanduidingBAGExploitant) kan gevuld worden met de BAG nummeraanduiding-identifier van de locatie van de exploitant. Indien niet gevuld wordt hiervoor de BAG-nummeraanduiding van het perceeladres van de inrichting gebruikt. Een gevuld waarde in één van de twee is verplicht. | ||
+ | |||
+ | Indien de BAG-nummeraanduiding (// | ||
+ | |||
+ | ==== TbMilBklActiviteiten (EV-activiteiten)==== | ||
+ | Te benaderen via de tegel //REV BKL-activiteiten// | ||
+ | |||
+ | 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// | ||
+ | |||
+ | 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, | ||
+ | |||
+ | 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, | ||
+ | |||
+ | 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, | ||
+ | |||
+ | De kolom **vergunningplicht** heeft default de waarde (F)alse. | ||
+ | |||
+ | De kolommen **vergunningsnummer, | ||
+ | |||
+ | 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 // | ||
+ | |||
+ | Onderaan in het detailscherm van de activiteit is in het blok // | ||
+ | |||
+ | ==== 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// | ||
+ | |||
+ | 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 // | ||
+ | |||
+ | 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// | ||
+ | |||
+ | 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// | ||
+ | |||
+ | De **identificatiecode** wordt automatisch toegekend. De waarde wordt opgebouwd met de kolom //Tekst// van de instelling //Sectie: Inrichtingen// | ||
+ | |||
+ | 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. | ||
+ | | ||
+ | |||
+ | 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, | ||
+ | |||
+ | 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, | ||
+ | |||
+ | 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, | ||
+ | |||
+ | Het **blok wordt verder aangevuld met de attributen** overgenomen uit de definitietabel tbrevrefcontour (zie hierboven) waarbij het vakje // | ||
+ | |||
+ | 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// | ||
+ | |||
+ | ==== TbMilOpslagEvContour (EV-contouren)==== | ||
+ | Rechten: opslagrechten: | ||
+ | |||
+ | 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// | ||
+ | * Met de insertknop kan een keuze voor een EV-contour gemaakt worden op basis van de // | ||
+ | * Met de wizardknop //Haal EvContouren uit de afstandentabel// | ||
+ | |||
+ | Het blok //Kenmerken EV-contour// | ||
+ | |||
+ | De **identificatiecode** wordt automatisch toegekend. De waarde wordt opgebouwd met de kolom //Tekst// van de instelling //Sectie: Inrichtingen// | ||
+ | |||
+ | 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, | ||
+ | |||
+ | 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, | ||
+ | |||
+ | 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, | ||
+ | |||
+ | Het **blok wordt verder aangevuld met de attributen** overgenomen uit de definitietabel tbrevevcontour (zie hierboven) waarbij het vakje // | ||
+ | |||
+ | 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 // | ||
+ | |||
+ | Bij de export van de JSON naar REV redeneert OpenWave qua geometrie en **afstand** als volgt: | ||
+ | * Indien attribuut afstand is gevuld, dan wordt deze afstand doorgegeven met als referentiepunt het Punt van de bovenliggende referentiecontour. | ||
+ | * Indien afstand niet gevuld, dan wordt het polygoon van de EV-contourkaart doorgegeven. | ||
+ | |||
+ | Onderaan de detailkaart is de knop //Teken en vervang vlak op kaart// zichtbaar (mits opslagrechten: | ||
+ | |||
+ | ==== TbMilBklKwetsbGebLoc (Kwetsbare gebouwen en locaties)==== | ||
+ | Hoewel er in het IMEV model geen relatie bestaat tussen een kwetsbaar gebouw/ | ||
+ | |||
+ | In OpenWave is een kwetsbaar gebouw/ | ||
+ | |||
+ | 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 // | ||
+ | |||
+ | Het gebouw/ | ||
+ | |||
+ | 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, | ||
+ | |||
+ | De REV **identificatiecode** van de kwetsbare gebouw/ | ||
+ | | ||
+ | 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, | ||
+ | |||
+ | 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/ | ||
+ | |||
+ | Eenmaal geëxporteerd betekent dat het gebouw/ | ||
+ | |||
+ | Met de schermknop **preview export Json** wordt een gebouw/ | ||
+ | |||
+ | Algemeen Endpoint (kolom //Tekst// van //Sectie: REV// en //Item: AlgemeenEndpoint// | ||
+ | |||
+ | OpenWave controleert of (de gevuld aangeleverde) JSON-mallen (zie hierboven bij beheer) m.b.t. gebouw/ | ||
+ | |||
+ | De preview controleert zoveel mogelijk op voorhand of het te exporteren gebouw/ | ||
+ | * De objecten moeten voldoen aan alle regels met betrekking tot de begin- en eindGeldigheid. | ||
+ | * De datum laatst gewijzigd moet groter zijn dan de datum geëxporteerd naar REV. | ||
+ | * Alle objecten moeten een gevulde identificatiecode hebben. | ||
+ | * De attributen bij elk object moeten alle een gevulde waarde hebben. | ||
+ | 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/ | ||
+ | |||
+ | 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/ | ||
+ | |||
+ | De schermknop **Toon gegevens REV** is alleen zichtbaar indien de datum // | ||
+ | |||
+ | In het blok **Kenmerken** zijn de attributen overgenomen uit de definitietabel Kwetsbare gebouwen/ | ||
+ | |||
+ | Het attribuut // | ||
+ | |||
+ | =====Export naar REV ==== | ||
+ | Voor het kunnen exporteren naar het REV dienen de volgende gegevens gevuld te zijn: | ||
+ | * Algemeen Endpoint (kolom //Tekst// van //Sectie: REV// en //Item: AlgemeenEndpoint// | ||
+ | * Token Endpoint (kolom //Tekst// van //Sectie: REV// en //Item: TokenEndpoint// | ||
+ | * client_id (kolom //Tekst// van //Sectie: REV// en //Item: Client_id)// | ||
+ | * client_secret (kolom //Tekst// van //Sectie: REV// en //Item: Client_secret// | ||
+ | * bronhouderscode (kolom //Tekst// van //Sectie: REV// en //Item: Bronhouder// | ||
+ | |||
+ | De export wordt gescheduled verzorgd door de [[openwave: | ||
+ | |||
+ | 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// | ||
+ | |||
+ | 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// | ||
+ | |||
+ | De taskscheduler voert de action ExportREV in twee loops uit: | ||
+ | * Loop **Kwetsbare gebouwen en locaties**: de rijen uit tbmilbklkwetsbgebloc waarvoor geldt: | ||
+ | * ddBeginGeldigheid niet leeg en kleiner dan vandaag | ||
+ | * EN ddexportnaarREV is leeg OF dddatumlaatstewijziging groter dan ddexportnaarrev | ||
+ | * EN ddeindGeldigheid is leeg of ddeindGeldigheid groter dan ddexportnaarrev | ||
+ | * Loop **Locatie-EVactiviteiten**: | ||
+ | * Ddbegingeldigheid is niet leeg en kleiner dan vandaag | ||
+ | * EN ddeindGeldigheid is leeg of ddeindGeldigheid groter dan ddexportnaarrev | ||
+ | * EN ddexportnaarrev is leeg OF vwfrmmilinrichtingen.ddmaxsetlaatstgewijzigd groter dan ddexportnaarrev | ||
+ | * EN dvlocatieevactiviteit is niet leeg | ||
+ | * EN de kolom **Klaargezet voor Export** (ddmagexport) moet gevuld zijn (zie hierboven). | ||
+ | |||
+ | 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: | ||
+ | * ddBeginGeldigheid niet leeg en kleiner of gelijk aan vandaag | ||
+ | * EN ddeindGeldigheid is null of ddeindGeldigheid groter dan ddexportnaarrev | ||
+ | * EN de activiteitnaam is ongelijk aan // | ||
+ | |||
+ | En binnen de loop van tbmilbklactiviteiten een subloop referentiecontouren: | ||
+ | * ddBeginGeldigheid niet leeg en kleiner of gelijk aan vandaag | ||
+ | * EN ddeindGeldigheid is null of ddeindGeldigheid groter dan ddexportnaarrev | ||
+ | |||
+ | En binnen de loop van tbmilopslag een subloop EV-contouren: | ||
+ | * ddBeginGeldigheid niet leeg en kleiner of gelijk aan vandaag | ||
+ | * EN ddeindGeldigheid is null of ddeindGeldigheid groter dan ddexportnaarrev | ||
+ | |||
+ | Bij elke te evalueren kaart wordt dezelfde controle uitgevoerd als plaatsvindt bij de hierboven beschreven preview-schermknop op de detailschermen inrichtingen en kwetsbare gebouwen/ | ||
+ | |||
+ | Indien de instelling //Sectie: REV en Item: ExportTest// | ||
+ | * wordt elke kaart die voldoet aan de criteria omgezet in een JSON-file (bij inrichtingen gaat het dus steeds om de hele set inrichting + bijbehorende activiteiten + referentie en EV-contouren) en geëxporteerd naar het endpoint. Een nieuwe set met een POST bericht, wijzigingen op een bestaande set met een PUT bericht | ||
+ | * Indien //Sectie: OWB, Item: MessageLog// | ||
+ | * Indien succesvol opgenomen in REV (resultcode 200 of 201) dan worden van de betreffende kaarten in OpenWave | ||
+ | * de datum exportnaarREV gevuld met timestamp | ||
+ | * de beginGeldigheid van alle gewijzigde objecten (alle kaarten waarvan de ddlaastgewijzigd groter is dan de (vorige) exportnaarrevdatum) op vandaag gezet. | ||
+ | |||
+ | 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// | ||
+ | |||
+ | 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. | ||
+ | |||
+ | {{tag> |