当使用 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。完成加载过程之后，您将收到一个通知。如果您的加载出现任何错误，通知中将包含一个用于下载错误日志的链接。