定义关系令牌（注册和档案管理）

使用注册和档案管理，您可以创建关系令牌组件，以便在某些对象记录和 MDL 组件中将某些功能自动化。当用户触发一个受支持的操作时，Vault 会根据令牌如何解析令牌所定义对象的相关记录，自动生成并填充记录。如果您将关系令牌链接到带字段映射的对象映射，Vault 还会基于令牌解析，使用源对象记录中的相同值填充映射字段。

您也可以使用 MDL 来创建关系令牌。必须使用 MDL 来修改关系令牌，以及访问和创建递归关系令牌。请参阅关于 RegulatoryOne 组件类型，以了解更多详细信息。

关于关系令牌

令牌是采用特殊格式的文本片段，Vault 用该文本片段替代令牌所代表的值。关系令牌使您能够利用对象之间的关系；与用于解析值的预定义令牌类似，关系令牌使您能够更好地控制要引用的层次结构对象关系值的可配置性。关系令牌指向指定对象上的指定字段。关系令牌还允许您拥有父子令牌关系，以便您可以在整个产品的层次结构中表示值。

受支持的操作

以下操作支持关系令牌，并基于令牌解析来生成和填充记录：

• 生成注册数据：使用来自用于本地影响评估的现有注册项的值，填充注册项上的映射字段。您必须将关系令牌链接到对象映射，以指定 Vault 要填充的映射字段。
• 生成要求：基于层次结构产品关系，使用 EDL 和 EDL 项生成注册项要求。如果将关系令牌链接到对象映射，Vault 还会在新的记录上自动填充映射字段。
• 拆分注册项：从源注册项中创建并关联注册项。如果将关系令牌链接到对象映射，Vault 还会在新的记录上自动填充映射字段。

格式

RegulatoryOne 中的关系令牌的格式不同于 Vault 中的其他位置使用的令牌，例如消息、文档编号、Vault 信息令牌或系统管理的对象记录名称。根据您使用关系令牌的方式，您需要在大括号中引用令牌的标签（例如“{产品}”），或者引用令牌的 API 名称（例如 product__c）。

RegulatoryOne 不包含任何标准 __v 或系统 __sys 命名空间关系令牌；您可以定义最适合组织需求的关系令牌。您创建的相关令牌是自定义令牌并且具有 __c 自定义命名空间后缀。

示例

查看下图，了解如何在关系令牌定义中利用产品层次结构数据模型的示例。

配置概述

要配置 Vault 以使用关系令牌，需执行以下步骤：

1. 可选：使用字段映射创建对象映射，以定义 Vault 如何基于令牌解析来填充字段。如果计划使用关系令牌生成用于本地影响评估的注册数据，您必须创建对象映射，才能创建关系令牌。
2. 创建适用的关系令牌。要创建递归令牌，您必须使用 MDL。
3. 在 MDL 中，将所有受支持的操作链接到根关系令牌。
4. 更新相关的对象记录和 MDL 组件，以引用适用的关系令牌。

定义对象映射和字段映射

在创建关系令牌之前，请确保已经创建要链接到关系令牌的任何可选对象映射组件，以使 Vault 使用基于关系令牌解析的源对象记录中的相同值，自动填充映射字段。如果计划使用关系令牌生成用于本地影响评估的注册数据，您必须将其链接到预定义的对象映射。

使用字段映射创建对象映射之后，您可以在创建新的关系令牌时填充对象映射节段中的适用字段，以便将对象映射链接到关系令牌。除非存在目标对象与您选择的下拉列表匹配的现有对象映射，否则对象映射节段中的下拉菜单将被禁用。例如，只有当对象映射的目标对象值为 request__v 时，请求对象映射下拉列表才会处于活动状态。

请参阅定义对象映射和字段映射，以了解有关如何使用字段映射创建对象映射的更多详细信息。

创建关系令牌

在创建关系令牌之前，请确保已经创建要链接到令牌的任何对象映射。如果计划使用关系令牌生成用于本地影响评估的注册数据，您必须将其链接到预定义的对象映射。

要创建关系令牌，请执行以下操作：

1. 导航到关系令牌。
2. 单击创建。
3. 输入一个唯一的令牌标签。
4. 输入此令牌所引用的对象的名称，例如 formulation__v。
5. 可选：输入使用该令牌时要向对象记录应用的任何 VQL 标准，例如 formulation_classification__c="formula__c"。
6. 可选：输入该令牌的描述。
7. 根据您计划使用此关系令牌的方式，输入字段标签：
   • 要生成要求，请输入对象字段的名称，以将令牌指向该对象上的特定字段。在记录中解析令牌时，此字段可用作该令牌的标签。
   • 要拆分注册项或生成用于本地影响评估的注册数据，请输入对象上处于活动状态的任何字段的名称，例如 name__v 或 title__v。当 Vault 生成和填充注册项记录时，将忽略此字段。
8. 可选：在父节段中，选择一个父令牌，例如“产品”。
9. 选择父令牌引用字段类型，以确定父令牌相对于当前令牌的处理方式：
   • 自己：此选项表示令牌引用字段位于该令牌引用的对象上。
   • 父级：此选项表示令牌引用字段位于父令牌中引用的对象上。
   • 组合：此选项表示令牌引用字段位于与该令牌引用的对象有关系的单独联合对象或组合对象上。
   • 无：此选项表明令牌没有任何父级，父级令牌引用字段是 ID。
10. 选择父令牌。如果您为父令牌引用字段类型选择了无，则此字段不可见。
11. 输入父令牌引用字段。如果您为父令牌引用字段类型选择了无，则此字段不可见。
12. 仅组合类型：输入入站关系的父令牌对象和父令牌子字段。
13. 在对象映射节段中选择一 (1) 个或多个映射，以便将此令牌链接到预定义的对象映射。这些字段对于用于生成要求或拆分注册项的关系令牌是可选的。如果希望使用此关系令牌生成用于本地影响评估的注册数据，您必须在请求对象映射字段中选择一个对象映射。Vault 会自动基于令牌解析来填充映射字段。如果填充了任何对象映射字段，对象映射上的源对象必须与此关系令牌的对象匹配。根据您计划如何使用此关系令牌，从适当的下拉列表中选择适用的对象映射：
    • 请求对象映射：支持使用关系令牌生成用于本地影响评估的注册数据和拆分注册项。
    • 请求要求对象映射：支持使用关系令牌生成要求。
    • EDL 对象映射：支持使用关系令牌生成要求。
    • EDL 项对象映射：支持使用关系令牌生成要求。
14. 单击保存。

创建递归关系令牌

您可以创建递归关系令牌，这意味着 Vault 会继续将该关系令牌应用于创建的所有记录，这是因为系统通过指定对象的层次结构解析关系令牌，直到无法创建更多其他记录为止。例如，您可以创建一个递归关系令牌，为产品层次结构中的所有原材料生成要求，包括由其他原材料组成的原材料，这些原材料通过配方成分与产品层次结构中的配方间接相关。您还可以指定在创建新记录时或创建递归记录后，是否应用关系令牌上的任何 VQL 标准。

请参阅关于 RegulatoryOne 组件类型，以了解有关如何在 MDL 中创建递归关系令牌的更多详细信息。

将操作链接到根关系令牌

创建适用的关系令牌之后以及配置任何受支持的操作之前，您必须将每个操作链接到一个根关系令牌。如果不这样做，当用户触发时，这些操作将失败。请参阅关于 RegulatoryOne 组件类型，以了解有关如何在 MDL 中创建“关系令牌设置”组件（用于将受支持的操作链接到根令牌）的详细信息。

在对象记录和 MDL 组件中使用关系令牌

创建一个关系令牌之后，您可以将其添加到某些对象记录和 MDL 组件中，以便在支持的字段内使用此令牌。“RegulatoryOne 注册和档案管理”支持下列字段中的关系令牌：

• 要求对象记录中的令牌标签字段
• 要求对象记录中的名称字段
• 拆分规则对象记录中的关系令牌字段
• 注册属性 (Registrationattribute) MDL 组件上的关系令牌 (relational_token) 属性

在要求中使用关系令牌

要更新记录以使用关系令牌生成注册项要求，请执行以下操作：

1. 导航到适当的要求记录。
2. 单击编辑。
3. 在令牌标签字段中，包含令牌标签，例如“产品”。
4. 在名称字段中，将令牌括在左大括号和右大括号内，以包含适当的令牌标签，例如“{产品}”。您可以在字段中使用令牌和文本的组合，例如使用名为“{Product}”的令牌，其中产品记录为“Lipstick”，旁边显示文本“SDS”，这样当解析令牌并创建适当的新记录时，记录的名称将显示为“Lipstick SDS”。
5. 单击保存。

在拆分规则中使用关系令牌

创建新的拆分规则记录时，您必须引用现有的关系令牌，这决定了 Vault 如何将源注册项拆分为新的和相关的注册项。

如果将带有层次结构输出结构的拆分规则链接到递归关系令牌，拆分注册项操作创建并关联新注册项，以反映关系令牌查询的记录的相同层次结构。例如，如果礼品套装包含旅行套装并且旅行套装包括乳液，则用户可以为礼品套装生成层次机构注册项。在这种情况下，旅行套装注册项是礼品套装注册项的子项，而乳液注册项是旅行套装注册项的子项。

在注册属性中使用关系令牌

当在 MDL 中创建注册属性组件时，您可以引用一个已链接到对象映射的现有关系令牌，以支持生成用于本地影响评估的注册数据。这定义了当用户触发生成注册数据操作时，Vault 如何填充注册项记录上的指定字段。

关于作业状态和错误日志

当用户触发以下任何作业时，Vault 会在相关作业日志中包含有关令牌解析的详细信息，以及在作业实例期间发生的任何错误：

• 为注册项生成要求
• 为注册目标生成要求
• 拆分注册项

限制

以下限制适用于关系令牌：

• 当用户触发记录生成时，Vault 将创建最多 100000 条要求记录和 35000 条总记录，作为关系令牌解析。
• Vault 最多支持 10 个级别的关系令牌层次结构，以满足要求。
• Vault 最多支持 100 条根级别要求记录。

相关权限

您可以使用标准系统管理员或 Vault 所有者安全配置文件完成本文中的所有步骤。如果 Vault 使用自定义安全配置文件，则您的配置文件必须授予以下权限：