openwave:1.30:applicatiebeheer:instellen_inrichten:standardlist_standarddetail:utigewerkt_voorbeeld

Uitgewerkt voorbeeld

Hieronder wordt stap voor stap uiteengezet hoe tegel, lijst- en detailschermen van de zaaktypes omgeving (tbsoortomgverg) en de dochtertabel gekoppelde producten (tbproducten)en de dochtertabel afwijkende termijnen (tbfataletermijnen) op het zaakbeheerportaal zijn gedefinieerd in de standaard uitlevering van OpenWave.

Uitgangspunt is het bestaan van de tabellen tbsoortomgverg en tbproducten en tbproductdef en tbfataletermijnen en het bestaan van views vwfrmsoortomgverg en vwfrmkopproductenzaaktypes. Bij het tonen van tbfataletermijnen wordt geen gebruik gemaakt van een view.

Kies in het beheerportaal onder de kolom Scherm-en tegelbeheer voor de tegel Portal. Kies vervolgens in deze lijst voor Zaakbeheer. In het detailscherm van de portaldefinitie Zaakbeheer bevindt zich het blok kolommen: kies hier voor Zaaktypes. Kies via het detailscherm van de kolom Zaaktypes vervolgens onder het blok tegels voor de tegel met de naam Zaaktypes omgeving.
Hier is de tegel gedefinieerd met een naam en een action die uitgevoerd wordt wanneer een geautoriseerde medewerker op deze tegel klikt.
Zie voor de betekenis van deze kolommen van de tegeldefinitie Portaltegel
Met de wizardknop linksonder kan de tegel toegekend worden aan één of meer medewerkers.

In dit geval is de action gedefinieerd als getFlexList(SysStandardList,nil,nil,G,beheer_vwfrmsoortomgverg). Dat betekent dat op een OpenWave standaard-manier (getFlexList) een lijst in een modalvenster getoond gaat worden, waarvan de specificaties in de tabel tbsysstandardtable staan op de rij met dvcode = beheer_vwfrmsoortomgverg. Zie voor de parameterbeschrijving kopje getFlexlist in Actions

Ga naar de tegel Tabellen Standaardapi in het beheerportaal onder de kolom Scherm-en tegelbeheer. Zoek vervolgens in de lijst met alle systandaardtabellen op waarde beheer_vwfrmsoortomgverg (is de tabelcodering waar we naar op zoek zijn) en klik door naar het detailscherm. Op het detailscherm van deze sysstandaardtabel is de definitie van zowel het lijst- als het detailscherm Zaaktypes Omgeving gedefinieerd. In het blok Knoppen zijn de knoppen gedefinieerd die onderaan het te tonen lijstscherm van de zaaktypes omgeving dienen te verschijnen.

Deze rij met dvcode = beheer_vwfrmsoortomgverg staat in de tabel tbsysstandardtable. De knopdefinities staan in tbsysstandardbutton met foreign key naar de betreffende rij in tbsysstandardtable.

De kolommen van dit scherm:

  • Code: beheer_vwfrmsoortomgverg
  • systeemcategorie. nadere indeling van sysstandardtabelkaarten. Wordt hier niet gebruikt.
  • Systeemkaart. Is aangekruist waarmee aangegeven wordtdat de kaart hoort bij de standaarduitlevering van OpenWave.
  • Hoofdtabel of viewnaam: vwfrmsoortomgverg. Dat betekent dat de schermdefinitie voor lijst en detailscherm gebaseerd zijn op de vwfrmsoortomgverg
  • Kolomnaam van de primary key: De kolomnaam in vwfrmsoortomgverg die verwijst naar de primary key van de onderliggende tabel tbsoortomgverg.
  • Tabelnaam waarop hoofdtabel/view is gebaseerd: tbsoortomgverg. De zaaktypes voor omgeving staan in deze tabel.
  • Kolomnaam foreign key uit deze achterliggende tabel Gevraagd wordt naar de foreign key in tbsoortomgverg die verwijst naar een parentttabel. In dit geval leeg want tbsoortomgverg heeft geen parenttabel.
  • Parenttabelnaam . In dit geval leeg want tbsoortomgverg heeft geen parenttabel.
  • Kolomnaam blokkering (uit hoofdtabel/view) Gevraagd wordt naar de kolomnaam van een datumveld in vwfrmsoortomgverg. Als die kolom gevuld is voor een specifieke kaart dan wordt het muteren van die kaart in vwfrmsoortomgverg tegengehouden. In dit geval is deze kolomnaam leeg want tbsoortomgverg heeft geen blokkeringsdatum (de tabel mag toch alleen maar aangeapst worden door systeembeheerders).
  • Kolomnaam blokkering (uit parenttabel) Gevraagd wordt naar de kolomnaam van een datumveld in de parenttabel. Als die kolom gevuld is voor een specifieke parentkaart dan wordt het muteren van de bijbehorende dochters in tbsoortomgverg tegengehouden. In dit geval is de kolomnaam leeg want tbsoortomgverg heeft geen parenttabel.
  • Schermidentifier voor lijst: MDLC_getVwFrmSoortOmgVergList.xml. Dit is de xml waarin beschreven staat welke kolommen waar en hoe worden getoond bij het oproepen van de lijst op basis van de view vwfrmsoortomgverg. OpenWave zoekt deze xml in eerste instantie in de kolom dvscreenxml van de tabel tbscreencolumns. Indien niet gevonden dan kan het zijn dat de xml opgenomen is in de programmatuur van OpenWave (systeemkaart is aangekruist: dus in dit geval is dat zo). Voor het bewerken van de xml zie: Scherm(kolom)definitie. Let OP: de benaming is case-sensitive.!!
  • Schermidentifier voor detail: MDDC_getVwFrmSoortOmgVergDetail.xml. Dit is de xml waarin beschreven staat welke kolommen waar en hoe worden getoond bij het oproepen van een detailscherm van een zaaktype omgeving (een rij uit vwfrmsoortomgverg).
  • Schermidentifier voor filter: Is leeg want standaard geen filter bij de lijst zaaktypes omgeving.
  • Datumkolombox vervallen: ddvervaldatum. Dit is een kolomnaam uit vwfrmsoortomgverg. Onderaan de lijstweergave van vwfrmsoortomgverg wordt een aanvinkbox vervallen kaarten zichtbaar zijn. Indien onzichtbaar aangevinkt dan zal de lijst gefilterd worden op de ddvervaldatum is null.
  • Zoekbox: is aangevinkt hetgeen betekent dat onderaan de lijstweergave van vwfrmsoortomgverg wordt een zoekbox zichtbaar wordt.
  • Kijkrechtenkolom: Is leeg want voor deze beheertabel tbsoortomgverg kijkt OpenWave niet naar een specifieke autorisatie, maar naar de medewerkers-eigenschap of de inlogger beheerrechten heeft.
  • Muteerrechtenkolom: idem
  • Tbqueries.dvcode voor kijkrechten: Hier wordt verwezen naar de systeemquery met dvcode = sysstandaard_isbeheerder. Deze standaard uitgeleverde query retourneert true indien de medewerker beheerniveau 99 heeft.(tbmedewerkers.dnbeheerniveau).
  • Tbqueries.dvcode voor muteerrechten: idem
  • Module/schermgroepcode: Hier leeg. Wordt alleen in zeer specifieke situaties gebruikt wanneer de aangeroepen API (action) een moduleletter vereist.
  • Action;bij dubbel klik; op lijstregel: getFlexDetail(SysStandardDetail,{id},beheer_vwfrmsoortomgverg). Hetgeen betekent dat een standaard modal(getFlexDetail) venster wordt geopend op basis van de aangeklikte rij in de lijst, waarvan de specificaties in de tabel tbsysstandardtable staan op de rij met dvcode = beheer_vwfrmsoortomgverg (in dit geval putten lijst en detail dus uit dezelfde bron in tbsysstandardtable: ook het detailscherm is dus op basis van vwfrmsoortomgverg).
    De variabele {id} in de aanroep wordt on the fly vervangen met de primary key van de rij waarop de gebruiker klikte.
    Zie voor de parameterbeschrijving kopje getFlexDetail in Actions
  • Detailvenster openen na insert: Hier leeg. Als er een insert wordt gedaan (zie hieronder bij knoppen op lijstniveau) wordt niet automatisch het detailscherm van de nieuwe zaak getoond.
  • Extra where clausule: Hier leeg. De lijst wordt getoond op basis van select * from vwfrmsoortomgverg. Hier kan desgewenst een extra clausule aan worden toegevoegd.

In de systandaardkaart zijn gebruikte tabellen en views en relaties gedefinieerd als mede de identifiers voor de schermen. In dit hoofdstukje wordt de definitie van het lijstscherm MDLC_getVwFrmSoortOmgVergList.xml besproken.

Achter de kolom Schermidentifier voor lijst: is een Ga-naar knop die de kaart opent (of bij ontbreken daarvan aanmaakt) in tbscreencolumns met daarin scherminformatie voor het lijstscherm van Zaaktypes Omgeving.
Deze rij in tbscreencolumns kan ook benaderd of aangemaakt worden via de tegel Schermkolomdefinitie tabellen standaard-api op het beheerportaal onder de kolom Scherm-en tegelbeheer. De unieke identifier voor het lijstscherm (tbscreencolumns.dvscreenfilename) is in dit geval MDLC_getVwFrmSoortOmgVergList.xml.
Deze rij in tbscreencolumns bevat meta-informatie over het lijstscherm en mogelijk de schermopbouw in kolommen op basis van de view vwfrmsoortomgverg in het blok kolominformatie.

De kolommen van dit scherm:

  • systeemcategorie. Nadere indeling van tbscreencolumns. Wordt hier niet gebruikt.
  • Systeemkaart. Is aangekruist waarmee aangegeven wordt dat de kaart hoort bij de standaarduitlevering van OpenWave. Dat betekent ook dat er een standaardversie van de schermopmaak in de AAR (programmatuur) is opgenomen.
  • klasse: sysStandard. Het lijstscherm wordt aangeroepen op basis van een sysstandaardtabel; dan is de klasse altijd sysStandard.
  • api: getSysStandardList. Het gaat om het oproepen van de lijst. Dat is de API getSysStandardList (die zit in de klasse sysStandard).
  • view/tabel: vwfrmsoortomgverg. De kolommen die gedefinieerd worden in deze lijst moeten voorkomen in de view vwfrmsoortomgverg.
  • identifier scherm: xml-filenam: MDLC_getVwFrmSoortOmgVergList.xml. De unieke identifier voor het lijstscherm.
  • toelichting: de inhoud van deze kolom heeft geen invloed op werking van getSysStandardList-api.
  • Zoekkolommen (gescheiden door puntkomma's). Hier leeg, hetgeen betekent dat in de zoekeditbox onderaan de lijst met zaaktypes omgeving gezocht kan worden binnen alle getoonde stringvelden van de view vwfrmsoortomgverg (de kolomnamen die beginnen met dv). Indien gevuld kan er in de zoekeditbox onderaan de lijst met zaaktypes omgeving alleen gezocht worden op de hier gedefinieerde kolommen inclusief dataumvelden (kolomnaam begint met dd).
  • lijst automatisch in editmode. Hier uitgevinkt. Indien aangevinkt zal de lijst editable zijn voor die kolommen die zelf de tag <edit> op true hebben staan. In dat geval is de editschuif op het lijstscherm operationeel.
  • excelknop onderaan lijst. Hier aangevinkt hetgeen tot gevolg heeft dat linksonder op de lijst met Zaaktypes Omgeving een Excel knop verschijnt, waarmee de hele lijst naar Excel kan worden geëxporteerd.
  • paging met paginanummers Hier aangevinkt het geen betekent dat altijd paging in de lijst rechtsboven operationeel is indien het aantal items groter dan getal1 van Sectie: Paging en Item: page_size.
  • default sortering. Dnkey. Dus de lijst wordt bij opstarten getoond in de volgorde van de primary key. Is alleen van toepassing voor lijstschermen. Een valide SQL sorteringsstatement kan hier worden opgegeven: bijvoorbeeld 'ddvervaldatum DESC'. De kolomnamen komen uit de view vwfrmsoortomgverg.
  • Editschuif automatisch aan. Is alleen van toepassing voor detailschermen.
  • Blokvolgorde. Alleen van toepassing op detailschermen.
  • sql kopregel1, kopregel2 en kopregel3. Hier alleen kopregel1 met select 'Zaaktypes Omgeving' from tbportalnames where dlisbegin = 'T'. Overigens zou select 'Zaaktypes Omgeving' ook volstaan.
    Indien gevuld met een valide SQL-statement worden de resultaten van die statements gebruikt voor de drie kopregels van het scherm (de bestaande OpenWave-default waardes worden hiermee overschreven). Aan de queries worden de volgende eisen gesteld:
    • het resultaat van een query ( dus de evaluatie van het select-statement) mag maar uit één kolom en één rij bestaan
    • EN de query moet met 'select' beginnen
    • EN er mag GEEN puntkomma (';') in voorkomen (vanwege het gevaar voor SQL-injectie). In de statements kunnen twee variabelen worden gebruikt:
      • :keyaccount zal worden vervangen door tbmedewerkers.dvcode van de inlogger
      • {id} wordt vervangen met de dnkey van tbomgvergunning of tbhandhavingen of tbmilinrichtingen of tbovvergunningen of tbmilvergunningen wanneer het statement gebruikt wordt op achterliggende schermen van een zaak- of inrichtingportaaltegel en/of door de primary key van de lijst waar vanuit een detailscherm wordt aangeroepen.
  • Kolominformatie (dvscreenxml). Waarschijnlijk is deze kolom leeg. Het gaat hier om een systeemscherm, dus in de AAR (programmatuur) is het scherm zoals door OpenWave gedefinieerd opgenomen. Deze MDLC_getVwFrmSoortOmgVergList.xml met schermopmaak kan echter zichtbaar gemaakt worden met het Haal Origineel-icoontje links onderaan de pagina. Vanaf het moment dat het blok kolominformatie hier is gevuld zal deze opmaak prevaleren boven de in de AAR opgeslagen versie. Indien het blok wordt leeggemaakt en default bestaat in de AAR, dan wordt dit defaultscherm weer actief. De functioneel beheerder kan dus de schermopmaak aanpassen. Zie: Scherminformatie voor opmaak lijstschermen en rapportages.
  • Backup kolominformatie : Kan gebruikt worden om bijvoorbeeld het origineel van een scherm ter vergelijking in op te slaan. Is verder niet van invloed op de werking van de getSysStandardList-api.

In dit hoofdstukje wordt de definitie van het detailscherm MDD_getVwFrmSoortOmgVergDetail.xml besproken.

Achter de kolom Schermidentifier voor detail: is een Ga-naar knop die de kaart opent (of bij ontbreken daarvan aanmaakt) in tbscreencolumns met daarin scherminformatie voor het detailscherm van zaaktypes omgeving.
Deze rij in tbscreencolumns kan ook benaderd of aangemaakt worden via de tegel Schermkolomdefinitie tabellen standaard-api op het beheerportaal onder de kolom Scherm-en tegelbeheer. De unieke identifier voor het lijstscherm (tbscreencolumns.dvscreenfielname) is in dit geval MDDC_getVwFrmSoortOmgVergDetail.xml.
Deze rij in tbscreencolumns bevat meta-informatie over het detailscherm en mogelijk de schermopbouw in kolommen en blokken op basis van de view vwfrmsoortomgverg in het blok kolominformatie.

De kolommen van dit scherm:

  • systeemcategorie. Nadere indeling van tbscreencolumns. Wordt hier niet gebruikt.
  • Systeemkaart. Is aangekruist waarmee aangegeven wordt dat de kaart hoort bij de standaarduitlevering van OpenWave. Dat betekent ook dat er een standaardversie van de schermopmaak in de AAR (programmatuur) is opgenomen.
  • klasse: sysStandard. Het detailscherm wordt aangeroepen op basis van een sysstandaardtabel; dan is de klasse altijd sysStandard.
  • api: getSysStandardDetail. Het gaat om het oproepen van de detailscherm. Dat is de API getSysStandardDetail (die zit in de klasse sysStandard).
  • view/tabel: vwfrmsoortomgverg. De kolommen die gedefinieerd worden in het detailscherm moeten voorkomen in de view vwfrmsoortomgverg.
  • identifier scherm: xml-filenam: MDDC_getVwFrmSoortOmgVergDetail.xml. De unieke identifier voor het detailscherm.
  • toelichting: de inhoud van deze kolom heeft geen invloed op werking van getSysStandardDetail-api.
  • Zoekkolommen (gescheiden door puntkomma's). Alleen van toepassing op lijstschermen.
  • Lijst automatisch in editmode. Alleen van toepassing op lijstschermen.
  • Excelknop onderaan lijst. Alleen van toepassing op lijstschermen.
  • Paging met paginanummers. Alleen van toepassing op lijstschermen.
  • Default sortering. Alleen van toepassing op lijstschermen.
  • Editschuif automatisch aan. Staat uit, maar indien aangevinkt zal het openen van een zaaktype-omgeving-detailscherm gebeuren met de editschuif op AAN ongeacht de default instelling (zie: Edit-schuif). Ook omdat hierboven in de tbsysstandardtable-kaart beheerrechten zijn toegekend.
  • Blokvolgorde. Is hier leeg. Dat wil zeggen dat de blokken van een zaaktype-omgeving-detailscherm getoond worden zoals ze in de AAR zijn opgeslagen of zoals in een eventueel afwijkende schermopbouw (zie hieronder bij kolom informatie) zijn gedefinieerd.
  • sql kopregel1, kopregel2 en kopregel3. Indien gevuld met een valide SQL-statement worden de resultaten van die statements gebruikt voor de drie kopregels van het scherm (de bestaande waardes worden hiermee overschreven). Aan de queries worden de volgende eisen gesteld:
    • het resultaat van een query (dus de evaluatie van het select-statement) mag maar uit één kolom en één rij bestaan
    • EN de query moet met 'select' beginnen
    • EN er mag GEEN puntkomma (';') in voorkomen (vanwege het gevaar voor SQL-injectie). In de statements kunnen twee variabelen worden gebruikt:
      • :keyaccount zal worden vervangen door tbmedewerkers.dvcode van de inlogger
      • {id} wordt vervangen met de dnkey van tbomgvergunning of tbhandhavingen of tbmilinrichtingen of tbovvergunningen of tbmilvergunningen wanneer het statement gebruikt wordt op achterliggende schermen van een zaak- of inrichtingportaaltegel en/of door de primary key van de lijst waar vanuit een detailscherm wordt aangeroepen.
  • Kolominformatie (dvscreenxml). Indien gevuld wordt de informatie in deze kolom gebruikt om een afwijkend scherm op te maken. Met de trigger Haal Origineel kan altijd het standaard uitgeleverde scherm worden opgehaald uit de aar (de OpenWave programmatuur) teneinde deze dus als afwijkend scherm aan te passen. Indien deze kolom leeg is, dan gebruikt het programma altijd de standaardversie van het scherm of rapport. Met F11 wordt de kolom weergegeven in een groot scherm met ondersteuning voor de xml-syntax. Met F11 kan nadien ook weer teruggekeerd worden naar normale modus. Voor de betekenis en gebruik van de xml-structuur

In de dochtertabel tbsysstandardbutton van de systandaardtabelkaart met code = beheer_vwfrmsoortomgverg zijn de knoppen met bijbehorende acties gedefinieerd voor het lijstscherm zaaktypes omgeving : te weten: nieuwe zaaktype, verwijder zaaktype en kopieer zaaktype.

Open het detailscherm van de knop nieuw zaaktype De kolommen van dit scherm:

  • identiefier: de waarde van de dnkey van deze kaart in tbsystandardbutton.
  • Foreign key: de waarde van de dnkey van de moederkaart in tbsystandardtable.
  • Systeemkaart: is aangekruist waarmee aangegeven wordt dat deze kaart hoort bij de standaarduitlevering van OpenWave.
  • Hint cq itemnaam: Nieuw zaaktype. De naam van de knop die als hint bij het bijbehorende icoontje zichtbaar wordt op het lijstscherm zaaktypes omgeving
  • Lijst of Detail: Hier de L van Lijst. De knop Nieuw zaaktype is alleen zichtbaar op het lijstscherm.
  • Linksonder of Itemlist: Hier de L van linksonder. De knop wordt linksonder de lijst getoond en niet rechtsboven in een dropdownlijstje.
  • Icoonnummer: Nummer 9 staat voor het plus/insert icoontje. Zie: Iconenlijst.
  • Volgorde: De iconen Linskonder worden in deze volgorde van links naar rechts getoond. Bij itemlijst van boven naar beneden.
  • Refresh: Aangekruist wil zeggen dat na het uitvoeren van de actie die hoort bij de knop het lijstscherm wordt ververst: logisch want er wordt een nieuwe rij toegevoegd in tbsoortomgverg.
  • Excecute rechtenkolom: Is leeg want voor het gebruik van deze knop kijkt OpenWave niet naar een specifieke autorisatie, maar naar de medewerkers-eigenschap of de inlogger beheerrechten heeft.
  • Tbqueries.dvcode voor excecuterechten: Hier wordt verwezen naar de systeemquery met dvcode = sysstandaard_isbeheerder. Deze standaard uitgeleverde query retourneert true indien de medewerker beheerniveau 99 heeft.(tbmedewerkers.dnbeheerniveau).
  • Action: De methode startWizard wordt met de knop aangeroepen met 4 parameters.
  • Parameter1: insertsysstandardrow. Dit betekent dat de wizard één scherm heeft die gedefinieerd wordt qua opmaak door een xml waarvan de naam begint met MDWC_. Zie Scherminformatie voor standaard insert- en kopieer.
  • Parameter2: MDWC_insertTbSoortOmgVerg.xml. De naam van de xml met de scherminformatie voor het insertscherm nieuw zaaktype. Achter deze kolom is een ga-naar knop die de kaart opent (of bij ontbreken daarvan aanmaakt) in tbscreencolumns met daarin de scherminformatie voor het insertscherm nieuw zaaktype.
    Deze rij in tbscreencolumns kan ook benaderd of aangemaakt worden via de tegel Schermkolomdefinitie tabellen standaard-api op het beheerportaal onder de kolom Scherm-en tegelbeheer. De unieke identifier voor het lijstscherm (tbscreencolumns.dvscreenfilename) is in dit geval MDWC_insertTbSoortOmgVerg.xml
    Deze rij in tbscreencolumns bevat meta-informatie over het insertscherm en mogelijk de schermopbouw in kolommen op basis van de tabel tbsoortomgverg in het blok kolominformatie. Aangezien het hier gaat om een systeemknop is het insertscherm aanwezig in de AAR (programmatuur) en kan desgewenst opgeroepen worden met de knop Haal Origineel in de kolom tbscreencolumns.dvscreenxml.
  • Parameter3. Is hier leeg, want wordt alleen gevuld indien een insert op een dochtertabel wordt gedaan; Dan komt hier de waarde van de foreign key in te geven als %keyparent%. Tbsoortomgverg heeft geen parent, dus leeg.
  • Parameter4: Hier wederom beheer_vwfrmsoortomgverg. De waarde van de kolom dvcode in de tbsysstandardtabel voor Zaaktypes Omgeving.

Voor de knoppen verwijder en kopieer zaaktype geldt dat zij beide ook linksonder aan de Lijst zaaktypes omgeving moeten komen met hun eigen icoonnummers. Actie en parameters verschillen uiteraard:

Voor de knop kopieer zaaktype:

  • Action: De methode startWizard wordt met de knop aangeroepen met 4 parameters.
  • Parameter1: kopieersysstandardrow. Dit betekent dat de wizard één scherm heeft die gedefinieerd wordt qua opmaak door een xml waarvan de naam begint met MDWC_. Zie Scherminformatie voor standaard insert- en kopieer. Veelal, ook hier, dezelfde als bij insertsysstandardrow.
  • Parameter2: MDWC_insertTbSoortOmgVerg.xml. De naam van de xml met de scherminformatie voor het kopieerscherm kopieer zaaktype. Zie hierboven bij insertsysstandardrow.
  • Parameter3 . Heeft de waarde {id}, het geen betekent dat deze {id| on the fly wordt vervangen met de dnkeywaarde van de kaart in vwfrmsoortomgverg waar de gebruiker op staat in de lijst bij het gebruiken van de kopieerknop.
  • Parameter4: Hier wederom beheer_vwfrmsoortomgverg. De waarde van de kolom dvcode in de tbsysstandardtabel voor zaaktypes omgeving.

Voor de knop verwijder zaaktype:

  • Action: De methode startWizard wordt met de knop aangeroepen met 4 parameters.
  • Parameter1: deletesysstandardrow. Dit betekent dat de wizard op een standaardwijze een regel uit tbsoortomgverg verwijderd. Zie ook kopje startwizard bij Actions
  • Parameter2: tbsoortomgverg.[id}. Deze parameter bestaat uit twee delen gescheiden door een punt. het eerste deel is de tabelnaam waaruit een kaart moet worden verwijderd. De {id} wordt on the fly vervangen met de dnkeywaarde van de kaart in vwfrmsoortomgverg waar de gebruiker op staat in de lijst bij het gebruiken van de deleteknop.
  • Parameter3. dvomschrijving. Een kolomnaam uit vwfrmsoortomgverg (de basisview/tabel van de lijst zaaktypes omgeving). Zodat het programma de vraag weet u zeker dat u deze rij wilt verwijderen kan duiden met die omschrijving.
  • Parameter4: Hier wederom beheer_vwfrmsoortomgverg. De waarde van de kolom dvcode in de tbsysstandardtabel voor Zaaktypes Omgeving.

Op het detailscherm van zaaktypes omgeving is een aantal blokken opgenomen met daarin een lijstweergave van een dochtertabel van tbsoortomgverg. Hier worden het blok Producten diensten besproken.

Schermaanroep
In de xml van het detailscherm zaaktypes omgeving dus in MDDC_getVwFrmSoortOmgVergDetail.xml is het volgende blok gedefinieerd:

  <blok>
    <label>Producten;Diensten</label>
    <width>100</width>
    <height>250</height>
    <type>getFlexList(SysstandardList,,%keypointer%,G,beheer_tbproducten_omg)</type>
  </blok>

De tag type is bepalend voor wat er in het blok wordt getoond:
In dit geval is het type gedefinieerd als getFlexList(SysstandardList,,%keypointer%,G,beheer_tbproducten_omg).
Dat betekent dat op een OpenWave standaard-manier (getFlexList) een lijst in het blok getoond gaat worden, waarvan de specificaties in de tabel tbsysstandardtable staan op de rij met dvcode = beheer_tbproducten_omg.
Het is een lijst binnen het detailscherm van een zaaktype omgeving. Dus het gaat logischerwijs om een dochtertabel. De parameter %keypointer% wordt on the fly gevuld met de dnkeywaarde van de moedertabel tbsoortomgverg (van de kaart waar de gebruiker op staat), zodat alleen die rijen in de bloklijst getoond worden die met een foreign key (%keypointer%) met een kaart uit tbsoortomgverg zijn verbonden.
Zie voor de parameterbeschrijving kopje getFlexlist in Actions
Om welke tabel of view het gaat staat in de kaart van tbsysstandardtable met de code = beheer_tbproducten_omg.

Definitie producten/diensten in tbsysstandardtabel
Kies in het beheerportaal onder de kolom Scherm-en tegelbeheer in de lijst achter de tegel Tabellen Standaardapi voor de rij in tbsysstandardtable met de code = beheer_tbproducten_omg.
De belangrijkste kolommen:

  • Code: beheer_tbproducten_omg
  • Hoofdtabel of viewnaam: vwfrmkopproductenzaaktypes. Dat betekent dat de schermdefinitie voor lijst en detailscherm gebaseerd zijn op de vwfrmkopproductenzaaktypes: de view over de koppeltabel tbproducten: in deze tabel worden product definities (tbproductdef) gekoppeld aan zaaktypes (tbsoortomgverg).
  • Kolomnaam van de primary key: dnkey: de kolomnaam in vwfrmkopproductenzaaktypes die verwijst naar de primary key van de onderliggende tabel tbproducten.
  • Tabelnaam waarop hoofdtabel/view is gebaseerd: tbproducten. De naam is wat ongelukkig.
  • Kolomnaam foreign key uit deze achterliggende tabel: dnkeysoortomgverg. Gevraagd wordt naar de foreign key in tbproducten die verwijst naar de parentttabel tbsoortomgverg.
  • Parenttabelnaam. Tbsoortomgverg. In de lijst worden alleen de rijen uit tbproducten getoond waarvan dnkeysoortomgverg overeenkomt met de dnkey uit tbsoortomgverg.

Definitie knoppen in lijst producten/diensten
Voor de knoppen producten koppelen aan zaaktype en verwijder koppeling zaak/type product geldt dat zij beide linksonder aan de Lijst producten/diensten (het lijstje op de detailpagina van zaaktype omgeving in het blok producten/diensten) moeten komen met hun eigen icoonnummers. Actie en parameters verschillen uiteraard:
Voor de knop koppelen aan zaaktype:

  • Action: De methode startWizard wordt met de knop aangeroepen met 4 parameters.
  • Parameter1: koppelsysstandardrow. Dit betekent dat de wizard één standaardscherm heeft dat gebaseerd is op de rijen van een derde tabel in dit geval de product definities (tbrpoductdef). Met koppelsysstandardrow kunnen de rijen van tbproducten die gekoppeld zijn aan de zaaktype omgeving gesynchroniseerd worden met de aangevinkte rijen in de wizard uit de product definities. Zie kopje Knop insert of synchroniseer vanuit een derde codetabel op Standaard Lijst- en Detailschermen
  • Parameter2: %keyparent%;dvomschrijving;;0. Een parameter bestaande uit 4 delen. %keyparent% wordt on the fly vervangen door de waarde van de dnkey uit tbsoortomgverg (het zaaktype omgeving van het detailscherm.) dvomschrijving is de kolomnaam uit tbsoortomgverg die gebruikt wordt in de kopregel van de wizard koppelsysstandardrow. De 0 staat voor synchroniseren: dat betekent dat er gekoppelde product definities bij het uitvoeren van de wizard worden verwijderd en anderen worden aangemaakt om zo overeen te komen met de aangevinkte items.
  • Parameter3. tbproductdef;dnkeyproductdef;dnkey;dvproductcode;dvproductoms;;ddvervallen;1=1. Een parameter bestaande uit 8 delen. Tbproductdef is de tabel waarvan de rijen worden getoond in de wizard. Dnkeyproductdef is de kolom in de koppeltabel tbproducten die verwijst naar een primary key van tbproductdef. Dnkey is de kolomnaam van de primary key in tbproductdef. dvproductcode en dvproductoms zijn kolommen uit tbproductdef die de wizard laat zien om aan en uit te vinken. Ddvervallen is de kolomnaam in tbproductdef die gebruikt wordt om de rijen van tbproductdef te filteren. 1=1 is - in dit geval een zinloze - extra conditie waaraan de rijen van tbproductdef moeten voldoen.
  • Parameter4: Hier beheer_tbproducten_omg. De waarde van de kolom dvcode in de tbsysstandardtabel voor de koppeltabel vwfrmkopproductenzaaktypes c.q. tbproducten.

Voor de knop Verwijder koppeling zaak/type product:
Het gaat hier om het deleten van een rij uit tbproducten met de wizard deleteSysStandardRow.
Zie hierboven bij de beschrijving van verwijderknop bij hoofdstuk knoppen linksonder lijst zaaktypes omgeving

Op het detailscherm van zaaktypes omgeving is een aantal blokken opgenomen met daarin een lijstweergave van een dochtertabel van tbsoortomgverg. Hier worden het blok Termijnen besproken.

Schermaanroep
In de xml van het detailscherm zaaktypes omgeving dus in MDDC_getVwFrmSoortOmgVergDetail.xml is het volgende blok gedefinieerd:

    <blok>
          <label>Termijnen</label>
          <width>100</width>
          <height>200</height>
          <type>getFlexList(SysStandardList,,%keypointer%,,beheer_fataletermijnen_omg)</type>
    </blok>

De tag type is bepalend voor wat er in het blok wordt getoond:
In dit geval is het type gedefinieerd als getFlexList(SysStandardList,,%keypointer%,,beheer_fataletermijnen_omg).
Dat betekent dat op een OpenWave standaard-manier (getFlexList) een lijst in het blok getoond gaat worden, waarvan de specificaties in de tabel tbsysstandardtable staan op de rij met dvcode = beheer_fataletermijnen_omg.
Het is een lijst binnen het detailscherm van een zaaktype omgeving. Dus het gaat logischerwijs om een dochtertabel. De parameter %keypointer% wordt on the fly gevuld met de dnkeywaarde van de moedertabel tbsoortomgverg (van de kaart waar de gebruiker op staat), zodat alleen die rijen in de bloklijst getoond worden die met een foreign key (%keypointer%) met een kaart uit tbsoortomgverg zijn verbonden.
Zie voor de parameterbeschrijving kopje getFlexlist in Actions.
Om welke tabel of view het gaat staat in de kaart van tbsysstandardtable met de code = beheer_fataletermijnen_omg.

Definitie producten/diensten in tbsysstandardtabel
Kies in het beheerportaal onder de kolom Scherm-en tegelbeheer in de lijst achter de tegel Tabellen Standaardapi voor de rij in tbsysstandardtable met de code = beheer_fataletermijnen_omg
De belangrijkste kolommen:

  • Code: beheer_fataletermijnen_omg
  • Hoofdtabel of viewnaam: tbfataletermijnen. Dat betekent dat de schermdefinitie voor lijst en detailscherm rechtstreeks gebaseerd zijn op de tabel tbfataletermijnen: in deze tabel worden mogelijke afhandelingstermijnen gedefinieerd per zaaktype omgeving (er is geen view over de tabel gedefinieerd).
  • Kolomnaam van de primary key: dnkey: de kolomnaam van de primary key in tbfataletermijnen
  • Tabelnaam waarop hoofdtabel/view is gebaseerd: tbfataletermijnen
  • Kolomnaam foreign key uit deze achterliggende tabel: dnkeysoortomgverg. Gevraagd wordt naar de foreign key in tbfataletermijnen die verwijst naar de parentttabel tbsoortomgverg.
  • Parenttabelnaam: Tbsoortomgverg. In de lijst worden alleen de rijen uit tbfataletermijnen getoond waarvan dnkeysoortomgverg overeenkomt met de dnkey uit tbsoortomgverg.
  • Action dubbelklik op lijsregel: Is leeg want er is geen detailscherm gedefinieerd. Wijzigingen worden in het lijstscherm zelf gedaan.

Definitie knoppen in lijst Termijnen
Voor de knoppen producten nieuwe fatale termijn en verwijder fatale termijn geldt dat zij beide linksonder aan de Lijst Termijnen (het lijstje op de detailpagina van zaaktype omgeving in het blok Termijnen) moeten komen met hun eigen icoonnummers. Actie en parameters verschillen uiteraard:
Voor de knop nieuwe fatale termijn:

  • Action: De methode startWizard wordt met de knop aangeroepen met 4 parameters.
  • Parameter1: insertsysstandardrow. Dit betekent dat de wizard één scherm heeft die gedefinieerd wordt qua opmaak door een xml waarvan de naam begint met MDWC_. Zie Scherminformatie voor standaard insert- en kopieer.
  • Parameter2: MDWC_insertTbFataleTermijnen.xml. De naam van de xml met de scherminformatie voor het insertscherm nieuw termijn. Achter deze kolom is een ga-naar knop die de kaart opent (of bij ontbreken daarvan aanmaakt) in tbscreencolumns met daarin de scherminformatie voor het insertscherm nieuw termijn.
  • Parameter3: %keyparent%. Wordt on the fly vervangen door de waarde van de dnkey uit tbsoortomgverg (het zaaktype omgeving van het detailscherm).
  • Parameter4: Hier beheer_fataletermijnen_omg. De waarde van de kolom dvcode in de tbsysstandardtabel voor de tabel tbfataletermijnen.

Voor de knop verwijder fatale termijn:
Het gaat hier om het deleten van een rij uit tbfataletermijnen met de wizard deleteSysStandardRow.
Zie hierboven bij de beschrijving van verwijderknop bij hoofdstuk knoppen linksonder lijst zaaktypes omgeving.

Wijzigen van termijn in de lijst Termijnen
In de schermdefinitie MDLC_getTbFataletermijnenList.xml (te benaderen via de Ga-naar knop achter de kolom Schermidentifier voor lijst: op de sysstandaardtabelkaart met dvcode = beheer_fataletermijnen_omg) is de kolom Lijst automatisch in editmode (mits geautoriseerd) aangevinkt.

De xml MDLC_getTbFataletermijnenList.xml waarin de schermopmaak wordt geregeld kan zichtbaar gemaakt worden met het Haal Origineel-icoontje links onderaan de pagina in de schermdefinitie. Vanaf het moment dat het blok kolominformatie hier is gevuld zal deze opmaak prevaleren boven de in de AAR opgeslagen versie.

De kolom dntermijn is muteerbaar in de lijst omdat de kolom als hieronder is gedefinieerd.

 <column tagnaam="dntermijn">
      <label>Termijn in dagen</label>
      <index>15</index>
      <length>100</length>
      <wavetype>integer</wavetype>
      <icoon/>
      <showhint>false</showhint>
      <edit>true</edit>
      <refresh>false</refresh>
      <fieldname>dntermijn</fieldname>
      <source/>
  </column>
  • openwave/1.30/applicatiebeheer/instellen_inrichten/standardlist_standarddetail/utigewerkt_voorbeeld.txt
  • Laatst gewijzigd: 2024/03/11 15:49
  • door Lonneke van Dijk