Funktioner referens för Microsoft Identity Manager 2016Functions Reference for Microsoft Identity Manager 2016

I Microsoft Identity Manager (MIM) 2016, funktionerna kan du ändra attributvärden innan flödar dem till ett mål i en function-aktivitet eller deklarativ etablering.In Microsoft Identity Manager (MIM) 2016, functions enable you to modify attribute values prior to flowing them to a target in a function activity or declarative provisioning. Syftet med det här dokumentet är att ge dig en översikt över alla tillgängliga funktioner och en beskrivning av hur de kan använda.The objective of this document is to give you an overview of the available functions and a description of how you can use them.

Konfigurera mappningar av attributflöde är en grundläggande uppgift när du konfigurerar Synkroniseringsregler.Configuring attribute flow mappings is an elementary task when configuring synchronization rules. Den enklaste formen av ett flöde attributmappning är en direkt mappning.The simplest form of an attribute flow mapping is a direct mapping. Som anges med namnet som en direkt mappning tar värdet för ett källattribut och avser konfigurerade Målattributet.As indicated by the name, a direct mapping takes the value of a source attribute and applies it to the configured destination attribute. Finns det fall där du antingen behöver befintliga attributvärden som ska ändras eller nya attributvärden ska beräknas innan systemet använder dem till ett mål.There are cases where you either need existing attribute values to be modified or new attribute values to be calculated before the system applies them to a destination.

Funktioner är en inbyggd metod som används för att definiera typ av ändring som du behöver Synkroniseringsmotorn ska användas när ett attributvärde för ett mål.Functions are a built-in method used to define the type of modification you need the synchronization engine to apply when generating an attribute value for a destination.

I MIM, kan du gruppera befintliga funktioner i följande kategorier:In MIM, you can group the existing functions into the following categories:

  • Datahanteringsfunktioner.Data Manipulation Functions. Funktioner för en mängd olika manipulering åtgärder på strängar.Functions to perform a variety of manipulation operations on strings.

  • Funktioner för hämtning av data.Data Retrieval Functions. Funktioner för att extrahera data från attributvärden.Functions to extract data from attribute values.

  • Data Generation funktioner.Data Generation Functions. Funktioner för att skapa värden.Functions to generate values.

  • Funktioner i Logic.Logic Functions. Funktioner för att utföra åtgärder baserat på villkor.Functions to perform operations based on conditions.

Följande avsnitt innehåller mer information om funktioner i varje kategori.The following sections provide more details about the functions in each category.

Funktioner för datahanteringData manipulation functions

Datahanteringsfunktioner används för att utföra en mängd manipulering åtgärder på strängar.Data manipulation functions are used to perform a variety of manipulation operations on strings.

SammanfogaConcatenate
BeskrivningDescription Funktionen sammanfoga används för att sammanfoga två eller flera strängar.The Concatenate function is used to concatenate two or more strings.
FunktionssignaturenFunction Signature sträng1 + sträng2...string1 + string2...
IndataInputs Två eller flera strängarTwo or more strings
ÅtgärderOperations Alla Indatasträngen parametrar sammanfogas med varandra.All input string parameters are concatenated with each other.
UtdataOutput En strängOne string
VersalerUpperCase
BeskrivningDescription Funktionen versaler konverterar alla tecken i en textsträng till versaler.The UpperCase function converts all characters in a string to upper case.
FunktionssignaturenFunction Signature Strängen UpperCase(string)String UpperCase(string)
IndataInputs En strängOne string
ÅtgärderOperations Alla gemener för Indataparametern konverteras till versaler.All lower case characters of the input parameter are converted to upper case characters. Exempel: UpperCase("test") resulterar i ”TEST”.Example: UpperCase(“test”) results in “TEST”.
UtdataOutput En strängOne string
GemenerLowerCase
BeskrivningDescription Funktionen gemener konverterar alla tecken i en textsträng till gemener.The LowerCase function converts all characters in a string to lower case.
FunktionssignaturenFunction Signature Strängen LowerCase(string)String LowerCase(string)
IndataInputs En strängOne string
ÅtgärderOperations Alla tecken med versaler för Indataparametern omvandlas till gemener.All upper case characters of the input parameter are converted to lower case characters. Exempel: LowerCase("TeSt") resulterar i ”test”.Example: LowerCase(“TeSt”) results in “test”.
UtdataOutput En strängOne string
ProperCaseProperCase
BeskrivningDescription ProperCase fungera coverts det första tecknet i varje blankstegsavgränsad ord i en sträng med versal och alla andra tecken har konverterats till gemener.The ProperCase function coverts the first character of each space-delimited word in a string to upper case and all other characters are converted to lower case.
FunktionssignaturenFunction Signature Strängen ProperCase(string)String ProperCase(string)
IndataInputs En strängOne string
ÅtgärderOperations Det första tecknet i varje blankstegsavgränsad ord Indataparametern konverteras till versaler, och alla tecken med versaler omvandlas till gemener.The first character of every space-delimited word in the input parameter is converted to upper case, and all upper case characters are converted to lower case characters. Om ett ord i Indataparametern börjar med ett icke-alfabetiska tecken, är det första tecknet i ordet inte att konvertera till versaler.If a word in the input parameter starts with a non-alphabet character, the first character of the word is not converted to upper case.
Exempel:Examples:
-ProperCase("TEsT") resulterar i ”Test”.- ProperCase(“TEsT”) results in “Test”.
-ProperCase("britta simon") resulterar i ”Britta Simon”.- ProperCase(“britta simon”) results in “Britta Simon”.
-ProperCase("TEsT") resulterar i ”Test”.- ProperCase(“ TEsT”) results in “ Test”.
-ProperCase("\$TEsT") resulterar i ”\$Test”.- ProperCase(“\$TEsT”) results in “\$Test”.
UtdataOutput En strängOne string
LTrimLTrim
BeskrivningDescription Funktionen LTrim tar bort inledande blanksteg från en sträng.The LTrim function removes leading white spaces from a string.
FunktionssignaturenFunction Signature Strängen LTrim(string)String LTrim(string)
IndataInputs En strängOne string
ÅtgärderOperations De inledande blanksteg i Indataparametern tas bort.The leading white space characters contained in the input parameter are removed.

Exempel: LTrim (”Test”) ger ”Test”.Example: LTrim(“ Test ”) results in “Test ”.
UtdataOutput En strängOne string
RTrimRTrim
BeskrivningDescription RTrim funktionen tar bort avslutande blanksteg från en sträng.The RTrim function removes trailing white spaces from a string.
FunktionssignaturenFunction Signature Strängen RTrim(string)String RTrim(string)
IndataInputs En strängOne string
ÅtgärderOperations De avslutande blanksteg i Indataparametern tas bort.The trailing white space characters contained in the input parameter are removed. Exempel: RTrim (”Test”) ger ”Test”.Example: RTrim(“ Test ”) results in “ Test”.
UtdataOutput En strängOne string
RensaTrim
BeskrivningDescription Funktionen Rensa tar bort inledande och avslutande blanksteg från en sträng.The Trim function removes leading and trailing white spaces from a string.
FunktionssignaturenFunction Signature Strängen Trim(string)String Trim(string)
IndataInputs En strängOne string
ÅtgärderOperations De inledande och avslutande blanksteg i strängen tas bort.The leading and trailing white space characters contained in the string are removed. Exempel: Trim (”Test”) ger ”Test”.Example: Trim(“ Test ”) results in “Test”.
UtdataOutput En strängOne string
RightPadRightPad
BeskrivningDescription De RightPad funktionen höger-Pad en sträng till en angiven längd genom att använda angivna utfyllnadstecknet.The RightPad function right-pads a string to a specified length by using a provided padding character.
FunktionssignaturenFunction Signature Sträng RightPad (sträng, längd, padCharacter)String RightPad(string, length, padCharacter)
ÅtgärderOperations Om längden på strängen är mindre än längden, sedan läggs padCharacter upprepade gånger till i slutet av strängen förrän den har en längd som är lika med längden.If the length of string is less than length, then padCharacter is repeatedly appended to the end of string until it has a length equal to length.
Exempel:Examples:
-RightPad("User", 10, "0") leder ”User000000”.- RightPad(“User”, 10, “0”) would result in “User000000”.
-RightPad(RandomNum(1,10), 5, ”0”) kan resultera i att ”9000”.- RightPad(RandomNum(1,10), 5, “0”) could result in “9000”.
UtdataOutput Om strängen har en längd som är större än eller lika med längden, returneras en sträng som är identiska till sträng.If string has a length greater than or equal to length, a string identical to string is returned. Om längden på strängen är mindre än längden, returnerade en ny sträng med längden som innehåller strängen fylls ut med en padCharacter.If the length of string is less than length, then a new string of the desired length is returned containing string padded with a padCharacter. Om strängen är null returneras en tom sträng.If string is null, the function returns an empty string.
Anteckning

padCharacter kan vara ett blanksteg, men den kan inte vara ett null-värde.padCharacter can be a space character, but it cannot be a null value. Om längden på sträng är lika med eller större än längd, sträng returneras oförändrat.If the length of string is equal to or greater than length, string is returned unchanged.

LeftPadLeftPad
BeskrivningDescription De LeftPad funktionen vänster-Pad en sträng till en angiven längd genom att använda angivna utfyllnadstecknet.The LeftPad function left-pads a string to a specified length by using a provided padding character.
FunktionssignaturenFunction Signature Sträng LeftPad (sträng, längd, padCharacter)String LeftPad(string, length, padCharacter)
IndataInputs - Sträng.- String. Strängen utfyllnad.The string to pad.
- längden.- length. Ett heltal som representerar den önskade längden på strängen.An integer representing the desired length of string.
- padCharacter.- padCharacter. En sträng som består av ett enskilt tecken som ska användas som ett pad tecken.A string that consist of a single character to be used as a pad character.
ÅtgärderOperations Om längden på strängen är mindre än längden, sedan läggs padCharacter upprepade gånger till i början av strängen förrän den har en längd som är lika med längden.If the length of string is less than length, then padCharacter is repeatedly appended to the beginning of string until it has a length equal to length.
Exempel:Examples:
-LeftPad("User", 10, "0") leder ”000000User”.- LeftPad(“User”, 10, “0”) would result in “000000User”.
LeftPad(RandomNum(1,10), 5, ”0”) kan resultera i att ”0009”.LeftPad(RandomNum(1,10), 5, “0”) could result in “0009”.
UtdataOutput Om strängen har en längd som är större än eller lika med längden, returneras en sträng som är identiska till sträng.If string has a length greater than or equal to length, a string identical to string is returned.
Om längden på strängen är mindre än längden, returnerade en ny sträng med längden som innehåller strängen fylls ut med en padCharacter.If the length of string is less than length, then a new string of the desired length is returned containing string padded with a padCharacter.
Om sträng är null, returneras en tom sträng.If string is null, the function returns an empty string.

<[!NOTE] padCharacter kan vara ett blanksteg, men den kan inte vara ett null-värde.padCharacter can be a space character, but it cannot be a null value. Om längden på sträng är lika med eller större än längd, sträng returneras oförändrat.If the length of string is equal to or greater than length, string is returned unchanged.

BitOrBitOr
BeskrivningDescription BITOR-funktion anger lite angivna för en flagga till 1.The BitOr function sets a specified bit on a flag to 1.
FunktionssignaturenFunction Signature Int BitOr(mask, flag)Int BitOr(mask, flag)
IndataInputs 1. mask.1. mask. Ett hexadecimalt värde som anger bitars ska anges flaggan.A hexadecimal value that specifies the bit to set on the flag.
2. flaggan.2. flag. Ett hexadecimalt värde som ska ha en viss bitars ändras.A hexadecimal value that is to have a specific bit modified.
ÅtgärderOperations Den här funktionen konverterar båda parametrarna till binär representation och jämför dem:This function converts both parameters to binary representation and compares them:
-Anger lite till 1 om en eller båda motsvarande bitar i mask och flaggan är mellan 1 och 0 om båda motsvarande bits är 0.- Sets a bit to 1 if one or both of the corresponding bits in mask and flag are 1 and to 0 if both of the corresponding bits are 0.
-Den returnerar 1, utom där motsvarande bitarna av båda parametrarna är 0.- It returns 1 in all cases except where the corresponding bits of both parameters are 0.
-De resulterande bitmönster är i ”Ange” (1 eller true) bitar för någon av de två operanderna.- The resulting bit pattern is the "set" (1 or true) bits of any of the two operands. Flera flaggan bits kan anges om flera bits har värdet 1 i mask.Multiple flag bits can be set if multiple bits have the value 1 in mask.
UtdataOutput En ny version av flaggan, med angivna bitarna i mask värdet 1.A new version of flag, with the bits specified in mask set to 1.
BitAndBitAnd
BeskrivningDescription Funktionen BitAnd anger lite angivna för en flagga som 0.The BitAnd function sets a specified bit on a flag to 0.
FunktionssignaturenFunction Signature Int BitOr(mask, flag)Int BitOr(mask, flag)
IndataInputs 1. mask.1. mask. Ett hexadecimalt värde som anger bitars att ändra på flaggan.A hexadecimal value that specifies the bit to modify on the flag.
2. flaggan.2. flag. Ett hexadecimalt värde som ska ha en viss bitars ändrasA hexadecimal value that is to have a specific bit modified
ÅtgärderOperations Den här funktionen konverterar båda parametrarna till binär representation och jämför dem:This function converts both parameters to binary representation and compares them:
-Anger lite till 0 om en eller båda av motsvarande bitar i mask och flaggan är 0 och 1 om båda motsvarande bitar är 1.- Sets a bit to 0 if one or both of the corresponding bits in mask and flag are 0 and to 1 if both of the corresponding bits are 1.
-Returneras 0, utom där motsvarande bitarna av båda parametrarna är 1.- It returns 0 in all cases except where the corresponding bits of both parameters are 1. Flera flaggan bits kan anges till 0 om flera bits har värdet 0 i mask.Multiple flag bits can be set to 0 if multiple bits have the value 0 in mask.
UtdataOutput En ny version av flaggan med angivna bitarna i mask anges som 0.A new version of flag with the bits specified in mask set to 0.
DateTimeFormatDateTimeFormat
BeskrivningDescription Funktionen DateTimeFormat används för att formatera ett datetime-värde i form av sträng till ett bestämt format.The DateTimeFormat function is used to format a DateTime in string form to a specified format.
FunktionssignaturenFunction Signature Strängen DateTimeFormat (dateTime, format)String DateTimeFormat(dateTime, format)
IndataInputs 1. dateTime.1. dateTime. En sträng som representerar DateTime ska formateras.A string representing the DateTime to format.
2. format.2. format. En sträng som representerar det format som ska konverteras till.A string representing the format to convert to.
ÅtgärderOperations Den formatsträng som anges i formatet tillämpas på datum/tid i dateTime-sträng.The format string specified in format is applied to the DateTime in the dateTime string.
Strängen som anges i formatet måste vara ett giltigt DateTime-format.The string specified in format must be a valid DateTime format. Om det inte finns returneras ett fel som anger att formatet inte är ett giltigt DateTime-format.If it is not, an error is returned indicating that the format is not a valid DateTime format.
Exempel: DateTime (”2007-12-25” ”, åååå-MM-dd”) resulterar i ”2007-12-25”.Example: DateTime(“12/25/2007”, “yyyy-MM-dd”) results in “2007-12-25”.
UtdataOutput En sträng som uppstår till följd av att tillämpa format till dateTime.A string resulting from applying format to dateTime.
Anteckning

Tecken som kan skapa användardefinierade format, se användardefinierade format för datum/tidFor the characters accepted to create user-defined formats, see User-Defined Date/Time Formats

ConvertSidToStringConvertSidToString
BeskrivningDescription ConvertSidToString konverterar en bytematris som innehåller en säkerhetsidentifierare till en sträng.The ConvertSidToString converts a byte array containing a security identifier to a string.
FunktionssignaturenFunction Signature Strängen ConvertSidToString(ObjectSID)String ConvertSidToString(ObjectSID)
IndataInputs ObjectSID.ObjectSID. En bytematris som innehåller en säkerhetsidentifierare (SID).A byte array containing a security identifier (SID).
ÅtgärderOperations Den angivna binära SID konverteras till en sträng.The specified binary SID is converted to a string.
UtdataOutput En strängrepresentation av SID.A string representation of the SID.
ConvertStringToGuidConvertStringToGuid
BeskrivningDescription ConvertStringToGuid funktionen konverterar strängrepresentation av en GUID till en binär representation av GUID.The ConvertStringToGuid function converts the string representation of a GUID to a binary representation of the GUID.
FunktionFunction Byte [] ConvertStringToGuid(stringGuid)Byte[] ConvertStringToGuid(stringGuid)
IndataInputs GUID.Guid. En sträng formaterad i det här mönstret: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, där värdet för GUID är representeras som en serie hexadecimala siffror i grupper med 8, 4, 4, 4 och 12 siffror och avgränsade med bindestreck.A string formatted in this pattern: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, where the value of the GUID is represented as a series of hexadecimal digits in groups of 8, 4, 4, 4, and 12 digits and separated by hyphens. Ett exempel på ett returvärde är ”382c74c3-721d-4f34-80e557657b6cbc27”.An example of a return value is "382c74c3-721d-4f34-80e557657b6cbc27".
ÅtgärderOperations Strängen Guid anges i parametern 1 konverteras till dess binär representation.The string Guid specified in parameter 1 is converted to its binary representation.
Om strängen inte är en representation av en giltig Guid, funktionen avvisar argumentet med följande fel:If the string is not a representation of a valid Guid, the function rejects the argument with the following error:
Parametern för funktionen ConvertStringToGuid måste vara en sträng som representerar ett giltigt Guid.The parameter for the ConvertStringToGuid function must be a string representing a valid Guid.
UtdataOutput En binär representation av Guid.A binary representation of the Guid.
ReplaceStringReplaceString
BeskrivningDescription Funktionen ReplaceString ersätter alla förekomster av en textsträng med en annan sträng.The ReplaceString function replaces all occurrences of a string to another string.
FunktionFunction Sträng ReplaceString (sträng, OldValue, NewValue)String ReplaceString(string, OldValue, NewValue)
IndataInputs 1. Sträng.1. String. En sträng som ska ersätta värden.A string in which to replace values.
2. OldValue.2. OldValue. Sträng att söka efter och ersätta.The string to search for and to replace.
3. Nytt-värde.3. NewValue. Strängen som ska ersätta.The string to replace to.
ÅtgärderOperations Alla förekomster av OldValue i strängen ersätts med NewValue.All occurrences of OldValue in the string are replaced with NewValue. Funktionen måste kunna hantera följande specialtecken:The function must be able to handle the following special characters:
- \n.- \n. Ny rad.New Line.
- \r.- \r. Vagnretur.Carriage Return.
- \t.- \t. Fliken.Tab.
Exempel: ReplaceString (”One\n\rMicrosoft\n\r\Way”, ”\n\r” ”,”) returnerar ”One Microsoft Way”.Example: ReplaceString(“One\n\rMicrosoft\n\r\Way”,”\n\r”,” “) returns “One Microsoft Way”.
UtdataOutput En sträng med alla förekomster av OldValue i strängen ersätts med NewValue.A string with all occurrences of OldValue in the string replaced with NewValue.

Funktioner för hämtning av dataData retrieval functions

Funktioner för hämtning av data används för att utföra åtgärder som att hämtar önskad tecken från en sträng.Data retrieval functions are used to perform operations that retrieve the desired characters from a string.

WordWord
BeskrivningDescription Funktionen Word returnerar ett ord som ingår i en sträng, baserat på parametrarna som beskriver avgränsare ska användas och word-nummer för att returnera.The Word function returns a word contained within a string, based on parameters describing the delimiters to use and the word number to return.
FunktionssignaturenFunction Signature Sträng Word (sträng, siffra, avgränsare)String Word(string, number, delimiters)
IndataInputs 1. sträng.1. string. Strängen som ska returnera ett ord.The string from which to return a word.
2. nummer.2. number. Ett värde som identifierar vilka word tal som ska returneras.A number identifying which word number should be returned.
3. avgränsare.3. delimeters. En sträng som representerar avgränsare som ska användas för att identifiera ord.A string representing the delimeters that should be used to identify words.
ÅtgärderOperations Varje sträng med tecken i en sträng som separeras med ett tecken i avgränsare identifieras som ett ord.Each string of characters in a string that is separated by one of the characters in delimiters is identified as a word. Det ord som hittades på den plats som anges i parametern 3 (nummer) returneras:The word that was found at the position specified in parameter 3 (number) is returned:
-Om number < 1, returnerar en tom sträng.- If number < 1, return an empty string.
-Om strängen är null returneras en tom sträng.- If string is null, return an empty string.

Exempel:Examples:
1. Word (”testa; för % funktionen;”, 3 ”,; $& %") returnerar ”används”.1. Word(“Test;of%function;”, 3, “;$&%”) returns “function”.
2. Word (”testa; Funktionen ”, 2,” ”;) Returnerar ”” (en tom sträng).2. Word(“Test;;Function” , 2 , “;”) returns “” (an empty string). 3.3. Word (”testa; för % funktionen;”, 0 ”,; $& %") returnerar ”” (en tom sträng).Word(“Test;of%function;”, 0, “;$&%”) returns “” (an empty string).
UtdataOutput En sträng som innehåller ordet vid position användaren uppge.A string containing the word at the position the user asked for. Om sträng innehåller mindre än antalet ord, eller sträng innehåller inte några ord som identifieras av avgränsare, returneras en tom sträng.If string contains less than number of words, or string does not contain any words identified by delimeters, an empty string is returned.
VänsterLeft
BeskrivningDescription Funktionen vänster returnerar ett angivet antal tecken från vänster i en sträng.The Left function returns a specified number of characters from the left of a string.
FunktionssignaturenFunction Signature Sträng Left (sträng, numChars)String Left(string, numChars)
IndataInputs 1. sträng.1. string. Strängen som ska returnera tecken.The string from which to return characters. 2.2. numChars.numChars. Ett nummer som identifierar antalet tecken ska returneras från början av en sträng.A number identifying the number of characters to return from the beginning of a string.
ÅtgärderOperations numChars tecken som ska returneras från den första positionen i strängen.numChars characters are returned from the first position of the string.
Exempel: Left (”Britta Simon”, 3) returnerar ”Bri”.Example: Left(“Britta Simon”, 3) returns “Bri”.
UtdataOutput En sträng som innehåller de första numChars tecken i strängen.A string containing the first numChars characters in the string.
-Om numChars = 0, returneras en tom sträng.- If numChars = 0, return an empty string.
-Om numChars < 0, returnerar en indatasträng.- If numChars < 0, return an input string.
-Om strängen är null returneras en tom sträng.- If string is null, return an empty string.
HögerRight
BeskrivningDescription Funktionen höger returnerar ett angivet antal tecken från höger (end) i en sträng.The Right function returns a specified number of characters from the right (end) of a string.
FunktionssignaturenFunction Signature Sträng höger (sträng, numChars)String Right(string, numChars)
IndataInputs 1. Sträng.1. String. Strängen som ska returnera tecken.The string from which to return characters.
2. numChars.2. numChars. Ett nummer som identifierar antalet tecken ska returneras från slutet av strängen.A number identifying the number of characters to return from the end of string.
ÅtgärderOperations numChars.numChars. Tecken som ska returneras från slutet av en sträng.Characters are returned from the end of a string.
Exempel: Höger (”Britta Simon”, 3) returnerar ”måndag”.Example: Right(“Britta Simon”, 3) returns “mon”.
UtdataOutput En sträng som innehåller de senaste numChars tecken i en sträng.A string containing the last numChars characters in a string. Om numChars = 0, returneras en tom sträng.If numChars = 0, return an empty string.
-Om numChars < 0, returnera en indatasträng.- If numChars < 0, return an input string.
-Om strängen är null returneras en tom sträng.- If the string is null, return an empty string.
-Om strängen innehåller färre tecken än antalet angivna i numChars, returneras en sträng som är identiska till sträng.- If the string contains fewer characters than the number specified in numChars, a string identical to string is returned.
MidMid
BeskrivningDescription Funktionen Mid returnerar ett angivet antal tecken från en angiven position i en sträng.The Mid function returns a specified number of characters from a specified position in a string.
FunktionssignaturenFunction Signature Strängen Mid(string, pos, numChars)String Mid(string, pos, numChars)
IndataInputs 1. sträng.1. string. Strängen som ska returnera tecken.The string from which to return characters.
2. pos.2. pos. Ett nummer som anger startpositionen i en sträng för att returnera tecken.A number identifying the starting position in a string for returning characters.
3. numChars.3. numChars. Ett nummer som identifierar antalet tecken ska returneras från en position i strängen.A number identifying the number of characters to return from a position in the string.
ÅtgärderOperations Returnera numChars tecken med början från positionen pos i strängen.Return numChars characters starting from position pos in the string.
Exempel: Mid (”Britta Simon”, 3, 5) returnerar ”itta”.Example: Mid(“Britta Simon”, 3, 5) would return “itta ”.
UtdataOutput En sträng som innehåller numChars tecken från position pos i en sträng:A string containing numChars characters from position pos in a string:
-Om numChars = 0, returneras en tom sträng.- If numChars = 0, return an empty string.
-Om numChars < 0, returneras en tom sträng.- If numChars < 0, return an empty string.
-Om pos > längden på strängen, returnera en indatasträng.- If pos > the length of string, return an input string.
-Om pos ≤ 0, returnera en indatasträng.- If pos ≤ 0, return an input string.
-Om sträng är null returneras en tom sträng.- If string is null, return an empty string.
Om det finns inga numChar tecken kvar i sträng från position poseftersom många tecken som kan returneras som ska returneras.If there are no numChar characters remaining in string from position pos, as many characters as can be returned are returned.

Funktioner för generering av dataData generation functions

Data generation funktioner används för att generera värden för specifika datatyper.Data generation functions are used to generate values for specific data types.

CRLFCRLF
BeskrivningDescription CRLF genererar en transport radmatningstecken.The CRLF generates a Carriage Return/Line Feed. Du kan använda den här funktionen för att lägga till en ny rad.You use this function to add a new line.
FunktionssignaturenFunction Signature Sträng CRLFString CRLF
IndataInputs Inga parametrarNo parameters
ÅtgärderOperations En CRLF returneras.A CRLF is returned.
Exempel: AddressLine1 + CRLF() + AddressLine2 resulterar i:Example: AddressLine1 + CRLF() + AddressLine2 results in:
-AddressLine1- AddressLine1
-AddressLine2- AddressLine2
UtdataOutput En CRLF är utdata.A CRLF is the output.
RandomNumRandomNum
BeskrivningDescription Funktionen RandomNum returnerar ett slumptal inom ett visst intervall.The RandomNum function returns a random number within a specified interval.
FunktionssignaturenFunction Signature Int RandomNum(start, end)Int RandomNum(start, end)
IndataInputs - Starta.- start. Ett nummer som identifierar den nedre gränsen för slumpmässiga värdet ska genereras.A number identifying the lower limit of the random value to generate.
- end.- end. Ett nummer som identifierar den övre gränsen för slumpmässiga värdet ska genereras.A number identifying the upper limit of the random value to generate.
ÅtgärderOperations Ett slumptal som är större än eller lika med starta och mindre än eller lika med end genereras.A random number greater than or equal to start and less than or equal to end is generated.
Exempel: Random(0,999) kunde returnera 100.Example: Random(0,999) could return 100.
UtdataOutput Ett slumptal inom det angivna intervallet starta och end.A random number within the range specified by start and end.
EscapeDNComponentEscapeDNComponent
BeskrivningDescription Den EscapeDNComponent metoden bearbetar Indatasträngen baserat på vilken typ av hanteringsagenten som används.The EscapeDNComponent method processes the input string based on the type of management agent that is being used.
FunktionssignaturenFunction Signature Strängen EscapeDNComponent(string)String EscapeDNComponent(string)
IndataInputs strängen.string. En sträng som används för att bearbeta ett unikt namn.A string that is used to process a distinguished name. Strängen får inte innehålla kommenterad tecken.The string should not contain escaped characters.
ÅtgärderOperations Metoden EscapeDNComponent från MIISUtils används för att utföra den här åtgärden.The EscapeDNComponent method from MIISUtils is used to perform this operation. Den här metoden bearbetar Indatasträngen baserat på vilken typ av hanteringsagenten som används.This method processes the input string based on the type of management agent that is being used.
Eftersom olika hanteringsagenter kräver olika huvudnamnet format, bearbetar den här metoden indatasträng baserat på vilken typ av hanteringsagenten.Because different management agents require different distinguished name formats, this method processes the input strings based upon the type of management agent. Typerna är LDAP för Lightweight Directory Access Protocol) huvudnamnet sådana asActive Directory® Domain Services, Sun Directory Server (tidigare iPlanet Directory Server), Microsoft Exchange Server. hierarkiska nonLDAP, till exempel Microsoft Lotus Notes; och extrinsic som databasen och XML utan LDAP unika namn.The types are Lightweight Directory Access Protocol LDAP) distinguished name, such asActive Directory® Domain Services, Sun Directory Server (formerly iPlanet Directory Server), Microsoft Exchange Server; hierarchical nonLDAP, such as Microsoft Lotus Notes; and extrinsic, such as database and XML without LDAP distinguished names.
** LDAP unikt namn: LDAP distinguished name:
– Alla ogiltiga XML-tecken i värde-delen av en viss del är hexadecimal-kodad.- Any invalid XML characters in the value portion of a given part are hexadecimal-encoded.
– Alla ogiltiga tecken (inklusive ogiltiga XML-tecken) i del av en viss del genererar ett fel.- Any illegal characters (including invalid XML characters) in the name portion of a given part generate an error.
-Följande tecken är undantagna:- The following characters are escaped:
   -Kommatecken (',')    - Comma (',')
   -Lika med-tecken ('=')    - Equal sign ('=')
   -Plustecknet (”+”)    - Plus sign ('+')
   -Mindre-än-tecken (”<”)    - Less-than sign ('<')
   -Större-än-tecken ('> ')    - Greater-than sign ('>')
   -Nummertecken (#)    - Number sign ('#')
   -Semikolon (;')    - Semicolon (';')
   -Omvänt snedstreck ('\')    - Backslash ('\')
   -Citattecken (”” ”)    - Quotation mark ('"')
– Om det sista tecknet i strängen är ett blanksteg, hoppas det utrymmet.- If the last character in the string is a space, then that space is escaped.
– Alla överflödig inledande eller avslutande blanksteg runt en delnamn har tagits bort.- Any extraneous leading or trailing spaces around a part name are removed.
-För XML-hanteringsagenten om det finns flera delar sedan delarna visas i bokstavsordning.- For the XML management agent, if there are multiple parts, then the parts are alphabetized.
– Om flera delar anges, är det sammansatta unika namnet sammanfogning av de enskilda strängar åtskilda av plustecken.- If multiple parts are specified, the composite distinguished name string is the concatenation of the individual strings separated by plus signs.
-Ett fel genereras om den inmatade strängen inte är en giltig, LDAP-format unikt namnsträngen.- An error is generated if the input string is not a well-formed, LDAP-style distinguished name string.

Hierarkisk icke-LDAPHierarchical non-LDAP
-Dessa hanteringsagenter stöder inte multipart-komponenter.- These management agents do not support multipart components. Om flera strängar skickas till EscapeDNComponent genereras ett ArgumentException.If multiple strings are passed to EscapeDNComponent, an ArgumentException is thrown.
– Om något tecken i strängen är ogiltiga XML-tecken genereras ett ArgumentException.- If any of the characters in the input string are invalid XML characters, an ArgumentException is thrown.
-Alla kommatecken och omvända snedstreck i Indatasträngen är undantagna.- All commas and backslashes in the input string are escaped.
– Om det sista tecknet i strängen är ett blanksteg, hoppas det utrymmet.- If the last character in the string is a space, then that space is escaped.

Extrinsic:Extrinsic:**
1. Om någon del är binär eller innehåller ett ogiltigt XML-tecken, lagras den del som en hexadecimal-kodad version av rådata med tecknet '#' framför strängen som prefix.1. If any part is binary or contains an invalid XML character, that part is stored as a hexadecimal-encoded version of the raw data with a '#' character prefixed to the front of the string. Till exempel om en del var 'AxC' (där x representerar ett ogiltigt XML-tecken, till exempel '0x10'), är den del kodad som '#410010004300'.For example, if a part was 'AxC' (where x represents an illegal XML character such as '0x10'), that part is encoded as '#410010004300'.
2. Annars är alla instanser av följande tecken undantagna:2. Otherwise, all instances of the following characters are escaped:
   -Omvänt snedstreck ('\')    - Backslash ('\')
   -Kommatecken (',')    - Comma (',')
   -Plustecknet (‘+’)    - Plus sign ('+')
   -Nummertecken (‘#’)    - Number sign ('#')
3. Om det sista tecknet i en viss del sträng kan hoppas det utrymmet.3. If the last character in a given part string is a space, that space is escaped.
4. Om flera delar anges, är det sammansatta unika namnet sammanfogning av de enskilda strängar som åtskilda av plustecken.4. If multiple parts are specified, the composite distinguished name string is the concatenation of all the individual strings separated by plus signs.
UtdataOutput En sträng som innehåller ett giltigt domännamn.A string containing a valid domain name.
Anteckning

Verifiering av unika namn är mindre strikta än den syntax som definierats i LDAP-specifikationer.The validation of distinguished names is less strict than the syntax defined in the LDAP specifications. EscapeDNComponent(String[]) tillåter ett namn som innehåller en kombination av en eller flera av tecknen ”a”-”z”, ”A” - Z, '0'-'9', '-', och '.'.EscapeDNComponent(String[]) allows a part name to contain any combination of one or more of the characters 'a'-'z', 'A'-'Z', '0'-'9', '-', and '.'.
Det går inte att ange en binära delen med den här metoden.It is not possible to specify a binary part with this method. Det är dock möjligt att ha en binär del CommitNewConnector om huvudnamnet konstrueras utifrån fästpunkt attribut och ett av attributen fästpunkt är en binär typ.However, it is possible to have a binary part in CommitNewConnector if the distinguished name is constructed from anchor attributes and one of the anchor attributes is a binary type.

NullNull
BeskrivningDescription Funktionen Null används för att definiera som den här MA saknar ett attribut med egna bidrag och att Attributprioritet fortsätter med nästa st.The Null function is used to define that this MA does not have an attribute to contribute and that attribute precedence should continue with the next MA.
FunktionssignaturenFunction Signature Strängen är NullString Null
IndataInputs Inga parametrarNo parameters
ÅtgärderOperations Ett null-värde returneras.A Null is returned.
Exempel: IIF(Eq(domain), ”okänt”, Null())Example: IIF(Eq(domain), “unknown”, Null())
UtdataOutput Ett null-värde är utdata.A Null is output.

Logik funktionerLogic Functions

Logik funktioner används för att utföra en åtgärd baserat på villkor som utvärderas av systemet.Logic functions are used to perform an operation based on conditions evaluated by the system.

IIFIIF
BeskrivningDescription Funktionen IIF returnerar ett av en uppsättning möjliga värden baserat på ett angivet villkor.The IIF function returns one of a set of possible values based on a specified condition.
FunktionssignaturenFunction Signature Objektet IIF (villkor, värdeomsant, värdeomfalskt)Object IIF(condition, valueIfTrue, valueIfFalse)
IndataInputs 1. Villkoret.1. Condition. Ett värde eller uttryck som kan utvärderas till true eller false.Any value or expression that can be evaluated to true or false. 2.2. värde_om_sant ett värde som returneras om villkoret utvärderas till true.valueIfTrue A value that is returned if the condition evaluates to true.
3. värdeomfalskt ett värde som returneras om villkoret utvärderas till false.3. valueIfFalse A value that is returned if the condition evaluates to false.

Följande är funktioner som är tillgängliga för användning som uttryck i funktionen IIF som villkor:The following are functions available for use as expressions in the IIF function as condition:
EQ.Eq. Den här funktionen Jämför två argument sinsemellan.This function compares two arguments for equality.
NotEquals.NotEquals. Den här funktionen Jämför två argument för ojämlikhet, returnerar true om de inte är lika med och FALSKT om de är lika.This function compares two arguments for inequality, returning true if they are not equal and false if they are equal.
Exempel: NotEquals (EmployeeType, ”leverantör”)Example: NotEquals(EmployeeType, "Contractor")
LessThan.LessThan. Den här funktionen Jämför två talen, annars returnerar true om först är mindre än det andra och false.This function compares two numbers, returning true if the first is less than the second and false otherwise.
Exempel: LessThan (lön 100000)Example: LessThan(Salary, 100000)
GreaterThan.GreaterThan. Den här funktionen Jämför två talen, returnerar true om först annars är större än det andra och false.This function compares two numbers, returning true if the first is greater than the second and false otherwise.
Exempel: GreaterThan (lön 100000)Example: GreaterThan(Salary, 100000)
LessThanOrEquals.LessThanOrEquals. Den här funktionen Jämför två talen, returnerar true om först är mindre än eller lika med den andra och false i annat.This function compares two numbers, returning true if the first is less than or equal to the second and false otherwise.
Exempel: LessThanOrEquals (lön 100000)Example: LessThanOrEquals(Salary, 100000)
GreaterThanOrEquals.*GreaterThanOrEquals.* Den här funktionen Jämför två talen, returnerar true om först är större än eller lika med den andra och false annars.This function compares two numbers, returning true if the first is greater than or is equal to the second and false otherwise.
Exempel: GreaterThanOrEquals (lön 100000)Example: GreaterThanOrEquals(Salary, 100000)
IsPresent.IsPresent. Den här funktionen tar som indata för ett attribut i ILM-schemat och returnerar true om det inte är null och false om attributet är null.This function takes as input an attribute in the ILM schema and returns true if the attribute is not null and false if the attribute is null.
ÅtgärderOperations Om villkoret utvärderas till true, returnerar värde_om_sant.If condition evaluates to true, return valueIfTrue. Annars returnerar värdeomfalskt.Otherwise return valueIfFalse.
Exempel: IIF (Eq (EmployeeType, ”interna”), ”t-” + Alias, Alias) returnerar alias för en användare med ”t-” läggs till i början av det om användaren är en intern.Example: IIF(Eq(EmployeeType,”Intern”),”t-“ + Alias, Alias)returns the alias of a user with “t-“ added to the beginning of it if the user is an intern. Annars returnerar användarens alias som är.Otherwise, it returns the user’s alias as is.
UtdataOutput Utdata är värdeomsant om villkoret är SANT eller värdeomfalskt om villkoret är FALSKT.The output is valueIfTrue if the condition is true or valueIfFalse if the condition is false.