Queries

Een query kan worden gebruikt om de inhoud van de tag label contextgevoelig te maken.

Voorbeeld: wanneer in de schermkolomdefinitie van een detailscherm staat <label>Datum %query(omg_labelbesluit)%</label> zal het programma dynamisch het label samenstellen met de tekst 'Datum ' + daarachter het resultaat van de geëvalueerde query uit de tabel tbqueries met dvcode = omg_labelbesluit.

Indien de contextgevoeligheid is gebaseerd op andere informatie uit de kaart die getoond wordt (de query zal dan bestaan uit select x from y where dnkey = {id}) dan moet een tweede parameter %keypointer% meegegeven worden: <label>Datum %query('omg_labelbesluit,%keypointer%)%</label>. De variabele {id} uit de query zal vervangen worden met de primary key (dnkey) van de kaart waar je op staat.

Zie de voorbeelden hieronder bij action.

Een query kan worden gebruikt om een kolom contextgevoelig in het scherm op te nemen. In de schermkolomdefinitie (zowel voor kolommen van een lijst- als die voor het detailscherm) kan tag <visible> opgenomen zijn. Indien deze optionele tag de waarde false of 0 heeft dan moet de betreffende kolom NIET worden opgenomen. Indien deze optionele tag de waarde true of 1 heeft, of indien de tag niet bestaat, dan wordt de kolom wel opgenomen.

Een query kan worden gebruikt om de inhoud van de tag contextgevoelig de waarde true of false te geven. Voorbeeld: wanneer in de schermkolomdefinitie van een detailscherm staat <visible>%query(kolomXzichtbaar,%keypointer%)%</visible> zal het programma de tag visible vullen met de waarde die komt uit de aangeroepen geëvalueerde query. Indien die waarde ongelijk aan 'true' is dan moet de kolom NIET worden opgenomen.

De query zal dan bestaan uit zoiets als select case when x then 'true' else 'false' from y where dnkey = {id}) waarbij {id} onder water wordt vervangen door de dnkey van kaart waar je op staat (de parameter %keypointer% in de aanroep). Indien de query niet valide is, dan wordt de tag gevuld met 'false'.

Er bestaat een systeemquery met dvcode = geefWaardeRechtenkolom die makkelijk toegang geeft tot het rechtensysteem van OpenWave en false of true retourneert. 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.

Een query kan worden gebruikt om de tag edit contextgevoelig de waarde true of false te geven.

Voorbeeld: wanneer in de schermkolomdefinitie van een detailscherm staat <edit>%query(omgeving_mddc_schermknopolo,%keypointer%)%</edit> zal het programma het attribuut edit vullen met de waarde die komt uit de aangeroepen geëvalueerde query.

De query zal dan bestaan uit zoiets als select case when x then 'true' else 'false' from y where dnkey = {id}) waarbij {id} onder water wordt vervangen door de dnkey van kaart waar je op staat (de parameter %keypointer% in de aanroep). Indien de query niet valide is, dan wordt het attribuut edit gevuld met 'false'.

Er bestaat een systeemquery met dvcode = geefWaardeRechtenkolom die makkelijk toegang geeft tot het rechtensysteem van OpenWave en false of true retourneert. Zie hierboven bij visible: geefwaarderechtenkolom.

Een query kan worden gebruikt om de tags backcolor en fontcolor contextgevoelig de waarde true of false te geven. Het resultaat van de query moet gevuld zijn met standaard html colorname (https://www.w3schools.com/colors/colors_names.asp).

Een action kan in een schermkolomdefinitie worden gekoppeld aan een schermknop. Bijvoorbeeld een knop achter de kolom OLO-nummer in de omgevingsdetailkaart waarmee het OLO-loket met de juiste aanvraag wordt geopend afhankelijk van het OLO-nummer op de kaart: Of een knop die een PDOK-kaart opent op basis van de coördinaten van het bijbehorende locatie adres. Die action is dus contextgevoelig.

De URL daartoe is: https://www.omgevingsloket.nl/BevoegdGezag/bevoegdgezag/AanvraagTab/Aanvraag/?????/AanvraagGegevens

Waarbij op de plaats van de vraagtekens een valide OLO-aanvraagnummer moet worden gevuld. Dat lossen we op door:

• een knop te definiëren op het detailscherm van de omgevingszaak met een action waarin bovengenoemde URL wordt gedefinieerd
• in de URL een queryverwijzing te maken teneinde het juiste OLO-aanvraagnummer op te halen
• een query te maken die het gevraagde OLO-nummer retourneert.

De knop kan als volgt worden gedefinieerd:

<column>
     <regel>3</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>14</icoon>
     <align/>
     <pretext/>
     <posttext/>
     <hint>ga naar omgevingsloket</hint>
    <action>openTabPage(https://www.omgevingsloket.nl/BevoegdGezag/bevoegdgezag/AanvraagTab/Aanvraag/%query(omgeving_olonummer,%keypointer%)%/AanvraagGegevens)</action>
   </column>

Een action die begint met de functie openTabPage laat het programma als het ware de inhoud van openTabPage() intikken in de URL-editbox van de browser met als gevolg dat in een nieuw browsertabblad de gevraagde site wordt geopend. In de URL is het OLO-nummer opgenomen door een verwijzing naar een query met dvcode = omgeving_olonummer. Die query ziet er als volgt uit:

select dvlvoaanvraagnr from tbomgvergunning where dnkey = {id}

Aangezien in de query de variabele {id} is opgenomen die vervangen moet worden door de dnkey van de betreffende omgevingszaak, is de aanroep naar de query voorzien van een tweede parameter %keypointer% dus: %query(omgeving_olonummer,%keypointer%)%.

Stel het OLO-nummer is '123456' dan zal het uiteindelijke resultaat van het indrukken van de schermknop zijn het openen van de URL:

https://www.omgevingsloket.nl/BevoegdGezag/bevoegdgezag/AanvraagTab/Aanvraag/123456/AanvraagGegevens

De URL daartoe is: http://www.ruimtelijkeplannen.nl/web-roo/roo/bestemmingsplannen?xxxx&yyyy Waarbij op de plaats van de xxxx de tekst 'postcode='+ een valide postcode moet worden ingevoerd en op de plaats van de yyyy moet de tekst 'huisnummer=' + een huisnummer en eventueel een huisletter worden ingevoerd.

Dat lossen we op door:

• een knop te definiëren op het detailscherm van het locatie adres met een action waarin bovengenoemde URL wordt gedefinieerd
• in de URL een queryverwijzing te maken teneinde de tekst 'postcode=' + de gewenste postcode op te halen
• in de URL een queryverwijzing te maken teneinde de tekst 'huisnummer=' + een huisnummer en huisletter op te halen
• een query te maken die de gevraagde postcode informatie retourneert
• een query te maken die het gevraagde huisnummerinformatie retourneert.

De knop kan als volgt worden gedefinieerd:

<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>14</icoon>
   <align/>
   <pretext/>
   <posttext/>
   <hint>ga naar ruimtelijke plannen</hint>
   <action>openTabPage(http://www.ruimtelijkeplannen.nl/web-roo/roo/bestemmingsplannen?%query(locatie_postcode,%keypointer%)%&amp;%query(locatie_huisnr,%keypointer%)%)</action>
</column>

In de URL is het postcodegedeelte opgenomen door een verwijzing naar een query met dvcode = locatie_postcode. Die query ziet er als volgt uit:

select 'postcode='| | coalesce(dvpostcode,'') from tbperceeladressen where dnkey = {id}

Aangezien in de query de variabele {id} is opgenomen die vervangen moet worden door de dnkey van de betreffende locatie (tbperceeladressen), is de aanroep naar de query voorzien van een tweede parameter %keypointer%, dus: %query(locatie_postcode,%keypointer%)%.

In de URL is het huisnummergedeelte opgenomen door een verwijzing naar een query met dvcode = locatie_huisnr. Die query ziet er als volgt uit:

select 'huisnummer=' | | coalesce(trim(dvhuisnummer),'') | | coalesce(dvhuisletter,'') from tbperceeladressen where dnkey = {id}

Aangezien in de query de variabele {id} is opgenomen die vervangen moet worden door de dnkey van de betreffende locatie (tbperceeladressen), is de aanroep naar de query voorzien van een tweede parameter %keypointer%, dus: %query(locatie_huismummer,%keypointer%)%.

Stel de postcode van de locatiekaart waarvandaan de knop wordt aangesproken = 1074XK en het huisnummer = 41, dan zal een URL geopend worden met:

http://www.ruimtelijkeplannen.nl/web-roo/roo/bestemmingsplannen?postcode=1074XK&huisnummer=41

De URL van bijvoorbeeld het x, y punt (168875,382535) op een PDOK-kaart is:

https://kaart.pdok.nl/api/api.html?mloc=168875,382535&mt=mt3&loc=168875,382535&zoom=10&tekst=Locatie:%3C/BR%3E168875,382535

De action:

opentabpage(https://kaart.pdok.nl/api/api.html?mloc=%query(coordinaten,%keypointer%)%&mt=mt3&loc=%query(coordinaten,%keypointer%)%&zoom=10&tekst=Locatie:%3C/BR%3E%query(coordinaten,%keypointer%)%)

De query coördinaten moet dus als resultaat een x- en een y-coördinaat teruggeven (in rijksdriehoek) gescheiden door een komma.

Een query kan worden gebruikt om de inhoud van de tag filter contextgevoelig te maken.

Voorbeeld: wanneer bij een processtap een extra invoerkolom is gedefinieerd van type dropdown, dan wordt de bijbehorende query voor het dropdownlijstje in het beheer bij de definitie van de procestap gedefinieerd. Deze wordt bij het binnenhalen van een proces vervolgens gekopieerd naar de tabel tbtermijnbewstappen om de kolom dvinvoerdropd aldaar met een dropdowwnlijstje te kunnen vullen. Om nu - dynamisch - het juiste dropdownlijstje te krijgen is de kolom dvinvoerdropd in de schermkolomdefinitie van het detailscherm van een processtap als volgt gedefinieerd (inclusief contextgevoelige zichtbaarheid en label):

<column value="dvinvoerdropd">
                <regel>3</regel>
                <tagnaam>dvinvoerdropd</tagnaam>
                <label>%query(termijnstappen_mddc_getinvoerlabeldropd,%keypointer%)%</label>
                <divwidth>400</divwidth>
                <divheight>30</divheight>
                <edit>true</edit>
                <showhint>false</showhint>
                <wavetype>keuzelijst</wavetype>
                <source>generalwithoutemptyline</source>
                <filter>%query(termijnstappen_mddc_getinvoerquerydropd,%keypointer%)%</filter>
                <refresh>false</refresh>
                <backcolor/>
                <fontcolor/>
                <nullable>true</nullable>
                <icoon/>
                <visible>%query(termijnstappen_mddc_isinvoerdropdvsb,%keypointer%)%</visible>
   </column>

Een query kan worden gebruikt om de inhoud van de tag nullable contextgevoelig te maken.

select case when (select dvcodesoortovverg from tbovvergunningen where dnkey = {id}) = 'O' 
              then  'Volgens artikel X van wet y zal de ontheffing ....'
              else ''::text
         end

Hetgeen betekent dat indien het zaaktype van de APV/Overige vergunning waar vandaan het document wordt gecreëerd van het soort 'O' is dat alleen dan de tekst Volgens artikel X van wet y zal de ontheffing …. zal worden ingevoegd.

select dvtekstblok from tbtekstblokken where lower(dvcode) = 
               case when (select dvcodesoortovverg from tbovvergunningen where dnkey = {id}) = 'O' 
                    then  'tkstblk_1'
                    when (select dvcodesoortovverg from tbovvergunningen where dnkey = {id}) = 'E' 
                     then  'tkstblk_2'
               else 'xxx'
               end

Hetgeen betekent dat indien het zaaktype van de APV/Overige vergunning waar vandaan het document wordt gecreëerd van het soort 'O' is dat dan de inhoud van de kolom dvtekstblok uit de tabel tbtekstblokken (beheer) met dvcode = tkstblk_1 wordt afgedrukt.

Indien soort = 'E' wordt de inhoud van de kolom dvtekstblok met dvcode = tkstblk_2 afgedrukt. En anders niets.

Zie voor invoegen plaatjes op basis van query onder Kopje: Invoegen plaatjes op basis van een query-aanroep naar tbqueries die verwijst naar tbimages bij Documentsjablonen.