本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
对象类型映射定义详细信息
对象类型映射定义分为两部分:字段定义和键定义。
提示
要了解如何创建对象类型映射器,请参阅以下博客文章:使用预建的 Amazon S3 连接器,使用 Amazon Connect 客户档案统一和整理客户信息
字段定义详细信息
字段定义定义了字段的来源、目标(目标)和类型。例如:
"Fields": { "{fieldName}": { "Source": "{source}", "Target": "{target}", "ContentType": "{contentType}" }, ... }, ...
-
Source
:这可以是字段的 JSON 访问器,也可以是用于生成字段值的 Handlebar 宏。正在解析的源对象已命名
_source
,因此源字段中的所有字段都需要以此字符串作为前缀。仅支持该_source
对象。使用 Handlebar 宏解决方案生成常量并将多个源对象字段合并为一个字段。这对于索引很有用。
-
Target
:指定应将该字段的数据映射到标准对象类型中的哪个位置。填充标准配置文件允许您将从任何数据源提取的数据与基于客户配置文件构建的应用程序一起使用,而无需具体了解所摄取数据的格式。
此字段为可选项。您可能只想定义字段以将其包含在键中。
此字段的格式始终为 JSON 访问器。唯一支持的目标对象是
_profile
。 -
ContentType
:支持以下值为 “字符串”、“数字”、“电话号码”、“电子邮件地址”、“名称”。如果未指定ContentType
,则假定为 STRING。ContentType
用于确定如何为该值编制索引,以便代理可以搜索该值。例如,如果设置ContentType
为 PHONE_NUMBER,则会处理电话号码,以便座席可以用任何格式进行搜索:字符串 “+15551234567” 与 “(555) -123-4567” 匹配。
密钥定义详情
密钥包含一个或多个字段,这些字段共同定义了一个密钥,该密钥可用于使用 SearchProfilesAPI 搜索对象(或它们所属的配置文件)。也可以将密钥定义为唯一地识别配置文件或唯一地识别对象本身。
"Keys": { "{keyName}": [{ "StandardIdentifiers": [...], "FieldNames": [ "{fieldname}", ...] }], ... }, ...
密钥名称是域的全局名称。如果你有两个密钥,在两个不同的对象类型映射中同名:
-
这些密钥应该占据相同的命名空间
-
它们可能被用来将不同对象之间的配置文件链接在一起。如果它们在对象之间匹配,则客户配置文件将这两个对象放在同一个配置文件中。
换句话说:当且仅当相同的值表示它们相互关联时,密钥在域中才应具有相同的键名。例如,在一种类型的对象中指定的电话号码将与另一种类型的对象中指定的相同电话号码相关。为从 Salesforce 导入的对象指定的内部标识符可能与从 Marketo 导入的另一个对象无关,即使它们的值完全相同。
键定义的使用方式有两种:
-
在摄取期间,在客户配置文件中,它们用于确定应将对象分配给哪个配置文件。
-
它们允许您使用 SearchProfilesAPI 搜索密钥值并查找配置文件。