高级账户字段表达式

函数名

函数定义

说明

举例

Append

Append(str1, str2, ..., strn)

拼接输入参数为新的字符串，等于str1+str2+...。

• 输入：Append("str1", "@example.com")

• 输出： str1@example.com

Join

Join(source1, source2, ..., sourceN, separator)

将多个源值拼接为一个字符串，源值间用分隔符分隔。

• 输入：Join("str1", "str2", 123,"-")

• 输出："str1-str2-123"

Coalesce

Coalesce(source1, source2, ..., sourceN, defaultValue)

返回输入参数中第一个非空参数，若参数都为空，则返回null，其中非空指非null且参数长度大于0。

• 输入：Coalesce("", user.phoneRegion, "86")

• 输出：当手机号区号为空即缺失时，输出为 86

IIF

IIF(condition, whenTrue, whenFalse)

三目运算。根据condition的结果返回不同的值，为true时返回whenTrue，为false时返回whenFalse。

示例1：

• 输入：IIF(true, 1, 2)

• 输出：1

示例2：

• 输入：IIF(false, 1, 2)

• 输出：2

IsNull

IsNull(value)

当value为null即缺失时，输出为true。

示例1：

• 输入：IsNull(null)

• 输出：输出为true

示例2：

• 输入：IsNull("")

• 输出：输出为false

IsNullOrEmpty

IsNullOrEmpty(value)

当value为null或空字符串时，输出为true。

示例1：

• 输入：IsNullOrEmpty(user.email)

• 输出：当邮箱为null即缺失时，输出为true

示例2：

• 输入：IsNullOrEmpty("")

• 输出：输出为true

Now

Now()

返回表示当前UTC DateTime的字符串，格式为 yyyy-MM-dd'T'HH:mm:ssXXX。

• 输出：2021-11 01T09:52:11Z

StringReplace

StringReplace("hello $VariableName", "$VariableName", ReplaceString)

普通字符串替换。

• 输入：StringReplace("hello $str", "$str", "world")

• 输出：hello world

Trim

Trim(source)

去除源值字符串前后的空白字符。

• 输入：Trim(" 123 ")

• 输出：123

TrimLeft

TrimLeft(source)

去除源值字符串左侧的空白字符。

• 输入：TrimLeft(" 123 ")

• 输出：123

TrimRight

TrimRight(source)

去除源值字符串右侧的空白字符。

• 输入：TrimRight(" 123 ")

• 输出： 123

ToLower

ToLower(source)

字符串变为全大写或全小写。

• 输入：ToLower(" Abc ")

• 输出：abc

ToUpper

ToUpper(source)

字符串变为全大写。

• 输入：ToUpper(" Abc ")

• 输出：ABC

Substring

Substring(source, fromIndex, endIndex)

返回字符串的子字符串，即子字符串下标地址为 [fromIndex, endIndex]。

• source：必须，源字符串，可为语法支持的任意类型。

• fromIndex：必须，整数类型。非整型时返回null。

• endIndex：必须，整数类型。非整型时返回null。

示例1：

• 输入：Substring("0123456", 1, 5)

• 输出：1234

示例2：

• 输入：Substring("0123456", -1, 7)

• 输出：0123456

示例3：

• 输入：Substring("0123456", "1", 5)

• 输出：null

SubstringBefore

SubstringBefore(source, subString)

返回源字符串中从左到右匹配到的第一个目标字符串后的字串。若目标字符串不存在，则返回null。

参数：

• source：必须，源字符串，可为语法支持的任意类型。

• target：必须，目标字符串，可为语法支持的任意类型。

返回值：string

示例1：

• 输入：SubstringBefore("test@example@com", "@")

• 输出："test"

Array

Array(source1, source2,...)

将多个值组合成为数组。值可为Object类型。

• 输入：Array(1, 2, 3)

• 输出：[1, 2, 3]

ArrayAdd

ArrayAdd(Array(), "test")

在数组对象中添加一个数组。

• 输入：ArrayAdd(Array(), "test")

• 输出：["test"]

ArrayMap

ArrayMap($ArrayObject, __item.ObjectProperty)

取数组对象中的某个属性的值形成新的数组。

取用户中所属组的ID列表：

• 输入：ArrayMap(user.groups, __item.groupId)

• 输出：["groupId1","groupId2","groupId3"]

ArrayIndex

ArrayIndex(Array(), n)

取Array第几个元素，从0开始。

• 输入：ArrayIndex(Array(1,2,3), 0)

• 输出：1

ArrayJoin

ArrayJoin(Array(), str)

数组以某个字符串拼接。

• 输入：ArrayJoin(Array(1,2,3), "-")

• 输出："1-2-3"

Object

Object(key1, value1, key2, value2, ...)

通过制定键值对组合成为Object对象。

支持零个或偶数个参数。

• 输入 Object("key1", "value1", "key2", "value2")

• 输出对应对象。

{"key1": "value1", "key2": "value2"}

ObjectIndex

ObjectIndex(user, "username")

指定对象的某个属性的值

代码 ObjectIndex(user, "username") 等价于 user.username

ObjectToJsonString

ObjectToJsonString(user.groups)

对象转JSON字符串。

-

Contains

Contains(str1,str2)

判断是否包含，返回true,false。

示例1：

• 输入：Contains("test", "t")

• 输出：true

示例2：

• 输入：Contains("test", "a")

• 输出：false

Or

Or(true,false,...,true)

或的方式判断多个条件，有一个条件为true，则为true。

示例1：

• 输入：Or(true,false)

• 输出：true

示例2：

• 输入：Or(true,true,false)

• 输出：true

示例3：

• 输入：Or(false,false)

• 输出：false

And

And(true,false,...,true)

且的方式判断多个条件，有一个条件为false，则为false。

示例1：

• 输入：And(true,false)

• 输出：false

示例2：

• 输入：And(true,true,false)

• 输出：false

示例3：

• 输入：And(true,true,true)

• 输出：true

xOr

xOr(true,false,...,true)

有且只能有2个条件。

如果都为true或者都为false,则返回false。

如果同时存在true,false的条件，则返回true。

示例1：

• 输入：xOr(true,false)

• 输出：true

示例2：

• 输入：xOr(true,true)

• 输出：false

示例3：

• 输入：And(false,false)

• 输出：false

StartsWith

StartsWith(str1, str2)

判断字符串以...开头，只能包含2个参数。

示例1：

• 输入：StartsWith("test", "t")

• 输出：true

示例2：

• 输入：StartsWith("test", "e")

• 输出：false

Split

Split("str1,str2,str3")

字符串分割后，返回一个数组。

示例1：

• 输入：Split("str1,str2,str3",",")

• 输出：Array(str1,str2,str3)

Equals

Equals(str1,str2)

比较2个字符串是否一致。

Equals(str1,str2)。

Equals(str1,str2,false) 不忽略大小写比较。

Equals(str1,str2,true) 忽略大小写比较。

示例1：

• 输入：Equals("test","Test")

• 输出：false

示例2：

• 输入：Equals("test","Test",true)

• 输出：true

示例3：

• 输入：Equals("test","Test",false)

• 输出：false

CurrentTimeMillis

CurrentTimeMillis()

当前时间UNIX时间戳，单位毫秒。

-

SamlArray

SamlArray(Array())

仅SAML SSO可用。

输入：

SamlArray(Array("group1","group2"))

• SAML Response输出。

<saml2:Attribute Name="grouIdArray"

NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:unspecified">

<saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:type="xsd:string">

group1

</saml2:AttributeValue>

<saml2:AttributeValue xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xsd:string">

group2

</saml2:AttributeValue>

• 输入：SamlArray(Array("group1","group2"))

• SAML Response输出。

</saml2:Attribute>

ExtractPhoneRegion

ExtractPhoneRegion(source, defaultRegion,autoAppendPlusSignal)

提取手机号中的区号。

• source: 手机号。

• autoAppendPlusSignal：是否自动补充+号。true为自动补充，false为不补充。

• defaultRegion：手机区号默认的国家或地区。国家或地区的编码请参考ISO 3166 Country Codes标准，使用Alpha-2 code（https://www.iso.org/obp/ui/#search）。如CN，US，TW等。

  • 如果手机号里面携带了区号，并且区号前面有+号，可以不传入autoAppendPlusSignal和deafaultRegion。

  • 如果手机号里面携带区号，但区号前没有+号，需要传入autoAppendPlusSignal=true，defaultRegion为默认的国家或地区编码。

  • 如果手机号里面不携带区号，想要设置默认区号，需要传入autoAppendPlusSignal=false，defaultRegion为默认的国家或地区编码。

示例1：

如果手机号为：+86131xxxxx000，+86 131xxxxx000, +86-131xxxxx000

• 输入：ExtractPhoneRegion(idpUser.mobile)

• 返回：86

示例2：

如果手机号为86131xxxxx000，86 131xxxxx000, 86-131xxxxx000

• 输入：ExtractPhoneRegion(idpUser.mobile，"CN",true)

• 返回：86

示例3：

如果手机号为131xxxxx000

• 输入：ExtractPhoneRegion(idpUser.mobile，"CN",false)

• 返回：86

ExtractPhoneNumber

ExtractPhoneNumber(source, defaultRegion,autoAppendPlusSignal)

提取手机号中的真实手机号(不含区号)。

• source: 手机号。

• autoAppendPlusSignal：是否自动补充+号。true为自动补充，false为不补充。

• defaultRegion：手机区号默认的国家或地区。国家或地区的编码请参考ISO 3166 Country Codes标准，使用Alpha-2 code（https://www.iso.org/obp/ui/#search）。如CN，US，TW等。

  • 如果手机号里面携带了区号，并且区号前面有+号，可以不传入autoAppendPlusSignal和deafaultRegion。

  • 如果手机号里面携带区号，但区号前没有+号，需要传入autoAppendPlusSignal=true，defaultRegion为默认的国家或地区编码。

  • 如果手机号里面不携带区号，想要设置默认区号，需要传入autoAppendPlusSignal=false，defaultRegion为默认的国家或地区编码。

示例1：

如果手机号为：+86131xxxxx000，+86 131xxxxx000, +86-131xxxxx000

• 输入：ExtractPhoneNumber(idpUser.mobile)

• 返回：131xxxxx000

示例2：

如果手机号为：86131xxxxx000，86 131xxxxx000, 86-131xxxxx000

• 输入：ExtractPhoneNumber(idpUser.mobile，"CN",true)

• 返回：131xxxxx000

示例3：

如果手机号为：131xxxxx000

• 输入：ExtractPhoneNumber(idpUser.mobile，"CN",false)

• 返回：131xxxxx000