${client/hoofdadres}
De tag ${client/hoofdadres} maakt gebruik van de API AddressAPI.mainAddressByClientId. Hierbij wordt het hoofdadres voor de cliënt opgehaald op basis van de volgende rangschikking:
AddressType.TIJDELIJK |
AddressType.VERBLIJF |
AddressType.GBA |
AddressType.CORRESPONDENTIE |
AddressType.ONBEKEND |
AddressType.OVERIG |
AddressType.FACTUUR_ADRES |
AddressType.SLEUTEL_ADDRESS |
Deze volgorde is anders dan de oude rangschikking van Ons Administratie voor de tag [client/adres].
${client/adressen/bijType}
De tag ${client/adressen/bijType} maakt gebruik van de API AddressAPI.byClientId en filtert daarbij op enkel actuele adressen (zonder einddatum).
Het is mogelijk om in het gebruik van de tag een type mee te geven, bijvoorbeeld ${client/adressen/bijType[type=1]:straat}. Hierbij wordt voor een client een actueel adres gezocht van het type GBA (zie hieronder). Daarbij pakt de tag met : het eerste resultaat en wordt de straatnaam geprint.
Waarde | Cupido-term | Vertaling |
0 | Unknown adress | Onbekend |
1 | Living address | GBA |
2 | Postal address | Correspondentie |
3 | Residence address | Verblijf |
4 | Temporary address | Tijdelijk |
50 | Key address | Sleutel |
98 | Other address | Overig |
100 | Invoice address | Factuur |
null | Haalt alle adressen op ongeacht type |
Adres met aangepaste rangschikking
Het is mogelijk om een adres op te halen volgens een zelf opgegeven rangschikking. Gebruik daarvoor het filter eerste match. Bij dit filter geef je een aantal zoektermen op gescheiden door komma's. Ons Tags geeft vervolgens het adres terug dat voldoet aan de eerste gevonden zoekterm.
Voorbeeld
Stel je wilt het eerste adres zoeken dat een sleuteladres is. Als dat er niet is, wil je het eerste adres dat een GBA-adres is. Als dat er niet is, het eerste overige adres; enzovoorts. In dit voorbeeld is de rangschikking:
Type adres |
Sleutel adres |
GBA-adres |
Overig adres |
Het is hierbij belangrijk te onthouden wat je als filter kunt gebruiken:
Type adres | Te gebruiken filter |
Onbekend | Unknown |
GBA | Living |
Correspondentie | Postal |
Verblijf | Residence |
Tijdelijk | Temporary |
Sleutel | Key |
Overig | Other |
Factuur | Invoice |
Je gaat dan als volgt te werk:
Maak een kopie van de tag ${client/adressen/bijType}.
Hernoem de tagCollectie en bovenste tagNode, bijvoorbeeld naar client/adressen/sleutel}.
Maak een filter op de lijstnode.
Bij Selecteer een node kies je getTypeString.
Bij Selecteer een filter kies je eerste match.
Bij waarde typ je de rangschikking: key,living,other.
Sla het filter op.
Zet de parameter type op vaste waarde null (je wilt immers zoeken in alle typen).
De lijstnode ziet er als volgt uit als je de bovenstaande stappen hebt uitgevoerd:
Bij het uitvoeren van de tag:
van voorbeeldcliënt Jansen met een sleutel- en een GBA-adres, geeft deze tag nu het sleuteladres terug.
van voorbeeldcliënt De Vries met een GBA- en overig adres, geeft de tag het GBA-adres terug.
van een voorbeeldcliënt met alleen een verblijfadres, wordt geen adres teruggegeven. Wil je in dit laatste geval toch het eerste overgebleven adres terugkrijgen, dan gebruik je key,living,other,, (met twee kommas achteraan) als filterwaarde.
Met dit filter krijg je een lijst met adressen terug, weliswaar met maar één adres erin. In een template kun je de notatie voor geaggregeerde tags gebruiken, bijvoorbeeld ${_client/adressen/sleutel:_volledig} voor het volledige adres.
