当使用 Spark 消息功能创建 Vault 与 Vault 集成时,可能需要转换来自源 Vault 数据模型的数据,以使其适应目标 Vault的数据模型。例如,您可能需要指明源 Vault 中的 country__v
值“US”等于目标 Vault 中的“美国”。
引用查找是一种集成规则,您可以使用它来配置查找,以间接使用一个来自源 Vault 的值,为目标对象或文档上的一个字段设置值。
需要通过三个步骤来创建引用查找:
- 设置集成规则。了解更多信息。
- 设置引用查找对象记录。这篇文章将指导您完成此步骤。
- 开发一个 Spark 消息处理器,以使用您的引用查找。了解有关开发人员门户中的 Spark 消息处理器的更多信息。
访问引用查找管理
您可以从管理 > 连接中查看和管理集成。进入此区域之后,选择一个具有 Vault 到 Vault 连接类型的记录。在连接详细信息页面上,您将看到一个引用查找节段。
您必须拥有一个能够授予应用程序:管理连接权限的安全配置文件,才能访问连接标签页中的连接。
如何创建引用查找记录
要创建引用查找记录:
- 从连接详细信息页面中,展开引用查找节段。
- 单击添加。
- 从创建引用查找对话框中,为此引用选择一个类型。例如对象。如果存在不匹配的数据类型,且源 Vault 中的类型与目标 Vault 中的类型不同,请选择通用。
- 接下来,选择目标对象。例如国家/地区 (country__v)。如果您选择通用作为类型,输入以__c结尾的
名称
。只允许使用小写字母、字母数字字符和下划线 (_
)。 - 单击继续。
- 如果正在创建一个类型为对象的查找,请选择一个目标键字段。此字段是对象上用于在 Vault 之间映射值的字段。建议不要选择 name__v 作为键字段,因为对象记录名称可能会发生变化。实际上,建议使用一个静态字段,例如 ID。
- 接下来,您需要为查找添加第一个值。单击添加。
- 输入一个源键。此键将识别源 Vault 中的对象记录,而且必须是唯一的。建议使用记录 ID。例如源 Vault 中的“US”国家/地区记录的 ID。
- 选择一个目标键。此键将识别目标 Vault 中的对象记录。例如,从目标 Vault 中的可用对象记录的列表中选择美国。如果您的查找类型是通用,您必须手动输入此值。
- 设置状态。建议将查找设置为非活动状态,直到您准备好将它们编码到 Spark 消息处理器中。
- 单击保存。如果需要添加多个引用查找记录,您可以单击保存 + 创建。
- 可选:如果希望为与对象关联的所有内容添加值,建议使用 CSV 模板。
通用
如果源 Vault 中的数据类型与目标 Vault 中的数据类型不匹配,或者需要匹配此处未列出的数据类型,管理员可以使用通用选项手动映射数据类型。
通用支持所有单值字段的任意至任意映射。不支持多值字段。例如:支持是/否字段,不支持多值选项列表。最好仅在所需的数据类型不可用时才使用通用。
导出和加载引用查找模板
为了能够轻松一次性更新多个引用查找值,您可以导出一个可填写的模板,以批量更新所有记录。为此,请从引用查找详细信息页面上单击导出模板。
Vault 会将此模板下载为一个具有以下列的 CSV 文件:
- 目标名称(仅用于显示/引用):这个预先填充的列将列出与此目标对象关联的目标 Vault 中的每个记录(最多 2,000 个记录)的名称。
- 目标键:这个可填写的列将列出用于识别目标 Vault 中的此记录的目标键字段值。例如,如果您的目标键字段是 ID,请输入与目标 Vault 中的这些记录关联的 ID。
- 源名称(仅用于显示/引用):这个可填写的列可用于列出与此目标对象关联的源 Vault 中的每个记录的名称。
- 源键:这个可填写的列将列出用于识别源 Vault 中的对象记录的键,而且必须是唯一的。建议使用记录 ID。例如源 Vault 中的“US”国家/地区记录的 ID。
填写您导出的模板之后,您可以快速将您的值加载到 Vault 中。为此,请单击加载引用查找,然后选择您已填好的 CSV。完成加载过程之后,您将收到一个通知。如果您的加载出现任何错误,通知中将包含一个用于下载错误日志的链接。