| Beide kanten vorige revisie Vorige revisie Volgende revisie | Vorige revisie |
| openwave:1.30:applicatiebeheer:instellen_inrichten:actions [2024/02/07 14:34] – Ton Pullens | openwave:1.30:applicatiebeheer:instellen_inrichten:actions [2024/03/13 15:49] (huidige) – Lonneke van Dijk |
|---|
| ======= Actions ======= | ======= Actions ======= |
| | {{tag>openwave:1.30:applicatiebeheer:functionaliteiten:applicatiebouw}} |
| ===== Wat is een action ===== | ===== Wat is een action ===== |
| |
| * param2: De tweede parameter is {id} of bevat een waarde waarmee de substring {id} van die query wordt gesubstitueerd | * 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 | * autorisatie: Wordt geregeld in de autorisatiekolommen van tbqueries en anderzijds - indien mogelijk - door de API die door de uiteindelijke action wordt aangeroepen |
| * voorbeeld aanroep bij tag ''<action>'' van een schermknop in lijst: //getFlexAction(testAction,{id})//. De query met dvcode = testAction kan bijvoorbeeld zijn: <code sql>select 'openTabPage(' | | dvhyperlink | | ')'from tbtermijnbewstappen where dnkey = {id}</code> | |
| | <adm example> |
| | 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).\\ |
| |
| | <column tagnaam="void"> |
| | <label></label> |
| | <index>80</index> |
| | <length>60</length> |
| | <wavetype>schermknop</wavetype> |
| | <icoon>28</icoon> |
| | <showhint>false</showhint> |
| | <action>getFlexAction(termijnbewaking_toelichting,{id})</action> |
| | <visible>%query(termijnbewaking_toelichtingzichtbaar)%</visible> |
| | <celvisible>%query(termijnbewaking_celtoelichtingzichtbaar,{id})%</celvisible> |
| | </column> |
| | |
| | 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. |
| | </adm> |
| | <adm example> |
| | 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> |
| | <index>10</index> |
| | <length>40</length> |
| | <wavetype>icoon</wavetype> |
| | <icoon>12</icoon> |
| | <showhint>false</showhint> |
| | <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> |
| ==== geefGeoVanLokatie ==== | ==== geefGeoVanLokatie ==== |
| |
| * Wat doet het?: In een modal venster wordt een kaart getoond getoond op basis van de coördinaatgegevens van een detailkaart. Zie [[openwave:1.30:applicatiebeheer:probleemoplossing:module_overstijgende_schermen:kaart]] | * Wat doet het?: In een modal venster wordt een kaart getoond getoond op basis van de coördinaatgegevens van een detailkaart. Zie [[openwave:1.30:applicatiebeheer:probleemoplossing:module_overstijgende_schermen:kaart]] |
| * aanroep: geefgeovanLokatie(param1, param2): | * aanroep: geefGeoVanLokatie(param1, param2): |
| * param1: De eerste parameter moet de een primary key zijn van een tabel die hoort bij de tweede parameter. Met uitzondering indien param2 = //AlgemeneKaart//. In dat laatste geval kan param1 een lege waarde hebben | * param1: De eerste parameter moet de een primary key zijn van een tabel die hoort bij de tweede parameter. Met uitzondering indien param2 = //AlgemeneKaart//. In dat laatste geval kan param1 een lege waarde hebben |
| * param2: De tweede parameter is OF een tabelnaam OF de waarde //AlgemeneKaart//. De tabelnaam moet één van volgende zijn: tbperceeladressen, tbmilinrichtingen, tbmildiversen, tbmilemlucht, tbmilemwater, tbmilopslag, tbhorontheffingen, tbhandhavingen, tbovvergunningen, tbomgvergunning, tbmilasbest, tbmilvergunningen, tbbouwvergunningen, tbinfoaanveragen, tbhorecavergunningen, tbmilstal of tbzaakkadperc of tbmilafvalstoffen | * param2: De tweede parameter is OF een tabelnaam OF de waarde //AlgemeneKaart//. De tabelnaam moet één van volgende zijn: tbperceeladressen, tbmilinrichtingen, tbmildiversen, tbmilemlucht, tbmilemwater, tbmilopslag, tbhorontheffingen, tbhandhavingen, tbovvergunningen, tbomgvergunning, tbmilasbest, tbmilvergunningen, tbbouwvergunningen, tbinfoaanveragen, tbhorecavergunningen, tbmilstal of tbzaakkadperc of tbmilafvalstoffen |
| * Voorbeeld: startwizard(deleteContactadres,333) | * Voorbeeld: startwizard(deleteContactadres,333) |
| * param1: deleteContactadres | * param1: deleteContactadres |
| * param2: De dnkeywaarde van de contactadreskaart die verwijderd moet worden. Indien param2 de waarde {id} bevat: de API wordt aangeroepen vanuit een lijst, dan wordt deze string {id} on the fly door OpenWave vervangen met deze primary key-waarde van de actieve kaart uit een lijst). | * param2: De dnkeywaarde van de contactadreskaart die verwijderd moet worden. Indien param2 de waarde {id} bevat: de API wordt aangeroepen vanuit een lijst, dan wordt deze string {id} on the fly door OpenWave vervangen met deze primary key-waarde van de actieve kaart uit een lijst. |
| * **startwizard(deleteSysStandardRow,param2,param3,param4)** | * **startwizard(deleteSysStandardRow,param2,param3,param4)** |
| * Voorbeeld: startwizard(deleteSysStandardRow,tbadressoort.{id},dvomschrijving,beheer_tbadressoort) | * Voorbeeld: startwizard(deleteSysStandardRow,tbadressoort.{id},dvomschrijving,beheer_tbadressoort) |
| * param4: de code uit tbsysstandardtable die verwijst naar de kaart waar de betreffende tabel in is gedefinieerd. | * param4: de code uit tbsysstandardtable die verwijst naar de kaart waar de betreffende tabel in is gedefinieerd. |
| * **startwizard(koppelSysStandardRow,param2,param3,param4)** | * **startwizard(koppelSysStandardRow,param2,param3,param4)** |
| * Voorbeeld: startwizard(kopieerSysStandardRow,MDWC_insertTbMwTeams.xml,{id},beheer_tbmwteams) | * Voorbeeld: startwizard(koppelSysStandardRow,%keyparent%;dvomschrijving;;0, tbdocumentsoorten;dnkeydocsoort;dnkey;;dvomschrijving;;ddvervaldatum;1=1, beheer_vwfrmkopdocaandocsoort ) |
| * Aanroep van een standaard insertactie van een kaart van een tabel die gedefinieerd is in tbsysstandardtable (beheertegel //Tabellen Standaardapi//). Deze action kan bijv. aan een insertknop onder aan een lijst gekoppeld worden. De functie houdt rekening met de in de tbsysstandardbutton gedefinieerde rechten bij die knop en met het al of niet gevuld zijn van de in de tbsysstandardtable gedefinieerde blokkeringsvelden | * Aanroep van een meerdere inserts tegelijk op een koppeltabel die gedefinieerd is in tbsysstandardtable (beheertegel //Tabellen Standaardapi//) als dochtertabel (dus voorzien van een parentkey). Deze action kan bijv. aan een insertknop onder aan een lijst gekoppeld worden. De gebruiker kan uit een derde tabel rijen aanvinken op grond waarvan nieuwe kaarten worden toegevoegd en/of verwijderd in de standaardtabel. De functie houdt rekening met de in de tbsysstandardbutton gedefinieerde rechten bij die knop en met het al of niet gevuld zijn van de in de tbsysstandardtable gedefinieerde blokkeringsvelden. Zie ook knoppen bij [[openwave:1.30:applicatiebeheer:instellen_inrichten:standardlist_standarddetail|]] |
| * param1: kopieerSysStandardRow | * param1: koppelSysStandardRow |
| * param2: De naam van de screen.xml waarin de opmaak van het insertscherm is geregeld. De naam moet beginnen 'MDWC_'. De xml moet aan een aantal voorwaarden voldoen. Zie: [[openwave:1.30:applicatiebeheer:instellen_inrichten:schermdefinitie:scherminfomatie_voor_standaard_insertschermen]]. Kan in veel gevallen dus gelijk zijn aan het scherm dat hoort bij de insertStandardRow | * param2: Bestaat uit vier delen gescheiden door een puntkomma. |
| * param3: Wordt gevuld met de dnkey van de rij waar je op staat. Indien de kopieerknop onderaan een lijst staat kan {id} worden gebruikt, en anders, op een detailscherm, %keypointer% | * Eerste deelparameter is de waarde van de parentkey naar de parenttabel (in te geven als %keyparent% en wordt on the fly vervangen met de echte waarde). |
| | * Twee deelparameter is een veldnaam uit de parenttabel waarvan de waarde gebruikt wordt in de koptekst. |
| | * De derde deelparameter is optioneel en bevat - indien gevuld - een veldnaam uit de parenttabel die een moduleletter bevat. Mag dus leeg zijn. |
| | * De vierde deelparameter is leeg of 0 of 1. Indien 0 of leeg dan worden de rijen in de standaardtabel (de koppeltabel) gelijkgemaakt met de aangevinkte rijen van de codetabel. Sommige worden dus verwijderd, sommige worden toegevoegd. Indien de waarde 1 dan worden alle aangevinkte rijen altijd toegevoegd aan de standaardtabel. |
| | * param3: Bestaat uit acht delen gescheiden door een puntkomma. |
| | * De eerste deelparameter is de tabelnaam van de codetabel |
| | * De tweede deelparameter is de veldnaam van de foreign-key kolom uit de koppeltabel naar de codetabel |
| | * De derde deelparameter is de veldnaam van de primary key van de codetabel |
| | * De vierde deelparameter is een veldnaam uit de codetabel die getoond kan worden in het aanvinkscherm. Mag leeg zijn. |
| | * De vijfde deelparameter is een veldnaam uit de codetabel die getoond moet worden in het aanvinkscherm. Mag NIET leeg zijn. |
| | * De zesde deelparameter is optioneel en bevat - indien gevuld - een veldnaam uit de codetabel die een moduleletter bevat. Mag dus leeg zijn. |
| | * De zevende deelparameter is optioneel en bevat - indien gevuld - een veldnaam uit de codetabel die gevuld kan zijn met een vervaldatum. Indien gevuld dan zijn de vervallen items niet zichtbaar in het keuzelijstscherm. |
| | * De achtste deelparameter is optioneel en bevat een extra where clausule die aan de query die ten grondslag aan de keuzelijst wordt toegevoegd. Bijvoorbeeld //substr(dvcode,1,1) = 'R'// of //dnminwaarde > 40// |
| * param4: de code uit tbsysstandardtable die verwijst naar de kaart waar de betreffende tabel in is gedefinieerd. | * param4: de code uit tbsysstandardtable die verwijst naar de kaart waar de betreffende tabel in is gedefinieerd. |
| * **startWizard(selecteerTaak,param2)** waarbij een wizard wordt gestart om een selectie te maken van openstaande taken op medewerker(s), modules en taaksoorten. De waarde 1 bij param2 geeft aan dat de zoekwizard blijft staan. | * **startWizard(selecteerTaak,param2)** waarbij een wizard wordt gestart om een selectie te maken van openstaande taken op medewerker(s), modules en taaksoorten. De waarde 1 bij param2 geeft aan dat de zoekwizard blijft staan. |