Sie können integrierte Regelfunktionen in Ihren Regelausdrücken verwenden, um verschiedene Transformationen auf den Werten durchzuführen. Das allgemeine Format für den Aufruf integrierter Regelfunktionen ist
%[*]$$function(arg[,…])[:Offset,Länge]%
wobei das Sternchen (*) als Platzhalter für mehrere Werte und die Spezifikationen für die untergeordneten Zeichenfolgen "Offset" und "Länge" auch in diesem Fall optional sind.
Beim Folgenden handelt es sich um anerkannte integrierte Funktionen:
|
Integrierte Regelfunktion |
Beschreibung |
|---|---|
|
ALLOF |
Führt alle Parameter zu einem mehrwertigen Attribut zusammen. Die Reihenfolge wird beibehalten und doppelte Werte werden entfernt. Wenn z. B. für Benutzerattribute das Folgende festgelegt wurde: eTCustomField01: { A, B } Dann wird die Regel: %*ALLOF(%*UCU01%,%*UCU02%)% in drei Werten { A, B, C } ausgewertet. |
|
DATE |
Wertet das aktuelle Datum im Format tt/mm/jjjj aus. Der Regelausdruck %D% entspricht einem der Folgenden: %$$DATE()% |
|
FIRSTOF |
Gibt den ersten Wert eines beliebigen Parameters zurück. Wird verwendet, um einen Standardwert einzufügen, wenn ein Attribut nicht festgelegt wurde: %$$FIRSTOF(%UCU01%,'unbekannt')% Wenn keiner der Werte festgelegt wurde, enthält das Ergebnis keine Werte. Um eine Zeichenfolge in Form einer Konstanten in ein Argument einzugeben, setzen Sie sie in einzelne Anführungszeichen. |
|
INDEX |
Gibt einen Wert eines mehrwertigen Attributs zurück. Index 1 ist der erste Wert. Wenn der Index größer als die Anzahl der Werte ist, besteht das Ergebnis aus einer leeren Zeichenfolge, d. h. einem nicht festgelegten Wert. Die folgenden Regeln entsprechen dem Folgenden: %$$INDEX(%*UCU01%,1)% %$$FIRSTOF(%*UCU01%)% |
|
NOTEMPTY |
Gibt den einzigen Wert eines einzelnen Arguments zurück, meldet jedoch einen Fehler, wenn dieser Attributwert nicht festgelegt ist. Beispiel 1: Die Erstellung des Kontos wird mit einem Fehler beendet oder aktualisiert, wenn der Benutzer nicht über ein zugewiesenes UID-Attribut verfügt: %$$NOTEMPTY(%UID%)% Beispiel 2: Verwendet den Vornamen, es sei denn, dieser wurde nicht festgelegt. In einem solchen Fall wird der Nachname verwendet. Wenn keiner von beiden festgelegt wird, wird die Erstellung des Kontos mit einem Fehler beendet oder aktualisiert. %$$NOTEMPTY( %$$FIRSTOF( %UF%, %UL% )% )% |
|
PRIMARYEMAIL |
Gibt die primäre E-Mail-Adresse zurück, die aus den unterschiedlichen E-Mail-Adressen extrahiert wurde. Der Ausdruck %UE% entspricht dem Folgenden: %$$PRIMARYEMAIL(%UEP%)% |
|
RDNVALUE |
Behandelt den Attributwert als einen definierten LDAP-Namen und extrahiert den allgemeinen Namen des Objekts aus diesem DN: %*$$RDNVALUE(%#eTRoleDN%)% Gibt die allgemeinen Namen aller zugewiesenen Bereitstellungsrollen zurück. Wenn der Benutzer zwei Bereitstellungsrollen mit demselben allgemeinen Namen angehört, wird dieser Rollenname nur einmal aufgeführt. |
|
TOLOWER |
Wandelt Text in Großbuchstaben in Kleinbuchstaben um: %$$TOLOWER(%AC%)% |
|
TOUPPER |
Wandelt Text in Kleinbuchstaben in Großbuchstaben um: %$$TOUPPER(%U%)% |
|
TRIM |
Entfernt führende und nachgestellte Leerzeichen von einem Attributwert. So erstellt z. B. "%UF %UL%" allgemein einen Wert, bei dem Vor- und Nachname durch ein Leerzeichen getrennt sind. Wenn das Attribut für den Vornamen des Benutzers jedoch eine leere Zeichenfolge ist, würde diese Regel jedoch einen Wert erzeugen, der mit einem nachgestellten Leerzeichen endet. Wenn Sie jedoch "%$$TRIM(%UF% %UL%)% verwenden, stellen Sie so sicher, dass es keine führenden oder nachgestellten Leerzeichen im Wert des Kontoattributs gibt, selbst wenn der Vorname oder der Nachname nicht festgelegt wurde. |
|
Copyright © 2015 CA Technologies.
Alle Rechte vorbehalten.
|
|