ConvertToBase64

函数：ConvertToBase64(source)

说明：ConvertToBase64 函数将字符串转换为 Unicode base64 字符串。

示例 2：将 DateDiff 与 IIF 函数合并用于设置属性值
如果一个帐户在 Workday 中处于活动状态，则仅当雇用日期的范围在接下来的 5 天内时，才将用户的 accountEnabled 属性设置为 True。

Switch([Active], , 
  "1", IIF(DateDiff("d", Now(), CDate([StatusHireDate])) > 5, "False", "True"), 
  "0", "False")
DateFromNum
函数：DateFromNum(value)
说明：DateFromNum 函数将 AD 日期格式的值转换为日期/时间类型。
必选/重复
示例：DateFromNum([lastLogonTimestamp])
DateFromNum(129699324000000000)
返回表示 2012 年 1 月 1 日 11:00PM 的日期/时间。
FormatDateTime
函数：FormatDateTime(source, dateTimeStyles, inputFormat, outputFormat)
说明：取一种格式的日期字符串并将其转换为不同的格式。
必选/重复
使用此参数可以指定格式设置选项，这些选项可自定义用于某些日期和时间分析方法的字符串分析。 有关支持的值，请参阅 DateTimeStyles 文档。如果留空，则使用的默认值为 DateTimeStyles.RoundtripKind, DateTimeStyles.AllowLeadingWhite, DateTimeStyles.AllowTrailingWhite
inputFormat
String
源值的预期格式。 有关支持的格式，请参阅 .NET 自定义日期和时间格式字符串。
outputFormat
String
输出日期的格式。
输出日期是一种特定格式的字符串
示例：你想要以特定格式将日期发送到 ServiceNow 等 SaaS 应用程序。 可以考虑使用以下表达式。
FormatDateTime([extensionAttribute1], , "yyyyMMddHHmmss.fZ", "yyyy-MM-dd")
示例输入/输出：
输入 (extensionAttribute1)：“20150123105347.1Z”
              输出：“2015-01-23”
函数：Guid()
说明：函数 Guid 生成新的随机 GUID
Guid()

示例输出：“1088051a-cd4b-4288-84f8-e02042ca72bc”

IgnoreFlowIfNullOrEmpty
函数：IgnoreFlowIfNullOrEmpty(expression)
说明：如果包含的函数或属性为 NULL 或为空，则 IgnoreFlowIfNullOrEmpty 函数会指示预配服务忽略属性，并将其从流中删除。
必选/重复
示例 1：如果属性为 null，则不流式传输 

IgnoreFlowIfNullOrEmpty([department]) 

如果值为 null 或为空，则上述表达式将从预配流中删除部门属性。 

示例 2：如果表达式映射的计算结果为空字符串或 null，则不流式传输属性 

假设 SuccessFactors 属性 prefix 通过以下表达式映射映射到本地 Active Directory 属性 personalTitle：

IgnoreFlowIfNullOrEmpty(Switch([prefix], "", "3443", "Dr.", "3444", "Prof.", "3445", "Prof. Dr.")) 

上述表达式将首先计算 Switch 函数的结果。 如果 prefix 属性没有 Switch 函数内列出的任何值，则 Switch 将返回一个空字符串，并且 personalTitle 属性不会包括在本地 Active Directory 的预配流中。
函数：IIF(condition,valueIfTrue,valueIfFalse)
说明：IIF 函数基于指定的条件返回一组可能值中的一个。
必选/重复
              示例：如果“国家/地区 = 美国”，则将目标属性值设为“源国家/地区”属性，否则设为“源部门”属性。
IIF([country]="USA",[country],[department])
IIF 函数的已知限制和解决方法
IIF 函数当前不支持 AND 和 OR 逻辑运算符。
若要实现 AND 逻辑，请使用沿 trueValue 路径链接的嵌套 IIF 语句。
示例：如果“国家/地区 = 美国”且“省/市/自治区 = 加州”，则返回值“True”，否则返回“False”。
IIF([country]="USA",IIF([state]="CA","True","False"),"False")
若要实现 OR 逻辑，请使用沿 falseValue 路径链接的嵌套 IIF 语句。
示例：如果“国家/地区 = 美国”或“省/市/自治区 = 加州”，则返回值“True”，否则返回“False”。
IIF([country]="USA","True",IIF([state]="CA","True","False"))
如果在 IIF 函数内使用的源属性为空或 null，则将无法进行条件检查。
不支持的 IIF 表达式示例：

IIF([country]="","Other",[country])
IIF(IsNullOrEmpty([country]),"Other",[country])
IIF(IsPresent([country]),[country],"Other")
建议的解决方法：使用 Switch 函数检查是否有空值/null 值。 示例：如果国家/地区属性为空，则将值设置为“其他”。 如有国家/地区，则将属性值传递到目标属性。
Switch([country],[country],"","Other")
IsNullorEmpty
函数：IsNullOrEmpty(Expression)
说明：如果表达式为 null 或空字符串，则 IsNullOrEmpty 函数返回 true。 对于属性，如果属性不存在，或存在但为空字符串，此语法计算结果则为 True。
此函数的逆函数命名为 IsPresent。
必选/重复
IsPresent
函数：IsPresent(Expression)
说明：如果表达式求值为非 Null 且非空的字符串，则 IsPresent 函数返回 true。 此函数的逆函数被命名为 IsNullOrEmpty。
必选/重复
示例：Switch(IsPresent([directManager]),[directManager], IsPresent([skiplevelManager]),[skiplevelManager], IsPresent([director]),[director])
IsString
函数：IsString(Expression)
说明：如果表达式的值可为字符串类型，则 IsString 函数的值为 True。
必选/重复
函数：Join(separator, source1, source2, …)
说明：Join() 类似于 Append()，只不过它可以将多个源字符串值合并到单个字符串中，每个值由分隔符字符串分隔 。
如果其中一个源值是多值属性，那么该属性中的每个值都将联接在一起，由分隔符值分隔。
必选/重复
如果 numChars < 0，则返回输入字符串。
如果字符串为 null，则返回空字符串。
如果字符串包含的字符数比 numChars 中指定的数量少，则返回与该字符串相同的字符串（即，包含参数 1 中的所有字符）。

必选/重复
NormalizeDiacritics
函数：NormalizeDiacritics(source)
说明：需要一个字符串自变量。 返回字符串，但将任何标注字符替换为等效的非标注字符。 通常用于将包含标注字符（重音符号）的名字和姓氏转换为可用于各种用户标识符（例如用户主体名称、SAM 帐户名称和电子邮件地址）的合法值。
必选/重复
ä, à, â, ã, å, á, ą, ă, ā, ā́, ā̀, ā̂, ā̃, ǟ, ā̈, ǡ, a̱, å̄
Ä, À, Â, Ã, Å, Á, Ą, Ă, Ā, Ā́, Ā̀, Ā̂, Ā̃, Ǟ, Ā̈, Ǡ, A̱, Å̄
ç, č, ć, c̄, c̱
Ç, Č, Ć, C̄, C̱
ď, d̄, ḏ
Ď, D̄, Ḏ
ë, è, é, ê, ę, ě, ė, ē, ḗ, ḕ, ē̂, ē̃, ê̄, e̱, ë̄, e̊̄
Ë, È, É, Ê, Ę, Ě, Ė, Ē, Ḗ, Ḕ, Ē̂, Ē̃, Ê̄, E̱, Ë̄, E̊̄
ğ, ḡ, g̱
Ğ, Ḡ, G̱
ï, î, ì, í, ı, ī, ī́, ī̀, ī̂, ī̃, i̱
Ï, Î, Ì, Í, İ, Ī, Ī́, Ī̀, Ī̂, Ī̃, I̱
ľ, ł, l̄, ḹ, ḻ
Ł, Ľ, L̄, Ḹ, Ḻ
ñ, ń, ň, n̄, ṉ
Ñ, Ń, Ň, N̄, Ṉ
ö, ò, ő, õ, ô, ó, ō, ṓ, ṑ, ō̂, ō̃, ȫ, ō̈, ǭ, ȭ, ȱ, o̱
Ö, Ò, Ő, Õ, Ô, Ó, Ō, Ṓ, Ṑ, Ō̂, Ō̃, Ȫ, Ō̈, Ǭ, Ȭ, Ȱ, O̱
ø, ø̄, œ̄
Ø, Ø̄, Œ̄
ř, r̄, ṟ, ṝ
Ř, R̄, Ṟ, Ṝ
ü, ù, û, ú, ů, ű, ū, ū́, ū̀, ū̂, ū̃, u̇̄, ǖ, ṻ, ṳ̄, u̱
Ü, Ù, Û, Ú, Ů, Ű, Ū, Ū́, Ū̀, Ū̂, Ū̃, U̇̄, Ǖ, Ṻ, Ṳ̄, U̱
ÿ, ý, ȳ, ȳ́, ȳ̀, ȳ̃, y̱
Ÿ, Ý, Ȳ, Ȳ́, Ȳ̀, Ȳ̃, Y̱
ź, ž, ż, z̄, ẕ
Ź, Ž, Ż, Z̄, Ẕ
从字符串中删除音调符号
示例：将包含重音符号的字符替换为不包含重音符号的等效字符。
表达式：NormalizeDiacritics([givenName])
示例输入/输出：
输入 (givenName)：“Zoë”
              输出：“Zoe”
函数：Not(source)
说明：对 source 的布尔值取反。 如果 source 值为 True，则返回 False。 否则返回 True。
必选/重复
Now 函数返回表示当前 UTC DateTime 的字符串，格式为 M/d/yyyy h:mm:ss tt。

示例：Now() 

返回的示例值：7/2/2021 3:33:38 PM
NumFromDate
函数：NumFromDate(value)
说明： NumFromDate 函数将日期/时间值转换为 Active Directory 格式，设置 accountExpires 等特性时必须采用此格式。 使用此函数可将从云 HR 应用（例如 Workday 和 SuccessFactors）收到的日期/时间值转换为其等效的 AD 表示形式。
必选/重复
Workday 示例：假设你要将 Workday 中采用 2020-12-31-08:00 格式的 ContractEndDate 特性映射到 AD 中的 accountExpires 字段，那你可以按下面的方式使用此函数并更改时区偏差，使之与你的区域设置相匹配  。
NumFromDate(Join("", FormatDateTime([ContractEndDate], ,"yyyy-MM-ddzzz", "yyyy-MM-dd"), " 23:59:59-08:00"))
SuccessFactors 示例：假设你要将 SuccessFactors 中采用 M/d/yyyy hh:mm:ss tt 格式的 endDate 特性映射到 AD 中的 accountExpires 字段，那你可以按下面的方式使用此函数并更改时区偏差，使之与你的区域设置相匹配  。
NumFromDate(Join("",FormatDateTime([endDate], ,"M/d/yyyy hh:mm:ss tt","yyyy-MM-dd")," 23:59:59-08:00"))
PCase
函数：PCase(source, wordSeparators)
说明：PCase 函数将字符串中每个单词的第一个字符转换为大写形式，并将所有其他字符转换为小写形式。
必需/可选
如果未指定 wordSeparators 参数，则 PCase 将在内部调用 .NET 函数 ToTitleCase 将源字符串转换为正确的大小写。 .NET 函数 ToTitleCase 支持全面的一组 Unicode 字符类别作为单词分隔符。
控制字符，例如 CRLF
格式控制字符
ConnectorPunctuation 字符，例如下划线
DashPunctuation字符，例如破折号和连字符（包括短破折号、长破折号、双连字符等字符）
成对出现的 OpenPunctuation 和 ClosePunctuation 字符，例如圆括号、大括号、尖括号等 。
InitialQuotePunctuation 和 FinalQuotePunctuation 字符，例如单引号、双引号和角引号 。
OtherPunctuation 字符，例如感叹号、数字符号、百分号、& 号、星号、逗号、句号、冒号、分号等。
MathSymbol 字符，例如加号、小于号、大于号、竖线、波浪号、等号等。
CurrencySymbol 字符，例如美元符号、美分符号、英镑符号、欧元符号等。
ModifierSymbol 字符，例如长音符号、重音符号、箭头等。
OtherSymbol 字符，例如版权符号、度符号、注册符号等。
如果指定了 wordSeparators 参数，则 PCase 只会使用指定为单词分隔符的字符。
假设你要从 SAP SuccessFactors 寻找属性 firstName 和 lastName，而在 HR 中，这两个属性都采用大写。 使用 PCase 函数，可以将名称转换为正确的大小写，如下所示。
Expression
firstName = "PABLO GONSALVES (SECOND)"
"Pablo Gonsalves (Second)"
由于未指定 wordSeparators 参数，PCase 函数将使用默认的单词分隔符字符集。
PCase([lastName]," '-")
lastName = "PINTO-DE'SILVA"
"Pinto-De'Silva"
PCase 函数使用 wordSeparators 参数中的字符来识别单词，将其转换为正确的大小写 。
PCase(Join(" ",[firstName],[lastName]))
firstName = GREGORY, lastName = "JAMES" 
"Gregory James"
可以在 PCase 中嵌套 Join 函数。 由于未指定 wordSeparators 参数，PCase 函数将使用默认的单词分隔符字符集。
RandomString
函数：RandomString(Length, MinimumNumbers, MinimumSpecialCharacters, MinimumCapital, MinimumLowerCase, CharactersToAvoid)
说明： RandomString 函数根据指定的条件生成随机字符串。 可在此处确定允许的字符。
必选/重复
Number
随机字符串的总长度。 这应该大于或等于 MinimumNumbers、MinimumSpecialCharacters 和 MinimumCapital 的总长度。 最多 256 个字符。
MinimumNumbers
Number
随机字符串的最小数目。
MinimumSpecialCharacters
Number
特殊字符的最小数目。
MinimumCapital
Number
随机字符串中大写字母的最小数目。
MinimumLowerCase
Number
随机字符串中小写字母的最小数目。
CharactersToAvoid
String
生成随机字符串时要排除的字符。
示例 1： - 生成无特殊字符限制的随机字符串：RandomString(6,3,0,0,3)生成包含 6 个字符的随机字符串。 字符串包含 3 个数字和 3 个小写字符 (1a73qt)。
示例 2： - 生成有特殊字符限制的随机字符串：RandomString(10,2,2,2,1,"?,")生成包含 10 个字符的随机字符串。 字符串至少包含 2 个数字、2 个特殊字符、2 个大写字母、1 个小写字母，并排除字符“?”和“,”（例如 1@!2BaRg53）。
Redact
函数：Redact()
说明：Redact 函数将预配日志中的属性值替换为字符串字面量“[Redact]”。
必选/重复
例 1：编校属性：Redact([userPrincipalName])从预配日志中删除 userPrincipalName。
例 2：编校字符串：Redact("StringToBeRedacted")从预配日志中删除常量字符串。
例3：编校随机字符串：Redact(RandomString(6,3,0,0,3))从预配日志中删除随机字符串。
RemoveDuplicates
函数：RemoveDuplicates(attribute)
说明：RemoveDuplicates 函数取多值字符串，并确保每个值唯一。
必选/重复
Replace
函数：Replace(source, oldValue, regexPattern, regexGroupName, replacementValue, replacementAttributeName, template)
说明：以区分大小写的方式替换字符串中的值。 该函数的行为因提供的参数而异：
当提供了 oldValue 和 replacementValue 时：
将 source 中出现的所有 oldValue 替换为 replacementValue
当提供了 oldValue 和 template 时：
将 template 中出现的所有 oldValue 替换为 source 值
如果已提供 regexPattern 和 replacementValue：
函数将 regexPattern 应用到 source 字符串，你可以使用 regex 组名称来构造 replacementValue 的字符串。
当提供 regexPattern、regexGroupName、replacementValue 时：
函数将 regexPattern 应用到 source 字符串，并将与 regexGroupName 匹配的所有值替换为 replacementValue
如果已提供 regexPattern、regexGroupName 和 replacementAttributeName：
如果 source 具有值，则返回 source
如果 source 没有值，则函数会将 regexPattern 应用到 replacementAttributeName 并返回与 regexGroupName 相匹配的值
必选/重复
String
source 中要替换的值的正则表达式模式。 当使用 replacementAttributeName 时，将应用 regexPattern 提取 replacementAttributeName 中的值。
regexGroupName
String
regexPattern 中的组名称。 使用指定的 replacementAttributeName 时，我们将从 replacementAttributeName 中提取指定正则表达式组的值，并将其返回为替换值。
replacementValue
String
用于替换旧值的新值。
replacementAttributeName
String
用于替换值的属性的名称
template
String
当提供 template 值时，会在模板中查找 oldValue 并将其替换为 source 值。
使用正则表达式替换字符
          示例 1：使用 oldValue 和 replacementValue 将整个 source 字符串替换为另一个字符串。
假设你的 HR 系统具有 BusinessTitle 属性。 作为最近的职务更改的一部分，你的公司希望将业务头衔为“Product Developer”的全部人员更新为“Software Engineer”。
在这种情况下，可以在属性映射中使用以下表达式。
Replace([BusinessTitle],"Product Developer", , , "Software Engineer", , )
              source：[BusinessTitle]
          oldValue：“Product Developer”
          replacementValue：“Software Engineer”
          表达式输出：Software Engineer
          示例 2：使用 oldValue 和 template 将 source 字符串插入另一模板化字符串。
此方案中的 oldValue 参数为误用。 我们将在实际应用过程中替换该值。

假设你希望始终以 <username>@contoso.com 格式生成登录 ID。 有一个名为 UserID 的源属性，你希望该值用于登录 ID 的 <username> 部分。
在这种情况下，可以在属性映射中使用以下表达式。
Replace([UserID],"<username>", , , , , "<username>@contoso.com")
              source：[UserID] =“jsmith”
              oldValue：“<username>”
              template：“<username>@contoso.com”
              表达式输出：“jsmith@contoso.com”
          示例 3：使用 regexPattern 和 replacementValue 提取部分 source 字符串，并将其替换为空字符串或使用正则表达式模式或正则表达式组名称生成的自定义值。
假设源属性 telephoneNumber 包含以空格字符分隔的 country code 和 phone number 组件。 例如：+91 9998887777。在这种情况下，可以在属性映射中使用以下表达式来提取 10 位数字的电话号码。
Replace([telephoneNumber], , "\\+(?<isdCode>\\d* )(?<phoneNumber>\\d{10})", , "${phoneNumber}", , )
              source：[telephoneNumber] =“+91 9998887777”
              regexPattern：“\\+(?<isdCode>\\d* )(?<phoneNumber>\\d{10})”
              replacementValue：“${phoneNumber}”
              表达式输出：9998887777
你还可以使用此模式来删除字符和折叠字符串。
例如，下面的表达式在手机号字符串中删除了括号、短划线和空格字符，并只返回数字。
Replace([mobile], , "[()\\s-]+", , "", , )
              source：[mobile] = "+1 (999) 888-7777"
              regexPattern：“[()\\s-]+”
              replacementValue：“”（空字符串）
              表达式输出：19998887777
          示例 4：使用 regexPattern、regexGroupName 和 replacementValue 提取 source 字符串的一部分，并将其替换为另一个文本值或空字符串。
假设源系统属性 AddressLineData 具有两个街道编号和街道名称组件。 作为最近移动的一部分，假设地址的街道号已更改，并且你只想更新地址行的街道号部分。
在这种情况下，可以在属性映射中使用以下表达式来提取街道号。
Replace([AddressLineData], ,"(?<streetNumber>^\\d*)","streetNumber", "888", , )
              source：[AddressLineData] =“545 Tremont Street”
              regexPattern：“(?<streetNumber>^\\d*)”
              regexGroupName：“streetNumber”
              replacementValue：“888”
              表达式输出：888 Tremont Street
下面是另一个示例，我们在其中将 UPN 的域后缀替换为空字符串，以生成不带域后缀的登录 ID。
Replace([userPrincipalName], , "(?<Suffix>@(.)*)", "Suffix", "", , )
              source：[userPrincipalName] =“jsmith@contoso.com”
              regexPattern：“(?<Suffix>@(.)*)”
              regexGroupName：“Suffix”
              replacementValue：“”（空字符串）
              表达式输出：jsmith
          示例 5：使用 regexPattern、regexGroupName 和 replacementAttributeName 处理源属性为空或没有值时的情况。
假设你的源系统具有 telephoneNumber 属性。 如果 telephoneNumber 为空，则需要提取移动电话号码属性的 10 位数字。
在这种情况下，可以在属性映射中使用以下表达式。
Replace([telephoneNumber], , "\\+(?<isdCode>\\d* )(?<phoneNumber>\\d{10})", "phoneNumber" , , [mobile], )
              source：[telephoneNumber] =“”（空字符串）
              regexPattern：“\\+(?<isdCode>\\d* )(?<phoneNumber>\\d{10})”
              regexGroupName：“phoneNumber”
              replacementAttributeName：[mobile] =“+91 8887779999”
              表达式输出：8887779999
              示例 6：你需要查找与正则表达式值匹配的字符并将其删除。
Replace([mailNickname], , "[a-zA-Z_]*", , "", , )
              source：[mailNickname]
              oldValue：“john_doe72”
              replaceValue：“”
              表达式输出：72
SelectUniqueValue
函数：SelectUniqueValue(uniqueValueRule1, uniqueValueRule2, uniqueValueRule3, …)
说明：需要至少两个自变量，这些自变量是使用表达式定义的唯一值生成规则。 此函数会评估每个规则，然后在目标应用/目录中检查生成的值的唯一性。 将返回找到的第一个唯一值。 如果所有值都已存在于目标中，则会托管该条目并在审核日志中记录原因。 可以提供的参数数目没有上限。
此函数必须是顶级函数，不能嵌套。
此函数不能应用到具有匹配优先级的属性。
此函数仅供用于创建条目。 将其与属性一起使用时，请将“应用映射”属性设置为“仅在创建对象期间”。

目前只有“Workday 到 Azure Active Directory 的用户预配”和“SuccessFactors 到 Active Directory 的用户预配”支持此函数。 此函数不可用于其他预配应用程序。
SelectUniqueValue 函数在本地 Active Directory 中执行的 LDAP 搜索不会转义特殊字符（如音调符号）。 如果传递包含特殊字符的字符串（如“Jéssica Smith”），则会遇到处理错误。 嵌套下例中所示的 NormalizeDiacritics 函数来规范特殊字符。
必选/重复
为 userPrincipalName (UPN) 属性生成唯一值
示例：你需要根据用户的名字、中间名和姓氏为 UPN 特性生成值，并在将该值分配给 UPN 特性之前在目标 AD 目录中检查其唯一性。
    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")
示例输入/输出：
输入 (PreferredFirstName)："John"
输入 (PreferredLastName)："Smith"
输出："John.Smith@contoso.com"，如果 UPN 值 John.Smith@contoso.com 尚未存在于目录中
输出："J.Smith@contoso.com"，如果 UPN 值 John.Smith@contoso.com 已存在于目录中
输出："Jo.Smith@contoso.com"，如果上面的两个值已存在于目录中
SingleAppRoleAssignment
函数：SingleAppRoleAssignment([appRoleAssignments])
说明：对于给定的应用程序，从向一个用户分配的所有 appRoleAssignments 列表中返回单个 appRoleAssignment。 需要此函数才能将 appRoleAssignments 对象转换为单个角色名称字符串。 最佳做法是确保一次给一位用户只分配一个 appRoleAssignment。 如果用户具有多个应用角色分配，则不支持此功能。
必选/重复
将字符串拆分为多值数组
示例：你需要提取一个以逗号分隔的字符串列表，并将这些字符串拆分为可插入到多值特性（例如 Salesforce 的 PermissionSets 特性）的数组。 在此示例中，Azure AD 中的 extensionAttribute5 中填充了一个权限集列表。
表达式：Split([extensionAttribute5], ",")
示例输入/输出：
输入 (extensionAttribute5)："PermissionSetOne, PermissionSetTwo"
              输出：["PermissionSetOne", "PermissionSetTwo"]
StripSpaces
函数：StripSpaces(source)
说明：从源字符串中删除所有空格 (" ") 字符。
必选/重复
函数：Switch(source, defaultValue, key1, value1, key2, value2, …)
说明：当源值匹配某个键时，返回该键的值   。 当 source 值未与任何 key 匹配时，则返回 defaultValue。  Key 和 value 参数必须始终成对出现。 该函数始终需要偶数个参数。 不应该对 manager 等引用属性使用该函数。
Switch 函数会对 source 值和 key 值执行区分大小写的字符串比较。 如果要执行不区分大小写的比较，请在使用嵌套的 ToLower 函数进行比较之前规范化 source 字符串，并确保对所有 key 字符串都使用小写。
示例：Switch(ToLower([statusFlag]), "0", "true", "1", "false", "0")。 在此示例中，source 属性 statusFlag 的值可以为“True”、“true”或“TRUE”。 但是，Switch 函数始终会将其转换为小写字符串“true”，然后再与 key 参数进行比较。
对于 source 参数，请不要使用嵌套函数 IsPresent、IsNull 或 IsNullOrEmpty。 请改用字面量空字符串作为键值之一。

示例：Switch([statusFlag], "Default Value", "true", "1", "", "0")。 在此例中，如果 source 属性 statusFlag 为空，Switch 函数将返回值 0。
必选/重复
示例：根据 Azure AD 中存储的状态代码来定义用户的时区。
如果状态代码与任何预定义选项都不匹配，则使用默认值“澳大利亚/悉尼”。
表达式：Switch([state], "Australia/Sydney", "NSW", "Australia/Sydney","QLD", "Australia/Brisbane", "SA", "Australia/Adelaide")

示例输入/输出：
输入 (state)：“QLD”
输出：“澳大利亚/布里斯班”
ToLower
函数：ToLower(source, culture)
说明：取源字符串值，并使用指定的区域性规则将其转换为小写。 如果没有指定任何区域性信息，则使用固定区域性。

如果要将目标系统中的现有值设置为小写，请更新目标应用程序的架构，并将所需特性的 caseExact 属性设置为“true”。
必选/重复
将生成的 userPrincipalName (UPN) 值转换为小写
示例：你要通过连接 PreferredFirstName 和 PreferredLastName 源字段并将所有字符转换为小写，来生成 UPN 值。
ToLower(Join("@", NormalizeDiacritics(StripSpaces(Join(".",  [PreferredFirstName], [PreferredLastName]))), "contoso.com"))
示例输入/输出：
输入 (PreferredFirstName)："John"
输入 (PreferredLastName)："Smith"
输出：“john.smith@contoso.com”
ToUpper
函数：ToUpper(source, culture)
说明：取源字符串值，并使用指定的区域性规则将其转换为大写。 如果没有指定任何区域性信息，则使用固定区域性。

如果要将目标系统中的现有值设置为大写，请更新目标应用程序的架构，并将所需特性的 caseExact 属性设置为“true”。
必选/重复
函数：Word(String,WordNumber,Delimiters)
说明：Word 函数根据描述要使用的分隔符以及要返回的单词数的参数，返回字符串中包含的单词。 字符串中的字符由分隔符中其中一个字符分隔的每个字符串被标识为单词：
如果数字 < 1，则返回空字符串。
如果字符串为 null，则返回空字符串。
如果字符串包含的单词少于应返回数字或字符串不包含由分隔符标识的任何单词，则返回空字符串。
必选/重复
示例：Word("The quick brown fox",3," ")
返回“brown”。
Word("This,string!has&many separators",3,",!&#")
返回“has”。
本部分提供更多的表达式函数用法示例。
删除已知域名
从用户的电子邮件地址中删除已知域名，以获取用户名。
例如，如果域为“contoso.com”，则可以使用以下表达式：
              表达式：Replace([mail], "@contoso.com", , ,"", ,)
示例输入/输出：
输入 (mail)：“john.doe@contoso.com”
              输出：“john.doe”
通过连接名字和姓氏部分来生成用户别名
取用户名字的前 3 个字母和用户姓氏的前 5 个字母生成用户别名。
表达式：Append(Mid([givenName], 1, 3), Mid([surname], 1, 5))

示例输入/输出：
输入 (givenName)：“John”
输入 (surname)：“Doe”
              输出：“JohDoe”
在姓氏和名字之间添加英文逗号。
在姓氏和名字之间添加英文逗号。
表达式：Join(", ", "", [surname], [givenName])

示例输入/输出：
输入 (givenName)：“John”
输入 (surname)：“Doe”
输出：“Doe, John”
在 SaaS 应用中自动预配和取消预配用户
为用户预配自定义属性映射
用于用户预配的作用域筛选器
使用 SCIM 启用从 Azure Active Directory 到应用程序的用户和组自动预配
帐户预配通知
有关如何集成 SaaS 应用的教程列表