[REFERENCE] & [LASTVALUE] - Récupération des données historiques des utilisateurs

En combinant les [REFERENCE] et [LASTVALUE] fonctions, vous pouvez récupérer les valeurs historiques des attributs. Une application courante consiste à récupérer les informations relatives à l'ancien responsable et au service d'un utilisateur, ce qui s'avère utile pour des processus tels que l'envoi de notifications par e-mail lors d'un changement de poste. Ce guide aborde également l'utilisation de la[IFEMPTYUSE] fonction permettant de fournir une valeur par défaut en l'absence de données historiques.

Syntaxes

[LASTVALUE; Attribute]: Récupère la valeur précédente la plus récente de l'élément spécifié Attribute.
[REFERENCE; AttributeToReturn; LookupAttribute; LookupValue; MatchValue]: Recherche un objet et renvoie un attribut spécifié de celui-ci.
[IFEMPTYUSE; PrimaryValue; FallbackValue]: Renvoie le PrimaryValue si elle n'est pas vide ; sinon, elle renvoie la FallbackValue.

Cas d'utilisation

Obtenir les coordonnées d'un ancien responsable

Pour trouver l'adresse e-mail ou le nom d'affichage du dernier ancien responsable d'un utilisateur, vous pouvez utiliser [LASTVALUE; Manager] comme valeur à rechercher.

Pour obtenir l'adresse e-mail de votre ancien responsable :
```
[REFERENCE;Email;UserId;1;[LASTVALUE;Manager]]
```

Pour obtenir le nom de l'ancien responsable :

[REFERENCE;DisplayName;UserId;1;[LASTVALUE;Manager]]

Mise en place d'une solution de secours pour le gestionnaire actuel

Si aucun gestionnaire précédent n'est trouvé, les expressions ci-dessus renverront une valeur vide. Pour fournir les informations relatives au gestionnaire actuel à titre de solution de secours, placez l'expression entre des balises[IFEMPTYUSE] fonction.

E-mail (à transmettre à votre responsable actuel si nécessaire) :

[IFEMPTYUSE;[REFERENCE;Email;UserId;1;[LASTVALUE;Manager]];[REFERENCE;Email;UserId;1;[manager]]]

Nom (ou, à défaut, nom du responsable actuel) :

[IFEMPTYUSE;[REFERENCE;DisplayName;UserId;1;[LASTVALUE;Manager]];[REFERENCE;DisplayName;UserId;1;[manager]]]

Utilisation avancée : correspondance approximative

Le [REFERENCE] La fonction dispose d'un dernier paramètre facultatif qui détermine si la recherche nécessite une correspondance exacte :

[REFERENCE;AttributeToReturn;LookupAttribute;LookupValue;MatchValue;IsExactMatch]

Lorsque le IsExactMatch Le paramètre est défini sur false, le MatchValue Ce champ prend en charge les caractères génériques (%). Cela s'avère utile pour les recherches complexes et spécifiques à un poste, par exemple lorsqu'un cadre est employé par plusieurs entreprises et peut occuper plusieurs UserId.

Dernière mise à jour : 4 août 2025