[REFERENCE] & [LASTVALUE] - Historische gebruikersgegevens ophalen
Door de [REFERENTIE]
en [LASTVALUE]
functies kun je historische attribuutwaarden ophalen. Een veelgebruikte toepassing is het ophalen van de vorige manager en afdelingsgegevens van een gebruiker, wat handig is voor processen zoals het versturen van e-mailmeldingen tijdens een functiewijziging. Deze handleiding behandelt ook het gebruik van de[IFEMPTYUSE]
functie om een terugvalwaarde te geven als er geen historische gegevens zijn.
Syntaxen
[LASTVALUE; Attribuut].
: Haalt de meest recente vorige waarde van de opgegevenAttribuut
.[REFERENCE; AttributeToReturn; LookupAttribute; LookupValue; MatchValue].
: Zoekt een object op en geeft er een gespecificeerd attribuut van terug.[IFEMPTYUSE; PrimaryValue; FallbackValue]
: Geeft als resultaat dePrimaireWaarde
als deze niet leeg is; anders wordt deFallbackValue
.
Gebruikscases
Contactgegevens van een vorige manager ophalen
Om het e-mailadres of de weergavenaam van de meest recente voormalige manager van een gebruiker te vinden, kun je het volgende gebruiken [LASTVALUE; Manager]
als de op te zoeken waarde.
Het e-mailadres van de vorige manager opvragen:
CODE[REFERENCE;Email;UserId;1;[LASTVALUE;Manager]]
Om de naam van de vorige manager op te halen:
CODE[REFERENCE;DisplayName;UserId;1;[LASTVALUE;Manager]]
Een noodoplossing bieden voor de huidige manager
Als er geen vorige manager wordt gevonden, geven de bovenstaande expressies een lege waarde terug. Om de details van de huidige manager als fallback te geven, wikkel je de expressie in een[IFEMPTYUSE]
functie.
E-mail (terugval naar huidige manager):
CODE[IFEMPTYUSE;[REFERENCE;Email;UserId;1;[LASTVALUE;Manager]];[REFERENCE;Email;UserId;1;[manager]].
Naam (Fallback naar huidige manager):
CODE[IFEMPTYUSE;[REFERENCE;DisplayName;UserId;1;[LASTVALUE;Manager]];[REFERENCE;DisplayName;UserId;1;[manager]].
Geavanceerd gebruik: Niet-exacte overeenkomst
De [REFERENTIE]
functie heeft een optionele laatste parameter die bepaalt of het opzoeken een exacte overeenkomst vereist:
[REFERENCE;AttributeToReturn;LookupAttribute;LookupValue;MatchValue;IsExactMatch].
Wanneer de IsExactMatch
parameter is ingesteld op vals
de WedstrijdWaarde
veld ondersteunt jokertekens (%
). Dit is handig voor complexe, positie-specifieke lookups, zoals wanneer een manager in dienst is bij meerdere bedrijven en meer dan één UserId
.