BoToVa - Toetsing en Validatie Service

Transcriptie

1 BoToVa - Toetsing en Validatie Service Technische Ontwerp - Concept Versie september 2012 I.T. Works BV Opdrachtgever: I.T. Works Paardenmark 1C Auteur: Robin Huisman 2611 PA Delft Datum: 18 september 2012 Nederland Versie: 1.1 Tel. +31-(0) Concept/Definitief Fax. +31-(0)

2 Inhoudsopgave Inhoud Inhoudsopgave...2 Inleiding...3 Versie...3 Begrippenlijst Functionele beschrijving voor de BoToVa Technische Architectuur Gewenste lagen architectuur BusinessEntities Klassediagram ExchangeEntities ToetsingEntities DatabaseEntities Check Autorisatie Uitvoeren van toetsingen Berichten verkeer BoToVa Algemene denkwijze Uitwerking in IM0101 Informatie model Uitwerking in IM0101 Product model Codelijsten Toetsingen Toetsregels ToetsnormParameters Parameters en resultaten per toetsregel Logging I.T. Works 2 18 september 2012

3 Inleiding Ter voorbereiding aan de bouw van BoToVa is er een technisch ontwerp gemaakt. Het ontwerp heeft tot doel de risico s tijdens de realisatie van de service uit te sluiten. Dit document gaat in op de volgende onderwerpen: Het functioneel ontwerp voor BoToVa wordt met name bepaald door de rekenregels in de vorm van stroomdiagrammen. Zie document Toetsingsregels Bodem van de rekenmeesters. Het functioneel ontwerp is daarmee vrij ver technisch uitgewerkt en kan daarmee 1 op 1 worden overgenomen in het Technisch ontwerp. Voor de duidelijkheid worden enkele aspecten uit de rekenregels expliciet uitgelicht in het hoofdstuk Functionele beschrijving. Technische architectuur van de service. In een aantal stappen worden de verschillende componenten van de service toegelicht Belangrijk voor de systemen die gebruik gaan maken van de service vormt het berichtenverkeer. Na een globale toelichting wordt de koppeling getoond met het op dit moment in ontwikkeling zijnde IMSIKB0101. Vervolgens wordt aan de hand van de opgestelde rekenregels een voorbeeld weergegeven van het berichtenverkeer. Het document sluit af met de performance en stresstest. Versie Versie Datum Door Opmerking RHU Opzetten eerste versie, belangrijkste van dit document wordt het bepalen van het berichtenverkeer RHU Commentaar in Workshop PSL verwerkt en rekenregels bekeken met Aad Windmeijer voor het berichten verkeer LSC Toevoegen van Performance en Stresstest gegevens RHU Toevoegen van nieuwe bevindingen na bestuderen van Rekenregels RHU Verwerken van nieuwe inzichten mbt de rekenregels RHU Nieuw inzichten na overleg met Hinne en Etta RHU Opmerkingen Etta bij Technisch ontwerp en opmerkingen IHW verwerkt RHU Toevoegen van specificaties die voortkomen uit het SIKB PSL overleg. I.T. Works 3 18 september 2012

4 Begrippenlijst Toetskader Een Toetskader is de wettelijke regeling. Een Toetskader bestaat vaak uit meerdere toetsingen voor verschillende toepassingen. (Voorbeelden: WBB Wet Bodem Bescherming, BBK Besluit Bodem Kwaliteit) Toetsing Een toetsing is hetgeen wat de gebruikers van BoToVa kunnen aanroepen. In de wet staan enkele toetsingen binnen bepaalde Toetskaders, deze zijn opgesplitst in meerdere rekenregels. De uitkomst van de toetsing geeft een oordeel over de kwaliteit van een of meerdere monsters. (Voorbeelden: WBB grond, WBB Grondwater, WBB Diep grondwater) Rekenregel Een rekenregel is een stroomschema van de rekenmeesters en kan ook Toetsregel genoemd worden. De rekenmeesters hebben de toetsingen uit elkaar gehaald en alle stappen in een stroomschema verwerkt. Enkele stappen komen voor in meerdere toetsingen en door het splitsen in rekenregels kunnen deze in meerdere toetsingen gebruikt worden. (Voorbeelden: Somparameters berekenen, Vaststelling Organische stof en Lutum) I.T. Works 4 18 september 2012

5 1. Functionele beschrijving voor de BoToVa In dit hoofdstuk wordt beschreven wat de specificaties zijn en hoe dit vertaald wordt naar het gedrag van BoToVa. Alle specificaties worden in dit hoofdstuk per paragraaf beschreven en uitgelegd. Voor de inleiding staat hier een kort overzicht van de belangrijkste specificaties: - Som parameters altijd berekenen. - Meerdere monster omrekenen naar één monster met gemiddelden. - Per toetsing een aanroep doen. - Een toetsing moet tijdelijk uitgezet kunnen worden met een melding waarom. - De meetwaarde corrigeren i.p.v. de norm. - Gebruikersnaam en wachtwoord controle waarbij ook gebruikers op niet actief gezet kunnen worden. - Log van de toetsing terugkoppelen naar gebruiker, wat ging goed, wat ging niet goed. - Gebruikersnamen worden uitgedeeld op bedrijfsniveau of op systeem niveau. Som parameters altijd berekenen Wanneer de stoffen aangeleverd worden in de aanroep, dan kunnen hier ook somparameters tussen zitten die foutief berekend zijn. Om er zeker van de te zijn dat de output correct is, worden alle somparameters opnieuw berekend. Dit zorgt ervoor dat de somparameters altijd correct getoetst worden omdat deze goed zijn berekend uit de aangeleverd individuele parameters. Aangeleverde somparameters worden nooit gebruikt. Meerdere monster omrekenen naar één monster met gemiddelden Wanneer in de aanroep naar de webservice meerdere monsters zitten, dan worden deze niet alleen apart getoetst, maar ook beschouwd als een toetsmonster. Daarbij wordt een extra monster gecreëerd en worden de stoffen van de verschillende monsters gemiddeld en daarna als één monster behandeld. Het resultaat van de toetsing bevat dan naast de toetsoordelen van de individuele monsters ook een extra monster met toetsoordelen. Verwijzingen naar de originele monsters wordt bijgehouden. Er is veel vraag naar een Batch mogelijkheid, maar om Load Balancing goed te regelen is dit niet gewenst. Maximaal aantal monsters voor middeling Het moet mogelijk zijn 1000 monster als een toetsmonster aan te kunnen leveren. Dus 1000 emmertjes toetsen en middelen, daarna nogmaals als één toetsmonster toetsen. Per Toetsing een aanroep doen Het kan wenselijk zijn dat bijvoorbeeld een gebruiker een monster aan zowel WBB Grondwater als WBB Diep Grondwater getoetst wil hebben. In zo n geval zal de gebruiker twee keer de webservice moeten aanroepen, één keer voor grondwater en één keer voor grondwater diep. BoToVa voert dus maar één toetsing per keer uit. Per Toetsing en versie een toetsing uit kunnen zetten I.T. Works 5 18 september 2012

6 Het kan voorkomen dat een bepaalde toetsing aangepast moet worden of niet meer gebruikt mag worden. Dan moet deze uitgezet kunnen worden. Dit moet per toetsing en versie nummer kunnen. Dit betekend dat ook alleen een oudere versie van een toetsing uitgezet moet kunnen worden, terwijl de nieuwste gewoon gebruikt kan worden. Indien een bepaalde toetsing uit staat maar wel aangevraagd wordt, dan wordt er een reden teruggegeven waarom deze toetsing niet actief is. Aanroep via SOAP uitwisselobjecten met daarin SIKB-xml of Aquo-xml Een aanvraag naar de webservice verloopt via SOAP waarin enkele uitwisselobjecten zijn gedefinieerd. In deze uitwisselobjecten wordt SIKB- of Aquo-xml meegegeven. Deze standaarden worden later nog verder gespecificeerd. Dit wordt een gezamenlijk formaat IM0101. Resultaten via SOAP uitwisselobjecten met daarin SIKB-xml of Aquo-xml De resultaten van de toetsing via SOAP waarin enkele uitwisselobjecten zijn gedefinieerd. In deze uitwisselobjecten wordt SIKB- of Aquo-xml teruggegeven, afhankelijk van de aanroep. Dit wordt een gezamenlijk formaat IM0101. De meetwaarde corrigeren i.p.v. de norm Tot nu toe was het altijd gebruikelijk in de droge bodemwereld dat de meetwaarde niet werd gecorrigeerd, maar de norm. Dit gaat veranderen. BoToVa zal de meetwaardes corrigeren en deze teruggeven aan de gebruikers. Zie verder de documenten van de rekenmeesters, hierin staan alle gevallen exact beschreven. Significantie en afronding In de BoToVa webservice wordt niet afgerond en geen rekening gehouden met significantie. Alle berekende waardes worden onafgerond teruggestuurd naar de gebruiker. Als decimaalteken moet een. gehanteerd worden. Versiebeheer in toetsregels - X wijziging (toetsregel wijziging) Alle versies van een Toetsing moeten beschikbaar blijven daarom moet er versiebeheer op de Toetsregels plaatsvinden. Per versie wordt een stuk sourcecode onderhouden. Zodra er een nieuw versie van de Toetsregels uitkomt, dan wordt er een kopie gemaakt van de sourcecode. In de kopie worden de aanpassingen op de Toetsregels verwerkt en het versienummer opgehoogd. Alle Toetsingen waarin deze Toetsregel gebruikt wordt moet opgehoogd worden met een gelijksoortige ophoging. Dit wordt gezien als een X-wijziging, dit is wettelijk bepaald en dus een volledig nieuwe versie. (Bijv.: versie 2.1.2; X.Y.Z) Versiebeheer van toetsregels Y wijziging (norm wijziging) Indien er nieuwe normen zijn of een correctie uitgevoerd dient te worden in de normen, dan wordt dit gezien als een Y wijziging. Een Toetsregel sourcecode wordt gekopieerd en een nieuw versienummer I.T. Works 6 18 september 2012

7 aan gegeven. In de database wordt een nieuwe norm toegevoegd. De koppeling van de oude versie worden gekopieerd en nieuwe gewijzigde norm wordt ontkoppeld en vervangen door de nieuwe norm. Hierdoor blijft heel duidelijk zichtbaar waar de wijzigingen in de historie plaats gevonden hebben. Alle Toetsingen waarin deze Toetsregel gebruikt wordt moet opgehoogd worden met een gelijksoortige ophoging. (Bijv.: versie 2.2.0; X.Y.Z) Versiebeheer van toetsregels Z wijziging (toetsregel bugfix) Het kan gebeuren, ook al wordt er goed getest, dat er in de productieversie van een toetsregel een fout zit. Dit moet per direct gecorrigeerd worden, maar dit gebeurd alleen in een nieuwe versie. Dus zonder terugwerkende kracht! Dit wordt gezien als een Z wijziging. De foutieve versie kan eventueel uitgezet worden. Een kopie van de sourcecode van Toetsregel wordt gemaakt en in het gekopieerde stuk wordt de bug opgelost. Uiteraard worden hier dan ook de normen weer aan gekoppeld. Alle Toetsingen waarin deze Toetsregel gebruikt wordt moet opgehoogd worden met een gelijksoortige ophoging. Versiebeheer van BoToVa Webservice X wijziging (webservice uitbreiding) Het versiebeheer van de Webserice zelf, dus ongeacht welke Toetsing versies en Toetsregel versies er zijn, moet ook geregeld worden. Een X wijziging zal een uitbreiding van de webservice betekenen, mogelijk veranderd hierdoor de aanroep van de webservice. Hiervan moeten aansluitende applicaties op de hoogte zijn. (Bijv.: versie 4.0.0; X.Y.Z) Versiebeheer van BoToVa Webservice Y wijziging (IM0101 wijziging) Zodra een nieuwe versie van IM0101 uitkomt, zal ook de webservice hiervoor aangepast moeten worden om dit te ondersteunen. Dit zal resulteren in een Y wijziging. (Bijv.: versie 4.2.0; X.Y.Z) Versiebeheer van BoToVa Webservice Z wijziging (webservice bugfix) Er kunnen situaties zijn waarbij blijkt dat er een bug in de webservice zit, anders dan in de Toetsing of Toetsregels. Zodra een nieuwe versie wordt gemaakt i.v.m. een oplossing van een bug in het algemene deel van de webservice, wordt dit gezien als een Z wijziging. (Bijv.: versie 4.0.0; X.Y.Z) Gebruikersnaam en wachtwoord controle Het aanroepen BoToVa mag niet door iedereen zomaar gebeuren dus moet er een gebruikersnaam en wachtwoord bij de aanroep meegestuurd worden. De gebruikersnaam en wachtwoord kan door een beheerder worden toegevoegd. Een systeemleverancier vraagt dit aan. Deze mag zelf beslissen of één gebruiker gebruikt wordt voor het hele systeem, of dat een gebruiker wordt aangevraagd per bedrijf. I.T. Works 7 18 september 2012

8 Een gebruiker moet ook tijdelijk uitgeschakeld kunnen worden. Log van de toetsing terugkoppelen naar gebruiker Bij het toetsen kan er een keer iets mis gaan. Hiervan moet de gebruiker op de hoogte gesteld worden. Maar het is ook zeker interessant om te weten wat er wel goed ging en BoToVa allemaal voor de gebruiker gedaan heeft. Er wordt dus bij een antwoord van de webservice naar de gebruiker een log meegestuurd met daarin wat wel en niet goed is gegaan. Daarin nemen we ook op wat de tijdsduur is geweest op de server voor het toetsen van het monster. De Log kan teruggestuurd worden in XML of HTML. Als voorbeeld wordt de Log van Towabo gehanteerd, elke actie van een toetsregel wordt hierin beschreven. Terugkoppelen belangrijke meldingen Bij het toetsen volgens de stroomschema s moeten er ook in bepaalde situaties melding teruggekoppeld worden. Deze moeten gekoppeld worden aan de Analyse of eventueel het Toetsoordeel, omdat ze betrekking hebben op de uitslag van de toetsing. In IM0101 worden velden toegevoegd om meldingen van de BoToVa in kwijt te kunnen. Bijhouden van activiteiten op de webservice BoToVa moet voor zichzelf bijhouden welke gebruikers een Toetsing aanroepen en natuurlijk ook welke Toetsing. Hieruit kunnen statistieken gehaald worden als er problemen zijn. De webservice moet dus bij een aanvraag noteren welke toetsing en welke gebruiker iets uitvoer, hieruit kunnen aantallen gehaald worden. Uiteraard moeten foutmeldingen van de webservice ook bijgehouden worden. Via een website bepaalde toetsingen uitzetten Eerder in de specificaties staat dat een bepaalde Toetsing uitgezet moet kunnen worden, deze specificatie geeft de manier waarop dit moet gebeuren. Een beheerder moet een bepaalde versie van een Toetsing tijdelijk kunnen uitzetten via een website. Hierop moet de beheerder uiteraard eerst inloggen. Tevens moet bij het uitzetten ook een reden opgegeven worden. Nieuwe gebruikers kunnen zich registreren Nieuwe gebruikers kunnen zich registreren via een website. Hierna hebben zij direct toegang tot het aanroepen van de Toetsingen. Via een website nieuwe gebruikers aanmaken en verder beheren De gebruikers moeten ook via een website door de beheerder aangemaakt, gewijzigd, verwijderd en inactief gemaakt kunnen worden. De functionele beveiliging wordt via rollen afgedwongen I.T. Works 8 18 september 2012

9 Het moet mogelijk zijn dat bepaalde gebruikers extra rechten krijgen, dit kan worden afgedwongen via rollen. Het idee is om twee rollen toe te kennen: Applicatiebeheerder; mag gebruikers aanmaken, wijzigen en Toetsingen aan- of uitzetten. Gebruiker; mag een Toetsing uitvoeren. De webservice kan alleen worden aangeroepen via HTTPS/SSL De technische beveiliging wordt nog verder afgestemd met de beherende partij. Maar als uitgangpunt zal wel alleen HTTPS/SSL ondersteund worden. Dit zorgt ervoor dat het verkeer van en naar de webservice in ieder geval gecodeerd is en niet zomaar af te luisteren. De webservice moet gebruik maken van een MySQL Database Er is besloten om gebruik te maken van een MySQL database om de normen in op te slaan. Openbare publiceren van gegevens De BoToVa geeft bepaalde informatie ook openbaar zichtbaar, namelijk: - De Toetsregels moeten te downloaden zijn als originele stroomschema van de rekenmeesters, - statistieken mogen openbaar maar zonder bedrijfsgegevens. De status van de BoToVa. Bij een wijziging in de BoToVa of het uitzetten van een Toetsing moet de status openbaar op te vragen zijn en gecommuniceerd worden. Dit moet gaan via een RSS-feed en via een notificatie naar alle gebruikers, hierin is de status wijziging beschreven. Aansluitende externe applicaties De BoToVa krijgt geen eigen interface om monsters te sturen en/of te selecteren. Alle applicaties die willen aansluiten aan de BoToVa zorgen voor een interface om monsters te selecteren en eventueel toetsmonsters samen te stellen. Het rekenwerk zal door de BoToVa uitgevoerd worden. Normen downloaden Eerder werd gesteld dat bij de BoToVa ook normen gedownload kunnen worden, dit gaat de BoToVa niet doen. Alle normen staan in Bijlagen, deze kunnen op een nader te bepalen overheidswebsite opgevraagd worden als officiële documenten. Wel worden de normen waaraan getoetst is teruggekoppeld bij een toetsoordeel. Testen De BoToVa-service wordt gevalideerd aan de testscripts, die gemaakt worden t.b.v. de Blackbox-test. De testscripts worden opgesteld door het testteam. I.T. Works 9 18 september 2012

10 Organische stof en Lutum Deze kunnen op twee manieren aangeleverd worden aan de BoToVa. Niet altijd worden Organische stof en Lutum geanalyseerd in het lab en dus niet altijd als analyseresultaat beschikbaar. Een gebruiker zou het om die reden dus handmatig willen instellen. Hiervoor komt de mogelijkheid om deze als Toetsinstelling mee te geven bij toetsen. Indien de waardes meegegeven worden, worden de meegegeven waardes gehanteerd. Worden ze niet meegegeven, dan wordt in de lijst met analyseresultaten gezocht naar de waardes. I.T. Works september 2012

11 2. Technische Architectuur Gewenste lagen architectuur BoToVa (Common Helpers) Hierin komen enkele globale Helpers die uitbreidingen zijn op.net klassen. BusinessEntities Hierin komen alle uitwisselobjecten en dataklassen voor van en naar de database. BusinessLayer Heeft de pure functionaliteit in zich om toetsingen en berekeningen uit te voeren. ServiceObjects Per dataklasse een geoptimaliseerd service object om generiek bepaalde functies op te lossen. Kiest tevens het type dataaccess. DataAccess Per type database een geoptimaliseerde klasse voor connectie met de database. Database Opslag van normen, gebruikers, gebruik en rechten. Met voorkeur communiceren via STP s. BoToVaWS De functies voor de buitenwereld worden hierin beschikbaar gesteld. BusinessEntities Klassediagram Hieronder staat een beschrijving van alle entiteiten die voor gaan komen Toetsregel Een toetsregel is de omschrijving van de toetsregels die opgezet worden door de rekenmeesters. ToetsregelVersie Een toetsregel kan meerdere versies krijgen in de tijd. Om dit flexibel op te vangen krijgt elke toetsregel de mogelijkheid tot extra versies en bij elke versies worden de normen weer gekoppeld aan een versie. Zo overschrijft een nieuwe versie, nooit iets van een voorgaande versie. ToetsingVersie Indien een nieuwe ToetsregelVersie onstaat in de sourcecode, werkt dit uiteraard door in één of meerdere toetsingen. Hiervoor is dus ook versiebeheer op Toetsingen nodig. Er ligt geen expliciete link tussen ToetsregelVersie en ToetsingVersie omdat deze hardcoded zullen zijn. I.T. Works september 2012

12 ToetsnormWaarde Dit is de waarde van een norm in een voorkeurs eenheid, waarbij de ToetsnormParameterCode staat voor een gestandaardiseerde lijst met o.a.: AW, IND en I. I.T. Works september 2012

13 ExchangeEntities Deze klassen zijn ervoor om uit te wisselen met de buitenwereld. Om een toetsing aan te vragen moet er een [ToetsingAanvraag] verzonden worden naar de webservice. Deze gaat controleren of de username en password goed is, daarna wordt het veld [AanvraagXML] uitgelezen. Dit is IM0101-xml. Dit wordt omgezet naar ToetsingEntities. Daarna wordt de toetsing aangevraagd. Sommige toetsingen hebben extra instellingen nodig, deze kunnen worden meegegeven met de [ToetsingInstelling] (dit zijn geen stoffen, maar instellingen). Een [ToetsingInstelling] kan alle indelingen info bevatten, namelijk string, float en DateTime. Een Boolean wordt genoteerd in het veld string met True / False en een integer kan worden gestuurd via een float. Zodra de toetsing is uitgevoerd of is fout gegaan wordt het bericht via klasse [ToetsAntwoord] teruggestuurd naar de aanroepende applicatie. Hierin zit een [ResultaatCode], dit kan naast Succes ook een fout omschrijving zijn zoals AuthorisationError. Indien een fout is opgetreden kan hierover extra info teruggegeven worden in het veld [ResultaatBeschrijving]. Dit is GEEN technische foutmelding uit de applicatiecode, deze geven we namelijk nooit terug, deze gaat een logging in. Een logbestand kan als HTML of XML teruggegeven worden in het veld [Logbestand]. Het Resultaat gaat weer als IM0101-xml over de lijn in het veld [ResultaatXML]. ToetsingEntities De webservice ondersteund IM0101-xml, deze kunnen worden meegestuurd in het veld [AanvraagXML] in de klasse [ToetsingAanvraag]. Door de Converter wordt de xml omgezet in de ToetsingEntities. Een [Analysemonster] wordt gemaakt met daaraan de [Analyse]. Tijdens toetsen worden hieraan de [BerekendeAnalyse] toegevoegd, de [ToetsingVariabele] en natuurlijk het [ToetsOordeel]. Een [ToetsingVariabele] is een meegestuurde instelling maar ook de tellers die gehanteerde worden in de rekenregels. De [NormWaarde] wordt toegevoegd aan het resultaat XML voor de gebruiker. De complete beschrijving van velden in deze klassen komt uit het IM0101 formaat. DatabaseEntities Deze entities zijn nodig om gegevens uit de database op te halen en daar eenvoudig Object- Georienteerd mee te werken. Een [ToetsregelVersie] is versie van een toetsregel zoals de rekenmeesters deze hebben opgedeeld in losse stroomschema s. Een [ToetsnormWaarde] is de waarde die een component heeft per norm. Een ToetsnormWaarde wordt altijd gekoppeld aan een ToetsnormParameter. ToetsnormParameters zijn gestandaardiseerd in een Codelijst en zijn bijvoorbeeld: Achtergrondwaarde, Industrie, Interventiewaarde. Om een [ToetsregelVersie] te kunnen uitrusten met de juiste normen, is een koppeltabel tussen de I.T. Works september 2012

14 [ToetsnormWaarde] en de [ToetsregelVersie]. Hiermee wordt een flexibele koppeling gelegd, rekening houdend met versiebeheer van normen en toetsregels/rekenregels. [ToetsingVersie] is de toetsing die de gebruiker kan aanroepen. De Toetsingen zijn een vaste lijst, maar hier kunnen meerdere versies van zijn. Een [ToetsingVersie] kan specifiek uitgezet worden door het veld [IsActief], door het veld [RedenInactief] te vullen kan een reden opgegeven worden waarom. Per [ToetsingVersie] is een vaste Handler in de sourcecode. In deze Handler wordt de keuze gemaakt voor de juiste Toetsregels en versie. Dit is ook de reden dat er databasetechnisch geen link ligt tussen [ToetsingVersie] en [ToetsregelVersie]. Indien er een nieuwe versie komt van een norm dan kan deze toegevoegd worden via [ToetsnormWaarde] en gekoppeld worden aan de juiste versie van een toetsregel via [LinkToetsregelVersie_ToetsnormWaarde]. Indien er een nieuwe versie komt van een Toetsregel, dan wordt een nieuwe [ToetsregelVersie] in de database aangemaakt. De Handler in de sourcecode wordt gekopieerd en krijgt een nieuwe naam a.h.v. ophogen versie nummer. Voor alle Toetsingen die gebruik maken van die Toetsregel, wordt ook een nieuwe [ToetsingVersie] in de database aangemaakt met een nieuw versienummer. Bijbehorende Handler wordt ook gekopieerd en krijgt ook een nieuwe naam a.h.v. ophogen versienummer. [Persoon] is ervoor om de gebruikers te noteren. Een gebruiker kan worden uitgezet via het veld [IsActief] of eventueel zelf verwijderd worden via [IsVerwijderd]. I.T. Works september 2012

15 Check Autorisatie I.T. Works september 2012

16 Uitvoeren van toetsingen I.T. Works september 2012

17 BaseHandlerToetsing De ToetsingFactory bereid het toetsen voor; regelt het omzetten van xml naar klassen en kiest de juiste BaseHandlerToetsing. Per ToetsingVersie is hier een afgeleide Handler van. De afgeleide Handler controleert in de database of een zijn eigen Toetsing en Versie beschikbaar is (afhankelijk van het veld [IsActive] in [ToetsingVersie]). Is deze beschikbaar dan worden alle Toetsregels uitgevoerd. BaseHandlerToetsregel Per [ToetsregelVersie] is een Handler, afgeleid van BaseHandlerToetsregel. In deze Handler wordt de rekenregel/toetsregel afgehandeld zoals deze is beschreven in een stroomschema van de rekenmeester. Komt er een nieuwe versie van de rekenregels of is er een aanpassing in de normen, dan wordt een voorgaande Handler gekopieerd. In de kopie worden de nieuwe aanpassingen verwerkt. Hierop zit een X.Y.Z. versiebeheer. Deze ophoging van versie werkt ook door in de aanroepende BaseHandlerToetsing. Helpers De [Helpers] zijn ervoor om op een snelle manier bepaalde informatie op te zoeken die ieder één of meerdere Handlers nodig hebben. Twee voorbeeld hiervan zijn het opzoeken van de Organische stof/lutum in de lijst met [Analyse] of een bepaalde instelling opzoeken in de lijst met [ToetsingVariabele]. I.T. Works september 2012

18 3. Berichten verkeer BoToVa Algemene denkwijze Het idee is om geen dubbele gegevens heen en weer te sturen. Dus het monster met de resultaten opgestuurd naar de service moeten niet geretourneerd worden. Alleen nieuwe gegevens worden teruggestuurd, hierin verwerkt een verwijzing naar het origineel m.b.v. NEN3610-ID (Guid). Er is een splitsing gemaakt tussen Analyse, BerekendeAnalyse en ToetsOordeel. Analyse Is het resultaat aangeleverd door en in de meeste gevallen gemeten in het laboratorium. BerekendeAnalyse Een BerekendeAnalyse heeft twee types, namelijk Rekenwaarde en Gestandaardiseerdewaarde. Het is een Rekenwaarde na omrekenen naar de juiste eenheid en na controle aan de rapportage grens waarbij eventueel maal 0,7 gedaan wordt. Het is een Gestandaardiseerdewaarde nadat de Rekenwaarde is gecorrigeerd aan bijvoorbeeld de Organische stof/lutum. De Gestandaardiseerdewaarde zal tegen de normen gehouden worden en krijgt uiteindelijk het Toetsoordeel. Beide situaties wijzen terug naar hun originele waarde waaruit deze is berekend. In het perfecte geval ontstaat een volgende situatie: Analyse BerekendeAnalyse (Rekenwaarde) BerekendeAnalyse (Gestandaardiseerdewaarde) ToetsOordeel Is het resultaat nadat een Gestandaardiseerdewaarde tegen de normwaarde is gehouden. Hierbij wordt dan een verwijzing naar de Gestandaardiseerdewaarde bijgehouden. Het kan voorkomen dat meerdere Gestandaardiseerdewaarde een ToetsOordeel vormen, dan is er een verwijzing naar meerdere Gestandaardiseerdewaardes. (Bijvoorbeeld een Monster oordeel bij de BBK.) Normwaarde De normwaardes waarop een ToetsOordeel is gebaseerd worden ook teruggekoppeld naar de gebruiker. (Staat niet in bovenstaande figuur.) Toetsmonster Indien meerdere monsters aangeleverd worden in één aanroep, dan wordt hiervan een toetsmonster I.T. Works september 2012

19 berekend. Er zal een extra monster terug geleverd worden met de verwijzing naar de originele monsters. Dit Toetsmonster heeft dan alleen BerekendeAnalyses en geen Analyses. Uitwerking in IM0101 Informatie model Hieronder staat het model zoals dit de logische wereld beschrijft. Alle velden en relaties zoals hierin beschreven worden later uitgewerkt in een Product model waarin de koppeling ligt met andere standaarden. Uitwerking in IM0101 Product model Hieronder staat een stukje van het model zoals dit technisch is gekoppeld aan andere standaarden uit o.a. ISO, NEN3610 en GML. I.T. Works september 2012

20 Figuur 1. Uitwerkingen in IM0101 met Observations I.T. Works september 2012

21 4. Codelijsten Hieronder staat enkele codelijsten, deze staan als concept vermeld om een goed beeld te vormen. Ze moeten nog gecontroleerd en vastgesteld worden. Toetsingen In deze codelijst is de kolom Basisschem keuze opgenomen, dit moet de keuze zijn in het eerste stroomschema van de rekenmeesters. De waardes die hier nu instaan kunnen niet kloppen, deze moeten vastgesteld worden door de rekenmeesters. Code Toetskader Basisschema keuze Beschrijving T.1.2. BBK Landbodem/grond/waterbodem/bag ger/gbt emissietoetswaarde Beoordeling kwaliteit van grond en bagger bij toepassing op of in de bodem T.2.2 BBK Landbodem/grond/waterbodem/bag Beoordeling kwaliteit ontvangende landbodem ger/gbt emissietoetswaarde T.3.2. BBK Landbodem/grond/waterbodem/bag ger/gbt emissietoetswaarde Beoordeling kwaliteit van bagger en ontvangende bodem bij toepassing in een oppervlaktewaterlichaam T.4.2. BBK Landbodem/grond/waterbodem/bag ger/gbt emissietoetswaarde Beoordeling kwaliteit van grond bij toepassing in bodem of oever van oppervlaktewater T.5.2 BBK Baggerspecie Verspreiding op aangrenzend perceel Beoordeling verspreidbaarheid van baggerspecie op aangrenzend perceel (landbodem) T.6.2. BBL Landbodem/grond/waterbodem/bag ger/gbt emissietoetswaarde Beoordeling kwaliteit van bagger bij verspeiden in een zoet oppervlaktewaterlichaam T.7.2 BBK Landbodem/grond/waterbodem/bag ger/gbt emissietoetswaarde Beoordeling verspreidbaarheid van baggerspecie in zoute oppervlaktewaterlichamen T.8.2 GBT GBT (Emissiewaarde) Beoordeling kwaliteit van grond bij GBT op landbodem (emissietoetswaarde) T.9.2 GBT GBT (Emissiewaarde) Beoordeling kwaliteit van baggerspecie bij GBT op landbodem (emissietoetswaarde) T.10.2 GBT GBT (Emissiewaarde) Beoordeling kwaliteit van grond bij GBT in oppervlaktewateren (emissietoetswaarde) T.11.2 GBT GBT (Emissiewaarde) Beoordeling kwaliteit van baggerspecie bij GBT in oppervlaktewateren (Emissietoetswaarde) T.12.2 WBB Landbodem/grond/waterbodem/bag Beoordeling kwaliteit van grond volgens Wbb ger/gbt emissietoetswaarde T.13.2 WBB Grondwater Beoordeling kwaliteit van grondwater volgens Wbb T.27.2 WBB Landbodem/grond/waterbodem/bag ger/gbt emissietoetswaarde Beoordeling kwaliteit van grond en baggerspecie bij GBT (Emissiewaarden) n.t.b. Bouwstoffen Bouwstoffentoetsing n.t.b. Reinigbaarhei Reinigbaarheidstoetsing dstoetsing Zie hoofdstuk 3 van document Toetsingregels Bodem v1.2. Toetsregels Nummer Toelichting T.0. Globaal stroomschema T.1.1 Beoordeling kwaliteit van grond en bagger bij toepassing op of in de bodem op parameterniveau T.1.2. Beoordeling kwaliteit van grond en bagger bij toepassing op of in de bodem op monsterniveau T.2.2 Beoordeling kwaliteit ontvangende landbodem monsterniveau T.3.1. Beoordeling kwaliteit van bagger en ontvangende bodem en oever bij toepassen in een oppervlaktewaterlichaam op parameterniveau T.3.2. Beoordeling kwaliteit van bagger en ontvangende bodem bij toepassing in een oppervlaktewaterlichaam op monsterniveau T.4.1 Beoordeling kwaliteit van grond bij toepassing in bodem of oever van oppervlaktewater parameterniveau T.4.2. Beoordeling kwaliteit van grond bij toepassing in bodem of oever van oppervlaktewater monsterniveau T.5.1 Beoordeling verspreidbaarheid van baggerspecie op aangrenzend perceel (landbodem) parameterniveau I.T. Works september 2012

22 T.5.2 Beoordeling verspreidbaarheid van baggerspecie op aangrenzend perceel (landbodem) monsterniveau T.6.1. Beoordeling kwaliteit van bagger bij verspreiden en in een zoet oppervlaktewaterlichaam op parameterniveau T.6.2. Beoordeling kwaliteit van bagger bij verspeiden in een zoet oppervlaktewaterlichaam op monsterniveau T.7.1 Beoordeling verspreidbaarheid van baggerspecie in zoute oppervlaktewaterlichamen op parameterniveau T.7.2 Beoordeling verspreidbaarheid van baggerspecie in zoute oppervlaktewaterlichamen op monsterniveau T.8.2 Beoordeling kwaliteit van grond bij GBT op landbodem (emissietoetswaarde) monsterniveau T.9.2 Beoordeling kwaliteit van baggerspecie bij GBT op landbodem (emissietoetswaarde) monsterniveau T.10.2 Beoordeling kwaliteit van grond bij GBT in oppervlaktewateren (emissietoetswaarde) monsterniveau T.11.2 Beoordeling kwaliteit van baggerspecie bij GBT in oppervlaktewateren (Emissietoetswaarde) monsterniveau T.12.2 Beoordeling kwaliteit van grond volgens Wbb (monsterniveau) T.13.1 Beoordeling kwaliteit van grondwater volgens Wbb (parameterniveau) T.13.2 Beoordeling kwaliteit van grondwater volgens Wbb (monsterniveau) T.14 <LEEG> T.15.1.a Beoordeling individuele parameters INPUT T.15.1.b Beoordeling individuele parameters INPUT T.15.2 Vaststelling vracht individueel T <LEEG> T <LEEG> T.15.3 Vaststelling Uitvoer na reiniging per stof per techniek T.15.4 Vaststelling VRACHT UIT & 1e schifting reinigbaarheid obv rendement T.15.5 berekening % residu T.15.6 Toetsing Reinigbaarheid <IND T.15.7 Toetsing voorkeurstechniek T.16.1 Beoordeling kwaliteit bouwstoffen (Emissiewaarden) - parameterniveau T.16.2 Beoordeling kwaliteit bouwstoffen (Emissiewaarden) - monsterniveau T.17.1 Beoordeling kwaliteit bouwstoffen (Samenstellingswaarde) - parameterniveau T.17.2 Beoordeling kwaliteit bouwstoffen (Samenstellingswaarde) - monsterniveau T.18 Toetsregel (F) overschrijdingsregels AW verspreiden op aangrenzend perceel T.19. Correctie standaardisatie rekengehalte (bijlage G III uit Rbk) T.20. Toetsregels overschrijding AW en Wonen (teller A en B) T.21. Bepaal rekengehalte component (App. G IV) T.22. Toetsregels overschrijding AW en Wonen Bagger (Teller C) T.23 Toetsregels overschrijding GBT baggerspecie op landbodem (Teller D) T.24. Bepaal rekengehalte component (Bijlage G IV, Emissiewaarde) T.25 <LEEG> T.26.I Bepaal OS, Lu op monsterniveau versie T.26.II Berekening van Organische stof vanuit Gloeiverlies,Gloeirest T.26.III Bepaal OC op monsterniveau berekening PAF T.27.1 Beoordeling kwaliteit van grond en baggerspecie bij GBT (Emissiewaarden) parameterniveau T.27.2 Beoordeling kwaliteit van grond en baggerspecie bij GBT (Emissiewaarden) monsterniveau T.28. Toetsregels overschrijding AW verspreiding in zoet (Teller E) T.29 <LEEG> T.30 <LEEG> T.31.2 bouwstoffen hergebruik - Emissie - monsterniveau T.32 <LEEG> T.33. Bepaal rekengehalte somparameters als fractie van IW T.34. Bepaling van gehalten van somparameters T.35 Bepaling van gemiddelde gehalten T.36. PAF metalen bereken concentratie poriewater T.37. PAF metalen correctie poriewater Aw en DOC T.38. PAF organisch bereken concentratie poriewater Zie hoofdstuk 3 van document Toetsingregels Bodem v1.2. I.T. Works september 2012

23 ToetsnormParameters Code Publicatie Omshcrijving AW Achtergrondwaarde IND Industrie n.t.b. 5. Parameters en resultaten per toetsregel Tabel 1. Parameters en resultaten voor "T1.2 Bagger bij toepassing op monster niveau" als voorbeeld. Rekenregel Parameters Type Opmerking Niveau T0 Algemeen Monsters met Matrix In Monster Uit te voeren toetsing In Monster Normen terugsturen Ja of Nee In Monster Middeling uitvoeren Ja of Nee In Monster --- Zie uit te voeren toetsing --- Uit T26 Bepalen OS en Lutum Parameters Lu, OS, Gloeiverlies of Gloeirest In Lutum en Organisch stof, indien niet bepaald kunnen worden dan worden sommige parameters niet getoetst. Parameter Vastgestelde Lu, OS Uit Monster T21 Rekengehalte Analyses In Parameter BerekendeAnalyses (rekenwaarde) Uit Bepaald aan de Rapportagegrens en Parameter eventueel een 0.7 factor. Rapportagegrens als Norm Uit Rapportagegrens eisen wordt gezien Parameter als extra norm T34 BerekendeAnalyses (rekenwaarde) In Somparameters Somparameters als Uit Parameter BerekendeAnalyses (rekenwaarde) T19 BerekendeAnalyses (rekenwaarde) In Parameter Standaardisatie BerekendeAnalyses Uit Gecorrigeerde meetwaardes Parameter (gestandaardiseerdewaarde) T1.1 Kwaliteit van BerekendeAnalyses In Parameter Grond of Bagger op parameter niveau (gestandaardiseerdewaarde) Toetsoordelen Uit Parameter Tellers (aantal overschrijdingen en Uit Parameter aantal getoetst aan norm) Meldingen op parameter niveau Uit Speciale situaties als: Zorgplicht van Parameter toepassing. Misschien als Log, of als ToetsOordeel Normwaardes Uit Indien gewenst Parameter T1.2 Bagger bij toepassing op monster niveau BerekendeAnalyses (gestandaardiseerdewaarde) In Parameter ToetsOordelen In Parameter Tellers In Parameter ToetsOordeel Uit Monster Vrijstelling aantal Uit Op basis van de tellers is een aantal Monster vrijstelling mogelijk. T35 Middeling Monsters In Monster I.T. Works september 2012

24 ToetsOordeel In Monster BerekendeAnalyses (rekenwaarde) In Parameter Nieuwe Monster Uit Monster Nieuwe BerekendeAnalyses Uit Parameter (rekenwaarde) --- Opnieuwe toetsingcyclus in --- Geen behandelingen meer, alles is direct klaar om mee te rekenen. De bovengenoemde proces stappen worden volgens de rekenregels uitgevoerd. I.T. Works september 2012

25 Type Codelijst Opmerking Voorbeeld Monsterniveau type matrix codelijst IHW: TypeCompartiment grond, grondwater, bagger, type bouwstof Guid - SIKBID GUID ffff-ffff-fff-ffff code/naam string (max 50) M001 omschrijving string (max 200) Dit is een omschrijving bij het monster datum/tijd datetime T09:00:00 Parameterniveau Toetsinformatie Toetsinstellingen %lutum Parameter/ Toetsinstelling Wordt meegevens in de lijst met parameters of instelling %OS (%Gloeiverlies, %Gloeirest, %Fe2O3, %OC) Parameter/ Toetsinstelling Wordt meegevens in de lijst met parameters of instelling Extra (bouwstoffen) instellingen Toetsinstellingen Per monster? Wat te doen met middeling? unieke identificatie van de stof GUID/SIKBID eeee-eeee-eee-eeee parameter grootheid codelijst IHW: TypeGrootheid Concentratie, Temperatuur, ph, Aantal, Dikte, massafractie parameter code codelijst IHW: TypeChemischeStof Chemische stof - Lood, Chemische stof- PAK 10, Object - Badgasten parameter hoedanigheid codelijst IHW: TypeHoedanigheid Filtratie, drooggewicht, korrelgroottefractie, paf gehalte float 12,34 eenheid codelijst IHW: TypeEenheid mg/kg ds, mg/l, % limiet symbool codelijst IHW: TypeBepalingsGrens <, > kwaliteits oordeel codelijst IHW: KwaliteitsOordeel detectielimiet, rapportage limiet, verhoogde rapportagelimiet Toetsregel Int Wordt opgeslagen in de Database, deze kan opgevraagd worden via de service en is dynamisch. Toetsregel versie Int Wordt opgeslagen in de Database, deze kan opgevraagd worden via de service en is dynamisch. welke monsters moeten gemiddeld worden Type instelling codelijst Nieuw: Testproperties Vormgegeven bouwstof ja/nee, Niet-Vormgegeven bouwstof ja/nee floatvalue Float Indien Boolean dan in dit veld een: 1 of een 0 datetimevalue DateTime stringvalue string (100)

26 6. Logging Tijdens het toetsen en valideren wordt een logbestand bijgehouden per Toetsregel. Dit logbestand kan naar wens in twee types worden teruggegeven: XML of HTML. Een voorbeeld van een logbestand staat hieronder. Samenvatting Toetsing en Validatie Rekenregel Omschrijving Meldingen Errors T.0 Basis 0 0 T.26 Vaststellen Lutum en OS 0 0 T.21 Bepaal rekengehalte 2 0 T.34 Somnormen berekenen 0 1 T.19 Standaardiseren rekengehalte 0 1 T.0 Basis Type Onderwerp Omschrijving Aantal monsters Er is 1 monster aangeleverd met 12 resultaten Type Toetsing De toetsing: BBK Bodem is aangevraagd T.26 Vaststellen Lutum en OS Type Onderwerp Omschrijving Gehalte Lutum Het gehalte Lutum is vastgesteld op: 12,4 T.21 Bepaal rekengehalte Type Onderwerp Omschrijving! Correctie Lood is gecorrigeerd met factor 0,7 Rekenwaarde: [12,4]! Eenheid Lood is gecorrigeerd naar de juiste eenheid. Rekenwaarde: [124,0]. Rekengehaltes Koper is overgenomen zonder bewerking Rekenwaarde: [45,3] T.34 Somnormen berekenen Type Onderwerp Omschrijving X Incompleet Enkele parameters ontbreken in de som PAK 10. Somparameters Som PAK 10 stof xx [12,1] Somparameters Som PAK 10 stof yy [3,7] Somparameters Som PAK 10 stof zz [0,7] Somparameters Som PAK 10 is vastgesteld. Rekenwaarde: [44,2] T.19 Standaardiseren rekengehalte

27 Type Onderwerp Omschrijving X Organisch gehalte OS ontbreekt, toetsing kan niet volledig worden uitgevoerd Gestandaardiseerde Gehalte Lood is gestandaardiseerd. - Rekenwaarde: [124,0], Gestandaardiseerdewaarde: [56,2] Gestandaardiseerde Gehalte Koper is gestandaardiseerd. - Rekenwaarde: [45,3], Gestandaardiseerdewaarde: [56,2] Naast deze exacte doorloop logging, worden ook meldingen die vermeld staan in de rekenregels van de rekenmeesters teruggekoppeld in IM0101-xml bij de Monsters en de BerekendeAnalyse. I.T. Works september 2012