Durch die Kombination der [REFERENCE] und [LASTVALUE] Mit diesen Funktionen können Sie historische Attributwerte abrufen. Eine häufige Anwendung ist das Abrufen der Angaben zum früheren Vorgesetzten und zur früheren Abteilung eines Benutzers, was beispielsweise für Prozesse wie das Versenden von E-Mail-Benachrichtigungen bei einem Stellenwechsel nützlich ist. In diesem Leitfaden wird auch die Verwendung der[IFEMPTYUSE] Funktion, um einen Ausweichwert bereitzustellen, falls keine historischen Daten vorliegen.
Syntaxen
-
[LASTVALUE; Attribute]: Ruft den letzten vorherigen Wert des angegebenenAttribute. -
[REFERENCE; AttributeToReturn; LookupAttribute; LookupValue; MatchValue]: Sucht ein Objekt und gibt ein bestimmtes Attribut davon zurück. -
[IFEMPTYUSE; PrimaryValue; FallbackValue]: Gibt diePrimaryValuewenn sie nicht leer ist; andernfalls gibt sie dieFallbackValue.
Anwendungsfälle
Kontaktdaten eines früheren Vorgesetzten abrufen
Um die E-Mail-Adresse oder den Anzeigenamen des letzten Vorgesetzten eines Benutzers zu ermitteln, können Sie Folgendes verwenden: [LASTVALUE; Manager] als den zu suchenden Wert.
-
So erhalten Sie die E-Mail-Adresse des vorherigen Vorgesetzten:
[REFERENCE;Email;UserId;1;[LASTVALUE;Manager]]
-
So ermitteln Sie den Namen des vorherigen Vorgesetzten:
[REFERENCE;DisplayName;UserId;1;[LASTVALUE;Manager]]
Bereitstellung einer Ausweichlösung für den aktuellen Manager
Wird kein vorheriger Manager gefunden, geben die obigen Ausdrücke einen leeren Wert zurück. Um die Daten des aktuellen Managers als Ausweichlösung bereitzustellen, schließen Sie den Ausdruck in ein[IFEMPTYUSE] Funktion.
-
E-Mail (bei Nichtverfügbarkeit an den derzeitigen Vorgesetzten):
[IFEMPTYUSE;[REFERENCE;Email;UserId;1;[LASTVALUE;Manager]];[REFERENCE;Email;UserId;1;[manager]]] -
Name (falls nicht vorhanden, aktueller Vorgesetzter):
[IFEMPTYUSE;[REFERENCE;DisplayName;UserId;1;[LASTVALUE;Manager]];[REFERENCE;DisplayName;UserId;1;[manager]]]
Fortgeschrittene Anwendung: Ungenaue Übereinstimmung
Die [REFERENCE] Die Funktion verfügt über einen optionalen letzten Parameter, der festlegt, ob bei der Suche eine exakte Übereinstimmung erforderlich ist:
[REFERENCE;AttributeToReturn;LookupAttribute;LookupValue;MatchValue;IsExactMatch]
Wenn die IsExactMatch Der Parameter ist auf false, das MatchValue Das Feld unterstützt Platzhalter (%). Dies ist nützlich für komplexe, positionsspezifische Abfragen, beispielsweise wenn ein Manager bei mehreren Unternehmen beschäftigt ist und möglicherweise mehr als eine UserId.