====== Flexmap (technische) Beschrijving ======
{{tag>openwave:1.32:applicatiebeheer:functionaliteiten:geo}}
===== Gebruik en aanroep =====
De (interne) FlexMap wordt getoond indien
* de instelling //Sectie: Programma en Item: Flexmap// aangevinkt is.
* EN de instelling //Sectie: Programma en Item: ToonKaart// aangevinkt is
* EN de kolom info van de instelling //Sectie: Programma en Item: Toonkaart// leeg is (hier kan namelijk de URL van een externe kaartviewer staan).
Is dat het geval dan wordt met de kaartknop of met een tekenopdracht uit een menulijstje de FlexMap getoond door een aanroep naar de OpenWave-API //getFlexMap//.
Daarbij wordt met parameters aangegeven of de kaart alleen in kijkmodus wordt geopend, of dat de kaart geopend wordt om een punt aan te wijzen of om een polygoon of lijn te tekenen.\\
Ook wordt met een parameter geregeld waarvandaan de kaart wordt geopend en wat er op te zien is, door de naam van een xml-file mee te geven, waarin deze informatie staat.
* vanuit een omgevingzaak in kijkmodus: //getFlexMap(163636,tbomgvergunning,MDMC_tbomgvergunning.xml)// waarbij 163636 de dnkey is van een kaart in tbomgvergunning
* dus als action bij een zelf gedefinieerde knop op een detailscherm //getFlexMap(%keypointer%,tbomgvergunning,MDMC_tbomgvergunning.xml)//
* dus als action bij een zelf gedefinieerde knop op een lijstscherm //getFlexMap({id},tbomgvergunning,MDMC_tbomgvergunning.xml)//
* vanuit een inrichting met de opdracht om een vlak te tekenen: //getFlexMap(13456,tbmilinrichtingen,MDMC_tbmilinrichtingen.xml,Polygon)//
* vanuit een projectlocatie die gekoppeld is aan een omgevingzaak met de opdracht om een punt aan te wijzen: //getFlexMap(12345,tbzaakkadperc,MDMC_tbzaakkadperc_w.xml,Point)//
* vanuit een projectlocatie die gekoppeld is aan een inrichting in kijkmodus: //getFlexMap(6789,tbzaakkadperc,MDMC_tbzaakkadperc_V.xml)//
* vanuit een stal met de opdracht om een vlak te tekenen //getFlexMap(2345,tbmilstal,MDMC_tbmilstal.xml,Polygon)//
De api getFlexmap heeft dus 3 of 4 parameters:
* param1 = een pointer naar een specifieke rij van een tabel van waaruit de FlexMap wordt aangeroepen door middel van de primary key van die tabel.
* param2 = de tabelnaam van waaruit de FlexMap wordt aangeroepen
* param3 = de naam van de xml waarin alle instructies staan voor de opbouw van de kaart. De naam van deze xml moet beginnen met //'MDMC_'//
* param4 = indien
* leeg dan wordt de kaart gestart in kijkmodus.
* Indien //Polygon// dan kan de gebruiker een polygoon tekenen op de kaart.
* Indien //Point// dan kan de gebruiker een punt aanwijzen op de kaart
* Indien //LineString// dan kan de gebruiker een lijn trekken op de kaart
===== Welke MDMC_*.xml's =====
In de aangeroepen MDMC_*.xml is geregeld:
* het centrale punt van de kaart
* wat er in de widget info getoond moet worden
* welke basisobjecten er sowieso zichtbaar moeten zijn
* wat er in de widget tekenopdracht getoond moet worden
* welke kaartlagen er getoond kunnen worden
* waar en hoe een getekend punt of polygoon of lijn moet worden opgeslagen
In de programmatuur van OpenWave zijn hiertoe standaard de volgende xml's opgenomen
* MDMC_tbperceeladressen
* MDMC_tbmilinrichtingen
* MDMC_tbomgvergunning
* MDMC_tbomgvergunning
* MDMC_tbmilvergunningen
* MDMC_tbhandhavingen
* MDMC_tbinfoaanvragen
* MDMC_tbhorecavergunningen
* MDMC_tbbouwvergunningen
* MDMC_tbzaakkadperc_w (voor een project locatie gekoppeld aan een omgevingzaak)
* MDMC_tbzaakkadperc_o (voor een project locatie gekoppeld aan een APV/overige zaak)
* MDMC_tbzaakkadperc_h (voor een project locatie gekoppeld aan een handhaving zaak)
* MDMC_tbzaakkadperc_v voor een project locatie gekoppeld aan een inrichting)
* MDMC_tbmilopslag
* MDMC_tbmildiversen
* MDMC_tbmilemlucht
* MDMC_tbmilemwater
* MDMC_horontheffingen
* MDMC_tbmilstal
* MDMC_tbmilasbest
* MDMC_tbmilopslagevcontour
* MDMC_tbmilbklkwetsbgebloc.xml
OpenWave zoekt bij het openen van de kaart eerst naar de waarde van param3 van de FlexMap-aanroep in de tabel tbscreencolumns in de kolom dvscreenfilename (//beheerportaal: tegel Alle schermkolomdefinities//) en als de kolom dvscreenxml gevuld is, dan wordt die (xml-)definitie genomen.\\
Niet gevonden, of de kolom dvscreenxml is leeg, dan gebruikt OpenWave de default xml-kaartdefinitie, maar dit alleen indien param3 één van de bovenstaande namen heeft.
=====Foutafvanging=====
Indien de kaart wordt aangeroepen op basis van een xml die niet goed in elkaar zit, dan
* verschijnt een foutmelding linksonder in het scherm
* en wordt een rij aangemaakt in de tabel tbmissingconfiguration (//beheerportaal: tegel: ontbrekende configuratieitems//) met in de foutbeschrijving het gedeelte uit de xml dat voor het probleem zorgt.
De xml moet in ieder geval aan de volgende xsd voldoen
=====Inhoudelijke beschrijving van de MDMC_*.xml=====
//(Op basis van mdmc_tbmilinrichtingen.xml)//\\
De xml is verdeeld in de volgende blokken:
* center
* zoom
* widgetinfo
* basisobjecten
* widgetopdracht
* openwavelayers
* wfslayers
* wmslayers
* widgetbuttons
* actions
* punten
* lijnen
* vlakken
* cirkels
OpenWave evalueert voordat de kaart geopend wordt de SQL-statements in de xml en vervangt deze statements door hun resultaat.\\
De variabele %keypointer% wordt overal vervangen door param1 van de FlexMap-aanroep (dus in onderstaande voorbeelden een dnkey van tbmilinrichtingen).
===== Blok
=====
select case when b.dvxrdcoordinaat is null and substr(b.dvgmlrdpolygoon, 1, position(' 'IN b.dvgmlrdpolygoon) - 1) is null then coalesce(a.dnxcoordinaat,155600) ||','|| coalesce(a.dnycoordinaat,465175)
when b.dvxrdcoordinaat is null then substr(b.dvgmlrdpolygoon, 1, position(' 'IN b.dvgmlrdpolygoon) - 1)
else b.dvxrdcoordinaat ||','|| b.dvyrdcoordinaat
end dvpos
from vwfrmmilinrichtingen a left outer join tbzaakkadperc b
on (a.dnkeymilinrichtingen = b.dnkeymilinrichtingen and b.dlhoofdprojectlocatie = 'T')
where a.dnkeymilinrichtingen = %keypointer%
Het blok
moet één keer voorkomen.\\
Het blok
bevat één tag dat gevuld wordt door de evaluatie van het SQL-statement. Het resultaat van de SQL bestaat uit één rij bestaande uit één string die een x-coördinaat en een y-coördinaat gescheiden door een komma bevat. In rijksdriehoek.\\
De kaart wordt gecentreerd op dat punt.
===== Tag =====
12
De tag moet één keer voorkomen.\\
In de tag moet rechtsreeks een integer waarde staan (dus geen SQL-statement). De kaart wordt gestart met dit zoomlevel.
===== Blok =====
select 'Locatiedossier:' || dvinrichtingnaam from vwfrmmilinrichtingen where
dnkeymilinrichtingen = %keypointer%select coalesce(dvobjadres,'') ||' ' || coalesce(dvobjplaats,'') from vwfrmmilinrichtingen
where dnkeymilinrichtingen = %keypointer% select 'Handelsnaam:' || dvhandelsnaam from vwfrmmilinrichtingen where
dnkeymilinrichtingen = %keypointer%
Het blok moet één keer voorkomen.\\
Het blok moet één blok bevatten en elk blok moet bestaan uit één of meer regels die in het attribuut id oplopend genummerd moeten worden. Het SQL-statement per regel moet één rij opleveren bestaande uit één string.\\
Het blok widgetinfo moet ook één blok bevatten en elk blok moet bestaan uit één of meer regels die in het attribuut id oplopend genummerd moeten worden. Het SQL-statement per regel moet één rij opleveren bestaande uit één string.\\
Op de kaart verschijnt een widget met als titel //Zaakinformatie// met daarin de opgegeven kop- en bodyteksten.
===== Blok =====
select 'Adrespunt: '|| coalesce(a.dvinrichtingnaam,'') dvdescription,
case when b.dvxrdcoordinaat is null then a.dnxcoordinaat ||','|| a.dnycoordinaat
else b.dvxrdcoordinaat ||','|| b.dvyrdcoordinaat
end dvpos, 'Red' dvcolorname
from vwfrmmilinrichtingen a left outer join tbzaakkadperc b
on (a.dnkeymilinrichtingen = b.dnkeymilinrichtingen and b.dlhoofdprojectlocatie = 'T')
where a.dnkeymilinrichtingen = %keypointer%
select 'Grondvlak: '|| coalesce(a.dvinrichtingnaam,'') dvdescription,
coalesce(a.dvgmlpolygoon,b.dvgmlrdpolygoon) dvposlist, 'Red'
dvfillcolorname, 'Black' dvstrokecolorname, 0.5 dfopacity from vwfrmmilinrichtingen a left outer join tbzaakkadperc b
on (a.dnkeymilinrichtingen = b.dnkeymilinrichtingen and b.dlhoofdprojectlocatie = 'T') where
a.dnkeymilinrichtingen = %keypointer% and coalesce(b.dvgmlrdpolygoon,a.dvgmlpolygoon) is not null and fn_islinestring(coalesce(b.dvgmlrdpolygoon,a.dvgmlpolygoon)) != 1select 'Grondvlak: '|| coalesce(a.dvinrichtingnaam,'') dvdescription,
coalesce(a.dvgmlpolygoon,b.dvgmlrdpolygoon) dvposlist, 'Red'
dvfillcolorname, 'Black' dvstrokecolorname, 0.5 dfopacity, 3 dfstrokewidth from vwfrmmilinrichtingen a left outer join tbzaakkadperc b
on (a.dnkeymilinrichtingen = b.dnkeymilinrichtingen and b.dlhoofdprojectlocatie = 'T') where
a.dnkeymilinrichtingen = %keypointer% and coalesce(b.dvgmlrdpolygoon,a.dvgmlpolygoon) is not null and fn_islinestring(coalesce(b.dvgmlrdpolygoon,a.dvgmlpolygoon)) = 1
Het blok mag één keer voorkomen (maar hoeft niet).\\
Binnen het blok moet één of meer keer een blok zijn gedefinieerd.\\
Een blok heeft het attribuut //type// dat mag bestaan uit //point// of //polygon// of //linestring//.\\
Een blok van type //point// bevat één tag waarachter een SQL-statement die na evaluatie één rij oplevert met de kolommen dvcolorname, dvdescription en dvpos waarbij dvpos gevuld moet zijn met een x-coördinaat en een y-coördinaat, in rijksdriehoek, gescheiden door een komma en dvcolorname met een //html-color-name//.\\
Een blok van type //polygon// bevat één tag waarachter een SQL-statement die na evaluatie één rij oplevert met de kolommen dvfillcolorname, dvstrokecolorname, dvdescription en dvposlist en dfopacity waarbij:
* dvfillcolorname (vulling) en dvstrokecolorname (omlijning) gevuld moeten zijn met een //html-color-name//
* dvposlist met een reeks rijksdriehoek-punten gescheiden door een spatie waarbij het laatste coordinatenpaar gelijk is aan het eerste paar (bijv.: 154039.62,464749.74000000005 154154.7,464785.86000000004 154197.54,464748.9000000001 154137.9,464712.7800000001 154092.54,464723.70000000007 154039.62,464749.74000000005)
* dfopacity met een float-waarde tussen 0 en 1
Een blok van type //linestring// bevat één tag waarachter een SQL-statement die na evaluatie één rij oplevert met de kolommen dvfillcolorname, dvstrokecolorname, dvdescription en dvposlist en dfopacity waarbij:
* dvstrokecolorname gevuld moet zijn met een //html-color-name//
* dvposlist met een reeks rijksdriehoek-punten gescheiden door een spatie waarbij het laatste coordinatenpaar ongelijk is aan het eerste paar (bijv.: 154039.62,464749.74000000005 154154.7,464785.86000000004 154197.54,464748.9000000001 154137.9,464712.7800000001 154092.54,464723.70000000007)
* dfopacity met een float-waarde tussen 0 en 1
De uitkomst van de SQL-statements mag null zijn. In dat geval wordt het betreffende vlak, punt of lijn niet geprojecteerd op de map.\\
De SQL-statements die wel valide punt(en) en of vlak(ken) en of lijn(en) retourneren worden geprojecteerd op de kaart en daarvan zijn de omschrijvingen (dvdescription) terug te vinden in de widget met de titel //Legenda//.
===== Blok =====
select case when dvgmlpolygoon is null then 'Teken nieuwe lijn' else 'Wijzig lijn' end from vwfrmmilinrichtingen where
dnkeymilinrichtingen = %keypointer%select 'Lijn:' dvdescription,
dvgmlpolygoon dvposlist, 'Fuchsia' dvstrokecolorname, 0.5
dfopacity, 3 dfstrokewidthfrom vwfrmmilinrichtingen where dnkeymilinrichtingen = %keypointer% and fn_islinestring(dvgmlpolygoon) = 1select case when dvgmlpolygoon is null then 'Teken nieuw inrichtingcontour' else 'Wijzig inrichtingcontour' end from vwfrmmilinrichtingen where
dnkeymilinrichtingen = %keypointer%select 'Inrichtingscontour:' || dvinrichtingnaam dvdescription,
dvgmlpolygoon dvposlist, 'Fuchsia' dvfillcolorname, 'Black' dvstrokecolorname, 0.5
dfopacity from vwfrmmilinrichtingen where dnkeymilinrichtingen = %keypointer%
Het blok mag één keer voorkomen (maar hoeft niet).\\
Indien het blok niet voorkomt is er geen extra informatie over de tekenopdracht (zie hieronder blok ) beschikbaar, wanneer de vierde parameter van de FlexMap-aanroep is gevuld.\\
Binnen het blok mag één keer een blok en mag één keer een blok en mag één keer een blok zijn gedefinieerd.\\
Binnen een blok of of moet
* één blok zijn gedefinieerd met daarin één of meer tags die in het attribuut id oplopend genummerd moeten worden. Achter een tag regel moet een SQL-statement staan dat na evaluatie één rij bestaande uit één string oplevert.
* en één blok met daarbinnen één tag gevuld met een SQL-statement dat na evaluatie:
* in geval van één rij met de kolommen dvcolorname, dvdescription en dvpos bevat (zie hierboven bij )
* in geval van één rij met de kolommen dvfillcolorname, dvstrokecolorname, dvdescription en dvposlist en dfopacity bevat (zie hierboven bij )
* in geval van één rij met de kolommen dvstrokecolorname, dvdescription en dvposlist en dfopacity bevat (zie hierboven bij )
De evaluatie van de tag mag null zijn. Dus //select null// is een geldig statement. Met deze informatie wordt in deze OpenWave versie (namelijk nog) niets gedaan.
De koptekst wordt gebruikt als tekst in de widget met de titel //tekenen en bewerken// die zichtbaar wordt indien de aanroep van de FlexMap in de vierde parameter de waarde //Polygon// of //Point// of //LineString// bevat (indien point dan wordt de koptekst van gebruikt, indien linestring dan die van en bij Polygon die van .
===== Blok =====
select 'REV Referentieobjecten'select 'REV EvContouren'select 'Stallen'select 'Projectlocaties'select 'Perceeladrespunt bij inrichting'
Het blok mag één keer voorkomen (maar hoeft niet).\\
het blok bestaat uit een of meer tags .\\
Elke tag heeft een attribuut //id// (elke layer heeft hierin een unieke integer waarde) waarnaar wordt verwezen in de blokken , , en cirkels (zie verderop).\\
Elke tag heeft een attribuut //active// die de waarde false of true kan hebben: de layer staat standaard aan of uit.\\
Achter de tag staat een SQL-statement dat na evaluatie één rij oplevert bestaande uit één string: de laagnaam.\\
Deze laagnamen zijn aan en uit te vinken op de kaart in de widget met de titel //filter & kaartlagen// onder het subkopje //data-objecten//.\\
Indien een laagnaam is aangevinkt dan zal OpenWave de punten, vlakken, lijnen en cirkels tonen van de blokken vlak, lijn, punt en cirkel met een overeenkomstig attribuut layer id (zie verderop). Deze getoonde OpenWave-lagen bestaan uit data die komen uit de OpenWave database.\\
===== Blok =====
adressen
Het blok mag één keer voorkomen (maar hoeft niet).
het blok bestaat uit een of meer tags .
Elke tag heeft een attribuut:
* id (elke layer heeft hierin een unieke integer waarde).
* active die de waarde false of true kan hebben: de wfslayer staat standaard aan of uit.
* index die een integer waarde heeft
* isbasislaag die altijd de waarde false moet hebben
* layer met de externe naam van de WFS-laag
* opacity met een integer waarde tussen 0 en 100
* source met de URL waar de laag is op te halen
* icon met een integer waarde 1, 2 of 3 die aangeeft met welk soort icoontje de punten op de WFS-laag getoond moeten worden (respectievelijk vierkant, rondje, driehoek)
* color met een html_color-name
Achter de tag staat een string (dus geen SQL-statement) met de naam zoals de laag op de kaart moet heten: de laagnaam.\\
Deze laagnamen zijn aan en uit te vinken op de kaart in de widget met de titel //filter & kaartlagen// onder het subkopje WFS-lagen.\\
Indien een laagnaam is aangevinkt dan zal OpenWave de betreffende externe laag ophalen en tonen.
De WFS-lagen die in de tabel tbgeowms (//beheerportaal tegel: Geo kaartlagen//) aangemerkt zijn
* als WFS-laag: de kolom dlwMS //WMS-laag? (anders WFS)// staat NIET aangevinkt
* EN waarvoor geldt dat de kolom dlinFlexmap (//Altijd opnemen in FlexMap//) wel aangevinkt is
die lagen worden onder water automatisch opgenomen in de xml ook als het blok niet bestaat.
===== Blok =====
BAG-pandenKadasterGeotestVanAnneliesAlle vergunningszaken
Het blok mag één keer voorkomen (maar hoeft niet).
het blok bestaat uit een of meer tags .
Elke tag heeft een attribuut:
* id (elke layer heeft hierin een unieke integer waarde)
* active die de waarde false of true kan hebben: de wfslayer staat standaard aan of uit
* index die een integer waarde heeft
* isbasislaag die altijd de waarde false moet hebben
* layer met de externe naam van de WMS-laag
* opacity met een integer waarde tussen 0 en 100
* source met de URL waar de laag is op te halen
Achter de tag staat een string (dus geen SQL-statement) met de naam zoals de laag op de kaart moet heten: de laagnaam.\\
Deze laagnamen zijn aan en uit te vinken op de kaart in de widget met de titel //filter & kaartlagen// onder het subkopje WMS-lagen.\\
Indien een laagnaam is aangevinkt dan zal OpenWave de betreffende externe laag ophalen en tonen.
De WMS-lagen die in de tabel tbgeowms (//beheerportaal tegel: Geo kaartlagen//) aangemerkt zijn
* als WMS-laag: de kolom dlwMS //WMS-laag? (anders WFS)// staat aangevinkt
* EN waarvoor geldt dat de kolom dlinFlexmap (//Altijd opnemen in FlexMap//) ook aangevinkt is
die lagen worden onder water automatisch opgenomen in de xml ook als het blok niet bestaat.
De objecten van een WMS-laag kunnen in OpenWave geselecteerd worden en die selectie(s) kunnen vervolgens gebruikt worden om bijvoorbeeld een vlak te tekenen.
=
===== Blok =====
Het blok mag één keer voorkomen (maar hoeft niet).\\
Indien het blok niet voorkomt dan zijn er geen knoppen waarmee een tekenopdracht afgesloten kan worden, terwijl de vierde parameter van de FlexMap-aanroep is gevuld.\\
Binnen het blok mag één keer een blok en mag één keer een blok en mag één keer een blok zijn gedefinieerd. In bovenstaand voorbeeld ontbreekt een blok omdat in de inrichtingstabel alleen een vlak of lijn kan worden opgeslagen.\\
Binnen een blok of of moet één of meer keer de tag