Verschillen

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

--- openwave:1.32:applicatiebeheer:instellen_inrichten:actions [2024/11/26 06:12] – Kars Gottschal
+++ openwave:1.32:applicatiebeheer:instellen_inrichten:actions [2025/05/26 12:28] (huidige) – Externe bewerking 127.0.0.1
@@ Regel 1: / Regel 1: @@
 ======= Actions =======
 {{tag>openwave:1.32:applicatiebeheer:functionaliteiten:applicatiebouw}}
 ===== Wat is een action =====
@@ Regel 81: / Regel 83: @@
     * param2: De tweede parameter is {id} of bevat een waarde waarmee de substring {id} van die query wordt gesubstitueerd
   * autorisatie: Wordt geregeld in de autorisatiekolommen van tbqueries en anderzijds - indien mogelijk - door de API die door de uiteindelijke action wordt aangeroepen
+<adm warning>
+Het is raadzaam dat wanneer de action startwizard(showtekst)  wordt gebruikt, waarbij deze een tekst ophaalt uit een kolom waarbij harde returns en linefeeds kunnen worden gebruikt (bij voorbeeld een memo), deze aanroep te laten lopen via getFlexAction.
+</adm>
-<adm example>
+<adm voorbeeld getflexaction en showtekst>
 Een voorbeeld van het gebruik van een getFlexAction in de definitie van het lijstscherm van de processtappen (termijnbewakingstappen) bij een zaak, zoals die default wordt uitgeleverd: \\
 De kolom void in MDLC_GeefProcessenoverzicht toont een klikbaar vraagtekenicoon indien de kolom dvprocitemtoelichting op de regel is gevuld (de query achter celvisible) EN indien de instelling //Sectie: Termijnbewaking Item: ToelichtingZichtbaar// is aangevinkt (de query achter visible).\\
@@ Regel 99: / Regel 105: @@
 Met het aanklikken van het vraagtekenicoontje wordt de query //termijnbewaking_toelichting// geëvalueerd die aangeroepen wordt met de getFlexAction met de {id} ofwel de dnkey van tbtermijnbewstappen-rij als parameter.\\
-Dat levert de action //startWizard(showtekst,' || coalesce(replace(dvprocitemtoelichting,chr(44),chr(32)),'Sorry. Geen toelichting aanwezig') || ',Toelichting op processtap,300)' from tbtermijnbewstappen  where dnkey = {id}// op, die vervolgens wordt uitgevoerd.
+Die query:
+   select startWizard(showtekst,beginarg(' || coalesce(dvprocitemtoelichting ,'Sorry Geen toelichting aanwezig') || ')endarg,
+   Toelichting op processtap,300)' from tbtermijnbewstappen  where dnkey = {id}
+Het evalueren van de query levert een aanroep naar een action startwizard(showtekst) op , die vervolgens uitgevoerd wordt:
+  startWizard(showtekst,beginarg(ja ff documentje starten snap je wel?)endarg,Toelichting op processtap,300)
+Het gebruik van //beginarg(// en //)endarg// voorkomt dat komma's in de inhoud van dvprocitemtoelichting gezien worden als parameterscheiding.
 </adm>
-<adm example>
+<adm voorbeeld getflexaction en hoovertekst>
 Een tweede voorbeeld is de aanroep bij het hooveren over het groepicoontje op de lijst alle zaken (openingsportaal). Die kolom in de MDLC_AlleZakenList.xml is als volgt gedefinieerd.
    <column tagnaam="dnkeygroepvergunning">
         <label>Groep</label>
@@ Regel 112: / Regel 125: @@
         <hooverhint>getFlexAction(groep_inhoudtekst,{dnkeygroepvergunning})</hooverhint>
     </column>
 De tag hooverhint moet bij afspraak gevuld worden met de aanroep getFlexAction(querynaam,{id-naam}) waarbij de query een string teruggeeft. Deze string wordt getoond bij het hooveren over de kolom in de lijst, waarbij puntkomma's in de string worden geïnterpreteerd als een harde return.\\ Voorbeeld: het groepvergunningicoontje in de lijst alle zaken. De hooverhint is hier gedefinieerd als //getFlexAction(groep_inhoudtekst,{dnkeygroepvergunning})//. Dus de query met de naam //groep_inhoudtekst// wordt aangeroepen met de parameter dnkeygroepvergunning (uit vwfrmalleaanvragen) van de rij waar de gebruiker over het icoontje hoovert. De query retourneert startdatum, betreft en wavezaakcode van de leden van de groep, gescheiden met een puntkomma. \\ Door het gebruik van getFlexAction wordt de query pas aangeroepen wanneer daar om gevraagd wordt.
 </adm>
+<adm voorbeeld één getflexaction voor zowel getflexballoon als showtekst>
+Dt voorbeeld is dat achter een geflexballoon-knop en een starttwizard(showtekst)-knop verwezen kan worden naar eenzelfde query: de actie achter de twee knoppen tonen dezelfde inhoud, alleen in een ander jasje.\\
+action bij  knop showtekst: //getFlexAction(TestPaul_3_HaalMemoOp,**S**%keypointer%)//\\
+action bij  knop flexballoon: //getFlexAction(TestPaul_3_HaalMemoOp,**F**%keypointer%)//\\
+De query: //TestPaul_3_HaalMemoOp// ontleedt de substitutie van {id} , dus begint met letter **S** of **F** en construeert de gewenste vervolg actieaanroep.\\
+  select
+    case when substr('{id}',1,1) = 'F' then
+        'getFlexBalloon(beginarg(' || coalesce(replace(dvmemo,chr(13)||chr(10),chr(59)),'Sorry. Geen memotekst aanwezig')|| ')endarg,P)'
+         else
+         'startWizard(showtekst,beginarg(' || coalesce(dvmemo,'Sorry. Geen memotekst aanwezig')|| ')endarg,Memo bij adres,300)'
+    end
+  from tbomgvergunning where dnkey = substr('{id}',2)::integer
+Voor getFlexBaloon worden de linefeeds en returns vervangen worden door een puntkomma.
+</adm>
 ==== geefGeoVanLokatie ====
@@ Regel 144: / Regel 176: @@
   * autorisatie: Niet van toepassing
   * Voorbeeld: //getFlexBalloon(Hier alleen voorletters; zonder punt en spaties,P)//.
+<adm voorbeeld ophalen memo-kolom in flexballoon>
+Indien een query wordt aangeroepen, waarbij de waarde van een kolom wordt opgehaald waarin linefeeds en harde returns kunnen zitten (memo),  is het belangrijk dat de query deze linefeeds en returns vervangt door een puntkomma: \\
+aanroep:  //getFlexBalloon(%query(TestPaul_2_HaalMemoOp,%keypointer%)%,P)//\\
+de query //TestPaul_2_HaalMemoOp// kan dan bijvoorneeld de volgende select bevatten:
+  select  'beginarg(' || coalesce( replace(dvmemo,chr(13)||chr(10),chr(59)),'Sorry. Geen memotekst aanwezig') || ')endarg'
+  from tbomgvergunning where dnkey = {id}
+Het gebruik van //beginarg(// en //)endarg// voorkomt dat komma's in de inhoud van dvmemo gezien worden als parameterscheiding.
+</adm>
 ==== noAction ====
@@ Regel 214: / Regel 255: @@
   * **startWizard(maaknieuwproces,param2,param3)** waarbij een wizard wordt gestart teneinde een vervolgproces te kiezen vanuit de procesbewaking. Zie uitgewerkte voorbeelden onder kopje action bij [[openwave:1.32:applicatiebeheer:instellen_inrichten:inrichting_processen:termijnstappen]].
   * **startWizard(maaknieuwezaak,param2,param3,param4)** waarbij een wizard wordt gestart teneinde een nieuwe hoofdzaak te definiëren. Zie uitgewerkte voorbeelden onder kopje action bij [[openwave:1.32:applicatiebeheer:instellen_inrichten:inrichting_processen:termijnstappen]] EN bij lemma [[openwave:1.32:applicatiebeheer:probleemoplossing:programmablokken:maak_nieuwe_zaak]].
-  * **startwizard(showTekst,param2,param3,param4)** waarbij een wizard wordt gestart van één scherm met alleen een sluitknop die de tekst uit param2 toont.
+  * **startwizard(showTekst,param2,param3,param4)** waarbij een wizard wordt gestart van één scherm met alleen een sluitknop die de tekst uit param2 toont. Indien de  tekst wordt opgehaald uit een kolom die ook linefeeds en harde returns kan bevatten (zoals een memo) moet de aanroep via getflexaction verlopen: zie voorbeeld hierbioven bij getFlexAction.
     * Voorbeeld: startWizard(showTekst, dit is een tekst,dit is de koptekst,400)
     * param1: showTekst
@@ Regel 283: / Regel 324: @@
     * param3: Deze parameter wordt momenteel (nog) niet gebruikt en moet leeg zijn.
     * param4: Dit mag de dnkey van een termijnstap zijn (bijvoorbeeld %keypointer%), deze parameter mag leeg zijn.
+  * **startwizard(InsertRolContact,param2,param3;dnkeytermijnstap)** waarbij een wizard wordt gestart die een contactpersoon, en diens rol, toevoegd aan de bovenliggende zaak. Deze wizard mag ook aangeroepen worden vanuit een termijnstap.
+    * param1: InsertRolContact, dit is de naam van de wizard
+    * param2: Deze parameter moet gevuld zijn met de dnkey van de hoofdtabel die hoort bij de in param3 aangegeven moduleletter (bijvoorbeeld %keyparent%).
+    * param3: Moet tenminste gevuld zijn met de module letter, deze mag niet leeg zijn EN moet de letter **B**(ouw/sloop), **W**(abo/omgeving), **O**(overig/diversen/APV), **C**(horeca), **V** (inrichtingen), **E**(milieuvergunning) of **I**(nfo-aanvraag) zijn.
+    * dnkeytermijnstap: Indien deze wizard aangeroepen moet worden vanuit een termijnstap dan MOET de moduleletter gevolgd worden door een puntkomma en de dnkey van de termijnstap (bijvoorbeeld %keypointer%).
 ==== Action column:kolomnaam ====