Funktionsreferenz für Microsoft Identity Manager 2016

In Microsoft Identity Manager (MIM) 2016 können Sie mithilfe von Funktionen Attributwerte ändern, bevor sie in eine Funktionsaktivität oder deklarative Bereitstellung an ein Ziel übergeben werden. Ziel dieses Dokuments ist es, Ihnen einen Überblick über die verfügbaren Funktionen und eine Beschreibung der Verwendungsmöglichkeiten zu geben.

Das Konfigurieren von Attributflusszuordnungen ist eine elementare Aufgabe beim Konfigurieren von Synchronisierungsregeln. Die einfachste Form einer Attributflusszuordnung ist eine direkte Zuordnung. Wie durch den Namen angegeben, übernimmt eine direkte Zuordnung den Wert eines Quellattributes und wendet es auf das konfigurierte Zielattribute an. Es gibt Fälle, in denen Sie entweder vorhandene Attributwerte ändern oder neue Attributwerte berechnen müssen, bevor das System sie auf ein Ziel anwendet.

Funktionen sind eine integrierte Methode, die verwendet wird, um den Typ der Änderung zu definieren, den Sie benötigen, um das Synchronisierungsmodul beim Generieren eines Attributwerts für ein Ziel anzuwenden.

Die MIM-Funktionen werden in die folgenden Kategorien verteilt:

• Datenmanipulation: Führen Sie eine Vielzahl von Manipulationsvorgängen für Zeichenfolgen aus.

• Datenabruf: Extrahieren von Daten aus Attributwerten.

• Datengenerierung: Generieren von Werten.

• Logik: Ausführen von Vorgängen basierend auf Bedingungen.

Die folgenden Abschnitte enthalten weitere Details zu den Funktionen in jeder Kategorie.

Datenmanipulationsfunktionen

Datenmanipulationsfunktionen werden verwendet, um eine Vielzahl von Manipulationsvorgängen für Zeichenfolgen auszuführen.

Concatenate	Einzelheit
BESCHREIBUNG	Die Verkettenfunktion verkettet zwei oder mehr Zeichenfolgen.
Funktionssignatur	string1 + string2...
Eingänge	Mindestens zwei Zeichenfolgen.
Operationen	Alle Eingabezeichenfolgenparameter werden miteinander verkettet.
Ausgabe	Eine Zeichenfolge.

Großschrift	Einzelheit
BESCHREIBUNG	Die Großbuchstabenfunktion konvertiert alle Zeichen in einer Zeichenfolge in Großbuchstaben.
Funktionssignatur	String UpperCase(string)
Eingänge	Eine Zeichenfolge.
Operationen	Alle Kleinbuchstaben des Eingabeparameters werden in Großbuchstaben konvertiert. Beispiel: UpperCase("test") führt zu "TEST".
Ausgabe	Eine Zeichenfolge.

Kleingeschrieben	Einzelheit
BESCHREIBUNG	Die Funktion "Kleinbuchstaben" konvertiert alle Zeichen in einer Zeichenfolge in Kleinbuchstaben.
Funktionssignatur	String LowerCase(string)
Eingänge	Eine Zeichenfolge.
Operationen	Alle Großbuchstaben des Eingabeparameters werden in Kleinbuchstaben konvertiert. Beispiel: LowerCase("TeSt") führt zu "test".
Ausgabe	Eine Zeichenfolge.

ProperCase	Einzelheit
BESCHREIBUNG	Die Funktion "ProperCase" konvertiert das erste Zeichen jedes durch Leerzeichen getrennten Worts in einer Zeichenfolge in Großbuchstaben. Alle anderen Zeichen werden in Kleinbuchstaben konvertiert.
Funktionssignatur	String ProperCase(string)
Eingänge	Eine Zeichenfolge.
Operationen	Das erste Zeichen jedes durch Leerzeichen getrennten Worts im Eingabeparameter wird in Großbuchstaben konvertiert. Alle Großbuchstaben werden in Kleinbuchstaben konvertiert. Wenn ein Wort im Eingabeparameter mit einem nicht alphabetischen Zeichen beginnt, wird das erste Zeichen des Worts nicht in Großbuchstaben konvertiert. Beispiel: ProperCase("TEsT") führt zu "Test". ProperCase("britta simon") führt zu "Britta Simon". ProperCase(" TEsT") führt zu " Test". ProperCase("\$TEsT") führt zu "\$Test".
Ausgabe	Eine Zeichenfolge.

LTrim	Einzelheit
BESCHREIBUNG	Die LTrim-Funktion entfernt die führenden Leerzeichen aus einer Zeichenfolge.
Funktionssignatur	String LTrim(string)
Eingänge	Eine Zeichenfolge.
Operationen	Die führenden Leerzeichen, die im Eingabeparameter enthalten sind, werden entfernt. Beispiel: LTrim(" Test ") führt zu "Test ".
Ausgabe	Eine Zeichenfolge.

RTrim	Einzelheit
BESCHREIBUNG	Die RTrim-Funktion entfernt die nachfolgenden Leerzeichen aus einer Zeichenfolge.
Funktionssignatur	String RTrim(string)
Eingänge	Eine Zeichenfolge.
Operationen	Die nachfolgenden Leerzeichen, die im Eingabeparameter enthalten sind, werden entfernt. Beispiel: RTrim(" Test ") führt zu " Test".
Ausgabe	Eine Zeichenfolge.

Trimmen	Einzelheit
BESCHREIBUNG	Die Glättungsfunktion entfernt die führenden und nachfolgenden Leerzeichen aus einer Zeichenfolge.
Funktionssignatur	String Trim(string)
Eingänge	Eine Zeichenfolge.
Operationen	Die führenden und nachfolgenden Leerzeichen in der Zeichenfolge werden entfernt. Beispiel: Trim(" Test ") führt zu "Test".
Ausgabe	Eine Zeichenfolge.

RightPad	Einzelheit
BESCHREIBUNG	Mit der RightPad-Funktion wird eine Zeichenfolge mit einer angegebenen Länge mit einem bereitgestellten Abstandszeichen versehen.
Funktionssignatur	String RightPad(string, length, padCharacter)
Eingänge	Zeichenfolge: Die zu padde Zeichenfolge. Länge: Eine ganze Zahl, die die gewünschte Länge der Zeichenfolge darstellt. padCharacter: Eine Zeichenfolge, die aus einem einzelnen Zeichen besteht, das als Padzeichen verwendet werden soll.
Operationen	Wenn die Länge Zeichenfolge kleiner als Längeist, wird die padCharacter- wiederholt an das Ende Zeichenfolge angefügt, bis die Zeichenfolge Länge gleich Längeist. Beispiel: RightPad("User", 10, "0") führt zu "User000000". RightPad(RandomNum(1,10), 5, "0") kann zu "9000"führen.
Ausgabe	Wenn Zeichenfolge eine Länge größer oder gleich Längehat, wird eine Zeichenfolge zurückgegeben, die mit Zeichenfolge identisch ist, zurückgegeben wird. Wenn die Länge Zeichenfolge kleiner als Längeist, wird eine neue Zeichenfolge der gewünschten Länge zurückgegeben. Die neue Zeichenfolge enthält Zeichenfolge, die mit einem padCharacter-aufgefüllt. Wenn Zeichenfolge null ist, gibt die Funktion eine leere Zeichenfolge zurück. Hinweis: padCharacter kann ein Leerzeichen sein, es kann jedoch kein Nullwert sein. Wenn die Länge der Zeichenfolge gleich oder größer als Längeist, wird Zeichenfolge unverändert zurückgegeben.

LeftPad	Einzelheit
BESCHREIBUNG	Mit der LeftPad-Funktion wird eine Zeichenfolge mit einer angegebenen Länge mit einem bereitgestellten Abstandszeichen versehen.
Funktionssignatur	String LeftPad(string, length, padCharacter)
Eingänge	Zeichenfolge: Die zu padde Zeichenfolge. Länge: Eine ganze Zahl, die die gewünschte Länge der Zeichenfolge darstellt. padCharacter: Eine Zeichenfolge, die aus einem einzelnen Zeichen besteht, das als Padzeichen verwendet werden soll.
Operationen	Wenn die Länge der Zeichenfolge kleiner als Längeist, wird die padCharacter- wiederholt am Anfang Zeichenfolge, bis die Zeichenfolge Länge gleich Längeist. Beispiel: RightPad("User", 10, "0") führt zu "000000User". RightPad(RandomNum(1,10), 5, "0") kann zu "0009"führen.
Ausgabe	Wenn Zeichenfolge eine Länge größer oder gleich Längehat, wird eine Zeichenfolge zurückgegeben, die mit Zeichenfolge identisch ist, zurückgegeben wird. Wenn die Länge Zeichenfolge kleiner als Längeist, wird eine neue Zeichenfolge der gewünschten Länge zurückgegeben. Die neue Zeichenfolge enthält Zeichenfolge, die mit einem padCharacter-aufgefüllt. Wenn Zeichenfolge null ist, gibt die Funktion eine leere Zeichenfolge zurück. Hinweis: padCharacter kann ein Leerzeichen sein, es kann jedoch kein Nullwert sein. Wenn die Länge der Zeichenfolge gleich oder größer als Längeist, wird Zeichenfolge unverändert zurückgegeben.

BitOr	Einzelheit
BESCHREIBUNG	Die BitOr-Funktion legt ein angegebenes Bit für eine Kennzeichnung auf 1 fest.
Funktionssignatur	Int BitOr(mask, flag)
Eingänge	Mask: Ein Hexadezimalwert, der das bit angibt, das für das Flagfestgelegt werden soll. Flag: Ein Hexadezimalwert, der ein bestimmtes Bit geändert werden soll.
Operationen	Diese Funktion konvertiert beide Parameter in binäre Darstellung und vergleicht sie: Legt ein Bit auf 1 fest, wenn ein oder beide der entsprechenden Bits im Maskenformat und Flag- 1 sind. Legt ein Bit auf 0 fest, wenn beide der entsprechenden Bits 0 sind. Gibt 1 in allen Fällen zurück, außer wenn die entsprechenden Bits beider Parameter 0 sind. Das resultierende Bitmuster ist die "set" (1 oder true) Bits einer der beiden Operanden. Mehrere Flag Bits können festgelegt werden, wenn mehrere Bits den Wert 1 im Maskenformathaben.
Ausgabe	Eine neue Version von Flag mit den in Mask angegebenen Bits, auf 1 festgelegt ist.

BitAnd	Einzelheit
BESCHREIBUNG	Die BitAnd-Funktion legt ein angegebenes Bit für ein Flag auf 0 fest.
Funktionssignatur	Int BitOr(mask, flag)
Eingänge	Maske: Ein Hexadezimalwert, der das bit angibt, das für das Flaggeändert werden soll. Flag: Ein Hexadezimalwert, der ein bestimmtes Bit geändert werden soll.
Operationen	Diese Funktion konvertiert beide Parameter in binäre Darstellung und vergleicht sie: Legt ein Bit auf 0 fest, wenn ein oder beide der entsprechenden Bits in Maske und Kennzeichnung 0 sind. Legt ein Bit auf 1 fest, wenn beide der entsprechenden Bits 1 sind. Gibt in allen Fällen 0 zurück, es sei denn, die entsprechenden Bits beider Parameter sind 1. Mehrere Kennzeichnung Bits können auf 0 festgelegt werden, wenn mehrere Bit den Wert 0 im Maskhaben.
Ausgabe	Eine neue Version von Flag mit den in Mask angegebenen Bits, auf 0 festgelegt sind.

Datumszeitformat	Einzelheit
BESCHREIBUNG	Die DateTimeFormat-Funktion wird verwendet, um eine DateTime in Zeichenfolgenform in ein angegebenes Format zu formatieren.
Funktionssignatur	String DateTimeFormat(dateTime, format)
Eingänge	dateTime-: Eine Zeichenfolge, die die zu formatierende DateTime darstellt. Format: Eine Zeichenfolge, die das zu konvertierende Format darstellt. Hinweis: Informationen zu den Zeichen, die zum Erstellen benutzerdefinierter Formate akzeptiert werden, finden Sie unter benutzerdefinierten Datums-/Uhrzeitformate.
Operationen	Die im Format angegebene Formatzeichenfolge wird auf dateTime in der dateTime- Zeichenfolge angewendet. Die im Format angegebene Zeichenfolge muss ein gültiges DateTime-Format sein. Andernfalls wird ein Fehler zurückgegeben, der angibt, dass das Format kein gültiges DateTime-Format ist. Beispiel: DateTime("12/25/2007", "yyyy-MM-dd") führt zu "2007-12-25".
Ausgabe	Eine Zeichenfolge, die sich aus dem Anwenden Formats auf dateTime-ergibt.

ConvertSidToString	Einzelheit
BESCHREIBUNG	Die ConvertSidToString konvertiert ein Bytearray mit einem Sicherheitsbezeichner in eine Zeichenfolge.
Funktionssignatur	String ConvertSidToString(ObjectSID)
Eingänge	ObjectSID-: Ein Bytearray, das einen Sicherheitsbezeichner (SECURITY Identifier, SID) enthält.
Operationen	Die angegebene binäre SID wird in eine Zeichenfolge konvertiert.
Ausgabe	Eine Zeichenfolgendarstellung der SID.

ConvertStringToGuid	Einzelheit
BESCHREIBUNG	Die ConvertStringToGuid-Funktion konvertiert die Zeichenfolgendarstellung einer GUID in eine binäre Darstellung der GUID.
Funktionssignatur	Byte[] ConvertStringToGuid(stringGuid)
Eingänge	stringGuid: Eine im Muster xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxformatierte Zeichenfolge, wobei der Wert der GUID als Eine Reihe von Hexadezimalziffern in Gruppen von 8, 4, 4, 4 und 12 Ziffern dargestellt und durch Bindestriche getrennt wird. Ein Beispiel für einen Rückgabewert ist 382c74c3-721d-4f34-80e557657b6cbc27.
Operationen	Die stringGuid- wird in die binäre Darstellung konvertiert. Wenn die Zeichenfolge keine Darstellung einer gültigen GUID ist, weist die Funktion das Argument mit dem Fehler "Der Parameter für die ConvertStringToGuid-Funktion muss eine Zeichenfolge sein, die eine gültige GUID darstellt."
Ausgabe	Eine binäre Darstellung der GUID.

ReplaceString	Einzelheit
BESCHREIBUNG	Die ReplaceString-Funktion ersetzt alle Vorkommen einer Zeichenfolge in eine andere Zeichenfolge.
Funktionssignatur	String ReplaceString(string, OldValue, NewValue)
Eingänge	Zeichenfolge: Die Zeichenfolge, in der Werte ersetzt werden sollen. OldValue: Die Zeichenfolge, nach der gesucht und ersetzt werden soll. NewValue: Die zu ersetzende Zeichenfolge.
Operationen	Alle Vorkommen von OldValue in der Zeichenfolge werden durch NewValueersetzt. Die Funktion muss die Sonderzeichen \nverarbeiten können. neue Zeile, \r. Wagenrücklauf und \t. Registerkarte. Beispiel: ReplaceString("One\n\rMicrosoft\n\r\Way","\n\r"," ") gibt "One Microsoft Way"zurück.
Ausgabe	Eine Zeichenfolge mit allen Vorkommen von OldValue in der Zeichenfolge, die durch NewValue ersetzt wurde.

Datenempfangsfunktionen

Datenabruffunktionen werden verwendet, um Vorgänge auszuführen, die die gewünschten Zeichen aus einer Zeichenfolge abrufen.

Word	Einzelheit
BESCHREIBUNG	Die Word-Funktion gibt ein in einer Zeichenfolge enthaltenes Wort auf der Grundlage von Parametern zurück, die die zu verwendenden Trennzeichen und die Nummer des zurückzugebenden Worts beschreiben.
Funktionssignatur	String Word(string, number, delimiters)
Eingänge	Zeichenfolge: Die Zeichenfolge, aus der ein Wort zurückgegeben werden soll. Zahl: Eine Zahl, die angibt, welche Wortnummer zurückgegeben werden soll. Trennzeichen: Eine Zeichenfolge, die die Trennzeichen darstellt, die zum Identifizieren von Wörtern verwendet werden sollen.
Operationen	Jede Zeichenfolge in der Zeichenfolge, die durch eines der Zeichen in Trennzeichen getrennt ist, als Wort identifiziert wird. Wenn Zeichenfolge null ist, gibt die Funktion eine leere Zeichenfolge zurück. Das Wort, das an der in Zahl angegebenen Position gefunden wurde, zurückgegeben wird. Wenn Zahl< 1 zurückgibt, gibt die Funktion eine leere Zeichenfolge zurück. Beispiel: Word("Test;of%function;", 3, ";$&%") gibt "function" zurück. Word("Test;;Function" , 2 , ";") gibt "" zurück (eine leere Zeichenfolge). Word("Test;of%function;", 0, ";$&%") gibt "" zurück (eine leere Zeichenfolge).
Ausgabe	Eine Zeichenfolge, die das Wort an der Position enthält, nach der der Benutzer gefragt hat. Wenn Zeichenfolge weniger als Anzahl Wörter enthält, oder Zeichenfolge keine wörter enthält, die von Trennzeichen identifiziert werden, wird eine leere Zeichenfolge zurückgegeben.

Links	Einzelheit
BESCHREIBUNG	Die Left-Funktion gibt eine angegebene Anzahl von Zeichen von links (Anfang) einer Zeichenfolge zurück.
Funktionssignatur	String Left(string, numChars)
Eingänge	Zeichenfolge: Die Zeichenfolge, aus der Zeichen zurückgegeben werden sollen. numChars: Eine Zahl, die die Anzahl der Zeichen angibt, die vom Anfang einer Zeichenfolge zurückgegeben werden sollen.
Operationen	numChars Zeichen werden von der ersten Position der Zeichenfolgezurückgegeben. Beispiel: Left("Britta Simon", 3) gibt "Bri"zurück.
Ausgabe	Eine Zeichenfolge mit den ersten numChars Zeichen in der Zeichenfolge. Wenn numChars = 0 zurückgibt, gibt die Funktion eine leere Zeichenfolge zurück. Wenn numChars< 0 zurückgibt, gibt die Funktion eine Eingabezeichenfolge zurück. Wenn Zeichenfolge null ist, gibt die Funktion eine leere Zeichenfolge zurück.

Rechts	Einzelheit
BESCHREIBUNG	Die Right-Funktion gibt eine bestimmte Anzahl von Zeichen von der rechten Seite einer Zeichenfolge (also vom Ende her) zurück.
Funktionssignatur	String Right(string, numChars)
Eingänge	Zeichenfolge: Die Zeichenfolge, aus der Zeichen zurückgegeben werden sollen. numChars: Eine Zahl, die die Anzahl der Zeichen angibt, die vom Ende einer Zeichenfolge zurückgegeben werden sollen.
Operationen	Zurückgeben numChars Zeichen vom Ende der Zeichenfolge. Beispiel: Right("Britta Simon", 3) gibt "mon"zurück.
Ausgabe	Eine Zeichenfolge mit den letzten numChars Zeichen in der Zeichenfolge. Wenn numChars = 0 zurückgibt, gibt die Funktion eine leere Zeichenfolge zurück. Wenn numChars< 0 zurückgibt, gibt die Funktion eine Eingabezeichenfolge zurück. Wenn Zeichenfolge null ist, gibt die Funktion eine leere Zeichenfolge zurück. Wenn Zeichenfolge weniger Zeichen als die in numCharsangegebene Zahl enthält, wird Zeichenfolgen- zurückgegeben.

Mitte	Einzelheit
BESCHREIBUNG	Die Mid-Funktion gibt eine bestimmte Anzahl von Zeichen ab einer bestimmten Position in einer Zeichenfolge zurück.
Funktionssignatur	String Mid(string, pos, numChars)
Eingänge	Zeichenfolge: Die Zeichenfolge, aus der Zeichen zurückgegeben werden sollen. pos: Eine Zahl, die die Anfangsposition in einer Zeichenfolge für die Rückgabe von Zeichen angibt. numChars: Eine Zahl, die die Anzahl der Zeichen angibt, die von einer Position in der Zeichenfolge zurückgegeben werden sollen.
Operationen	Zurückgeben numChars Zeichen ab Position Pos- in der Zeichenfolge. Beispiel: Mid("Britta Simon", 3, 5) gibt "itta "zurück.
Ausgabe	Eine Zeichenfolge mit numChars Zeichen von position pos in der Zeichenfolge. Wenn numChars = 0 zurückgibt, gibt die Funktion eine leere Zeichenfolge zurück. Wenn numChars< 0 zurückgibt, gibt die Funktion eine leere Zeichenfolge zurück. Wenn pos> die Länge Zeichenfolge, gibt die Funktion eine Eingabezeichenfolge zurück. Wenn pos<= 0 darstellt, gibt die Funktion eine Eingabezeichenfolge zurück. Wenn Zeichenfolge null ist, gibt die Funktion eine leere Zeichenfolge zurück. Wenn keine numChar- Zeichen in Zeichenfolge von Position Pos-verbleiben, werden so viele Zeichen wie möglich zurückgegeben.

Funktionen zur Datengenerierung

Datengenerierungsfunktionen werden verwendet, um Werte für bestimmte Datentypen zu generieren.

CRLF	Einzelheit
BESCHREIBUNG	Die CRLF-Funktion generiert einen Wagenrücklauf/Zeilenvorschub. Verwenden Sie diese Funktion, um eine neue Zeile hinzuzufügen.
Funktionssignatur	String CRLF
Eingänge	Keiner.
Operationen	Ein CRLF wird zurückgegeben. Beispiel: AddressLine1 + CRLF() + AddressLine2 führt zu AddressLine1 AddressLine2.
Ausgabe	Ein CRLF ist die Ausgabe.

RandomNum	Einzelheit
BESCHREIBUNG	Die Zufallszahlfunktion gibt eine Zufallszahl innerhalb eines angegebenen Intervalls zurück.
Funktionssignatur	Int RandomNum(start, end)
Eingänge	beginnen: Eine Zahl, die die untere Grenze des zu generierenden Zufallswerts angibt. Ende: Eine Zahl, die die obere Grenze des zu generierenden Zufallswerts angibt.
Operationen	Eine Zufallszahl größer oder gleich Start und kleiner oder gleich End- wird generiert. Beispiel: Random(0,999) kann 100zurückgeben.
Ausgabe	Eine Zufallszahl innerhalb des durch angegebenen Bereichs beginnen und enden.

EscapeDNComponent	Einzelheit
BESCHREIBUNG	Die EscapeDNComponent-Methode von MIISUtils wird verwendet, um diesen Vorgang auszuführen. Diese Methode verarbeitet die Eingabezeichenfolge basierend auf dem Typ des verwendeten Verwaltungs-Agents (MA).
Funktionssignatur	String EscapeDNComponent(string)
Eingänge	Zeichenfolge: Eine Zeichenfolge, die zum Verarbeiten eines distinguishierten Namens verwendet wird. Die Zeichenfolge darf keine Escapezeichen enthalten.
Operationen	Für unterschiedliche MAs sind unterschiedliche Unterscheidungsnamenformate erforderlich. Diese Methode verarbeitet die Eingabe Zeichenfolge basierend auf den folgenden MA-Typen: LDAP distinguished name: Beispiele für diesen MA-Typ sind Active Directory Domain Services, Sun Directory Server (früher iPlanet Directory Server) und Microsoft Exchange Server. Alle ungültigen XML-Zeichen im Wertteil eines bestimmten Teils sind hexadezimalcodiert. Ungültige Zeichen (einschließlich ungültiger XML-Zeichen) im Namensteil eines bestimmten Teils generieren einen Fehler. Escapezeichen enthalten Komma (,), gleich (=), Pluszeichen (+), kleiner als (<), größer als (>), Zahl (#), Semikolon (;), umgekehrter Schrägstrich () und doppelte Anführungszeichen ("). Wenn das letzte Zeichen in der Zeichenfolge ein Leerzeichen ( ) ist, wird dieses Leerzeichen escapet. Alle zusätzlichen führenden oder nachgestellten Leerzeichen um einen Teilnamen werden entfernt. Wenn für die XML-MA mehrere Teile vorhanden sind, werden die Teile alphabetisch sortiert. Wenn mehrere Teile angegeben werden, ist die zusammengesetzte Distinguished Name String die Verkettung der einzelnen Zeichenfolgen, die durch Pluszeichen (+) getrennt sind. Es wird ein Fehler generiert, wenn die Eingabe Zeichenfolge keine wohlgeformte, ldap-formatierte Zeichenfolge mit distinguished name string ist. Hierarchische nicht-LDAP-: Ein Beispiel für diesen MA-Typ ist Microsoft Lotus Notes. Dieser MA-Typ unterstützt keine mehrteiligen Komponenten. Wenn mehrere Zeichenfolgen an EscapeDNComponentübergeben werden, wird ein ArgumentException- ausgelöst. Wenn eines der Zeichen in der Eingabe Zeichenfolge ungültige XML-Zeichen sind, wird ein ArgumentException- ausgelöst. Alle Kommas (,) und umgekehrten Schrägstriche (/) in der Eingabe Zeichenfolge escapet. Wenn das letzte Zeichen in der Zeichenfolge ein Leerzeichen ( ) ist, wird dieses Leerzeichen escapet. Extrinsic: Beispiele für diesen MA-Typ sind Datenbanken oder XML ohne LDAP-Distinguished Name. Wenn ein Teil binär ist oder ein ungültiges XML-Zeichen enthält, wird dieser Teil als hexadezimal codierte Version der Rohdaten gespeichert, wobei eine Zahl (#) vor der Zeichenfolge vorangestellt ist. Wenn z. B. ein Teil AxC wurde (wobei x ein unzulässiges XML-Zeichen wie 0x10darstellt), wird dieser Teil als #410010004300codiert. Andernfalls werden alle Instanzen dieser Zeichen mit Escapezeichen versehen: umgekehrter Schrägstrich (), Komma (,), Pluszeichen (+) und Zahl (#). Wenn das letzte Zeichen in einer bestimmten Teilzeichenfolge ein Leerzeichen ( ) ist, wird dieses Leerzeichen mit Escapezeichen versehen. Wenn mehrere Teile angegeben werden, ist die zusammengesetzte Distinguished Name String die Verkettung aller einzelnen Zeichenfolgen, die durch Pluszeichen getrennt sind.
Ausgabe	Eine Zeichenfolge, die einen gültigen Domänennamen enthält.

Hinweis

Die Überprüfung von unterschiedenen Namen ist weniger streng als die in den LDAP-Spezifikationen definierte Syntax. EscapeDNComponent(String[]) ermöglicht es einem Teilnamen, eine beliebige Kombination aus einem oder mehreren Zeichen 'a'-'z', 'A'-'Z', '0'-'9', '-' und '.' zu enthalten.

Es ist nicht möglich, einen binären Teil mit dieser Methode anzugeben. Es ist jedoch möglich, einen binären Teil in CommitNewConnector zu haben, wenn der distinguished Name aus Ankerattributen erstellt wird und eines der Ankerattribute ein binärer Typ ist.

Null	Einzelheit
BESCHREIBUNG	Die Null-Funktion wird verwendet, um anzugeben, dass die MA nicht über ein Attribut verfügt, das mitwirken soll, und dass diese Attributrangfolge mit dem nächsten MA fortgesetzt werden soll.
Funktionssignatur	String Null
Eingänge	Keiner.
Operationen	Es wird ein Nullwert zurückgegeben. Beispiel: IIF(Eq(domain), "unknown", Null()) gibt Nullzurück.
Ausgabe	Ein Nullwert wird ausgegeben.

Logikfunktionen

Logikfunktionen werden verwendet, um einen Vorgang basierend auf vom System ausgewerteten Bedingungen auszuführen.

IIF	Einzelheit
BESCHREIBUNG	Die IIF-Funktion gibt basierend auf einer angegebenen Bedingung einen Wert aus einem Satz möglicher Werte zurück.
Funktionssignatur	Object IIF(condition, valueIfTrue, valueIfFalse)
Eingänge	Bedingung: Ein beliebiger Wert oder Ausdruck, der auf "true" oder "false" ausgewertet werden kann. Die folgenden Funktionen sind für die Verwendung als Ausdrücke in der IIF-Funktion für die Bedingung verfügbar: Eq: Diese Funktion vergleicht zwei Argumente für die Gleichheit. NotEquals: Diese Funktion vergleicht zwei Argumente für Ungleichheit und gibt "true" zurück, wenn sie nicht gleich und falsch sind, wenn sie gleich sind. Beispiel: NotEquals(EmployeeType, "Contractor"). LessThan: Diese Funktion vergleicht zwei Zahlen, wobei "true" zurückgegeben wird, wenn der erste kleiner als der zweite und andernfalls "false" ist. Beispiel: LessThan(Salary, 100000). GreaterThan: Diese Funktion vergleicht zwei Zahlen und gibt "true" zurück, wenn die erste größer als die zweite und andernfalls "false" ist. Beispiel: GreaterThan(Salary, 100000). LessThanOrEquals: Diese Funktion vergleicht zwei Zahlen und gibt "true" zurück, wenn der erste kleiner oder gleich der zweiten und andernfalls "false" ist. Beispiel: LessThanOrEquals(Salary, 100000). GreaterThanOrEquals: Diese Funktion vergleicht zwei Zahlen und gibt "true" zurück, wenn der erste größer als oder gleich dem zweiten und andernfalls "false" ist. Beispiel: GreaterThanOrEquals(Salary, 100000). IsPresent: Diese Funktion verwendet als Eingabe eines Attributs im ILM-Schema und gibt "true" zurück, wenn das Attribut nicht NULL und "false" ist, wenn das Attribut null ist. valueIfTrue: Ein Wert, der zurückgegeben wird, wenn die Bedingung als wahr ausgewertet wird. valueIfFalse: Ein Wert, der zurückgegeben wird, wenn die Bedingung als "false" ausgewertet wird.
Operationen	Wenn Bedingung als wahr ausgewertet wird, gibt die Funktion valueIfTruezurück. Andernfalls gibt die Funktion ValueIfFalsezurück. Beispiel: IIF(Eq(EmployeeType,"Intern"),"t-" + Alias, Alias) gibt den Alias eines Benutzers zurück, dem "t-" am Anfang des Alias hinzugefügt wurde, wenn der Benutzer intern ist. Andernfalls gibt die Funktion den Alias des Benutzers as-iszurück.
Ausgabe	Die Ausgabe ist valueIfTrue, wenn die Bedingung wahr ist, oder valueIfFalse, wenn die Bedingung "false" ist.