Verschillen
Dit geeft de verschillen weer tussen de geselecteerde revisie en de huidige revisie van de pagina.
| Volgende revisie | Vorige revisie | ||
| openwave:1.30:applicatiebeheer:instellen_inrichten:actions [2024/01/08 09:06] – aangemaakt - Externe bewerking 127.0.0.1 | openwave:1.30:applicatiebeheer:instellen_inrichten:actions [Ongeldige datum] (huidige) – verwijderd - Externe bewerking (Ongeldige datum) 127.0.0.1 | ||
|---|---|---|---|
| Regel 1: | Regel 1: | ||
| - | ======= Actions ======= | ||
| - | |||
| - | ===== Wat is een action ===== | ||
| - | |||
| - | Een action is een aanroep naar een methode van OpenWave met de juiste parameters. Die action wordt gekoppeld aan een trigger (zoals een knop, of een tegel of dubbelklikken op een lijstregel). OpenWave roept de methode aan en het gevolg is dat een lijst- of detailscherm wordt geopend, of een nieuw tabblad met een URL, of een wizard die wordt opgestart, of een kaartje dat getoond wordt, een memo.... et cetera. | ||
| - | |||
| - | ===== Waar worden actions gedefinieerd ===== | ||
| - | |||
| - | Op vele plekken in OpenWave kan een action aan een trigger worden gekoppeld. Bijvoorbeeld: | ||
| - | |||
| - | * in de xml van een schermkolomdefinitie van een detailscherm, | ||
| - | * in de xml van een schermkolomdefinitie van een lijstscherm, | ||
| - | * in de tegeldefinitie (beheertegel //Portal//) waarbij de action wordt aangeroepen indien de gebruiker op de tegel drukt | ||
| - | * in een rapportdefinitie (beheertegel // | ||
| - | * in de definitie van een proces-termijnstap (beheertegel // | ||
| - | * in de definitie van lijst- en detailschermen via de beheertegel //Tabellen Standaardapi//, | ||
| - | * het dubbelklikken op regel van lijstscherm | ||
| - | * de knoppen van het lijstscherm en die van het detailscherm. | ||
| - | |||
| - | ===== Syntax en substitutie van variabelen ===== | ||
| - | |||
| - | In de meeste gevallen moet de action (methode + parameters) in één string worden gedefinieerd zoals: geefZaakMemo(12234, | ||
| - | |||
| - | OpenWave kan bij de aanroep van een action binnen die action-definitie de volgende substrings tegenkomen: | ||
| - | |||
| - | * %query(querynaam)% of %query(querynaam, | ||
| - | * de substring %keypointer% kan alleen worden gesubstitueerd (altijd met de primary key van het record dat actief is) wanneer de action wordt aangeroepen vanuit een detailscherm | ||
| - | * de substring %keyparent% kan alleen worden gesubstitueerd (altijd met de primary key van het moederrecord dat actief is) wanneer de action wordt aangeroepen vanuit een lijst- of detailscherm dat als dochter is gedefinieerd | ||
| - | * %keyaccount% zal vervangen worden met de waarde van tbmedewerkers.dvcode van de inlogger | ||
| - | * %inlogger% met de waarde van tbmedewerkers.dvcode van de inlogger | ||
| - | * {id} kan alleen worden gebruikt bij een action die wordt uitgevoerd vanuit een lijstscherm (bijv. dubbelklikken op regel). De substring {id} wordt vervangen met de regel-id uit de lijst waar de gebruiker op dat moment op staat, die - meestal- de primary key bevat van de tabel waarop de lijst is gebaseerd. Toepassing: Zie het record in standaardapi-tabel met code // | ||
| - | * {kolomnaam_uit_onderliggendeview/ | ||
| - | |||
| - | |||
| - | ===== Welke OpenWave methodes kunnen worden gebruikt? ===== | ||
| - | |||
| - | Voor de onderstreepte items geldt dat de substring //{id}// of // | ||
| - | |||
| - | ==== openTabPage ==== | ||
| - | |||
| - | * Wat doet het?: Opent een nieuw tabblad met een kaart, externe website of een intern OpenWave portaal | ||
| - | * aanroep: openTabPage(param1) | ||
| - | * Indien: | ||
| - | * param1 begint met de substring (http) dan wordt geacht dat param1 een URL bevat bijvoorbeeld %%https:// | ||
| - | * param1 bedoeld is een specifiek portaal binnen het domein van OpenWave te openen moet de portaalnaam en de dnkey worden doorgegeven bijv. openTabPage(# | ||
| - | * param1 de waarde //# | ||
| - | * param1 opgebouwd is als URI-aanroep voor openen of bewerken van een fileserver-document via een Microsoft-office pakket, dan zal OpenWave deze aanroep doorzetten in de URL-balk (met de juiste slashes) b.v. ms-word: | ||
| - | |||
| - | <adm warning> | ||
| - | **LET OP:** indien openTabPage vanuit een tegelaction wordt aangeroepen kunnen de parameters niet via een query aanroep worden gesubstitueerd. Dat moet in dat geval iets ingewikkelder via een flexaction: bijvoorbeeld de action op de tegel is // | ||
| - | </ | ||
| - | |||
| - | ==== getFlexList ==== | ||
| - | |||
| - | * Wat doet het?: In een modal venster wordt een standaard lijstscherm over een view of tabel getoond. Zie: | ||
| - | * aanroep: geefFlexList(param1, | ||
| - | * param1: De eerste parameter moet de waarde // | ||
| - | * param2: De tweede parameter kan leeg blijven | ||
| - | * param3: Indien de lijst een dochtertabel is van een andere tabel EN alleen die kaarten die horen bij een specifieke moederkaart getoond moeten worden, dan moet hier de primary key waarde komen van die moederkaart. Anders, de lijst wordt zelfstandig in een modal getoond zonder moeder, dan kan deze parameter leeg blijven | ||
| - | * param4: Heeft de waarde leeg, G of A. De lijst wordt met G opgestart met alle niet vervallen kaarten. Met A wordt de lijst gestart met alle kaarten. Het programma kijkt daarbij naar de // | ||
| - | * param5: De vijfde parameter moet verwijzen naar een dvcode uit de standaardapi-tabel (beheertegel //Tabellen Standaardapi)// | ||
| - | * autorisatie: | ||
| - | * voorbeeld aanroep lijst binnen een detailscherm van moeder: // | ||
| - | * voorbeeld aanroep vanuit action op tegel zelfstandig lijstscherm // | ||
| - | |||
| - | ==== getFlexDetail ==== | ||
| - | |||
| - | * Wat doet het?: In een modal venster wordt een standaard detailscherm over een view of tabel getoond. Zie: | ||
| - | * aanroep: geefFlexDetail(param1, | ||
| - | * param1: De eerste parameter moet de waarde // | ||
| - | * param2: De tweede parameter bevat de dnkey van de kaart waarvan het detailscherm wordt opgeroepen | ||
| - | * param3: De derde parameter moet verwijzen naar een dvcode uit de standaardapi-tabel (beheertegel //Tabellen Standaardapi// | ||
| - | * autorisatie: | ||
| - | * voorbeeld aanroep bij trigger dubbelklikken op rij in een lijst: // | ||
| - | |||
| - | ==== getFlexAction ==== | ||
| - | |||
| - | * Wat doet het?: Handig bij knoppen op lijsten, waarbij de action pas gedefinieerd kan worden nadat de gebruiker een regel actief heeft gemaakt. De uiteindelijk uit te voeren action wordt met deze methode eerst opgehaald uit een gedefinieerde query, waarbij vooraf de substring {id} van die query wordt gesubstitueerd door de waarde van param2. Indien param2 de waarde {id} heeft dan zal OpenWave deze vervangen door de identifier van de betreffende regel: meestal de dnkey van de tabel (de methode moet dan vanaf bijv. een schermknop op een lijst worden aangeroepen) | ||
| - | * aanroep: getFlexAction(param1, | ||
| - | * param1: De eerste parameter moet een bestaande dvcode uit de tabel tbqueries bevatten | ||
| - | * param2: De tweede parameter is {id} of bevat een waarde waarmee de substring {id} van die query wordt gesubstitueerd | ||
| - | * autorisatie: | ||
| - | * voorbeeld aanroep bij tag ''< | ||
| - | |||
| - | ==== geefGeoVanLokatie ==== | ||
| - | |||
| - | * Wat doet het?: In een modal venster wordt een kaart getoond getoond op basis van de coördinaatgegevens van een detailkaart. Zie [[openwave: | ||
| - | * aanroep: geefgeovanLokatie(param1, | ||
| - | * param1: De eerste parameter moet de een primary key zijn van een tabel die hoort bij de tweede parameter. Met uitzondering indien param2 = // | ||
| - | * param2: De tweede parameter is OF een tabelnaam OF de waarde // | ||
| - | * autorisatie: | ||
| - | * Voorbeeld: // | ||
| - | |||
| - | ==== getFlexMemo ==== | ||
| - | |||
| - | * Wat doet het?: In een modal venster wordt een memo (de kolom dvmemo) getoond | ||
| - | * aanroep: getFlexMemo(param1, | ||
| - | * param1: De eerste parameter moet de primary key zijn van de tabel die hoort bij de tweede parameter | ||
| - | * param2: De tweede parameter is de letter B (tbbouwvergunningen), | ||
| - | * autorisatie: | ||
| - | * Voorbeeld: // | ||
| - | |||
| - | ==== getFlexBalloon ==== | ||
| - | |||
| - | * Wat doet het?: In een hint-venster (ballontekst) behorende bij de knop waarmee deze methode wordt aangeroepen wordt een tekst getoond. <adm warning> | ||
| - | * aanroep: getFlexBalloon(param1, | ||
| - | * param1: Een gecrypte tekst of een niet gecrypte tekst of een evalueerbare query. Afhankelijk van param2 | ||
| - | * param2: | ||
| - | * D dan wordt de tekst in param1 in twee regels getoond in het ballonnetje. Eerste regel is param1 voorafgegaan door ' | ||
| - | * P dan wordt param1 ongewijzigd in de tekstballon getoond. Een semicolon (;) wordt daarbij geïnterpreteerd als harde return | ||
| - | * QD dan bevat param1 een evalueerbare query die één regel en één kolom als resultaat teruggeeft, bijvoorbeeld: | ||
| - | * QP dan bevat param1 een evalueerbare query die één regel en één kolom als resultaat teruggeeft, bijvoorbeeld: | ||
| - | * autorisatie: | ||
| - | * Voorbeeld: // | ||
| - | |||
| - | ==== noAction ==== | ||
| - | |||
| - | * Wat doet het?: Niets | ||
| - | * aanroep: noAction() | ||
| - | |||
| - | ==== refreshActiveDialog ==== | ||
| - | |||
| - | * Wat doet het?: Het scherm waarvandaan deze action wordt aangeroepen wordt opnieuw uitgeschreven | ||
| - | * aanroep: refreshActiveDialog() | ||
| - | * autorisatie: | ||
| - | |||
| - | ==== refreshActiveDialog(parameterlist) ==== | ||
| - | |||
| - | * Wat doet het?: Overschrijft het flexDetail- of flexListscherm waar je op staat, maar dan op basis van parameterlist. Bijvoorbeeld: | ||
| - | |||
| - | ==== startWizard ==== | ||
| - | |||
| - | * **startwizard(deleteContactadres, | ||
| - | * Voorbeeld: startwizard(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). | ||
| - | * **startwizard(deleteSysStandardRow, | ||
| - | * Voorbeeld: startwizard(deleteSysStandardRow, | ||
| - | * Aanroep van een standaard verwijderactie van een kaart van een tabel die gedefinieerd is in tbsysstandardtable (beheertegel //Tabellen Standaardapi// | ||
| - | * param1: deleteSysStandardRow | ||
| - | * param2: De tabelnaam waaruit een kaart verwijderd moet worden gevolgd door een punt gevolgd door {id}. Die {id} wordt on the fly door OpenWave vervangen met primary key-waarde van de kaart die verwijderd moet worden (bijv. de actieve kaart uit een lijst) | ||
| - | * param3: | ||
| - | * param4: de code uit tbsysstandardtable die verwijst naar de kaart waar de betreffende standaardlijst in is gedefinieerd. | ||
| - | * **startwizard(insertContactadres)** | ||
| - | * Aanroep vanuit een situatie dat een adres moet worden aangemaakt zonder deze via een rol te koppelen aan een inrichting of zaak. De wizard vraagt om elementaire gegevens waarmee een nieuwe kaart wordt aangemaakt waarna vervolgens automatisch het detailscherm van de contactadreskaart wordt aangeroepen getFlexDetail(tbcontactadressen, | ||
| - | * **startwizard(insertSysStandardRow, | ||
| - | * Voorbeeld: startwizard(insertSysStandardRow, | ||
| - | * Aanroep van een standaard insertactie van een kaart van een tabel die gedefinieerd is in tbsysstandardtable (beheertegel //Tabellen Standaardapi// | ||
| - | * param1: insertSysStandardRow | ||
| - | * param2: De naam van de screen.xml waarin de opmaak van het insertscherm is geregeld. De naam moet beginnen ' | ||
| - | * param3: Alleen gevuld indien de tabel waarop een insert wordt uitgevoerd een parenttabel heeft. Hier wordt de betreffende keywaarde van die parenttabel ingevuld. De waarde %keyparent% | ||
| - | * param4: de code uit tbsysstandardtable die verwijst naar de kaart waar de betreffende tabel in is gedefinieerd. | ||
| - | * **startwizard(kopieerSysStandardRow, | ||
| - | * Voorbeeld: startwizard(kopieerSysStandardRow, | ||
| - | * Aanroep van een standaard insertactie van een kaart van een tabel die gedefinieerd is in tbsysstandardtable (beheertegel //Tabellen Standaardapi// | ||
| - | * param1: kopieerSysStandardRow | ||
| - | * param2: De naam van de screen.xml waarin de opmaak van het insertscherm is geregeld. De naam moet beginnen ' | ||
| - | * 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, | ||
| - | * param4: de code uit tbsysstandardtable die verwijst naar de kaart waar de betreffende tabel in is gedefinieerd. | ||
| - | * **startWizard(selecteerTaak, | ||
| - | * **startWizard(maakDocument, | ||
| - | * **startWizard(maakEmail, | ||
| - | * **startWizard(maaknieuweInrichting, | ||
| - | * **startWizard(maaknieuwproces, | ||
| - | * **startWizard(maaknieuwezaak, | ||
| - | * **startwizard(showTekst, | ||
| - | * Voorbeeld: startWizard(showTekst, | ||
| - | * param1: showTekst | ||
| - | * param2: de tekst die getoond wordt in het wizardscherm. Mag een lange tekst zijn | ||
| - | * param3: de koptekst. Mag leeg zijn | ||
| - | * param4: hoogte van tekstvak in pixles. Indien leeg dan is de default 120. | ||
| - | * **startwizard(sluitZaak, | ||
| - | * **startwizard(startreport, | ||
| - | * **startWizard(zoekInrichtingopNaam, | ||
| - | * **startWizard(ZoekZaakViaZaaknummer, | ||
| - | * **startWizard(ZoekZaakViaAdres, | ||
| - | * **startWizard(ZoekZaakViaBetreftDatum, | ||
| - | * **startWizard(ZoekZaakViaContact, | ||
| - | * **startWizard(ZoekInspectieViaZaaknummer, | ||
| - | * **startWizard(StuurDSOOntvangstbevestiging, | ||
| - | * param1: StuurDSOOntvangstbevestiging | ||
| - | * param2: Primary key van tabel genoemd bij parma3. Dnkey van tbomgvergunning of tbomgdsoaanvulintrek | ||
| - | * param3: Naam van de tabel waarvoor na genereren de verstuurdatum gevuld moet worden. Moet gevuld zijn en of waarde // | ||
| - | * param4: optioneel, indien gevuld dan dnkey van processtap (tbtermijnbewstappen) die moet worden afgesloten. Let op als param4 gevuld dan mag param3 alleen waarde // | ||
| - | |||
| - | ==== Action column: | ||
| - | |||
| - | Heeft dezelfde functie als getFlexAction. Alleen wordt de uiteindelijke uit te voeren actie NIET opgehaald uit een query, maar uit een kolom van de view die aan de lijst ten grondslag ligt. | ||
| - | |||
| - | De tag ''< | ||
| - | |||
| - | Toepassing: zie beheertegel //Tabellen Standaardapi// | ||
| - | |||