Naslag informatie voor het schrijven van expressies voor kenmerk toewijzingen in azure ADReference for writing expressions for attribute mappings in Azure AD

Wanneer u inrichting voor een SaaS-toepassing configureert, is een van de typen kenmerk toewijzingen die u kunt opgeven een expressie toewijzing.When you configure provisioning to a SaaS application, one of the types of attribute mappings that you can specify is an expression mapping. Hiervoor moet u een script achtige expressie schrijven waarmee u de gegevens van uw gebruikers kunt transformeren naar indelingen die acceptabel zijn voor de SaaS-toepassing.For these, you must write a script-like expression that allows you to transform your users' data into formats that are more acceptable for the SaaS application.

Syntaxis overzichtSyntax overview

De syntaxis voor expressies voor kenmerk toewijzingen is reminiscent van Visual Basic for Applications (VBA)-functies.The syntax for Expressions for Attribute Mappings is reminiscent of Visual Basic for Applications (VBA) functions.

  • De volledige expressie moet worden gedefinieerd in termen van functies, die bestaan uit een naam gevolgd door argumenten tussen haakjes: functie naam ( <<argument 1>> , <<argument N>> )The entire expression must be defined in terms of functions, which consist of a name followed by arguments in parentheses: FunctionName(<<argument 1>>,<<argument N>>)

  • U kunt functies binnen elkaar nesten.You may nest functions within each other. Bijvoorbeeld: FunctionOne (FunctionTwo ( <<argument1>> ))For example: FunctionOne(FunctionTwo(<<argument1>>))

  • U kunt drie verschillende typen argumenten door geven aan functies:You can pass three different types of arguments into functions:

    1. Kenmerken, die tussen vier Kante haken moeten worden geplaatst.Attributes, which must be enclosed in square brackets. Bijvoorbeeld: [kenmerknaam]For example: [attributeName]
    2. Teken reeks constanten, die tussen dubbele aanhalings tekens moeten worden geplaatst.String constants, which must be enclosed in double quotes. Bijvoorbeeld: "Verenigde Staten"For example: "United States"
    3. Andere functies.Other Functions. Bijvoorbeeld: FunctionOne ( <<argument1>> , FunctionTwo ( <<argument2>> ))For example: FunctionOne(<<argument1>>, FunctionTwo(<<argument2>>))
  • Als u voor teken reeks constanten een back slash () of aanhalings teken (") in de teken reeks nodig hebt, moet deze worden voorafgegaan door het back slash-symbool ().For string constants, if you need a backslash ( \ ) or quotation mark ( " ) in the string, it must be escaped with the backslash ( \ ) symbol. Bijvoorbeeld: "bedrijfs naam: \ " Contoso \ ""For example: "Company name: \"Contoso\""

  • De syntaxis is hoofdletter gevoelig. deze moet worden overwogen als teken reeksen in een functie versus kopiëren deze rechtstreeks vanuit deze locatie te plakken.The syntax is case-sensitive, which must be considered while typing them as strings in a function vs copy pasting them directly from here.

Lijst met functiesList of Functions

    Toevoegen         BitAnd         CBool         Coalesce         ConvertToBase64         ConvertToUTF8Hex         Aantal         CStr     DateFromNum       FormatDateTime         GUID         IIf         InStr         IsNull         IsNullOrEmpty         IsPresent         IsString         Item     Lid     worden         Links     Mid             NormalizeDiacritics niet         NumFromDate         RemoveDuplicates         Vervang         SelectUniqueValue         SingleAppRoleAssignment         Split         StripSpaces         Switch ToLower                 toupper         woordAppend      BitAnd      CBool      Coalesce      ConvertToBase64      ConvertToUTF8Hex      Count      CStr      DateFromNum  FormatDateTime      Guid      IIF     InStr      IsNull      IsNullOrEmpty      IsPresent      IsString      Item      Join      Left      Mid         NormalizeDiacritics Not      NumFromDate      RemoveDuplicates      Replace      SelectUniqueValue     SingleAppRoleAssignment     Split    StripSpaces      Switch     ToLower     ToUpper     Word


ToevoegenAppend

Functie: Append (bron, achtervoegsel)Function: Append(source, suffix)

Beschrijving: Neemt een waarde voor de bron teken reeks en voegt het achtervoegsel toe aan het eind van het.Description: Takes a source string value and appends the suffix to the end of it.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
Bronsource VereistRequired TekenreeksString Doorgaans naam van het kenmerk van het bron object.Usually name of the attribute from the source object.
achtervoegselsuffix VereistRequired TekenreeksString De teken reeks die u wilt toevoegen aan het einde van de bron waarde.The string that you want to append to the end of the source value.

Een constant achtervoegsel toevoegen aan de gebruikers naamAppend constant suffix to user name

Voor beeld: als u een Sales Force-sandbox gebruikt, moet u mogelijk een extra achtervoegsel toevoegen aan al uw gebruikers namen voordat u ze synchroniseert.Example: If you are using a Salesforce Sandbox, you might need to append an additional suffix to all your user names before synchronizing them.

Expressie Append([userPrincipalName], ".test")Expression: Append([userPrincipalName], ".test")

Voor beeld van invoer/uitvoer:Sample input/output:

  • Invoer: (userPrincipalName): " John.Doe@contoso.com "INPUT: (userPrincipalName): "John.Doe@contoso.com"
  • Uitvoer: " John.Doe@contoso.com.test "OUTPUT: "John.Doe@contoso.com.test"

BitAndBitAnd

Functie: BitAnd (waarde1, waarde2)Function: BitAnd(value1, value2)

Beschrijving: Deze functie converteert beide para meters naar de binaire weer gave en stelt een bit in op:Description: This function converts both parameters to the binary representation and sets a bit to:

  • 0: als een of beide van de corresponderende bits in waarde1 en Value2 0 zijn0 - if one or both of the corresponding bits in value1 and value2 are 0
  • 1: als beide corresponderende bits 1 zijn.1 - if both of the corresponding bits are 1.

Met andere woorden: het retourneert 0 in alle gevallen, behalve wanneer de overeenkomstige bits van beide para meters 1 zijn.In other words, it returns 0 in all cases except when the corresponding bits of both parameters are 1.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
Value1value1 VereistRequired numnum Numerieke waarde die moet worden AND'ed met Value2Numeric value that should be AND'ed with value2
enzovoortvalue2 VereistRequired numnum Numerieke waarde die moet worden AND'ed met waarde1Numeric value that should be AND'ed with value1

Hierbij BitAnd(&HF, &HF7)Example: BitAnd(&HF, &HF7)

11110111 en 00000111 = 00000111 BitAnd retourneert dus 7, de binaire waarde van 00000111.11110111 AND 00000111 = 00000111 so BitAnd returns 7, the binary value of 00000111.


CBoolCBool

Functieassembly CBool(Expression)Function: CBool(Expression)

Beschrijving:
CBool retourneert een Booleaanse waarde op basis van de geëvalueerde expressie.
Description: CBool returns a boolean based on the evaluated expression. Als de expressie resulteert in een waarde die niet gelijk is aan nul, CBool wordt waar geretourneerd. anders wordt False geretourneerd.If the expression evaluates to a non-zero value, then CBool returns True, else it returns False.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
expressionexpression VereistRequired expressieexpression Een geldige expressieAny valid expression

Voorbeeld: CBool([attribute1] = [attribute2]) Example: CBool([attribute1] = [attribute2])
Retourneert waar als beide kenmerken dezelfde waarde hebben.Returns True if both attributes have the same value.


CoalesceCoalesce

Functie: Coalesce (source1, source2,..., defaultValue)Function: Coalesce(source1, source2, ..., defaultValue)

Beschrijving: Retourneert de eerste bron waarde die niet NULL is.Description: Returns the first source value that is not NULL. Als alle argumenten NULL zijn en defaultValue aanwezig is, wordt de defaultValue geretourneerd.If all arguments are NULL and defaultValue is present, the defaultValue will be returned. Als alle argumenten NULL zijn en defaultValue niet aanwezig is, retourneert Coalesce NULL.If all arguments are NULL and defaultValue is not present, Coalesce returns NULL.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
source1 ... Bronnsource1 … sourceN VereistRequired TekenreeksString Vereist, variabele-aantal keren.Required, variable-number of times. Doorgaans naam van het kenmerk van het bron object.Usually name of the attribute from the source object.
StandaarddefaultValue OptioneelOptional TekenreeksString De standaard waarde die moet worden gebruikt wanneer alle bron waarden NULL zijn.Default value to be used when all source values are NULL. Kan een lege teken reeks zijn ("").Can be empty string ("").

Stroom-mail waarde indien niet NULL, anders flow userPrincipalNameFlow mail value if not NULL, otherwise flow userPrincipalName

Voor beeld: u wilt het e-mail kenmerk stroomren als het aanwezig is.Example: You wish to flow the mail attribute if it is present. Als dat niet het geval is, wilt u in plaats daarvan de waarde van userPrincipalName door lopen.If it is not, you wish to flow the value of userPrincipalName instead.

Expressie Coalesce([mail],[userPrincipalName])Expression: Coalesce([mail],[userPrincipalName])

Voor beeld van invoer/uitvoer:Sample input/output:

  • Invoer (mail): nullINPUT (mail): NULL
  • Invoer (userPrincipalName): " John.Doe@contoso.com "INPUT (userPrincipalName): "John.Doe@contoso.com"
  • Uitvoer: " John.Doe@contoso.com "OUTPUT: "John.Doe@contoso.com"

ConvertToBase64ConvertToBase64

Functie: ConvertToBase64 (bron)Function: ConvertToBase64(source)

Beschrijving: De functie ConvertToBase64 converteert een teken reeks naar een Unicode base64-teken reeks.Description: The ConvertToBase64 function converts a string to a Unicode base64 string.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
Bronsource VereistRequired TekenreeksString De teken reeks die moet worden geconverteerd naar basis 64String to be converted to base 64

Hierbij ConvertToBase64("Hello world!")Example: ConvertToBase64("Hello world!")

Retourneert "SABlAGwAbABvACAAdwBvAHIAbABkACEA"Returns "SABlAGwAbABvACAAdwBvAHIAbABkACEA"


ConvertToUTF8HexConvertToUTF8Hex

Functie: ConvertToUTF8Hex (bron)Function: ConvertToUTF8Hex(source)

Beschrijving: De functie ConvertToUTF8Hex converteert een teken reeks naar een UTF8 hexadecimale waarde.Description: The ConvertToUTF8Hex function converts a string to a UTF8 Hex encoded value.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
Bronsource VereistRequired TekenreeksString Teken reeks die moet worden geconverteerd naar UTF8 hexString to be converted to UTF8 Hex

Hierbij ConvertToUTF8Hex("Hello world!")Example: ConvertToUTF8Hex("Hello world!")

Retourneert 48656C6C6F20776F726C6421Returns 48656C6C6F20776F726C6421


CountCount

Functie: Count (kenmerk)Function: Count(attribute)

Beschrijving: De functie Count retourneert het aantal elementen in een kenmerk met meerdere waardenDescription: The Count function returns the number of elements in a multi-valued attribute

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
geschrevenattribute VereistRequired kenmerkattribute Kenmerk met meerdere waarden waarvoor elementen worden geteldMulti-valued attribute that will have elements counted

CStrCStr

Functie: CStr (waarde)Function: CStr(value)

Beschrijving: De functie CStr zet een waarde om in een teken reeks gegevens type.Description: The CStr function converts a value to a string data type.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
valuevalue VereistRequired Numeriek, verwijzing of Booleaanse waardenumeric, reference, or boolean Dit kan een numerieke waarde, een referentie kenmerk of een Boolean zijn.Can be a numeric value, reference attribute, or Boolean.

Hierbij CStr([dn])Example: CStr([dn])

Retourneert "CN = Joe, DC = contoso, DC = com"Returns "cn=Joe,dc=contoso,dc=com"


DateFromNumDateFromNum

Functie: DateFromNum (waarde)Function: DateFromNum(value)

Beschrijving: Met de functie DateFromNum wordt een waarde in de datum notatie van AD geconverteerd naar een DateTime-type.Description: The DateFromNum function converts a value in AD's date format to a DateTime type.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
valuevalue VereistRequired DatumDate De AD-datum die moet worden geconverteerd naar een DateTime-typeAD Date to be converted to DateTime type

Hierbij DateFromNum([lastLogonTimestamp])Example: DateFromNum([lastLogonTimestamp])

DateFromNum(129699324000000000)

Retourneert een datum/tijd van 1 januari 2012 om 11:13:00.Returns a DateTime representing January 1, 2012 at 11:00PM.


FormatDateTimeFormatDateTime

Functie: FormatDateTime (source, dateTimeStyles, inputFormat, Output Format)Function: FormatDateTime(source, dateTimeStyles, inputFormat, outputFormat)

Beschrijving: Neemt een datum teken reeks van de ene indeling en converteert deze naar een andere indeling.Description: Takes a date string from one format and converts it into a different format.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
Bronsource VereistRequired TekenreeksString Doorgaans naam van het kenmerk van het bron object.Usually name of the attribute from the source object.
dateTimeStylesdateTimeStyles OptioneelOptional TekenreeksString Met deze optie geeft u de opmaak opties op waarmee het parseren van teken reeksen wordt aangepast voor bepaalde methoden voor het parseren van datum en tijd.Use this to specify the formatting options that customize string parsing for some date and time parsing methods. Zie DateTimeStyles docvoor ondersteunde waarden. Als dit veld leeg blijft, wordt de gebruikte standaard waarde DateTimeStyles. RoundtripKind, DateTimeStyles. AllowLeadingWhite, DateTimeStyles. AllowTrailingWhiteFor supported values, see DateTimeStyles doc. If left empty, the default value used is DateTimeStyles.RoundtripKind, DateTimeStyles.AllowLeadingWhite, DateTimeStyles.AllowTrailingWhite
inputFormatinputFormat VereistRequired TekenreeksString Verwachte indeling van de bron waarde.Expected format of the source value. Zie /DotNet/Standard/Base-types/Custom-date-and-time-format-stringsvoor ondersteunde indelingen.For supported formats, see /dotnet/standard/base-types/custom-date-and-time-format-strings.
OutputoutputFormat VereistRequired TekenreeksString De indeling van de uitvoer datum.Format of the output date.

Uitvoer datum als een teken reeks in een bepaalde notatieOutput date as a string in a certain format

Voor beeld: u wilt datums verzenden naar een SaaS-toepassing, zoals ServiceNow in een bepaalde indeling.Example: You want to send dates to a SaaS application like ServiceNow in a certain format. U kunt overwegen de volgende expressie te gebruiken.You can consider using the following expression.

ExpressieExpression:

FormatDateTime([extensionAttribute1], , "yyyyMMddHHmmss.fZ", "yyyy-MM-dd")

Voor beeld van invoer/uitvoer:Sample input/output:

  • Invoer (extensionAttribute1): "20150123105347.1 z"INPUT (extensionAttribute1): "20150123105347.1Z"
  • Uitvoer: "2015-01-23"OUTPUT: "2015-01-23"

GuidGuid

Functie: GUID ()Function: Guid()

Beschrijving: De functie-GUID genereert een nieuwe wille keurige GUIDDescription: The function Guid generates a new random GUID


IIFIIF

Functie: IIF (voor waarde, valueIfTrue, valueIfFalse)Function: IIF(condition,valueIfTrue,valueIfFalse)

Beschrijving: De functie IIF retourneert een van een set mogelijke waarden op basis van een opgegeven voor waarde.Description: The IIF function returns one of a set of possible values based on a specified condition.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
regelingcondition VereistRequired Variabele of expressieVariable or Expression Een waarde of expressie die als waar of ONWAAR kan worden geëvalueerd.Any value or expression that can be evaluated to true or false.
valueIfTruevalueIfTrue VereistRequired Variabele of teken reeksVariable or String Als de voor waarde wordt geëvalueerd als waar, wordt de geretourneerde waarde.If the condition evaluates to true, the returned value.
valueIfFalsevalueIfFalse VereistRequired Variabele of teken reeksVariable or String Als de voor waarde wordt geëvalueerd als onwaar, wordt de geretourneerde waarde.If the condition evaluates to false, the returned value.

Hierbij IIF([country]="USA",[country],[department])Example: IIF([country]="USA",[country],[department])


InStrInStr

Functie: InStr (waarde1, waarde2, begin, compareType)Function: InStr(value1, value2, start, compareType)

Beschrijving: De functie InStr zoekt het eerste exemplaar van een subtekenreeks in een teken reeksDescription: The InStr function finds the first occurrence of a substring in a string

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
Value1value1 VereistRequired TekenreeksString Teken reeks die moet worden doorzochtString to be searched
enzovoortvalue2 VereistRequired TekenreeksString Teken reeks die moet worden gevondenString to be found
startenstart OptioneelOptional Geheel getalInteger Begin positie om de subtekenreeks te vindenStarting position to find the substring
compareTypecompareType OptioneelOptional EnumEnum Kan vbTextCompare of vbBinaryCompare zijnCan be vbTextCompare or vbBinaryCompare

Hierbij InStr("The quick brown fox","quick")Example: InStr("The quick brown fox","quick")

Evalueert naar 5Evaluates to 5

InStr("repEated","e",3,vbBinaryCompare)

Evalueert tot 7Evaluates to 7


IsNullIsNull

Functie: IsNull (expressie)Function: IsNull(Expression)

Beschrijving: Als de expressie resulteert in null, retourneert de functie IsNull de waarde True.Description: If the expression evaluates to Null, then the IsNull function returns true. Voor een kenmerk wordt een null-waarde uitgedrukt door het ontbreken van het kenmerk.For an attribute, a Null is expressed by the absence of the attribute.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
expressionexpression VereistRequired expressieexpression Expressie die moet worden geëvalueerdExpression to be evaluated

Hierbij IsNull([displayName])Example: IsNull([displayName])

Retourneert waar als het kenmerk niet aanwezig is.Returns True if the attribute is not present.


IsNullorEmptyIsNullorEmpty

Functie: IsNullOrEmpty (expr)Function: IsNullOrEmpty(Expression)

Beschrijving: Als de expressie Null of een lege teken reeks is, retourneert de functie IsNullOrEmpty ' True '.Description: If the expression is null or an empty string, then the IsNullOrEmpty function returns true. Voor een-kenmerk resulteert dit in waar als het kenmerk ontbreekt of aanwezig is, maar een lege teken reeks is.For an attribute, this would evaluate to True if the attribute is absent or is present but is an empty string. De inverse van deze functie heeft de naam IsPresent.The inverse of this function is named IsPresent.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
expressionexpression VereistRequired expressieexpression Expressie die moet worden geëvalueerdExpression to be evaluated

Hierbij IsNullOrEmpty([displayName])Example: IsNullOrEmpty([displayName])

Retourneert waar als het kenmerk niet aanwezig is of een lege teken reeks is.Returns True if the attribute is not present or is an empty string.


IsPresentIsPresent

Functie: IsPresent (expr)Function: IsPresent(Expression)

Beschrijving: Als de expressie resulteert in een teken reeks die niet null en niet leeg is, retourneert de functie IsPresent de waarde True.Description: If the expression evaluates to a string that is not Null and is not empty, then the IsPresent function returns true. De inverse van deze functie heeft de naam IsNullOrEmpty.The inverse of this function is named IsNullOrEmpty.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
expressionexpression VereistRequired expressieexpression Expressie die moet worden geëvalueerdExpression to be evaluated

Hierbij Switch(IsPresent([directManager]),[directManager], IsPresent([skiplevelManager]),[skiplevelManager], IsPresent([director]),[director])Example: Switch(IsPresent([directManager]),[directManager], IsPresent([skiplevelManager]),[skiplevelManager], IsPresent([director]),[director])


IsStringIsString

Functie: IsString (expr)Function: IsString(Expression)

Beschrijving: Als de expressie kan worden geëvalueerd als een teken reeks type, wordt de functie IsString geëvalueerd als True.Description: If the expression can be evaluated to a string type, then the IsString function evaluates to True.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
expressionexpression VereistRequired expressieexpression Expressie die moet worden geëvalueerdExpression to be evaluated

ItemItem

Functie: Item (kenmerk, index)Function: Item(attribute, index)

Beschrijving: De functie item retourneert één item uit een teken reeks/kenmerk met meerdere waarden.Description: The Item function returns one item from a multi-valued string/attribute.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
geschrevenattribute VereistRequired KenmerkAttribute Kenmerk met meerdere waarden dat moet worden doorzochtMulti-valued attribute to be searched
TabIndexindex VereistRequired Geheel getalInteger Index naar een item in de teken reeks met meerdere waardenIndex to an item in the multi-valued string

Voor beeld: Item([proxyAddresses], 1) retourneert het tweede item in het kenmerk met meerdere waarden.Example: Item([proxyAddresses], 1) returns the second item in the multi-valued attribute.


DeelnemenJoin

Functie: Samen voegen (scheidings teken, source1, source2,...)Function: Join(separator, source1, source2, …)

Beschrijving: Samen voegen () is vergelijkbaar met Append (), behalve dat het meerdere bron teken reeks waarden kan combi neren in één teken reeks en elke waarde wordt gescheiden door een scheidings teken reeks.Description: Join() is similar to Append(), except that it can combine multiple source string values into a single string, and each value will be separated by a separator string.

Als een van de bron waarden een kenmerk met meerdere waarden is, wordt elke waarde in dat kenmerk samengevoegd, gescheiden door de waarde voor het scheidings teken.If one of the source values is a multi-value attribute, then every value in that attribute will be joined together, separated by the separator value.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
scheidingseparator VereistRequired TekenreeksString Teken reeks die wordt gebruikt om bron waarden te scheiden wanneer ze worden samengevoegd tot één teken reeks.String used to separate source values when they are concatenated into one string. Kan zijn als er geen scheidings teken is vereist.Can be "" if no separator is required.
source1 ... Bronnsource1 … sourceN Vereist, variabele-aantal kerenRequired, variable-number of times TekenreeksString Teken reeks waarden die samen moeten worden samengevoegd.String values to be joined together.

LinksLeft

Functie: Left (teken reeks, NumChars)Function: Left(String,NumChars)

Beschrijving: De functie Left retourneert een opgegeven aantal tekens vanaf de linkerkant van een teken reeks.Description: The Left function returns a specified number of characters from the left of a string. Als numChars = 0, retourneert u een lege teken reeks.If numChars = 0, return empty string. Als numChars < 0, wordt de invoer teken reeks geretourneerd.If numChars < 0, return input string. Als teken reeks null is, retourneert een lege teken reeks.If string is null, return empty string. Als teken reeks minder tekens bevat dan het getal dat is opgegeven in numChars, wordt een teken reeks geretourneerd die identiek is aan de teken reeks (dat wil zeggen, met alle tekens in para meter 1).If string contains fewer characters than the number specified in numChars, a string identical to string (that is, containing all characters in parameter 1) is returned.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
TekenreeksString VereistRequired KenmerkAttribute De teken reeks waaruit tekens moeten worden opgehaaldThe string to return characters from
NumCharsNumChars VereistRequired Geheel getalInteger Een getal waarmee het aantal tekens wordt aangegeven dat moet worden geretourneerd vanaf het begin (links) van de teken reeksA number identifying the number of characters to return from the beginning (left) of string

Hierbij Left("John Doe", 3)Example: Left("John Doe", 3)

Retourneert "Joh".Returns "Joh".


MidMid

Functie: Mid (bron, begin, lengte)Function: Mid(source, start, length)

Beschrijving: Retourneert een subtekenreeks van de bron waarde.Description: Returns a substring of the source value. Een subtekenreeks is een teken reeks die slechts een aantal tekens uit de bron teken reeks bevat.A substring is a string that contains only some of the characters from the source string.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
Bronsource VereistRequired TekenreeksString Meestal naam van het kenmerk.Usually name of the attribute.
startenstart VereistRequired geheel getalinteger Index in de bron teken reeks waarin de subtekenreeks moet worden gestart.Index in the source string where substring should start. Het eerste teken in de teken reeks heeft index 1, tweede teken heeft index 2, enzovoort.First character in the string will have index of 1, second character will have index 2, and so on.
lengthlength VereistRequired geheel getalinteger Lengte van de subtekenreeks.Length of the substring. Als de lengte van de bron teken reeks eindigt, wordt met de functie subtekenreeks geretourneerd vanuit Start index tot het einde van de bron teken reeks.If length ends outside the source string, function will return substring from start index till end of source string.

NormalizeDiacriticsNormalizeDiacritics

Functie: NormalizeDiacritics (bron)Function: NormalizeDiacritics(source)

Beschrijving: Vereist één teken reeks argument.Description: Requires one string argument. Retourneert de teken reeks, maar waarbij alle diakritische tekens worden vervangen door gelijkwaardige tekens die niet van het diakritische teken zijn.Returns the string, but with any diacritical characters replaced with equivalent non-diacritical characters. Wordt doorgaans gebruikt voor het converteren van de voor-en achternamen met diakritische tekens (accent markeringen) naar juridische waarden die kunnen worden gebruikt in verschillende gebruikers-id's, zoals User Principal Names, SAM-account namen en e-mail adressen.Typically used to convert first names and last names containing diacritical characters (accent marks) into legal values that can be used in various user identifiers such as user principal names, SAM account names, and email addresses.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
Bronsource VereistRequired TekenreeksString Meestal een voor naam-of achternaam-kenmerk.Usually a first name or last name attribute.

Diakritische tekens uit een teken reeks verwijderenRemove diacritics from a string

Voor beeld: u moet tekens met accent tekens vervangen door gelijkwaardige tekens die geen accent tekens bevatten.Example: You need to replace characters containing accent marks with equivalent characters that don't contain accent marks.

Expressie: NormalizeDiacritics ([OpgegevenNaam])Expression: NormalizeDiacritics([givenName])

Voor beeld van invoer/uitvoer:Sample input/output:

  • Invoer (voor OpgegevenNaam): "Zoë"INPUT (givenName): "Zoë"
  • Uitvoer: "Zoe"OUTPUT: "Zoe"

NotNot

Functie: Niet (bron)Function: Not(source)

Beschrijving: Hiermee wordt de Booleaanse waarde van de bron gespiegeld.Description: Flips the boolean value of the source. Als de bron waarde True is, wordt false geretourneerd.If source value is True, returns False. Anders wordt waar geretourneerd.Otherwise, returns True.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
Bronsource VereistRequired Booleaanse teken reeksBoolean String Verwachte bron waarden zijn ' True ' of ' false '.Expected source values are "True" or "False".

NumFromDateNumFromDate

Functie: NumFromDate (waarde)Function: NumFromDate(value)

Beschrijving: Met de functie NumFromDate wordt een DateTime-waarde geconverteerd naar Active Directory indeling die is vereist om kenmerken zoals accountExpiresin te stellen.Description: The NumFromDate function converts a DateTime value to Active Directory format that is required to set attributes like accountExpires. Gebruik deze functie om DateTime-waarden die zijn ontvangen van Cloud-HR-apps, zoals workday en SuccessFactors, te converteren naar hun equivalente advertentie voorstelling.Use this function to convert DateTime values received from cloud HR apps like Workday and SuccessFactors to their equivalent AD representation.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
valuevalue VereistRequired TekenreeksString Datum en tijd teken reeks in de ondersteunde indeling.Date time string in the supported format. Zie voor ondersteunde indelingen https://msdn.microsoft.com/library/8kb3ddd4%28v=vs.110%29.aspx .For supported formats, see https://msdn.microsoft.com/library/8kb3ddd4%28v=vs.110%29.aspx.

Voorbeeld:Example:

  • Voor beeld van een werkdag als u wilt dat het kenmerk ContractEndDate van workday wordt toegewezen in het veld 2020-12-31-08:00 tot accountExpires in AD, kunt u deze functie gebruiken en de tijd zone verschuiving wijzigen zodat deze overeenkomt met uw land instelling.Workday example Assuming you want to map the attribute ContractEndDate from Workday which is in the format 2020-12-31-08:00 to accountExpires field in AD, here is how you can use this function and change the timezone offset to match your locale. NumFromDate(Join("", FormatDateTime([ContractEndDate], ,"yyyy-MM-ddzzz", "yyyy-MM-dd"), "T23:59:59-08:00"))

  • Voor beeld van een SuccessFactors als u wilt dat het kenmerk EndDate van SuccessFactors wordt toegewezen in het veld format M/d/jjjj uu: mm: ss tt to accountExpires in AD, kunt u deze functie gebruiken en de tijd zone-offset wijzigen zodat deze overeenkomt met uw land instelling.SuccessFactors example Assuming you want to map the attribute endDate from SuccessFactors which is in the format M/d/yyyy hh:mm:ss tt to accountExpires field in AD, here is how you can use this function and change the time zone offset to match your locale. NumFromDate(Join("",FormatDateTime([endDate], ,"M/d/yyyy hh:mm:ss tt","yyyy-MM-dd"),"T23:59:59-08:00"))


RemoveDuplicatesRemoveDuplicates

Functie: RemoveDuplicates (kenmerk)Function: RemoveDuplicates(attribute)

Beschrijving: De functie RemoveDuplicates gebruikt een teken reeks met meerdere waarden en zorg ervoor dat elke waarde uniek is.Description: The RemoveDuplicates function takes a multi-valued string and make sure each value is unique.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
geschrevenattribute VereistRequired Kenmerk met meerdere waardenMulti-valued Attribute Kenmerk met meerdere waarden waarvoor duplicaten worden verwijderdMulti-valued attribute that will have duplicates removed

Voor beeld: RemoveDuplicates([proxyAddresses]) Retourneert een gezuiverd proxyAddress attribuut-kenmerk waarbij alle dubbele waarden zijn verwijderd.Example: RemoveDuplicates([proxyAddresses]) Returns a sanitized proxyAddress attribute where all duplicate values have been removed.


VervangenReplace

Functie: Replace (bron, oldValue, regexPattern, regexGroupName, replacementValue, replacementAttributeName, sjabloon)Function: Replace(source, oldValue, regexPattern, regexGroupName, replacementValue, replacementAttributeName, template)

Beschrijving: Vervangt waarden binnen een teken reeks op een hoofdletter gevoelige manier.Description: Replaces values within a string in a case-sensitive manner. De functie werkt anders afhankelijk van de opgegeven para meters:The function behaves differently depending on the parameters provided:

  • Wanneer oldValue en replacementValue worden gegeven:When oldValue and replacementValue are provided:

    • Vervangt alle exemplaren van oldValue in de bron door replacementValueReplaces all occurrences of oldValue in the source with replacementValue
  • Wanneer oldValue en sjabloon worden gegeven:When oldValue and template are provided:

    • Vervangt alle exemplaren van de oldValue in de sjabloon door de bron waardeReplaces all occurrences of the oldValue in the template with the source value
  • Wanneer regexPattern en replacementValue worden gegeven:When regexPattern and replacementValue are provided:

    • De functie past de regexPattern toe op de bron teken reeks en u kunt de regex-groeps namen gebruiken om de teken reeks voor replacementValue te makenThe function applies the regexPattern to the source string and you can use the regex group names to construct the string for replacementValue
  • Als regexPattern, regexGroupName, replacementValue worden gegeven:When regexPattern, regexGroupName, replacementValue are provided:

    • De functie past de regexPattern toe op de bron teken reeks en vervangt alle waarden die overeenkomen met regexGroupName met replacementValueThe function applies the regexPattern to the source string and replaces all values matching regexGroupName with replacementValue
  • Als regexPattern, regexGroupName, replacementAttributeName worden gegeven:When regexPattern, regexGroupName, replacementAttributeName are provided:

    • Als de bron geen waarde heeft, wordt de bron geretourneerdIf source has no value, source is returned
    • Als de bron een waarde heeft, past de functie de regexPattern toe op de bron teken reeks en worden alle waarden die overeenkomen met regexGroupName vervangen door de waarde die is gekoppeld aan replacementAttributeNameIf source has a value, the function applies the regexPattern to the source string and replaces all values matching regexGroupName with the value associated with replacementAttributeName

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
Bronsource VereistRequired TekenreeksString Doorgaans naam van het kenmerk van het bron object.Usually name of the attribute from the source object.
oldValueoldValue OptioneelOptional TekenreeksString De waarde die moet worden vervangen in de bron of de sjabloon.Value to be replaced in source or template.
regexPatternregexPattern OptioneelOptional TekenreeksString Regex-patroon voor de waarde die in de bron moet worden vervangen.Regex pattern for the value to be replaced in source. Of, wanneer replacementPropertyName wordt gebruikt, patroon om waarde uit replacementPropertyName te halen.Or, when replacementPropertyName is used, pattern to extract value from replacementPropertyName.
regexGroupNameregexGroupName OptioneelOptional TekenreeksString De naam van de groep in regexPattern.Name of the group inside regexPattern. Alleen wanneer replacementPropertyName wordt gebruikt, wordt de waarde van deze groep geëxtraheerd als replacementValue van replacementPropertyName.Only when replacementPropertyName is used, we will extract value of this group as replacementValue from replacementPropertyName.
replacementValuereplacementValue OptioneelOptional TekenreeksString Nieuwe waarde om oude te vervangen door.New value to replace old one with.
replacementAttributeNamereplacementAttributeName OptioneelOptional TekenreeksString Naam van het kenmerk dat moet worden gebruikt voor de vervangings waardeName of the attribute to be used for replacement value
sjabloontemplate OptioneelOptional TekenreeksString Als u een sjabloon waarde opgeeft, worden de oude waarden in de sjabloon gezocht en vervangen door de bron waarde.When template value is provided, we will look for oldValue inside the template and replace it with source value.

Tekens vervangen met een reguliere expressieReplace characters using a regular expression

Voor beeld: u moet tekens zoeken die overeenkomen met een reguliere expressie waarde en deze verwijderen.Example: You need to find characters that match a regular expression value and remove them.

ExpressieExpression:

Replace ([mailnickname],, "[a-zA-Z_] *",, "",,,)Replace([mailNickname], , "[a-zA-Z_]*", , "", , )

Voor beeld van invoer/uitvoer:Sample input/output:

  • Invoer (mailnickname: "john_doe72"INPUT (mailNickname: "john_doe72"
  • Uitvoer: "72"OUTPUT: "72"

SelectUniqueValueSelectUniqueValue

Functie: SelectUniqueValue(uniqueValueRule1, uniqueValueRule2, uniqueValueRule3, ...)Function: SelectUniqueValue(uniqueValueRule1, uniqueValueRule2, uniqueValueRule3, …)

Beschrijving: Er zijn mini maal twee argumenten vereist. Dit zijn de regels voor het genereren van unieke waarden die zijn gedefinieerd met behulp van expressies.Description: Requires a minimum of two arguments, which are unique value generation rules defined using expressions. De functie evalueert elke regel en controleert vervolgens de waarde die is gegenereerd voor uniekheid in de doel-app/-directory.The function evaluates each rule and then checks the value generated for uniqueness in the target app/directory. De eerste unieke waarde die wordt geretourneerd, wordt de gevonden.The first unique value found will be the one returned. Als alle waarden al bestaan in het doel, wordt de vermelding met borg en wordt de reden vastgelegd in de audit Logboeken.If all of the values already exist in the target, the entry will get escrowed and the reason gets logged in the audit logs. Er is geen bovengrens voor het aantal argumenten dat kan worden gegeven.There is no upper bound to the number of arguments that can be provided.

  • Dit is een functie op het hoogste niveau en kan niet worden genest.This is a top-level function, it cannot be nested.
  • Deze functie kan niet worden toegepast op kenmerken met een overeenkomende prioriteit.This function cannot be applied to attributes that have a matching precedence.
  • Deze functie is alleen bedoeld om te worden gebruikt voor het maken van items.This function is only meant to be used for entry creations. Wanneer u het gebruikt met een-kenmerk, moet u de eigenschap toewijzing Toep assen instellen op alleen tijdens het maken van een object.When using it with an attribute, set the Apply Mapping property to Only during object creation.
  • Deze functie wordt momenteel alleen ondersteund voor ' werkdag Active Directory gebruikers inrichten ' en ' SuccessFactors to Active Directory User provisioning '.This function is currently only supported for "Workday to Active Directory User Provisioning" and "SuccessFactors to Active Directory User Provisioning". Het kan niet worden gebruikt met andere inrichtings toepassingen.It cannot be used with other provisioning applications.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
uniqueValueRule1 ... uniqueValueRuleNuniqueValueRule1 … uniqueValueRuleN Ten minste 2 zijn vereist, geen bovengrensAt least 2 are required, no upper bound TekenreeksString Lijst met regels voor het genereren van unieke waarden om te evalueren.List of unique value generation rules to evaluate.

Genereer een unieke waarde voor het kenmerk userPrincipalName (UPN)Generate unique value for userPrincipalName (UPN) attribute

Voor beeld: op basis van de voor naam van de gebruiker, de middelste naam en de achternaam, moet u een waarde voor het UPN-kenmerk genereren en controleren of er uniek is in de AD-doel directory voordat u de waarde aan het UPN-kenmerk toewijst.Example: Based on the user's first name, middle name and last name, you need to generate a value for the UPN attribute and check for its uniqueness in the target AD directory before assigning the value to the UPN attribute.

ExpressieExpression:

    SelectUniqueValue( 
        Join("@", NormalizeDiacritics(StripSpaces(Join(".",  [PreferredFirstName], [PreferredLastName]))), "contoso.com"), 
        Join("@", NormalizeDiacritics(StripSpaces(Join(".",  Mid([PreferredFirstName], 1, 1), [PreferredLastName]))), "contoso.com"),
        Join("@", NormalizeDiacritics(StripSpaces(Join(".",  Mid([PreferredFirstName], 1, 2), [PreferredLastName]))), "contoso.com")
    )

Voor beeld van invoer/uitvoer:Sample input/output:

  • Invoer (PreferredFirstName): "John"INPUT (PreferredFirstName): "John"
  • Invoer (PreferredLastName): "Smith"INPUT (PreferredLastName): "Smith"
  • Uitvoer: " John.Smith@contoso.com " als UPN-waarde van John.Smith@contoso.com niet al bestaat in de mapOUTPUT: "John.Smith@contoso.com" if UPN value of John.Smith@contoso.com doesn't already exist in the directory
  • Uitvoer: " J.Smith@contoso.com " als UPN-waarde John.Smith@contoso.com al bestaat in de mapOUTPUT: "J.Smith@contoso.com" if UPN value of John.Smith@contoso.com already exists in the directory
  • Uitvoer: " Jo.Smith@contoso.com " als de bovenstaande twee UPN-waarden al bestaan in de mapOUTPUT: "Jo.Smith@contoso.com" if the above two UPN values already exist in the directory

SingleAppRoleAssignmentSingleAppRoleAssignment

Functie: SingleAppRoleAssignment ([appRoleAssignments])Function: SingleAppRoleAssignment([appRoleAssignments])

Beschrijving: Retourneert één appRoleAssignment uit de lijst met alle appRoleAssignments die zijn toegewezen aan een gebruiker voor een bepaalde toepassing.Description: Returns a single appRoleAssignment from the list of all appRoleAssignments assigned to a user for a given application. Deze functie is vereist om het appRoleAssignments-object om te zetten in een teken reeks met een enkele rolnaam.This function is required to convert the appRoleAssignments object into a single role name string. Houd er rekening mee dat de best practice ervoor moet zorgen dat er slechts één appRoleAssignment wordt toegewezen aan één gebruiker tegelijk. als er meerdere rollen zijn toegewezen, kan de geretourneerde functie teken reeks mogelijk niet voorspelbaar zijn.Note that the best practice is to ensure only one appRoleAssignment is assigned to one user at a time, and if multiple roles are assigned the role string returned may not be predictable.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
AppRoleAssignments[appRoleAssignments] VereistRequired TekenreeksString object [appRoleAssignments] .[appRoleAssignments] object.

SplitsenSplit

Functie: Splitsen (bron, scheidings teken)Function: Split(source, delimiter)

Beschrijving: Hiermee splitst u een teken reeks in een matrix met meerdere waarden met behulp van het opgegeven scheidings teken.Description: Splits a string into a multi-valued array, using the specified delimiter character.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
Bronsource VereistRequired TekenreeksString bron waarde die moet worden bijgewerkt.source value to update.
vormdelimiter VereistRequired TekenreeksString Hiermee geeft u het teken op dat wordt gebruikt om de teken reeks te splitsen (bijvoorbeeld: ",")Specifies the character that will be used to split the string (example: ",")

Een teken reeks splitsen in een matrix met meerdere waardenSplit a string into a multi-valued array

Voor beeld: u moet een door komma's gescheiden lijst met teken reeksen maken en deze opsplitsen in een matrix die kan worden aangesloten op een kenmerk met meerdere waarden zoals het kenmerk PermissionSets van Sales Force.Example: You need to take a comma-delimited list of strings, and split them into an array that can be plugged into a multi-value attribute like Salesforce's PermissionSets attribute. In dit voor beeld is een lijst met machtigingen sets ingevuld in extensionAttribute5 in azure AD.In this example, a list of permission sets has been populated in extensionAttribute5 in Azure AD.

Expressie: Splitsen ([extensionAttribute5], ",")Expression: Split([extensionAttribute5], ",")

Voor beeld van invoer/uitvoer:Sample input/output:

  • Invoer (extensionAttribute5): "PermissionSetOne, PermissionSetTwo"INPUT (extensionAttribute5): "PermissionSetOne, PermissionSetTwo"
  • Output: ["PermissionSetOne", "PermissionSetTwo"]OUTPUT: ["PermissionSetOne", "PermissionSetTwo"]

StripSpacesStripSpaces

Functie: StripSpaces (bron)Function: StripSpaces(source)

Beschrijving: Verwijdert alle spatie tekens ("") uit de bron teken reeks.Description: Removes all space (" ") characters from the source string.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
Bronsource VereistRequired TekenreeksString bron waarde die moet worden bijgewerkt.source value to update.

SwitchSwitch

Functie: Switch (bron, defaultValue, Key1, waarde1, Key2, waarde2,...)Function: Switch(source, defaultValue, key1, value1, key2, value2, …)

Beschrijving: Als de bron waarde overeenkomt met een sleutel, retourneert waarde voor die sleutel.Description: When source value matches a key, returns value for that key. Als de bron waarde niet overeenkomt met een sleutel, wordt DefaultValue geretourneerd.If source value doesn't match any keys, returns defaultValue. Sleutel -en waarde -para meters moeten altijd in paren zijn.Key and value parameters must always come in pairs. De functie verwacht altijd een even aantal para meters.The function always expects an even number of parameters. De functie mag niet worden gebruikt voor referentiële kenmerken, zoals Manager.The function should not be used for referential attributes such as manager.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
Bronsource VereistRequired TekenreeksString Bron waarde die moet worden bijgewerkt.Source value to update.
StandaarddefaultValue OptioneelOptional TekenreeksString De standaard waarde die moet worden gebruikt als de bron niet overeenkomt met een sleutel.Default value to be used when source doesn't match any keys. Kan een lege teken reeks zijn ("").Can be empty string ("").
prestatiekey VereistRequired TekenreeksString Sleutel voor het vergelijken van de bron waarde met.Key to compare source value with.
valuevalue VereistRequired TekenreeksString Vervangings waarde voor de bron die overeenkomt met de sleutel.Replacement value for the source matching the key.

Een waarde vervangen op basis van een vooraf gedefinieerde set optiesReplace a value based on predefined set of options

Voor beeld: u moet de tijd zone van de gebruiker definiëren op basis van de status code die is opgeslagen in azure AD.Example: You need to define the time zone of the user based on the state code stored in Azure AD. Als de status code niet overeenkomt met een van de vooraf gedefinieerde opties, gebruikt u de standaard waarde "Australië/Sydney".If the state code doesn't match any of the predefined options, use default value of "Australia/Sydney".

Expressie Switch([state], "Australia/Sydney", "NSW", "Australia/Sydney","QLD", "Australia/Brisbane", "SA", "Australia/Adelaide")Expression: Switch([state], "Australia/Sydney", "NSW", "Australia/Sydney","QLD", "Australia/Brisbane", "SA", "Australia/Adelaide")

Voor beeld van invoer/uitvoer:Sample input/output:

  • Invoer (status): "Qld"INPUT (state): "QLD"
  • Uitvoer: "Australië/Brisbane"OUTPUT: "Australia/Brisbane"

ToLowerToLower

Functie: ToLower (bron, cultuur)Function: ToLower(source, culture)

Beschrijving: Neemt een bron teken reeks waarde en converteert deze in kleine letters met de opgegeven cultuur regels.Description: Takes a source string value and converts it to lower case using the culture rules that are specified. Als er geen cultuur gegevens zijn opgegeven, wordt de invariante cultuur gebruikt.If there is no culture info specified, then it will use Invariant culture.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
Bronsource VereistRequired TekenreeksString Doorgaans naam van het kenmerk van het bron objectUsually name of the attribute from the source object
cultureleculture OptioneelOptional TekenreeksString De notatie voor de cultuur naam op basis van RFC 4646 is languagecode2-Country/regioncode2, waarbij languagecode2 de taal code van twee letters is en land/regioncode2 de subcultuurcode van twee letters is.The format for the culture name based on RFC 4646 is languagecode2-country/regioncode2, where languagecode2 is the two-letter language code and country/regioncode2 is the two-letter subculture code. Voor beelden zijn ja-JP voor Japans (Japan) en en-US voor Engels (Verenigde Staten).Examples include ja-JP for Japanese (Japan) and en-US for English (United States). In gevallen waarin een taal code van twee letters niet beschikbaar is, wordt er een code van drie letters gebruikt die is afgeleid van ISO 639-2.In cases where a two-letter language code is not available, a three-letter code derived from ISO 639-2 is used.

Gegenereerde userPrincipalName-waarde converteren naar kleine lettersConvert generated userPrincipalName (UPN) value to lower case

Voor beeld: u wilt de UPN-waarde genereren door de bron velden PreferredFirstName en PreferredLastName samen te voegen en alle tekens te converteren naar kleine letters.Example: You would like to generate the UPN value by concatenating the PreferredFirstName and PreferredLastName source fields and converting all characters to lower case.

ToLower(Join("@", NormalizeDiacritics(StripSpaces(Join(".", [PreferredFirstName], [PreferredLastName]))), "contoso.com"))

Voor beeld van invoer/uitvoer:Sample input/output:

  • Invoer (PreferredFirstName): "John"INPUT (PreferredFirstName): "John"
  • Invoer (PreferredLastName): "Smith"INPUT (PreferredLastName): "Smith"
  • Uitvoer: " john.smith@contoso.com "OUTPUT: "john.smith@contoso.com"

ToUpperToUpper

Functie: ToUpper (bron, cultuur)Function: ToUpper(source, culture)

Beschrijving: Neemt een bron teken reeks waarde en converteert deze in hoofd letters met de opgegeven cultuur regels.Description: Takes a source string value and converts it to upper case using the culture rules that are specified. Als er geen cultuur gegevens zijn opgegeven, wordt de invariante cultuur gebruikt.If there is no culture info specified, then it will use Invariant culture.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
Bronsource VereistRequired TekenreeksString Doorgaans naam van het kenmerk van het bron object.Usually name of the attribute from the source object.
cultureleculture OptioneelOptional TekenreeksString De notatie voor de cultuur naam op basis van RFC 4646 is languagecode2-Country/regioncode2, waarbij languagecode2 de taal code van twee letters is en land/regioncode2 de subcultuurcode van twee letters is.The format for the culture name based on RFC 4646 is languagecode2-country/regioncode2, where languagecode2 is the two-letter language code and country/regioncode2 is the two-letter subculture code. Voor beelden zijn ja-JP voor Japans (Japan) en en-US voor Engels (Verenigde Staten).Examples include ja-JP for Japanese (Japan) and en-US for English (United States). In gevallen waarin een taal code van twee letters niet beschikbaar is, wordt er een code van drie letters gebruikt die is afgeleid van ISO 639-2.In cases where a two-letter language code is not available, a three-letter code derived from ISO 639-2 is used.

WordWord

Functie: Woord (teken reeks, WordNumber, scheidings tekens)Function: Word(String,WordNumber,Delimiters)

Beschrijving: De functie Word retourneert een woord dat deel uitmaakt van een teken reeks, op basis van para meters die de scheidings tekens beschrijven die moeten worden gebruikt en het woord nummer dat moet worden geretourneerd.Description: The Word function returns a word contained within a string, based on parameters describing the delimiters to use and the word number to return. Elke teken reeks in een teken reeks gescheiden door de tekens van de spaties wordt aangeduid als woorden:Each string of characters in string separated by the one of the characters in delimiters are identified as words:

Als getal < 1 retourneert een lege teken reeks.If number < 1, returns empty string. Als de teken reeks null is, wordt een lege teken reeks geretourneerd.If string is null, returns empty string. Als teken reeks minder dan cijfer woorden bevat, of teken reeks geen woorden die zijn geïdentificeerd door scheidings tekens, wordt een lege teken reeks geretourneerd.If string contains less than number words, or string does not contain any words identified by delimiters, an empty string is returned.

InstellenParameters:

NameName Vereist/herhalendRequired/ Repeating TypeType OpmerkingenNotes
TekenreeksString VereistRequired Kenmerk met meerdere waardenMulti-valued Attribute De teken reeks waarmee een woord moet worden geretourneerd.String to return a word from.
WordNumberWordNumber VereistRequired Geheel getalInteger Nummer waarmee het woord nummer moet worden geretourneerdNumber identifying which word number should return
scheidings tekensdelimiters VereistRequired TekenreeksString Een teken reeks die de scheidings tekens vertegenwoordigt die moeten worden gebruikt voor het identificeren van woordenA string representing the delimiter(s) that should be used to identify words

Hierbij Word("The quick brown fox",3," ")Example: Word("The quick brown fox",3," ")

Retourneert ' bruin '.Returns "brown".

Word("This,string!has&many separators",3,",!&#")

Retourneert "is".Returns "has".


VoorbeeldenExamples

In deze sectie vindt u meer voor beelden van expressie functies.This section provides more expression function usage examples.

Bekende domein naam van de StripeStrip known domain name

U moet een bekende domein naam verwijderen uit het e-mail adres van een gebruiker om een gebruikers naam op te halen.You need to strip a known domain name from a user's email to obtain a user name. Als het domein bijvoorbeeld ' contoso.com ' is, kunt u de volgende expressie gebruiken:For example, if the domain is "contoso.com", then you could use the following expression:

Expressie Replace([mail], "@contoso.com", , ,"", ,)Expression: Replace([mail], "@contoso.com", , ,"", ,)

Voor beeld van invoer/uitvoer:Sample input / output:

  • Invoer (e-mail adres): " john.doe@contoso.com "INPUT (mail): "john.doe@contoso.com"
  • Uitvoer: "John. Splinter"OUTPUT: "john.doe"

Gebruikers alias genereren door delen van de voor-en achternaam samen te voegenGenerate user alias by concatenating parts of first and last name

U moet een gebruikers alias genereren door eerste drie letters van de voor naam van de gebruiker en eerste 5 letters van de achternaam van de gebruiker te nemen.You need to generate a user alias by taking first 3 letters of user's first name and first 5 letters of user's last name.

Expressie Append(Mid([givenName], 1, 3), Mid([surname], 1, 5))Expression: Append(Mid([givenName], 1, 3), Mid([surname], 1, 5))

Voor beeld van invoer/uitvoer:Sample input/output:

  • Invoer (voor gegeven): JohnINPUT (givenName): "John"
  • Invoer (achternaam): "Splinter"INPUT (surname): "Doe"
  • Uitvoer: "JohDoe"OUTPUT: "JohDoe"