Inhoud

Scherminformatie voor detailschermen

De plaats en inhoud van de kolommen en schermknoppen van een detailscherm worden geregeld in text-veld met een xml-opmaak. Of er in een detailscherm gemuteerd kan worden is naast het genoemde bij onderstaande tags van de blokken <column> afhankelijk van een eigenschap edit van het scherm zelf. Deze laatste eigenschap wordt voor 99% gebaseerd op de rechten en wordt geregeld door de API.

Zie voor automatisch inklappen (collapse) van blokken: kopje Automatisch inklappen van blokken (collapse) detailscherm bij : Scherm(kolom)definitie Zie voor aangepaste blokvolgorde kopje Blokvolgorde detailscherm bij : Scherm(kolom)definitie

Binnen de root-tag <document> zijn twee elementen:

Binnen het blok <columns> worden één of meer elementen <blok> gedefinieerd. Dat zijn de kaders waarbinnen de kolommen van het scherm gedefinieerd zijn met het blauwe paneel aan de linkerkant.

Verplichte tags/attributen - Blok

Een <blok> heeft de volgende elementen in de volgende volgorde: 

select case when (dlmappenhyperlink = 'F') then 1 else 0 end from tbrechten 
   where dnkey = (select dnkeyrechten from tbmedewerkers where trim(dvcode) = trim(:keyaccount))

Hetgeen wil zeggen dat indien de inlogger behoort tot een rechtengroep met dlmappenhyperlink = 'F', dat dan het blok waarin de tag <notvisibleif>%query(omgeving_blokhyperlink)%</notvisibleif> is opgenomen voor de betrokken inlogger NIET zichtbaar is. zie ook voorbeeld onder kopje Query's om blokken onzichtbaar te maken bij Queries

Bij bloktype doorlopend worden binnen het <blok> evenzoveel blokken <column> gedefinieerd als er verschillende elementen in dat blok getoond moeten worden (kolommen en schermknoppen).

Voor de blokvolgorde zie onder kopje blokvolgorde detailscherm in Scherm(kolom)definitie

Tags/attributen - columns

De volgende tags zijn altijd verplicht binnen een <column>: <regel>, <tagnaam>, <divwidth>, <divheight>, <edit>,<showhint> en <wavetype>

De tags en attributen binnen een <column> zijn in onderstaande volgorde:

Waarschuwing

De wijze waarop de Java en PHP spaties verwerken binnen Openwave verschilt: daar komt ook bij dat verscheidene browsers deze tekens ook anders kunnen opvatten. Om er voor te zorgen dat memo velden correct worden afgebeeld hanteren wij een marge om rekening te houden met het feit dat spaties soms als twee karakters tellen en soms als één.

Oorsprong In het verleden waren er twee acties nodig om op een typemachine een nieuwe regel aan te maken:

  • Keer terug naar het begin van de regel (return)
  • maak een nieuwe regel aan (line break)

Deze logica is men blijven hanteren met de opkomst van computers. Hierdoor zijn wij gedwongen een marge te hanteren bij karakter limieten waardoor een memoveld van bijvoorbeeld “max 2000 karakters” in werkelijkheid 1975 karakters toont. Per versie 1.32 zal de teller het stukje “(*inc marge)” tonen om dit aan te geven.

Query aanroep mogelijk bij tags edit en visible

De tags edit, action en visible moeten de waarde false of true hebben, maar die waarde kan ook door een query aanroep worden geleverd. Een bijzondere aanroep bij deze tags is de verwijzing naar een bestaande systeemquery met dvcode = geefWaardeRechtenkolom die makkelijk toegang geeft tot het rechtensysteem van OpenWave.

Voorbeeld

Voorbeeld is het zichtbaar zijn van de knop wijzig bevoegd gezag in het detailscherm van de omgevingszaak. In de schermkolomdefinitie is de tag visible als volgt: 

<visible>%query(geefwaarderechtenkolom,'tbomgrechten.dlbomgbevgezedt')%</visible>

De query kijkt voor de betreffende inlogger naar de waarde van de kolom tbomgrechten.dlbomgbevgezedt.

Column voorbeelden

Onderstaande voorbeelden maken duidelijk dat de tag wavetype eigenlijk bepalend is in hoe de overige tags worden geïnterpreteerd:

Niet-muteerbaar veld met fontcolor = red

<column>
    <regel>2</regel>
    <tagnaam>dvstatus</tagnaam>
    <label>Status</label>
    <divwidth>130</divwidth>
    <divheight>30</divheight>
    <edit>false</edit>
    <showhint>false</showhint>
    <wavetype>string</wavetype>
    <source/>
    <filter/>
    <refresh>false</refresh>
    <backcolor/>
    <fontcolor>red</fontcolor>
    <nullable>true</nullable>
    <icoon/>
  </column>

Muteerbaar veld met dropdownlijst

<column value="dnkeyportalcolumns">
     <regel>3</regel>
     <tagnaam>dvcolumnname</tagnaam>
     <label>Kolom</label>
     <divwidth>200</divwidth>
     <divheight>30</divheight>
     <edit>true</edit>
     <showhint>false</showhint>
     <wavetype>keuzelijst</wavetype>
     <source>GeneralWithoutEmptyLine</source>
     <filter>select dnkey id, dvname omschrijving 
             from tbportalcolumns where dnkeyportalnames = 
             (select dnkeyportalnames from vwfrmportaltiles where dnkey = %keypointer%)
     </filter>
     <refresh>false</refresh>
     <backcolor/>
     <fontcolor/>
     <nullable>true</nullable>
     <icoon/>
     <align/>
     <pretext/>
     <posttext/>
     <hint/>
     <action/>
  </column>

Schermknop voor een tekstballonnetje

<column>
    <regel>1</regel>
    <tagnaam/>
    <label/>
    <divwidth>20</divwidth>
    <divheight>30</divheight>
    <edit>true</edit>
    <showhint>false</showhint>
    <wavetype>schermknop</wavetype>
    <source></source>
    <filter>enable</filter>
    <refresh>false</refresh>
    <backcolor/>
    <fontcolor/>
    <nullable>true</nullable>
    <icoon>28</icoon>
    <align/>
    <pretext/>
    <posttext/>
    <hint/>
    <action>getFlexBalloon(Hier alleen voorletters; zonder punt en spaties,P)</action>
  </column>

Schermknop voor starten van een specifiek documentsjabloon

<column>
    <regel>1</regel>
    <tagnaam/>
    <label/>
    <divwidth>20</divwidth>
    <divheight>30</divheight>
    <edit>true</edit>
    <showhint>false</showhint>
    <wavetype>schermknop</wavetype>
    <source></source>
    <filter>enable</filter>
    <refresh>false</refresh>
    <backcolor/>
    <fontcolor/>
    <nullable>true</nullable>
    <icoon>48</icoon>
    <align/>
    <pretext/>
    <posttext/>
    <pattern/>
    <hint/>
    <action>startWizard(maakDocument,2702,tbdocumenten;;tbomgvergunning;{id},W)</action>
    <textpattern/>
  </column>