文档Experience Platform数据准备指南

数据准备映射函数

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • undefined

数据准备函数可用于根据在源字段中输入的内容计算和计算值。

字段

字段名称可以是任何合法标识符 — 由字母、美元符号($)或下划线字符(_)开头的Unicode字母和数字构成的无限长序列。 变量名称也区分大小写。

如果字段名称不遵循此约定，则字段名称必须用${}括起来。 因此，例如，如果字段名称为“First Name”或“First.Name”，则名称必须分别像${First Name}或${First\.Name}一样换行。

TIP
与层次结构交互时，如果子属性具有句点(.)，则必须使用反斜杠(\)对特殊字符进行转义。 有关详细信息，请阅读转义特殊字符的指南。

如果字段名称是以下保留关键字的​ any，则必须使用${}{}括起来：

new, mod, or, break, var, lt, for, false, while, eq, gt, div, not, null, continue, else, and, ne, true, le, if, ge, return, _errors, do, function, empty, size

此外，保留的关键字还包括此页面上列出的任何映射器函数。

可使用点表示法访问子字段中的数据。 例如，如果存在name对象，要访问firstName字段，请使用name.firstName。

函数列表

下表列出了所有支持的映射函数，包括示例表达式及其生成的输出。

字符串函数 string

NOTE
请向左/向右滚动以查看表格的全部内容。
函数
描述
参数
语法
表达式
示例输出
concat
连接给定的字符串。
  • STRING：将连接的字符串。
concat(STRING_1， STRING_2)
concat（“嗨，”，“那里”，“！”）
"Hi, there!"
分解
根据正则表达式拆分字符串并返回部分的数组。 可以选择包含正则表达式以拆分字符串。 默认情况下，拆分解析为“，”。 以下分隔符​ 需要 ​使用\进行转义： +, ?, ^, |, ., [, (, {, ), *, $, \如果您包含多个字符作为分隔符，则分隔符将被视为多字符分隔符。
  • 字符串： 必需 ​需要拆分的字符串。
  • REGEX： 可选 ​可用于拆分字符串的正则表达式。
explode(STRING， REGEX)
explode（“嗨，那里！”，“ ”）
["Hi,", "there"]
实例
返回子字符串的位置/索引。
  • 输入： 必需 ​正在搜索的字符串。
  • SUBSTRING： 必需 ​在字符串中搜索的子字符串。
  • START_POSITION： 可选 ​字符串中开始查找的位置。
  • 发生次数： 可选 ​要从起始位置查找的第n个发生次数。 默认情况下，该值为1。
instr(INPUT， SUBSTRING， START_POSITION， OCCURRENCE)
instr(“adobe.com”，“com”)
6
替换器
替换原始字符串中存在的搜索字符串。
  • 输入： 必需 ​输入字符串。
  • TO_FIND： 必需 ​要在输入中查找的字符串。
  • TO_REPLACE： 必需 ​将替换“TO_FIND”中的值的字符串。
replacestr(INPUT， TO_FIND， TO_REPLACE)
replacestr("This is a string re test"， "re"， "replace")
“这是一个字符串替换测试”
substr
返回给定长度的子字符串。
  • 输入： 必需 ​输入字符串。
  • START_INDEX： 必需 ​子字符串开始处的输入字符串的索引。
  • 长度： 必需 ​子字符串的长度。
substr(INPUT， START_INDEX， LENGTH)
substr（“这是一个子字符串测试”，7、8）
"一个子集"
小写/
lcase
将字符串转换为小写。
  • 输入： 必需 ​将转换为小写的字符串。
lower(INPUT)
lower(“HeLlO”)
lcase(“HeLlO”)
"hello"
upper /
ucase
将字符串转换为大写。
  • 输入： 必需 ​将转换为大写的字符串。
upper(INPUT)
upper(“HeLlO”)
ucase(“HeLlO”)
“HELLO”
split
在分隔符上拆分输入字符串。 以下分隔符​ 需要 ​使用\进行转义： \。 如果您包含多个分隔符，则字符串将拆分到字符串中存在的​ any ​个分隔符中。 注意： ​此函数只从字符串返回非null索引，而不管是否存在分隔符。 如果结果数组中需要所有索引（包括null），请改用“explode”函数。
  • INPUT： 必需 ​要拆分的输入字符串。
  • SEPARATOR： 必需 ​用于拆分输入的字符串。
split（输入，分隔符）
split(“Hello world”，“ ”)
["Hello", "world"]
加入
使用分隔符连接对象列表。
  • 分隔符： 必需 ​用于连接对象的字符串。
  • 对象： 必需 ​将要联接的字符串数组。
join(SEPARATOR, [OBJECTS])
join(" ", to_array(true, "Hello", "world"))
“Hello world”
lpad
将字符串的左侧与另一个给定的字符串填充。
  • 输入： 必需 ​要填充的字符串。 此字符串可以为null。
  • 计数： 必需 ​要填充的字符串的大小。
  • 填充： 必需 ​用于填充输入的字符串。 如果为null或为空，则将被视为单个空格。
lpad（输入、计数、填充）
lpad(“bat”， 8， “yz”)
"yzybat"
rpad
将字符串的右侧与另一个给定的字符串相贴合。
  • 输入： 必需 ​要填充的字符串。 此字符串可以为null。
  • 计数： 必需 ​要填充的字符串的大小。
  • 填充： 必需 ​用于填充输入的字符串。 如果为null或为空，则将被视为单个空格。
rpad（输入、计数、填充）
rpad(“bat”， 8， “yz”)
“batyzyzy”
左侧
获取给定字符串的前“n”个字符。
  • 字符串： 必需 ​要获取前“n”个字符的字符串。
  • 计数： 必需 ​要从字符串中获取的“n”个字符。
left(STRING， COUNT)
left(“abcde”， 2)
"ab"
右
获取给定字符串的最后“n”个字符。
  • 字符串： 必需 ​要获取最后“n”个字符的字符串。
  • 计数： 必需 ​要从字符串中获取的“n”个字符。
right(STRING， COUNT)
right(“abcde”， 2)
"de"
ltrim
删除字符串开头的空格。
  • 字符串： 必需 ​要删除空白的字符串。
ltrim(STRING)
ltrim(" hello")
"hello"
rtrim
删除字符串末尾的空格。
  • 字符串： 必需 ​要删除空白的字符串。
rtrim(STRING)
rtrim(“hello ”)
"hello"
trim
删除字符串开头和结尾的空格。
  • 字符串： 必需 ​要删除空白的字符串。
trim(STRING)
trim(" hello ")
"hello"
等于
比较两个字符串以确认它们是否相等。 此函数区分大小写。
  • STRING1： 必需 ​要比较的第一个字符串。
  • STRING2： 必需 ​要比较的第二个字符串。
STRING1. ​equals(​STRING2)
“string1”。​equals​("STRING1")
false
equalsIgnoreCase
比较两个字符串以确认它们是否相等。 此函数为​ 而非 ​区分大小写。
  • STRING1： 必需 ​要比较的第一个字符串。
  • STRING2： 必需 ​要比较的第二个字符串。
STRING1. ​equalsIgnoreCase​(STRING2)
“string1”。​equalsIgnoreCase​("STRING1)
true

正则表达式函数

函数
描述
参数
语法
表达式
示例输出
extract_regex
根据正则表达式从输入字符串中提取组。
  • 字符串： 必需 ​从中提取组的字符串。
  • REGEX： 必需 ​您希望组匹配的正则表达式。
extract_regex(STRING， REGEX)
extract_regex​("E259，E259B_009,1_1"​， "([，]+)，[，]*，([^，]+)")
["E259，E259B_009,1_1"，"E259"，"1_1"]
matches_regex
检查字符串是否与输入的正则表达式匹配。
  • 字符串： 必需 ​要检查的字符串与正则表达式匹配。
  • REGEX： 必需 ​要与之进行比较的正则表达式。
matches_regex(STRING， REGEX)
matches_regex("E259，E259B_009,1_1"， "([，]+)，[，]*，([^，]+)")
true

哈希函数 hashing

NOTE
请向左/向右滚动以查看表格的全部内容。
函数
描述
参数
语法
表达式
示例输出
sha1
接受输入并使用安全哈希算法1 (SHA-1)生成哈希值。
  • 输入： 必需 ​要散列的纯文本。
  • CHARSET： 可选 ​字符集的名称。 可能的值包括UTF-8、UTF-16、ISO-8859-1和US-ASCII。
sha1（输入，字符集）
sha1（“我的文本”，“UTF-8”）
c3599c11e47719df18a24​48690840c5dfcce3c80
sha256
采用输入并使用安全哈希算法256 (SHA-256)生成哈希值。
  • 输入： 必需 ​要散列的纯文本。
  • CHARSET： 可选 ​字符集的名称。 可能的值包括UTF-8、UTF-16、ISO-8859-1和US-ASCII。
sha256（输入，字符集）
sha256（“我的文本”，“UTF-8”）
7330d2b39ca35eaf4cb95fc846c21​ee6a39af698154a83a586ee270a0d372104
sha512
采用输入并使用安全哈希算法512 (SHA-512)生成哈希值。
  • 输入： 必需 ​要散列的纯文本。
  • CHARSET： 可选 ​字符集的名称。 可能的值包括UTF-8、UTF-16、ISO-8859-1和US-ASCII。
sha512（输入，字符集）
sha512（“我的文本”，“UTF-8”）
a3d7e45a0d9be5fd4e4b9a3b8c9c2163c21ef​708bf11b4232bb21d2a8704ada2cdcd7b367dd0788a89​a5c908cfe377aceb1072a7b7d4fd2ff68a fd24d16
md5
接受输入并使用MD5生成哈希值。
  • 输入： 必需 ​要散列的纯文本。
  • CHARSET： 可选 ​字符集的名称。 可能的值包括UTF-8、UTF-16、ISO-8859-1和US-ASCII。
md5（输入，字符集）
md5（“我的文本”，“UTF-8”）
d3b96ce8c9fb4​e9bd0198d03ba6852c7
crc32
取一个输入使用循环冗余校验(CRC)算法来生成32位循环代码。
  • 输入： 必需 ​要散列的纯文本。
  • CHARSET： 可选 ​字符集的名称。 可能的值包括UTF-8、UTF-16、ISO-8859-1和US-ASCII。
crc32（输入，字符集）
crc32（“我的文本”，“UTF-8”）
8df92e80

URL函数 url

NOTE
请向左/向右滚动以查看表格的全部内容。
函数
描述
参数
语法
表达式
示例输出
get_url_protocol
从给定URL返回协议。 如果输入无效，则返回空值。
  • URL： 必需 ​需要从中提取协议的URL。
get_url_protocol​(URL)
get_url_protocol("https://platform​.adobe.com/home")
https
get_url_host
返回给定URL的主机。 如果输入无效，则返回空值。
  • URL： 必需 ​需要从中提取主机的URL。
get_url_host​(URL)
get_url_host​("https://platform​.adobe.com/home")
platform.adobe.com
get_url_port
返回给定URL的端口。 如果输入无效，则返回空值。
  • URL： 必需 ​需要从中提取端口的URL。
get_url_port(URL)
get_url_port​("sftp://example.com//home/​joe/employee.csv")
22
get_url_path
返回给定URL的路径。 默认情况下，将返回完整路径。
  • URL： 必需 ​需要从中提取路径的URL。
  • FULL_PATH： 可选 ​一个布尔值，用于确定是否返回完整路径。 如果设置为false，则仅返回路径的结尾。
get_url_path​(URL， FULL_PATH)
get_url_path​("sftp://example.com//​home/joe/employee.csv")
"//home/joe/​employee.csv"
get_url_query_str
返回给定URL的查询字符串作为查询字符串名称和查询字符串值的映射。
  • URL： 必需 ​尝试从中获取查询字符串的URL。
  • 锚点： 必需 ​确定如何处理查询字符串中的锚点。 可以是以下三个值之一：“保留”、“移除”或“附加”。

    如果该值为“保留”，则锚点将附加到返回的值。
    如果值为“remove”，则将从返回值中删除锚点。
    如果值为“附加”，则锚点将作为单独值返回。
get_url_query_str​(URL， ANCHOR)
get_url_query_str​("foo://example.com:8042​/over/there？name=​ferret#nose"， "retain")
get_url_query_str​("foo://example.com:8042​ ​ ​ ​ ​/over/there？name=ferret#nose"， "remove")
get_url_query_str("foo://example.com：8042/over/there？name=ferret#nose"， "append")
{"name": "ferret#nose"}
{"name": "ferret"}
{"name": "ferret", "_anchor_": "nose"}
get_url_encoded
此函数将URL作为输入，并使用ASCII字符替换或编码特殊字符。 有关特殊字符的详细信息，请阅读本文档附录中的特殊字符列表。
  • URL： 必需 ​包含要替换或编码为ASCII字符的特殊字符的输入URL。
get_url_encoded(URL)
get_url_encoded("https：//example.com/partneralliance_asia-pacific_2022")
https%3A%2F%2Fexample.com%2Fpartneralliance_asia-pacific_2022
get_url_decoded
此函数以URL作为输入并将ASCII字符解码为特殊字符。 有关特殊字符的详细信息，请阅读本文档附录中的特殊字符列表。
  • URL： 必需 ​包含要解码为特殊字符的ASCII字符的输入URL。
get_url_decoded(URL)
get_url_decoded("https%3A%2F%2Fexample.com%2Fpartneralliance_asia-pacific_2022")
https：//example.com/partneralliance_asia-pacific_2022

日期和时间函数 date-and-time

NOTE
请向左/向右滚动以查看表格的全部内容。 有关date函数的更多信息，请参阅数据格式处理指南的日期部分。
函数
描述
参数
语法
表达式
示例输出
now
检索当前时间。
now()
now()
2021-10-26T10:10:24Z
时间戳
检索当前Unix时间。
timestamp()
timestamp()
1571850624571
格式
根据指定的格式设置输入日期的格式。
  • 日期： 必需 ​要设置格式的输入日期，即ZonedDateTime对象。
  • 格式： 必需 ​要将日期更改为的格式。
format（日期，格式）
format(2019-10-23T11:24:00+00:00， "yyyy-MM-dd HH:mm:ss")
2019-10-23 11:24:35
dformat
根据指定的格式将时间戳转换为日期字符串。
  • 时间戳： 必需 ​要设置格式的时间戳。 这是以毫秒为单位编写的。
  • 格式： 必需 ​您希望时间戳变为的格式。
dformat(TIMESTAMP， FORMAT)
dformat(1571829875000， "yyyy-MM-dd'T'HH:mm:ss.SSSX")
2019-10-23T11:24:35.000Z
日期
将日期字符串转换为ZonedDateTime对象（ISO 8601格式）。
  • 日期： 必需 ​表示日期的字符串。
  • 格式： 必需 ​表示源日期格式的字符串。注意： ​这​ 不 ​表示要将日期字符串转换为的格式。
  • DEFAULT_DATE： 必需 ​如果提供的日期为null，则返回默认日期。
date(DATE， FORMAT， DEFAULT_DATE)
date("2019-10-23 11:24"， "yyyy-MM-dd HH：mm"， now())
2019-10-23T11:24:00Z
日期
将日期字符串转换为ZonedDateTime对象（ISO 8601格式）。
  • 日期： 必需 ​表示日期的字符串。
  • 格式： 必需 ​表示源日期格式的字符串。注意： ​这​ 不 ​表示要将日期字符串转换为的格式。
日期（日期，格式）
date("2019-10-23 11:24"， "yyyy-MM-dd HH：mm")
2019-10-23T11:24:00Z
日期
将日期字符串转换为ZonedDateTime对象（ISO 8601格式）。
  • 日期： 必需 ​表示日期的字符串。
date(DATE)
date("2019-10-23 11:24")
“2019-10-23T11:24:00Z”
date_part
检索日期的各个部分。 支持以下组件值：

"year"
"yyyy"
"yy"

"quarter"
"qq"
"q"

"month"
"mm"
"m"

"dayofyear"
"dy"
"y"

"day"
"dd"
"d"

"week"
"w"

"weekday"
"dw"
"w"

"hour"
"hh"
"hh24"
"hh12"

"minute"
"mi"
"n"

"second"
"ss"
"s"

"millisecond"
"SSS"
  • 组件： 必需 ​表示日期部分的字符串。
  • 日期： 必需 ​标准格式的日期。
date_part​(COMPONENT， DATE)
date_part("MM"， date("2019-10-17 11:55:12")
10
set_date_part
替换给定日期中的组件。 接受以下组件：

"year"
"yyyy"
"yy"

"month"
"mm"
"m"

"day"
"dd"
"d"

"hour"
"hh"

"minute"
"mi"
"n"

"second"
"ss"
"s"
  • 组件： 必需 ​表示日期部分的字符串。
  • 值： 必需 ​为给定日期的组件设置的值。
  • 日期： 必需 ​标准格式的日期。
set_date_part​(COMPONENT， VALUE， DATE)
set_date_part("m"， 4， date("2016-11-09T11:44:44.797")
“2016-04-09T11:44:44Z”
make_date_time
从部件创建日期。 此函数也可以使用make_timestamp进行感应。
  • YEAR： 必需 ​用四位数字表示的年份。
  • 月份： 必需 ​月份。 允许的值为1到12。
  • 日： 必需 ​日。 允许的值为1到31。
  • 小时：必需 ​小时。 允许的值为0到23。
  • MINUTE： 必需 ​分钟。 允许的值为0到59。
  • NANOSECOND： 必需 ​纳秒值。 允许的值为0到999999999。
  • 时区： 必需 ​日期时间的时区。
make_date_time​（年、月、日、小时、分钟、秒、纳秒、时区）
make_date_time​（2019， 10， 17， 11， 55， 12， 999，“美国/洛杉矶”）
2019-10-17T11:55:12Z
zone_date_to_utc
将任何时区的日期转换为UTC格式的日期。
  • 日期： 必需 ​尝试转换的日期。
zone_date_to_utc​(DATE)
zone_date_to_utc​(2019-10-17T11:55:​12 PST
2019-10-17T19:55:12Z
zone_date_to_zone
将日期从一个时区转换为另一个时区。
  • 日期： 必需 ​尝试转换的日期。
  • 区域： 必需 ​您尝试将日期转换为的时区。
zone_date_to_zone​(DATE， ZONE)
zone_date_to_utc​(now(), "Europe/Paris")
2021-10-26T15:43:59Z

层次结构 — 对象 objects

NOTE
请向左/向右滚动以查看表格的全部内容。
函数
描述
参数
语法
表达式
示例输出
is_empty
检查对象是否为空。
  • 输入： 必需 ​您尝试检查的对象为空。
is_empty(INPUT)
is_empty([1, null, 2, 3])
false
arrays_to_object
创建对象列表。
  • 输入： 必需 ​键和数组对的分组。
arrays_to_object(INPUT)
arrays_to_objects('sku', explode("id1|id2", '\\|'), 'price', [22.5,14.35])
[{ "sku": "id1", "price": 22.5 }, { "sku": "id2", "price": 14.35 }]
to_object
根据给定的平面键/值对创建对象。
  • 输入： 必需 ​键/值对的平面列表。
to_object(INPUT)
to_object​(“firstName”、“John”、“lastName”、“Doe”)
{"firstName": "John", "lastName": "Doe"}
str_to_object
从输入字符串创建对象。
  • 字符串： 必需 ​正在分析以创建对象的字符串。
  • VALUE_DELIMITER： 可选 ​用于将字段与值分开的分隔符。 默认分隔符为:。
  • FIELD_DELIMITER： 可选 ​用于分隔字段值对的分隔符。 默认分隔符为,。
str_to_object​(STRING， VALUE_DELIMITER， FIELD_DELIMITER) 注意：您可以使用get()函数以及str_to_object()来检索字符串中键的值。
  • 示例#1： str_to_object("firstName - John ； lastName - ； - 123 345 7890"， "-"， "；")
  • 示例#2： str_to_object("firstName - John ； lastName - ； phone - 123 456 7890"， "-"， "；")。get("firstName")
  • 示例#1：{"firstName": "John", "lastName": "Doe", "phone": "123 456 7890"}
  • 示例#2： "John"
contains_key
检查源数据中是否存在该对象。 注意： ​此函数替换已弃用的is_set()函数。
  • 输入： 必需 ​要检查的路径是否存在于源数据中。
contains_key(INPUT)
contains_key("evars.evar.field1")
true
无效
将属性的值设置为null。 当您不想将字段复制到目标架构时，应使用此字段。
nullify()
nullify()
null
get_keys
解析键/值对并返回所有键。
  • 对象： 必需 ​从中提取键的对象。
get_keys(OBJECT)
get_keys({"book1"： “Pride and Visimit”， “book2”： “1984”})
["book1", "book2"]
get_values
解析键/值对并根据给定的键返回字符串的值。
  • 字符串： 必需 ​要分析的字符串。
  • KEY： 必需 ​必须提取其值的键。
  • VALUE_DELIMITER： 必需 ​用于分隔字段和值的分隔符。 如果提供了null或空字符串，则此值为:。
  • FIELD_DELIMITER： 可选 ​用于分隔字段和值对的分隔符。 如果提供了null或空字符串，则此值为,。
get_values(STRING， KEY， VALUE_DELIMITER， FIELD_DELIMITER)
get_values("firstName - John ， lastName - Cena ， phone - 555 420 8692"， "firstName"， "-"， "，")
John
map_get_values
获取映射和键输入。 如果输入是单个键，则函数返回与该键关联的值。 如果输入是字符串数组，则函数返回与提供的键对应的所有值。 如果传入的映射具有重复的键，则返回值必须删除重复的键并返回唯一值。
  • 映射： 必需 ​输入映射数据。
  • 密钥： 必需 ​密钥可以是单个字符串或字符串数组。 如果提供了任何其他基元类型（数据/数字），则会将其视为字符串。
get_values(MAP， KEY)
有关代码示例，请参阅附录。
map_has_keys
如果提供了一个或多个输入键，则函数返回true。 如果提供字符串数组作为输入，则函数在找到的第一个键上返回true。
  • 映射： 必需 ​输入映射数据
  • 密钥： 必需 ​密钥可以是单个字符串或字符串数组。 如果提供了任何其他基元类型（数据/数字），则会将其视为字符串。
map_has_keys(MAP， KEY)
有关代码示例，请参阅附录。
add_to_map
接受至少两个输入。 可以提供任意数量的映射作为输入。 数据准备返回具有来自所有输入的所有键值对的单个映射。 如果一个或多个键重复（在同一映射中或跨映射），数据准备会删除重复的键，以便第一个键值对按它们在输入中传递的顺序持续存在。
映射： 必需 ​输入映射数据。
add_to_map(MAP 1， MAP 2， MAP 3， …)
有关代码示例，请参阅附录。
object_to_map（语法1）
使用此函数可创建Map数据类型。
  • 密钥： 必需的 ​密钥必须是字符串。 如果提供了任何其他基元值（如整数或日期），则它们会自动转换为字符串并被视为字符串。
  • ANY_TYPE： 必需 ​引用除映射之外的任何受支持的XDM数据类型。
object_to_map(KEY， ANY_TYPE， KEY， ANY_TYPE， … )
有关代码示例，请参阅附录。
object_to_map（语法2）
使用此函数可创建Map数据类型。
  • 对象： 必需 ​您可以提供传入对象或对象数组，并以键的形式指向对象内的属性。
object_to_map(OBJECT)
有关代码示例，请参阅附录。
object_to_map（语法3）
使用此函数可创建Map数据类型。
  • 对象： 必需 ​您可以提供传入对象或对象数组，并以键的形式指向对象内的属性。
object_to_map(OBJECT_ARRAY， ATTRIBUTE_IN_OBJECT_TO_BE_USED_AS_A_KEY)
有关代码示例，请参阅附录。

有关对象复制功能的信息，请参阅下面的部分。

层次结构 — 数组 arrays

NOTE
请向左/向右滚动以查看表格的全部内容。
函数
描述
参数
语法
表达式
示例输出
合并
返回给定数组中的第一个非空对象。
  • INPUT： 必需 ​要查找的第一个非null对象的数组。
coalesce（输入）
coalesce(null， null， null， first， null， second)
"first"
第一
检索给定数组的第一个元素。
  • 输入： 必需 ​要查找的第一个元素的数组。
第一（输入）
first(“1”、“2”、“3”)
"1"
过去
检索给定数组的最后一个元素。
  • 输入： 必需 ​要查找的最后一个元素的数组。
last(INPUT)
last(“1”、“2”、“3”)
“3”
add_to_array
将元素添加到数组的末尾。
  • 数组： 必需 ​要将元素添加到的数组。
  • VALUES：要附加到数组的元素。
add_to_array​(ARRAY， VALUES)
add_to_array​(['a'， 'b']， 'c'， 'd')
['a'、'b'、'c'、'd']
join_array
将数组彼此组合在一起。
  • 数组： 必需 ​要将元素添加到的数组。
  • 值：要附加到父数组的数组。
join_arrays​(ARRAY， VALUES)
join_arrays​(['a'， 'b']， ['c']， ['d'， 'e'])
['a'、'b'、'c'、'd'、'e']
to_array
采用输入列表并将其转换为数组。
  • INCLUDE_NULLS： 必需 ​布尔值，用于指示响应数组中是否包含null。
  • 值： 必需 ​要转换为数组的元素。
to_array​(INCLUDE_NULLS， VALUES)
to_array(false， 1， null， 2， 3)
[1, 2, 3]
大小_of
返回输入的大小。
  • INPUT： 必需 ​您尝试查找大小的对象。
size_of(INPUT)
size_of([1, 2, 3, 4])
4
upsert_array_append
此函数用于将整个输入数组中的所有元素附加到配置文件中数组的末尾。 此函数仅​ 适用 ​于更新期间。 如果在插入的上下文中使用，则此函数按原样返回输入。
  • 数组： 必需 ​要在配置文件中附加数组的数组。
upsert_array_append(ARRAY)
upsert_array_append([123, 456])
[123， 456]
upsert_array_replace
此函数用于替换数组中的元素。 此函数仅​ 适用 ​于更新期间。 如果在插入的上下文中使用，则此函数按原样返回输入。
  • 数组： 必需 ​要替换配置文件中数组的数组。
upsert_array_replace(ARRAY)
upsert_array_replace([123, 456], 1)
[123， 456]

层次结构 — 映射 map

NOTE
请向左/向右滚动以查看表格的全部内容。
函数
描述
参数
语法
表达式
示例输出
array_to_map
此函数将对象数组和键作为输入，并返回键字段的映射，其中值为键，数组元素为值。
  • INPUT： 必需 ​要查找的第一个非null对象的对象数组。
  • KEY： 必需 ​键必须是对象数组中的字段名称，并且对象必须是值。
array_to_map（对象[]输入，键）
请阅读附录中的代码示例。
object_to_map
此函数将对象作为参数并返回键值对的映射。
  • INPUT： 必需 ​要查找的第一个非null对象的对象数组。
object_to_map(OBJECT_INPUT)
"object_to_map(address)，输入为" + "address： {line1 ： "345 park ave"，line2： "bldg 2"，City ： "san jose"，State ： "CA"，type： "office"}"
返回具有给定字段名称和值对的映射，如果输入为null，则返回null。 例如："{line1 : \"345 park ave\",line2: \"bldg 2\",City : \"san jose\",State : \"CA\",type: \"office\"}"
to_map
此函数接受键值对列表并返回键值对的映射。
to_map(OBJECT_INPUT)
"to_map("firstName"， "John"， "lastName"， "Doe")"
返回具有给定字段名称和值对的映射，如果输入为null，则返回null。 例如："{\"firstName\" : \"John\", \"lastName\": \"Doe\"}"

逻辑运算符 logical-operators

NOTE
请向左/向右滚动以查看表格的全部内容。
函数
描述
参数
语法
表达式
示例输出
解码
给定键值以及作为数组扁平化的键值对列表，如果找到键，此函数将返回值，如果数组中存在，则返回默认值。
  • 密钥： 必需 ​要匹配的密钥。
  • OPTIONS： 必需 ​键/值对的平面化数组。 或者，也可以在末尾放置默认值。
decode(KEY， OPTIONS)
decode(stateCode， "ca"， "California"， "pa"， "Pennsylvania"， "N/A")
如果给定的stateCode为“ca”，则为“California”。
如果提供的stateCode为“pa”，则为“Pennsylvania”。
如果stateCode与以下内容不匹配，“不适用”。
iif
计算给定的布尔表达式并根据结果返回指定的值。
  • 表达式： 必需 ​正在计算的布尔表达式。
  • TRUE_VALUE： 必需 ​如果表达式的计算结果为true，则返回的值。
  • FALSE_VALUE： 必需 ​表达式计算结果为false时返回的值。
iif（表达式， TRUE_VALUE， FALSE_VALUE）
iif("s"。equalsIgnoreCase("S")， "True"， "False")
"True"

聚合 aggregation

NOTE
请向左/向右滚动以查看表格的全部内容。
函数
描述
参数
语法
表达式
示例输出
min
返回给定参数的最小值。 使用自然排序。
  • OPTIONS： 必需 ​可以相互比较的一个或多个对象。
min(OPTIONS)
min(3， 1， 4)
1
max
返回给定参数的最大值。 使用自然排序。
  • OPTIONS： 必需 ​可以相互比较的一个或多个对象。
最大(OPTIONS)
max(3， 1， 4)
4

类型转换 type-conversions

NOTE
请向左/向右滚动以查看表格的全部内容。
函数
描述
参数
语法
表达式
示例输出
to_bigint
将字符串转换为大整数。
  • 字符串： 必需 ​要转换为BigInteger的字符串。
to_bigint(STRING)
to_bigint​("1000000.34")
1000000.34
to_decimal
将字符串转换为双精度类型。
  • 字符串： 必需 ​要转换为双精度类型的字符串。
to_decimal(STRING)
to_decimal("20.5")
20.5
to_float
将字符串转换为浮点数。
  • 字符串： 必需 ​要转换为浮点数的字符串。
to_float(STRING)
to_float("12.3456")
12.34566
to_integer
将字符串转换为整数。
  • 字符串： 必需 ​要转换为整数的字符串。
to_integer(STRING)
to_integer("12")
12

JSON函数 json

NOTE
请向左/向右滚动以查看表格的全部内容。
函数
描述
参数
语法
表达式
示例输出
json_to_object
将给定字符串中的JSON内容反序列化。
  • 字符串： 必需 ​要反序列化的JSON字符串。
json_to_object​(STRING)
​ json_to_object({"info"：{"firstName"："John"，"lastName"： "Doe"}})
表示JSON的对象。

特别操作 special-operations

NOTE
请向左/向右滚动以查看表格的全部内容。
函数
描述
参数
语法
表达式
示例输出
uuid /
guid
生成伪随机ID。
uuid()
guid()
uuid()
guid()
7c0267d2-bb74-4e1a-9275-3bf4fccda5f4
c7016dc7-3163-43f7-afc7-2e1c9c206333
fpid_to_ecid
此函数接受FPID字符串并将其转换为ECID，以便在Adobe Experience Platform和Adobe Experience Cloud应用程序中使用。
  • 字符串： 必需 ​要转换为ECID的FPID字符串。
fpid_to_ecid(STRING)
fpid_to_ecid("4ed70bee-b654-420a-a3fd-b58b6b65e991")
"28880788470263023831040523038280731744"

用户代理功能 user-agent

下表中包含的任何用户代理函数都可以返回以下任一值：

  • 电话 — 屏幕较小的移动设备（通常小于7英寸）
  • 移动设备 — 尚未识别的移动设备。 此移动设备可以是电子阅读器、平板电脑、手机、手表等。

有关设备字段值的详细信息，请阅读本文档附录中的设备字段值列表。

NOTE
请向左/向右滚动以查看表格的全部内容。
函数
描述
参数
语法
表达式
示例输出
ua_os_name
从用户代理字符串中提取操作系统名称。
  • USER_AGENT： 必需 ​用户代理字符串。
ua_os_name​(USER_AGENT)
ua_os_name​("Mozilla/5.0(iPhone；CPU iPhone OS 5_1_1，如Mac OS X)AppleWebKit/534.46（KHTML，如Gecko）版本/5.1 Mobile/9B206 Safari/7534.48.3")
iOS
ua_os_version_major
从用户代理字符串中提取操作系统的主要版本。
  • USER_AGENT： 必需 ​用户代理字符串。
ua_os_version_major​(USER_AGENT)
ua_os_version_major​s("Mozilla/5.0 (iPhone；CPU iPhone OS 5_1_1，如Mac OS X)AppleWebKit/534.46 （KHTML，如Gecko）版本/5.1 Mobile/9B206 Safari/7534.48.3")
iOS 5
ua_os_version
从用户代理字符串中提取操作系统的版本。
  • USER_AGENT： 必需 ​用户代理字符串。
ua_os_version​(USER_AGENT)
ua_os_version​("Mozilla/5.0(iPhone；CPU iPhone OS 5_1_1，如Mac OS X)AppleWebKit/534.46（KHTML，如Gecko）版本/5.1 Mobile/9B206 Safari/7534.48.3")
5.1.1
ua_os_name_version
从用户代理字符串中提取操作系统的名称和版本。
  • USER_AGENT： 必需 ​用户代理字符串。
ua_os_name_version​(USER_AGENT)
ua_os_name_version​("Mozilla/5.0(iPhone；CPU iPhone OS 5_1_1_1，如Mac OS X)AppleWebKit/534.46（KHTML，如Gecko）版本/5.1 Mobile/9B206 Safari/7534.48.3")
iOS 5.1.1
ua_agent_version
从用户代理字符串中提取代理版本。
  • USER_AGENT： 必需 ​用户代理字符串。
ua_agent_version​(USER_AGENT)
ua_agent_version​("Mozilla/5.0(iPhone；CPU iPhone OS 5_1_1，如Mac OS X)AppleWebKit/534.46（KHTML，如Gecko）版本/5.1 Mobile/9B206 Safari/7534.48.3")
5.1
ua_agent_version_major
从用户代理字符串中提取代理名称和主要版本。
  • USER_AGENT： 必需 ​用户代理字符串。
ua_agent_version_major​(USER_AGENT)
ua_agent_version_major​("Mozilla/5.0(iPhone；CPU iPhone OS 5_1_1，如Mac OS X)AppleWebKit/534.46（KHTML，如Gecko）版本/5.1 Mobile/9B206 Safari/7534.48.3")
Safari 5
ua_agent_name
从用户代理字符串中提取代理名称。
  • USER_AGENT： 必需 ​用户代理字符串。
ua_agent_name​(USER_AGENT)
ua_agent_name​("Mozilla/5.0(iPhone；CPU iPhone OS 5_1_1，如Mac OS X)AppleWebKit/534.46（KHTML，如Gecko）版本/5.1 Mobile/9B206 Safari/7534.48.3")
Safari
ua_device_class
从用户代理字符串中提取设备类。
  • USER_AGENT： 必需 ​用户代理字符串。
ua_device_class​(USER_AGENT)
ua_device_class​("Mozilla/5.0(iPhone；CPU iPhone OS 5_1_1，如Mac OS X)AppleWebKit/534.46（KHTML，如Gecko）版本/5.1 Mobile/9B206 Safari/7534.48.3")
电话

Analytics函数 analytics

NOTE
您只能对WebSDK和Adobe Analytics流使用以下分析函数。
函数
描述
参数
语法
表达式
示例输出
aa_get_event_id
从Analytics事件字符串中提取事件ID。
  • EVENT_STRING： 必需 ​逗号分隔的Analytics事件字符串。
  • EVENT_NAME： 必需 ​要从中提取的事件名称和ID。
aa_get_event_id(EVENT_STRING， EVENT_NAME)
aa_get_event_id("event101=5：123456，scOpen"， "event101")
123456
aa_get_event_value
从Analytics事件字符串中提取事件值。 如果未指定事件值，则返回1。
  • EVENT_STRING： 必需 ​逗号分隔的Analytics事件字符串。
  • EVENT_NAME： 必需 ​要从中提取值的事件名称。
aa_get_event_value(EVENT_STRING， EVENT_NAME)
aa_get_event_value("event101=5：123456，scOpen"， "event101")
5
aa_get_product_categories
从Analytics产品字符串中提取产品类别。
  • PRODUCTS_STRING： 必需 Analytics产品字符串。
aa_get_product_categories(PRODUCTS_STRING)
aa_get_product_categories("；Example product 1；1；3.50，Example category 2；Example product 2；1；5.99")
[null，“示例类别2”]
aa_get_product_names
从Analytics产品字符串中提取产品名称。
  • PRODUCTS_STRING： 必需 Analytics产品字符串。
aa_get_product_names(PRODUCTS_STRING)
aa_get_product_names("；Example product 1；1；3.50，Example category 2；Example product 2；1；5.99")
[“示例产品1”，“示例产品2”]
aa_get_product_quantities
从Analytics产品字符串中提取数量。
  • PRODUCTS_STRING： 必需 Analytics产品字符串。
aa_get_product_quantities(PRODUCTS_STRING)
aa_get_product_quantities（"；示例产品1；1；3.50，示例类别2；示例产品2"）
["1"，空]
aa_get_product_prices
从Analytics产品字符串中提取价格。
  • PRODUCTS_STRING： 必需 Analytics产品字符串。
aa_get_product_prices(PRODUCTS_STRING)
aa_get_product_prices（"；示例产品1；1；3.50，示例类别2；示例产品2"）
["3.50"，空]
aa_get_product_event_values
从products字符串中提取命名事件的值作为字符串数组。
  • PRODUCTS_STRING： 必需 Analytics产品字符串。
  • EVENT_NAME： 必需 ​要从中提取值的事件名称。
aa_get_product_event_values(PRODUCTS_STRING， EVENT_NAME)
aa_get_product_event_values（"；示例产品1；1；4.20；event1=2.3|event2=5:1，；示例产品2；1；4.20；event1=3|event2=2:2"， "event1"）
["2.3"，"3"]
aa_get_product_evars
从products字符串中抽取命名事件的evar值作为字符串数组。
  • PRODUCTS_STRING： 必需 Analytics产品字符串。
  • eVar_名称： 必需 ​要提取的eVar名称。
aa_get_product_evars(PRODUCTS_STRING， EVENT_NAME)
aa_get_product_evars("；示例产品；1；6.69；；eVar1=促销值"， "eVar1")
[“促销值”]

对象复制 object-copy

TIP
当源中的对象映射到XDM中的对象时，会自动应用对象复制功能。 无需用户执行其他操作。

您可以使用对象复制功能自动复制对象的属性，而无需更改映射。 例如，如果源数据的结构为：

address{
        line1: 4191 Ridgebrook Way,
        city: San Jose,
        state: California
        }

XDM结构：

addr{
    addrLine1: 4191 Ridgebrook Way,
    city: San Jose,
    state: California
    }

然后，映射将变为：

address -> addr
address.line1 -> addr.addrLine1

在上述示例中，city和state属性在运行时也会自动摄取，因为address对象已映射到addr。 如果您要在XDM结构中创建line2属性，并且您的输入数据在address对象中还包含line2，则它也将自动摄取，而无需手动更改映射。

要确保自动映射正常工作，必须满足以下先决条件：

  • 父级对象应进行映射；
  • 必须在XDM架构中创建新属性；
  • 新属性在源架构和XDM架构中应有匹配的名称。

如果不满足任何先决条件，则必须使用数据准备手动将源架构映射到XDM架构。

附录

下面提供了有关使用数据准备映射函数的其他信息

特殊字符 special-characters

下表概述了保留字符及其相应的编码字符。

保留字符
编码字符
空间
%20
！
%21
”
%22
#
%23
$
%24
%
%25
和
%26
’
%27
(
%28
）
%29
*
%2A
+
%2B
，
%2C
/
%2F
：
%3A
；
%3B
<
%3C
=
%3D
>
%3E
?
%3F
@
%40
[
%5B
]
%5D
^
%5E
`
%60
~
%7E

设备字段值 device-field-values

下表概述了设备字段值及其相应说明。

设备
描述
桌面
台式机或笔记本电脑类型的设备。
匿名
匿名设备。 在某些情况下，这些是匿名化软件更改的useragents。
未知
未知设备。 这些通常是useragents，不包含有关设备的信息。
移动设备
尚未识别的移动设备。 此移动设备可以是电子阅读器、平板电脑、手机、手表等。
平板电脑
大屏幕（通常大于7英寸）的移动设备。
电话
小屏幕的移动设备（通常小于7英寸）。
观看
带有小屏幕（通常小于2英寸）的移动设备。 这些设备通常用作手机/平板电脑类型的设备的附加屏幕。
增强现实
具有AR功能的移动设备。
虚拟现实
一种具有VR功能的移动设备。
电子阅读器
类似于平板电脑的设备，但通常具有eInk屏幕。
机顶盒
允许通过电视大小的屏幕进行交互的连接设备。
TV
与机顶盒类似的设备，但内置在电视机中。
家用电器
（通常是大型）家用电器，如冰箱。
游戏控制台
固定游戏系统，如Playstation或XBox。
手持游戏机
移动游戏系统，如Nintendo Switch。
语音
语音驱动设备，如Amazon Alexa或Google Home。
汽车
基于车辆的浏览器。
机器人
访问网站的机器人。
机器人移动设备
访问网站但表示希望被视为移动设备访客的机器人。
机器人模拟器
访问网站的机器人假装是类似Google的机器人，但实际上不是。 注意：在大多数情况下，机器人模仿者实际上是机器人。
云
基于云的应用程序。 它们既不是机器人，也不是黑客，而是需要连接的应用程序。 这包括Mastodon个服务器。
黑客
在useragent字符串中检测到脚本时使用此设备值。

代码示例 code-samples

map_get_values map-get-values

选择以查看示例
code language-json 
 example = "map_get_values(book_details,\"author\") where input is : {\n" +
        "    \"book_details\":\n" +
        "    {\n" +
        "        \"author\": \"George R. R. Martin\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-978-0553801477\"\n" +
        "    }\n" +
        "}",
      result = "{\"author\": \"George R. R. Martin\"}"

map_has_keys map_has_keys

选择以查看示例
code language-json 
 example = "map_has_keys(book_details,\"author\")where input is : {\n" +
        "    \"book_details\":\n" +
        "    {\n" +
        "        \"author\": \"George R. R. Martin\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-978-0553801477\"\n" +
        "    }\n" +
        "}",
      result = "true"

add_to_map add_to_map

选择以查看示例
code language-json 
example = "add_to_map(book_details, book_details2) where input is {\n" +
        "    \"book_details\":\n" +
        "    {\n" +
        "        \"author\": \"George R. R. Martin\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-978-0553801477\"\n" +
        "    }\n" +
        "}" +
        "{\n" +
        "    \"book_details2\":\n" +
        "    {\n" +
        "        \"author\": \"Neil Gaiman\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-0-380-97365-0\"\n" +
        "        \"publisher\": \"William Morrow\"\n" +
        "    }\n" +
        "}",
      result = "{\n" +
        "    \"book_details\":\n" +
        "    {\n" +
        "        \"author\": \"George R. R. Martin\",\n" +
        "        \"price\": 17.99,\n" +
        "        \"ISBN\": \"ISBN-978-0553801477\"\n" +
        "        \"publisher\": \"William Morrow\"\n" +
        "    }\n" +
        "}",
      returns = "A new map with all elements from map and addends"

object_to_map object_to_map

语法1

选择以查看示例
code language-json 
example = "object_to_map(\"firstName\", \"John\", \"lastName\", \"Doe\")",
result = "{\"firstName\" : \"John\", \"lastName\": \"Doe\"}"

语法2

选择以查看示例
code language-json 
example = "object_to_map(address) where input is " +
  "address: {line1 : \"345 park ave\",line2: \"bldg 2\",City : \"san jose\",State : \"CA\",type: \"office\"}",
result = "{line1 : \"345 park ave\",line2: \"bldg 2\",City : \"san jose\",State : \"CA\",type: \"office\"}"

语法3

选择以查看示例
code language-json 
example = "object_to_map(addresses,type)" +
        "\n" +
        "[\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City\": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"home\"\n" +
        "    },\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City \": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"work\"\n" +
        "    },\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City \": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"office\"\n" +
        "    }\n" +
        "]" ,
result = "{\n" +
        "    \"home\":\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City\": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"home\"\n" +
        "    },\n" +
        "    \"work\":\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City \": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"work\"\n" +
        "    },\n" +
        "    \"office\":\n" +
        "    {\n" +
        "        \"line1\": \"345 park ave\",\n" +
        "        \"line2\": \"bldg 2\",\n" +
        "        \"City \": \"san jose\",\n" +
        "        \"State\": \"CA\",\n" +
        "        \"type\": \"office\"\n" +
        "    }\n" +
        "}"

array_to_map array_to_map

选择以查看示例
code language-json 
example = "array_to_map(addresses, \"type\") where addresses is\n" +
  "\n" +
  "[\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City\": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"home\"\n" +
  "    },\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City \": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"work\"\n" +
  "    },\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City \": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"office\"\n" +
  "    }\n" +
  "]" ,
result = "{\n" +
  "    \"home\":\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City\": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"home\"\n" +
  "    },\n" +
  "    \"work\":\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City \": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"work\"\n" +
  "    },\n" +
  "    \"office\":\n" +
  "    {\n" +
  "        \"line1\": \"345 park ave\",\n" +
  "        \"line2\": \"bldg 2\",\n" +
  "        \"City \": \"san jose\",\n" +
  "        \"State\": \"CA\",\n" +
  "        \"type\": \"office\"\n" +
  "    }\n" +
  "}",
returns = "Returns a map with given field name and value pairs or null if input is null"
recommendation-more-help
461cc884-c234-4a0c-ac75-6efbaafc1394