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.33:applicatiebeheer:probleemoplossing:programmablokken:generiekebulkimport [2025/10/31 09:29] – [Daadwerkelijk aanroepen van Generieke bulk import] Lonneke van Dijk | openwave:1.33:applicatiebeheer:probleemoplossing:programmablokken:generiekebulkimport [2025/11/17 15:51] (huidige) – [Operationslog] Lonneke van Dijk | ||
|---|---|---|---|
| Regel 22: | Regel 22: | ||
| </ | </ | ||
| - | 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, | ||
| - | Zie voor deze voorbeelden: | ||
| 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' | ||
| + | Zie voor deze voorbeelden: | ||
| + | * [[openwave: | ||
| + | * [[openwave: | ||
| + | |||
| + | |||
| ===== 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 | + | * Wat moet de importactie doen? Stel men wilt bijvoorbeeld |
| * 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 |
| - | * bij de hoofdmatrijs | + | * bij de hoofdmatrijs |
| - | * een tweede vervolgactie voor aanmaken inspectiebezoeken onder de aangemaakte inspecties (nieuwe regel in tbimportmatrijs met dlhoofdmatrijs = F) | + | * een tweede vervolgactie voor het aanmaken |
| - | * bij de importmatrijs voor inspecties | + | * bij de importmatrijs voor het aanmaken |
| - | * 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 | + | * in het voorbeeld |
| - | * 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: | + | * of indien men van de functionaliteit [[openwave: |
| - | Na het uitdenken van het proces kan men starten met het inrichten van de gewenste bulk importactie. Te beginnen met het bestand | + | Na het uitdenken van het proces kan men starten met het inrichten van de gewenste bulk importactie. Te beginnen met het bestand |
| ==== 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 |
| - | De inhoud van het bestand zal wijzigen voor iedere importactie: | + | 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, |
| - | 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, | + | De inhoud van het bestand zal wel wijzigen voor iedere importactie: |
| - | Voor het inrichten van iedere | + | Voor het inrichten van een generieke bulk importactie |
| - | * 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 | + | * CSVQuote (het begrenzingsteken): tussen |
| - | * of null/lege waardes in een kolom ook omsloten zijn door het bovengenoemde | + | * of null/lege waardes in een kolom ook omsloten zijn door het bovengenoemde |
| * 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 |
| - | * 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 | + | * 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 | + | Bijvoorbeeld: |
| 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 | + | Dit gebeurt |
| Iedere importmatrijsregel wordt als volgt gedefinieerd: | Iedere importmatrijsregel wordt als volgt gedefinieerd: | ||
| Regel 115: | Regel 118: | ||
| ==== Import sleutels ==== | ==== Import sleutels ==== | ||
| - | <hier komt stukje uitleg over sleutels aanmaken/ | ||
| - | Voor de inrichting kan het mogelijk zijn, afhankelijk van wat men wilt, om met vaste sleutelwaardes te werken. Deze sleutelwaardes | + | Voor de inrichting kan het mogelijk zijn, afhankelijk van wat men wilt, om met vaste sleutelwaardes te werken. Deze sleutelwaardes |
| + | Hoe dit werkt wordt aan de hand van onderstaand voorbeeld uitgelegd: \\ | ||
| + | Stel in het bestand met de in te lezen data staan gegevens van aan te maken inspecties en inspectiebezoeken en de inrichtingnummers waaronder deze inspecties aan te maken.\\ | ||
| + | Voor het inlezen van de inspecties is het nodig om de corresponderende dnkey van de inrichting op te halen. Dit kan met een select statement in tbimportmatrijsregels. Maar kan ook door in de tabel voor import sleutels de dnkeys van de inrichtingen vast te leggen.\\ | ||
| + | Dit doet men als volgt:\\ | ||
| + | * klik op de plus-knop in de lijst van import sleutels | ||
| + | * kies hier de naam van de tabel waarin het veld staat waarnaar verwezen moet worden. In het voorbeeld is dit tbmilinrichtingen | ||
| + | * vervolgens bij // | ||
| + | * bij // | ||
| + | * dit herhaalt men totdat alle benodigde sleutels zijn aangemaakt | ||
| + | De importmatrijsregel voor de dnkeymilinrichtingen vullen bij tbinpspecties is dan als volgt gedefinieerd: | ||
| + | * doelveld = dnkeymilinrichtingen | ||
| + | * Bron/ | ||
| + | * de kolom in het bestand waarin het inrichtingnummer staat, als voorbeeld is hiervoor kolom 1 genomen | ||
| + | * sleutel = tbmilinrichtingen | ||
| + | |||
| + | Dit zorgt ervoor dat bij het draaien van de generieke bulk import, regels worden aangemaakt in tbinspecties onder de inrichting van het opgegeven inrichtingnummer in het bestand.\\ | ||
| + | Bovengenoemd voorbeeld is het vooraf vastleggen van vaste sleutelwaardes.\\ | ||
| + | Het tijdens de bulk importactie vastleggen van nieuwe vaste sleutelwaardes is ook benodigd in ons voorbeeld. Want onder de aangemaakte inspecties, wil men graag bezoeken aanmaken.\\ | ||
| + | Hiervoor zijn er rijtjes in tbimportsleutels nodig voor de net aangemaakte inspecties. Dit wordt geregeld, zoals hierboven al genoemd, door bij de importmatrijs voor tbinspecties, | ||
| + | Zo'n importmatrijsregel ziet er dan als volgt uit: \\ | ||
| + | * doelveld = IkBenSleutelVeld | ||
| + | * Bron/ | ||
| + | * de kolom in het bestand waarin de verwijzing naar inspectie staat (bijvoorbeeld de aan te maken inspectiecode), | ||
| + | * sleutelveld is leeg -> Niet gevuld | ||
| + | |||
| + | Bij het draaien van de bulk importactie zal dan voor iedere aangemaakte rij in tbinspecties, | ||
| + | Voor de vervolgactie van het aanmaken van bezoeken, definieert men dan in tbimportmatrijsregels voor veld dnkeyinspecties dat deze gevuld wordt door ophalen van de juiste waarde uit de sleuteltabel. | ||
| ===== Starten van Generieke bulk import ===== | ===== Starten van Generieke bulk import ===== | ||
| In het Operationsportaal is onder kolom //Import// nieuwe tegel **Start generieke bulk import** ([[openwave: | In het Operationsportaal is onder kolom //Import// nieuwe tegel **Start generieke bulk import** ([[openwave: | ||
| Regel 128: | Regel 157: | ||
| </ | </ | ||
| + | ==== Werkwijze ==== | ||
| De importactie zal beginnen met het controleren van een aantal zaken: | De importactie zal beginnen met het controleren van een aantal zaken: | ||
| * rechtencheck: | * rechtencheck: | ||
| Regel 162: | Regel 192: | ||
| Er wordt niet opnieuw gekeken naar het bestandstype: | Er wordt niet opnieuw gekeken naar het bestandstype: | ||
| Maar er wordt gekeken in de importmatrijstabel van de vervolgactie op welk werkblad de gegevens staan voor de vervolgactie (indien Excel) en/of naar de beginregel (Excel en CSV).\\ | Maar er wordt gekeken in de importmatrijstabel van de vervolgactie op welk werkblad de gegevens staan voor de vervolgactie (indien Excel) en/of naar de beginregel (Excel en CSV).\\ | ||
| - | Na uitvoeren van de vervolgactie wordt weer gekeken of er nog een vervolg is enz. enz. tot alle acties | + | Na uitvoeren van de vervolgactie wordt weer gekeken of er nog een vervolg is enz. enz. tot alle inleesacties |
| Regel 185: | 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 // | + | (hiervoor bestaat instelling // |
| 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**. | ||
| </ | </ | ||
| - | ===== 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 | ||
| + | |||
| + | Omwille van het mogelijk kunnen terugdraaien van 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 ' | ||
| + | </ | ||
| + | |||
| + | ==== 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. | ||
| Regel 220: | Regel 261: | ||
| Tevens is in de configuratietabel terug te zien of er al een proces draait voor terugdraaien van een bulk importactie: | Tevens is in de configuratietabel terug te zien of er al een proces draait voor terugdraaien van een bulk importactie: | ||
| In de logging bij de regel in de operationslog is terug te zien: | In de logging bij de regel in de operationslog is terug te zien: | ||
| - | * als een regel niet verwijderd | + | * als een regel niet verwijderd |
| * of het proces klaar is | * of het proces klaar is | ||
| * het aantal verwijderde regels | * het aantal verwijderde regels | ||