Skip to content

Mutaties laden in de BRMO

Matthijs Laan edited this page Jun 6, 2016 · 9 revisions

Het laden van mutaties gebeurt meestal via een automatisch proces. Elke nacht wordt contact gelegd met de landelijke voorziening en de nieuwste mutaties worden opgehaald. Ook kan een ESB automatisch berichten aan de BRMO toevoegen. Het is belangrijk om dit proces te monitoren. De BRMO heeft een voorziening waarmee de beheerder een email krijgt indien er iets fout gaat. Als dit proces lang onbewaakt blijft dan kunnen vele duizenden berichten zich ophopen in de pipeline, waardoor de actualiteit van de database in het geding komt.

![Laadproces-pagina](https://github.com/B3Partners/brmo/blob/master/docs/images/brmo overzicht laadprocessen.PNG)

Elke mutatielevering bestaat meestal uit één enkele mutatie, waardoor er precies evenveel laadprocessen ontstaan als berichten. Nu wordt via de laadproces-pagina de status van de laadprocessen gecontroleerd. Dit kan door te filteren op die status, als er geen resultaten zijn is het goed. Als hier een status STAGING_NOK voorkomt dan is minimaal een mutatiebericht uit het mutatiebestand niet geladen. Dit is uitzonderlijk en kan bijvoorbeeld optreden als de tablespace onvoldoende is of indien de landelijke voorziening een corrupt bericht heeft afgeleverd. De logfiles zullen moeten worden geraadpleegd. Vervolgens wordt gecontroleerd de berichten goed zijn geladen. Hiertoe wordt op de berichten-pagina gecontroleerd of er geen berichten zijn met de status STAGING_NOK. Dit kan door te filteren op die status, als er geen resultaten zijn is het goed.

![Bericht-pagina met log](https://github.com/B3Partners/brmo/blob/master/docs/images/brmo overzicht berichten plus log.PNG)

Voor het laden van de mutaties worden de knoppen "Selectie transformeren naar RSGB" op de laadprocessen-pagina en op de berichten-pagina gebruikt. Er worden dan extra sorteringen en controles uitgevoerd die nodig zijn voor het verwerken van de mutaties in de juiste volgorde. Als bij de transformatie van een mutatie een fout (status = 'RSGB_NOK') optreedt, dan stopt het transformatieproces (nieuw sinds 1.3).

![Knoppen Berichtenpagina](https://github.com/B3Partners/brmo/blob/master/docs/images/Knoppen Berichtenpagina Mutaties.PNG)

Als berichten de status RSGB_NOK hebben dan dient het lograpport van het bericht beoordeeld te worden. Er kan dan vastgesteld worden wat het probleem is en mogelijk kan dit opgelost worden. Het is mogelijk om op de berichten-pagina een het bericht nogmaals te transformeren dan dient hij de status op 'RSGB_WAITING' te zetten. Daarna kan het proces weer herstart worden. Indien een fout onduidelijk is, dan kan het beste contact opgenomen worden met B3Partners. Het is van het grootste belang niet verder te gaan met het laden van mutaties voordat is vastgesteld dat de fout geen invloed heeft op de kwaliteit van de data.

Als een proces is afgebroken dan is het waarschijnlijk dat een aantal berichten met de status RSGB_WAITING en/of RSGB_PROCESSING zijn achtergebleven. Dit kan gecontroleerd worden via de berichten-pagina en dan te filteren op die statussen. Op die pagina staat de knop "WAITING-berichten nogmaals transformeren naar RSGB". Via het klikken op de knop kan het proces weer worden herstart. Indien meerdere processen tegelijkertijd waren gestart kan het mogelijk zijn om deze knop meerdere keren te gebruiken, wel graag wachten tot het vorige proces is afgerond.

Let op: Zolang er berichten met de status RSGB_WAITING en/of RSGB_PROCESSING bestaan kan geen nieuw 'normaal' transformatieproces gestart worden.

Uiteindelijk dienen alle berichten de status RSGB_OK te hebben.

Clone this wiki locally