Voorbeeld: Toezicht zaken aanmaken bij inrichtingen

Op deze pagina wordt stap voor stap beschreven hoe men een generieke bulk importactie in kan richten die toezichtzaken zal aanmaken bij inrichtingen/locatiedossiers.
Dat betekent dat deze bulk importactie uit 1 actie bestaat in dit voorbeeld:

• insert in tabel tbomgvergunningen

Een voorbeeld van een bulk importactie met meerdere insert acties is beschreven op pagina Voorbeeld: Inspecties aanmaken bij inrichtingen/locatiedossiers.

Voor de bovengenoemde insert actie moet er een regel in de importmatrijstabel (tbimportmatrijs) aangemaakt worden. Onder deze importmatrijs hangen importmatrijsregels die ook aangemaakt moeten worden.
Voordat deze insert acties ingericht worden, wordt eerst uitgelegd hoe het bestand met de in te lezen data eruit moet zien. Daarna wordt een voorbeeld getoond hoe men vaste sleutelwaardes kan gebruiken benodigd voor de insert actie.

Zoals beschreven bij de pagina Generieke bulk import is er voor iedere generieke bulk importactie een bestand benodigd met daarin de gegevens die ingelezen moeten worden. In het voorbeeld op deze pagina wordt uitgegaan van een CSV bestand met daarin een kopregel die aangeeft welke kolom, welke waarde voorstelt en daaronder regels met de gegevens voor de aan te maken toezichtzaken. De kopregel is niet verplicht: men mag ook gelijk beginnen met vanaf de eerste regel de in te lezen waardes.

De programmatuur gaat straks voor iedere regel (minus de kopregel in dit geval) een insert actie proberen uit te voeren. Het is dus de bedoeling dat in dit voorbeeld per regel, alle informatie staat voor één regel aanmaken in tbomgvergunningen. Er is in dit voorbeeld gekozen voor de productvelden vullen van tbomgvergunning. Uitgaande van maar één product per zaak.
Aangezien de toezichtzaken moeten worden aangemaakt bij bestaande inrichtingen, zal er voor ieder aan te maken toezichtzaak verwezen moeten worden naar de inrichting waaronder deze moet worden aangemaakt. Dat betekent dat er in het bestand waarin de in te lezen gegevens staan, voor iedere regel een kolom bestaat met (bijvoorbeeld) het inrichtingnummer van de inrichting/locatie dossier waaronder de inspectie aangemaakt moet worden.
Zie voorbeeldplaatje hieronder voor hoe de CSV er uit ziet:

Voordat de import matrijs wordt ingericht moet er eerst worden nagedacht over hoe er naar de bestaande inrichtingen/locatiedossiers in OpenWave verwezen wordt. Immers de dnkey van deze inrichtingen/locatiedossiers (tbmilinrichtingen.dnkey) is benodigd voor het kunnen aanmaken van de toezichtzaken onder de juiste inrichting/locatiedossier.
Dit kan op twee manieren:

• via een select statement in de importmatrijsregels wordt de dnkey opgehaald met behulp van de waarde van de bestandskolom met daarin het unieke inrichtingnummer
• via de importmatrijsregels wordt de dnkey opgehaald met behulp van de vaste sleutelwaarde voor de inrichting uit tabel tbimportsleutels

In het voorbeeld wat hier beschreven wordt, gaat het om een sleutelwaarde ophalen uit de tabel tbimportsleutels. Dat betekent dat er bij het inrichten rijtjes moeten worden aangemaakt voor alle inrichtingen/locatiedossiers in het bestand.
Via tegel Import sleutels in het beheerportaal-nieuw klikken op de plus-knop in de lijst geeft de wizard voor het aanmaken van een nieuwe zoeksleutel.
Daarin wordt gevuld:

• Naam van (moeder)tabel. Het gaat om een verwijzing naar een inrichting/locatiedossier dus hier moet gekozen worden tbmilinrichtingen
• Pointer/keywaarde uit (moeder)tabel. Dit is de dnkey van de inrichting/locatiedossier. De waarde kan men vinden als men in de URL kijkt als men op het inrichtingportaal in OpenWave staat. Bijvoorbeeld als de URL eindigt op : /#inrichtingdetail/24588 dan is de pointer/keywaarde die gevuld moet worden 22542
• Zoeksleutel. Hier wordt de waarde gevuld waarop later gezocht gaat worden. In het voorbeeld is dit het inrichtingnummer.

De waardes in de wizard worden zo gevuld dat men uiteindelijk het volgende rijtjes aan zoeksleutels heeft:

Plaatje importmatrijs voor tbomgvergunningen:

Plaatje importmatrijsregel bij tbomgvergunningen:

Na het inrichten kan de bulk importactie uitgevoerd gaan worden.
Klik op de tegel Start generieke bulk import in het operationsportaal onder kolom Import.
De wizard vraagt om een hoofdmatrijs te kiezen. Kies hier voor de matrijs van de toezichtzaken en klik op volgende.
Wijs het bestand aan waarin de in te lezen gegevens staan en klik op uitvoeren.

Op de achtergrond worden nu de rijen aangemaakt in tbomgvergunningen.
De voortgang van de bulk importactie is in te zien via de operationslog tegel.
In de lijst van de operationslog gaan we naar de zojuist aangemaakte regel met code GeneriekeBulkImport.
Linksonder via de button Logboek is terug te zien welke importmatrijs verwerkt is en of er regels niet aangemaakt konden worden. Tevens kan men hier het bestand wat bij deze import is gekozen nog downloaden via de knop Download bestand van tempmap.

In de Audit log is tevens de voortgang in te zien: voor iedere regel die zojuist is aangemaakt in tbomgvergunningen, is ook een regel aangemaakt in tbaudit.
Indien men de importactie terug wilt draaien (dus de aangemaakte regels in tbomgvergunningen weer verwijderen) dan kan dat via de wizard achter knop VerwijderBulkImportregels linksonder in de Audit lijst. Zie voor een gedetailleerde uitleg kopje Terugdraaien van importactie op pagina Generieke bulk import.