Het bedrijf waarvoor ik werk, verkoopt een op MapGuide Open Source gebaseerde GIS-oplossing. Ik gebruik regelmatig de functies LOOKUP en CONCAT om tooltips en hyperlinks aan te maken. Dit zijn erg handige functies, maar wanneer je ze begint te gebruiken, is het niet altijd even duidelijk wat hun mogelijkheden zijn. In dit artikel leg ik ook uit hoe je in deze functies met NULL-waarden kunt omgaan.
Onze op MapGuide gebaseerde applicatie wordt beheerd met behulp van MapGuide Maestro. Hierdoor kunnen we tijdens het gebruik van de Expression Editor voor tooltips en hyperlinks de ingebouwde informatie over de functies raadplegen.
CONCAT
De ingebouwde informatie over de functie CONCAT toont Concat([text property], [text property]). Toen ik MapGuide Maestro begon te gebruiken, deed dit me vermoeden dat ik de functie als volgt moest gebruiken wanneer ik drie teksten wilde combineren:
CONCAT('Tekst A', CONCAT('Tekst B', 'Tekst C')) Als je nog meer teksten moet combineren, zou dat al snel leiden tot erg complexe expressies voor een vrij eenvoudige taak. Gelukkig is de functie CONCAT niet beperkt tot twee teksten. Je kunt ze dus als volgt gebruiken:
CONCAT('Text A', 'Text B', 'Text C')Hier is een voorbeeld van hoe je deze functie in een tooltip kunt gebruiken. De expressie combineert tekst, HTML-tags en veldwaarden:
CONCAT('<b>', LSTRNM, '</b><br/>Huisnummer: ', HNR)En hier is een voorbeeld van hoe je de functie in een hyperlink kunt gebruiken:
CONCAT('https://voorbeeld.be/zoek?straat=', URLENCODE(LSTRNM))Merk op dat ik ook de functie URLENCODE() gebruik. Zonder deze functie zou een straatnaam met spaties of accenten de URL onbruikbaar maken.
LOOKUP
De ingebouwde informatie over de functie LOOKUP toont de volgende syntaxis LOOKUP([expression], [defaultValue], [index], [value]). Voor mij maakte dit niet duidelijk wat deze functie precies doet.
LOOKUP vergelijkt de waarde van een expressie, meestal een veld, met een lijst van waarden. Wanneer er een overeenkomst wordt gevonden, geeft de functie het resultaat terug dat bij die waarde hoort. Wanneer er geen overeenkomst is, geeft ze een standaardwaarde terug. Als je andere programmeertalen kent, kun je dit vergelijken met een switch-instructie of een CASE in SQL. Dat klinkt misschien nog wat abstract. Daarom leg ik het uit aan de hand van een voorbeeld:
LOOKUP(VeldA, 'standaardwaarde', 'mijnwaarde', 'anderewaarde')In bovenstaand voorbeeld:
- De waarde van VeldA wordt vergeleken met de waarden in de lijst.
- Als VeldA gelijk is aan ‘mijnwaarde’, is het resultaat ‘anderewaarde’.
- Als VeldA met geen enkele waarde in de lijst overeenkomt, is het resultaat ‘standaardwaarde’.
Praktijkvoorbeeld
Hoe gebruik ik deze functie concreet? In het volgende voorbeeld is het resultaat een lege tekenreeks als het veld LSTRNM gelijk is aan ‘ng’. In alle andere gevallen wordt de inhoud van LSTRNM weergegeven.
LOOKUP(LSTRNM, LSTRNM, 'ng', '')In de laag waarin ik deze expressie gebruikte, werd de waarde ‘ng’ gebruikt wanneer een straatnaam niet beschikbaar was, in plaats van een NULL-waarde. Daardoor verschenen er op de kaart heel wat labels met ‘ng’. Deze functie verbergt die labels, maar toont nog steeds de namen van alle andere straten.
LOOKUP met meerdere waarden
LOOKUP is niet beperkt tot één waarde en één resultaat. Na de expressie en de standaardwaarde kun je zoveel paren toevoegen als je nodig hebt. Elk paar begint met de waarde waarmee vergeleken moet worden, gevolgd door het resultaat voor die waarde.
In het volgende voorbeeld bevat het veld WEGTYPE korte codes zoals ‘SW’ en ‘HW’. Deze codes zijn niet erg nuttig voor mensen die de kaart bekijken, dus wordt LOOKUP gebruikt om ze in de tooltip te vervangen door een begrijpelijke omschrijving:
CONCAT(
LSTRNM,
' (',
LOOKUP(
WEGTYPE,
'onbekend wegtype',
'SW', 'snelweg',
'HW', 'hoofdweg',
'LW', 'lokale weg',
'FP', 'fietspad'),
')')In dit voorbeeld:
- De waarde van WEGTYPE wordt in de opgegeven volgorde vergeleken met ‘SW’, ‘HW’, ‘LW’ en ‘FP’.
- Als er een overeenkomst wordt gevonden, wordt het resultaat gebruikt dat bij die waarde hoort. Zo wordt ‘SW’ vervangen door ‘snelweg’, ‘HW’ door ‘hoofdweg’, enzovoort.
- Als WEGTYPE met geen enkele waarde overeenkomt, wordt ‘onbekend wegtype’ als resultaat gebruikt.
- Vervolgens plaatst CONCAT de straatnaam ervoor, met het wegtype tussen haakjes.
Voor een straat met de naam Kerkstraat en het wegtype ‘HW’ zal de tooltip dus het volgende tonen: ‘Kerkstraat (hoodweg)’
Ik plaats elke waarde en het bijbehorende resultaat op een afzonderlijke regel. Dat is voor MapGuide niet noodzakelijk, maar het maakt het veel gemakkelijker om te zien welk resultaat bij welke waarde hoort, vooral wanneer de lijst langer wordt.
LOOKUP-functies combineren
Je kunt ook verschillende LOOKUP-functies combineren.
In het volgende voorbeeld zijn er twee velden met straatnamen: LSTRNM bevat de straatnaam aan de linkerkant van de straat en RSTRNM bevat de straatnaam aan de rechterkant van de straat.
LOOKUP(
LSTRNM,
LOOKUP(
RSTRNM,
LOOKUP(
LSTRNM,
CONCAT(LSTRNM, ' - ', RSTRNM),
RSTRNM,
LSTRNM),
'ng',
LSTRNM),
'ng',
LOOKUP(RSTRNM, RSTRNM, 'ng', ''))Deze expressie werkt van buiten naar binnen:
- Eerst wordt gecontroleerd of LSTRNM gelijk is aan ‘ng’. Als dat zo is, is er geen straatnaam aan de linkerkant en wordt de naam aan de rechterkant gebruikt. De laatste LOOKUP zorgt er nog voor dat er geen label wordt weergegeven als ook RSTRNM gelijk is aan ‘ng’.
- Als LSTRNM een straatnaam bevat, wordt gecontroleerd of RSTRNM gelijk is aan ‘ng’. Als dat het geval is, wordt alleen LSTRNM weergegeven.
- Als beide velden een straatnaam bevatten, vergelijkt de binnenste LOOKUP de twee waarden. Als ze gelijk zijn, wordt de naam slechts één keer weergegeven. Als ze verschillen, worden beide namen weergegeven met een koppelteken ertussen.
Dit levert de volgende mogelijke resultaten op:
| LSTRNM | RSTRNM | Label |
| Kerkstraat | Kerkstraat | Kerkstraat |
| Kerkstraat | Stationstraat | Kerkstraat – Stationstraat |
| Kerkstraat | ng | Kerkstraat |
| ng | Stationstraat | Stationstraat |
| ng | ng | (geen label) |
Omgaan met NULL-waarden
In mijn laag werden ontbrekende straatnamen opgeslagen als ‘ng’. In veel datasets wordt in plaats daarvan een NULL-waarde gebruikt, en de bovenstaande expressie houdt daar geen rekening mee. Een NULL-waarde is nooit gelijk aan iets anders, zelfs niet aan ‘ng’. Daardoor herkent LOOKUP deze waarde nooit als een ontbrekende straatnaam.
Het resultaat kan dan labels opleveren zoals ‘Kerkstraat -‘ , of er verschijnt helemaal geen label voor een straat die wel degelijk een naam heeft.
De oplossing is de functie NullValue.
NullValue(VELD, ‘ng’) geeft de inhoud van VELD terug, maar als VELD de waarde NULL heeft, geeft de functie in plaats daarvan ‘ng’ terug.
Op die manier behandelt de expressie een NULL-waarde precies hetzelfde als ‘ng’.
LOOKUP(
NullValue(LSTRNM, 'ng'),
LOOKUP(
NullValue(RSTRNM, 'ng'),
LOOKUP(
LSTRNM,
CONCAT(LSTRNM, ' - ', RSTRNM),
RSTRNM,
LSTRNM),
'ng',
LSTRNM),
'ng',
LOOKUP(NullValue(RSTRNM, 'ng'), RSTRNM, 'ng', ''))Je hoeft NullValue niet voor elk veld in de expressie te gebruiken, maar alleen op de plaatsen waar het veld wordt gecontroleerd op de waarde ‘ng’:
- De buitenste LOOKUP controleert NullValue(LSTRNM, ‘ng’). Als de straatnaam links ‘ng’ of NULL is, wordt de laatste LOOKUP gebruikt. Die toont RSTRNM, tenzij ook RSTRNM gelijk is aan ‘ng’ of NULL. In dat geval wordt er geen label weergegeven.
- De tweede LOOKUP controleert NullValue(RSTRNM, ‘ng’). Als de straatnaam rechts ‘ng’ of NULL is, wordt alleen LSTRNM weergegeven.
- De binnenste LOOKUP wordt alleen bereikt wanneer beide velden een straatnaam bevatten. Daar is dus geen NullValue nodig.
Dit levert de volgende resultaten op:
| LSTRNM | RSTRNM | Label |
| Kerkstraat | Kerkstraat | Kerkstraat |
| Kerkstraat | Stationstraat | Kerkstraat – Stationstraat |
| Kerkstraat | ng or NULL | Kerkstraat |
| ng or NULL | Stationstraat | Stationstraat |
| ng or NULL | ng or NULL | (no label) |
