openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:generiekebulkimport

Verschillen

Dit geeft de verschillen weer tussen de geselecteerde revisie en de huidige revisie van de pagina.

Link naar deze vergelijking

Beide kanten vorige revisie Vorige revisie
Volgende revisie
Vorige revisie
openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:generiekebulkimport [2025/10/31 11:41] – [Bestand met de in te lezen data] Lonneke van Dijkopenwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:generiekebulkimport [2025/11/17 15:51] (huidige) – [Operationslog] Lonneke van Dijk
Regel 22: Regel 22:
 </adm> </adm>
  
-Er wordt een voorbeeldsituatie uitgeschreven voor zowel een bulk importactie gebaseerd op een Excel file als een bulk importactie gebaseerd op een CSV file. 
-Hier wordt concreet uitgeschreven hoe men in tbimportmatrijs, tbimportmatrijsregels en tbimportsleutel de inrichting moet maken om de voorbeeld bulk importactie te kunnen uitvoeren. 
-Zie voor deze voorbeelden: <hier komt nog een link>. \\ 
 Op deze pagina wordt in het algemeen uitgelegd hoe de generieke bulk importactie werkt en hoe deze acties ingericht kunnen worden. Op deze pagina wordt in het algemeen uitgelegd hoe de generieke bulk importactie werkt en hoe deze acties ingericht kunnen worden.
 +Tevens zijn er twee voorbeeldsituaties uitgeschreven op onderliggende pagina's in de DokuWiki: daar staat uitgeschreven hoe men in tbimportmatrijs, tbimportmatrijsregels en tbimportsleutel de inrichting moet maken om de voorbeeld bulk importactie te kunnen uitvoeren.\\
 +Zie voor deze voorbeelden: 
 +  * [[openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:generiekebulkimport:voorbeeld_inspecties|Voorbeeld: Inspecties aanmaken bij inrichtingen/locatiedossiers]] 
 +  * [[openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:generiekebulkimport:voorbeeld_toezichtzaken|Voorbeeld: Toezichtzaken aanmaken bij inrichtingen/ locatiedossiers]] 
 +
 +
  
 ===== Inrichten van bulk import proces ===== ===== Inrichten van bulk import proces =====
Regel 31: Regel 34:
  
 Voordat men begint met het inrichten van een generieke bulk importactie moet men het proces van de gewenste importactie uitwerken: Voordat men begint met het inrichten van een generieke bulk importactie moet men het proces van de gewenste importactie uitwerken:
-  * wat moet de importactie doen? Bijvoorbeeld stel men wilt inrichtingen aanmaken en daaronder inspecties aanmaken en daaronder weer inspectiebezoeken. Dan zal ingericht moeten worden:+  * Wat moet de importactie doen? Stel men wilt bijvoorbeeld inrichtingen aanmaken met daaronder inspecties en daaronder weer inspectiebezoeken. Dan zal ingericht moeten worden:
     * een hoofdactie voor het aanmaken van inrichtingen (nieuwe regel in tbimportmatrijs met dlhoofdmatrijs = T)     * een hoofdactie voor het aanmaken van inrichtingen (nieuwe regel in tbimportmatrijs met dlhoofdmatrijs = T)
-    * een vervolgactie voor aanmaken inspecties onder de aangemaakte inrichtingen (nieuwe regel in tbimportmatrijs met dlhoofdmatrijs = F) +    * een vervolgactie voor het aanmaken van inspecties onder de aangemaakte inrichtingen (nieuwe regel in tbimportmatrijs met dlhoofdmatrijs = F) 
-    * bij de hoofdmatrijs als vervolgmatrijs kiezen de net aangemaakte vervolgactie voor inspecties aanmaken +    * bij de hoofdmatrijs zal een vervolgmatrijs gekozen moeten worden met de net aangemaakte vervolgactie voor het aanmaken van inspecties 
-    * een tweede vervolgactie voor aanmaken inspectiebezoeken onder de aangemaakte inspecties (nieuwe regel in tbimportmatrijs met dlhoofdmatrijs = F) +    * een tweede vervolgactie voor het aanmaken van inspectiebezoeken onder de aangemaakte inspecties (nieuwe regel in tbimportmatrijs met dlhoofdmatrijs = F) 
-    * bij de importmatrijs voor inspecties aanmaken als vervolgmatrijs kiezen de net aangemaakte vervolgactie voor bezoeken aanmaken +    * bij de importmatrijs voor het aanmaken van inspecties als vervolgmatrijs kiezende net aangemaakte vervolgactie voor het aanmaken van de inspectiebezoeken 
-  * welke gegevens zijn er nodig voor het kunnen aanmaken van regels in de tabellen? +  * Welke gegevens zijn er nodig voor het kunnen aanmaken van regels in de tabellen? 
-    * dus in bovengenoemd voorbeeld: opzoeken van de verplichte velden, eventueel aangevuld met de overige gewenste te vullen velden in tbmilinrichtingen, tbinspecties en tbinspbezoeken +    * in het voorbeeld hierboven betekent betekent dit dat je eerst de verplichte velden bepaalt en vervolgens deze aanvult met overige relevante velden uit tbmilinrichtingen, tbinspecties en tbinspbezoeken 
-  * de benodigde gegevens beschikbaar stellen in een Excel of CSV file+  * De benodigde gegevens beschikbaar stellen in een Excel of CSV file
     * dit kan bijvoorbeeld d.m.v. rapport(en) draaien en naar Excel exporteren     * dit kan bijvoorbeeld d.m.v. rapport(en) draaien en naar Excel exporteren
-    * of indien men van de functionaliteit [[openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:bulkinspzaken|Bulk aanmaken van inspecties/toezichtzaken]] gebruik maakt kan men de daar gebruikte Excel mallen gebruiken+    * of indien men van de functionaliteit [[openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:bulkinspzaken|Bulk aanmaken van inspecties/toezichtzaken]] gebruik maakt, dan kan men de daar gebruikte Excel mallen van gebruiken
  
-Na het uitdenken van het proces kan men starten met het inrichten van de gewenste bulk importactie. Te beginnen met het bestand wat men wilt gaan uploaden bij deze importactie:+Na het uitdenken van het proces kan men starten met het inrichten van de gewenste bulk importactie. Te beginnen met het bestand dat men wil gaan uploaden bij deze importactie.
 ==== Bestand met de in te lezen data ==== ==== Bestand met de in te lezen data ====
 Het bestand met daarin de in OpenWave in te lezen data mag in principe zo opgesteld zijn als men zelf wilt.\\ Het bestand met daarin de in OpenWave in te lezen data mag in principe zo opgesteld zijn als men zelf wilt.\\
-Het is wel belangrijk om te weten in welke (combinatie van) kolommen, welke data staat die men wilt inlezen. Dit is benodigd voor het correct inrichten van een bulk importactie in OpenWave. \\ +Het is daarbij belangrijk om te weten in welke (combinatie van) kolommen, welke data staat die men wilt inlezen. Dit is benodigd voor het correct inrichten van een bulk importactie in OpenWave. \\ 
-Het zal in de praktijk voorkomen dat men de basis van het bestand blijft gebruiken voor gelijke importacties. Stel dat men een import heeft ingericht voor inspecties aanmaken bij inrichtingen, dan zal de opzet van het bestand wat men upload steeds gelijk zijn (in kolom1 staat bijv. altijd de waarde voor inspectieaanleiding) maar de daadwerkelijke waardes per kolom/regel zal wijzigen.\\ +Het zal in de praktijk voorkomen dat men de basis van het bestand blijft gebruiken voor gelijke importacties. Stel dat men een import heeft ingericht voor het aanmaken van inspecties bij inrichtingen, dan zal de opzet van het bestand dat men upload steeds hetzelfde zijn (in kolom1 staat dan bijv. altijd de waarde voor inspectieaanleiding) maar de daadwerkelijke waarden per kolom/regel zullen veranderen.\\ 
-De inhoud van het bestand zal wel wijzigen voor iedere importactie: immers eenmaal ingelezen zal men niet opnieuw dezelfde data in willen lezen (m.u.v. opnieuw draaien van importactie indien men de importactie heeft teruggedraaid. Zie kopje //Terugdraaien van import actie// op deze pagina). Vandaar dat bij iedere importactie gevraagd wordt aan diegene die de actie start, om het juiste bestand aan te wijzen.\\+De inhoud van het bestand zal wel wijzigen voor iedere importactie: immers eenmaal ingelezen, dan zal men niet opnieuw dezelfde data in willen lezen (m.u.v. het opnieuw draaien van een importactie indien men de importactie heeft teruggedraaid. Zie kopje //Terugdraaien van import actie// op deze pagina). Vandaar dat bij iedere importactie gevraagd wordt aan diegene die de actie start, om het juiste bestand aan te wijzen.\\
  
-Voor het inrichten van iedere generieke bulk importactie zijn een aantal zaken van belang om te weten die met de file te maken hebben: +Voor het inrichten van een generieke bulk importactie is een aantal zaken van belang om te weten die met de file te maken hebben: 
-  * opzet van bestand waarin de in te lezen waardes staan (in welke kolom van de CSV of Excel staat welke waarde) +  * De opzet van het bestand waarin de in te lezen waardes staan (in welke kolom van de CSV of Excel staat welke waarde) 
-  * bestandtype van de file (CSV of Excel) +  * Het bestandtype van de file (CSV of Excel) 
     * indien CSV dan zal opgegeven worden bij het inrichten in tbimportmatrijs:     * indien CSV dan zal opgegeven worden bij het inrichten in tbimportmatrijs:
-      * CSVlimit: met welk teken de kolommen van elkaar gescheiden zijn (indien niet opgegeven gaat programmatuur uit van default teken: puntkomma) +      * CSVlimit: met welk teken de kolommen van elkaar gescheiden zijn (indien niet opgegeven, dan gaat de programmatuur uit van het default teken: puntkomma) 
-      * CSVQuote (omgrenzingswaarde): tussen welk teken de waarde binnen een kolom staan (indien niet opgegeven gaat programmatuur uit dat er geen omgrenzingswaarde is) +      * CSVQuote (het begrenzingsteken): tussen welke tekens de waarde binnen een kolom staan (indien niet opgegeven gaat programmatuur uit dat er geen begrenzingsteken is) 
-      * of null/lege waardes in een kolom ook omsloten zijn door het bovengenoemde omgrenzingsteken+      * of null/lege waardes in een kolom ook omsloten zijn door het bovengenoemde begrenzingsteken
     * indien Excel dan kan men met verschillende werkbladen werken:     * indien Excel dan kan men met verschillende werkbladen werken:
-      * indien dit zo is dan kan per importmatrijs opgegeven worden de naam van het werkblad waar de programmatuur naar moet kijken +      * indien dit zo is dan kan per importmatrijs opgegeven worden wat de naam is van het werkblad waar de programmatuur naar moet kijken 
-      * indien dit niet zo is dan kan bij de importmatrijs het veld voor werkblad leeggelaten worden: de programmatuur kijkt dan altijd naar het eerste tabblad van de Excel file +      * indien dit niet zo is dan kan bij de importmatrijs het veld voor het werkblad leeggelaten worden: de programmatuur kijkt dan altijd naar het eerste tabblad van de Excel file 
-  * de beginregel van de file (zowel bij Excel als CSV van toepassing):+  * De beginregel van de file (zowel bij Excel als CSV van toepassing):
     * indien men gebruik maakt van kopregels dan moet per importmatrijs aangegeven worden vanaf welke regel de programmatuur de file moet gaan verwerken (de eerste regel waar de daadwerkelijke data staat om ingelezen te worden)     * indien men gebruik maakt van kopregels dan moet per importmatrijs aangegeven worden vanaf welke regel de programmatuur de file moet gaan verwerken (de eerste regel waar de daadwerkelijke data staat om ingelezen te worden)
-    * indien men gelijk vanaf eerste regel in de file de data om ingelezen te worden heeft staan, dan hoeft men niet de beginregel te vullen bij de importmatrijs+    * indien men gelijk vanaf regel één in de file de data om ingelezen te worden heeft staan, dan hoeft men niet de beginregel te vullen bij de importmatrijs
  
-Met deze informatie kan men beginnen met het daadwerkelijk aanmaken van regels in de tabellen bedoelt voor inrichten van bulk importacties. +Met deze informatie kan men beginnen met het daadwerkelijk aanmaken van regels in de tabellen bedoelt voor het inrichten van bulk importacties. 
-Daarbij wordt gestart met het aanmaken van een regel in de tabel tbimportmatrijs:+Daarbij wordt gestart met het aanmaken van een regel in de tabel tbimportmatrijs.
  
 ==== Importmatrijs ==== ==== Importmatrijs ====
Regel 90: Regel 93:
 ==== Importmatrijsregels ==== ==== Importmatrijsregels ====
 In de lijst met importmatrijsregels wordt via de plus-knop een wizard gestart waarmee een importmatrijsregel wordt aangemaakt.\\ In de lijst met importmatrijsregels wordt via de plus-knop een wizard gestart waarmee een importmatrijsregel wordt aangemaakt.\\
-Er moeten evenzoveel importmatrijsregels worden aangemaakt als men velden benodigd heeft voor een insertactie.\\ +Er moeten evenzoveel importmatrijsregels worden aangemaakt als dat men velden benodigd heeft voor een insertactie.\\ 
-Dus bijvoorbeeld als de doeltabel van de bovenliggende matrijs 4 verplichte velden heeft en 3 velden die men ook wilt meegeven, dan moeten er 7 regels worden aangemaakt in tbimpormatrijsregels.\\+Bijvoorbeeld: in het geval dat de doeltabel van de bovenliggende matrijs 4 verplichte en 3 optionele velden heeft, dan moeten er 7 regels worden aangemaakt in tbimpormatrijsregels.\\
 Samen maken de importmatrijsregels onder één importmatrijs dan de definitie van één insert voor een regel in de doeltabel.\\ Samen maken de importmatrijsregels onder één importmatrijs dan de definitie van één insert voor een regel in de doeltabel.\\
 Indien er tijdens de daadwerkelijke importactie (dus tijdens het draaien van de generieke bulk import) in de vervolgactie(s) verwezen moet worden naar de net aangemaakte kaarten in de doeltabel, dan zal er ook een kaartje aangemaakt moeten worden in tbimportsleutels.\\ Indien er tijdens de daadwerkelijke importactie (dus tijdens het draaien van de generieke bulk import) in de vervolgactie(s) verwezen moet worden naar de net aangemaakte kaarten in de doeltabel, dan zal er ook een kaartje aangemaakt moeten worden in tbimportsleutels.\\
-Dit gebeurd automatisch indien men één importmatrijsregel aanmaakt met als naam van het veld **IkBenSleutelVeld**. In de bron/kolombewerking schrijft men vervolgens uit hoe gerefereerd gaat worden naar het aangemaakte kaartje. Zie kopje //Import sleutels// voor een voorbeeld.+Dit gebeurt automatisch wanneer men één importmatrijsregel aanmaakt met als naam van het veld**IkBenSleutelVeld**. In de bron/kolombewerking schrijft men vervolgens uit hoe gerefereerd gaat worden naar het aangemaakte kaartje. Zie kopje //Import sleutels// voor een voorbeeld.
  
 Iedere importmatrijsregel wordt als volgt gedefinieerd: Iedere importmatrijsregel wordt als volgt gedefinieerd:
Regel 212: Regel 215:
 Het bestand dat men geüpload heeft bij het starten van de bulk importactie (bestand met de in te lezen gegevens) kan men downloaden bij de operationslogregel.\\ Het bestand dat men geüpload heeft bij het starten van de bulk importactie (bestand met de in te lezen gegevens) kan men downloaden bij de operationslogregel.\\
 Deze wordt (tijdelijk) bewaard op een map die automatisch wordt aangemaakt bij de eerste keer starten van de generieke bulk import Deze wordt (tijdelijk) bewaard op een map die automatisch wordt aangemaakt bij de eerste keer starten van de generieke bulk import
-(hiervoor bestaat instelling //Sectie: OWV, Item: TussenMapBulkImportFiles, Tekst: /tmp/openwave/bulkimportfiles///).\\+(hiervoor bestaat instelling //Sectie: OWB, Item: TussenMapBulkImportFiles, Tekst: /tmp/openwave/bulkimportfiles///).\\
 Voor het downloaden klikt men in de operationslogregel op downloadknop linksonder met de hint **Download bestand van tempmap**. Voor het downloaden klikt men in de operationslogregel op downloadknop linksonder met de hint **Download bestand van tempmap**.
 </adm> </adm>
  
-===== Terugdraaien van import actie ===== +===== Terugdraaien van importactie ===== 
-In de audit tabel van OpenWave wordt bijgehouden in welke tabellen, welke regels (primary key) worden aangemaakt tijdens een bulk importactie. Dit werkt als volgt: tijdens het draaien van een generieke bulk importactie wordt voor iedere regel die in een tabel wordt aangemaakt, in tbaudit een regel aangemaakt met naam van de tabel, primary key van de nieuwe regel, dat het om een insert gaat, en veld dvbron krijgt waarde ‘I' om aan te geven dat de regel uit de bulk import komt.+Het kan natuurlijk voorkomen dat een gedraaide bulk importactie niet het gewenste resultaat geeft, bijvoorbeeld als de inrichting niet helemaal correct is of de data uit het inleesbestand niet juist bleek.  
 +Wat de aanleiding ook is, er is altijd de mogelijkheid in OpenWave om de via de bulk import aangemaakte regels te verwijderen.\\ 
 + 
 +Omwille van het mogelijk kunnen terugdraaien van een bulk importactie wordt er in OpenWave bijgehouden in welke tabellen, welke regels (primary key) worden aangemaakt tijdens een bulk importactie. \\ 
 +Dit werkt als volgt: tijdens het draaien van een generieke bulk importactie wordt voor iedere regel die in een tabel wordt aangemaakt, in tbaudit een regel aangemaakt met naam van de tabel, primary key van de nieuwe regel, dat het om een insert gaat, en veld dvbron krijgt waarde ‘I' om aan te geven dat de regel uit de bulk import komt. 
 + 
 +<adm Inzien aangemaakte regels in Audit> 
 +Los van of men de importactie wilt terugdraaien of niet: in de audit tabel van OpenWave wordt bijgehouden welke regels in welke tabellen zijn aangemaakt via de generieke bulk import.\\ 
 +Deze regels zijn te herkennen aan de letter 'I' in de kolom //Bron// in de Audit-lijst. 
 +</adm> 
 + 
 +==== Werkwijze ====
  
 In het lijstscherm van de Audit is linksonder een knop beschikbaar gekomen die een wizard start om de bulkactie ongedaan te maken. In het lijstscherm van de Audit is linksonder een knop beschikbaar gekomen die een wizard start om de bulkactie ongedaan te maken.
  • openwave/1.33/applicatiebeheer/probleemoplossing/programmablokken/generiekebulkimport.1761907312.txt.gz
  • Laatst gewijzigd: 2025/10/31 11:41
  • door Lonneke van Dijk