在配置过程中,有些 RegulatoryOne 注册和档案管理功能要求为特定的组件类型创建组件。组件类型是 Vault 的配置元素,可扩展 Vault 的功能行为。组件是包含特定配置详细信息的组件类型的实例。有些组件在子组件中存储其他数据。组件与其子组件之间存在父子关系,这意味着一个子组件总是属于一个父级组件。
您可以在注册和档案管理 Vault 中查看、创建和编辑某些组件;但有些组件只能在 MDL 中访问。您必须使用 MDL 停用、重新激活和删除本文中包含的任何组件类型。请参阅关于 Vault 组件,以了解有关如何在 MDL 中访问、创建和修改组件的更多详细信息。
注意:本文中介绍的组件类型只在 RegulatoryOne 注册和档案管理 Vault 中可用。
组件类型
注册和档案管理 Vault 中提供了以下组件类型:
标签 | API 名称 | 详细信息 | 可访问性 |
对象映射 | Objectmapping | 映射源对象和目标对象。 | 可以在 Vault 和 MDL 中访问。 |
字段映射 | Fieldmapping | 对象映射的此子组件将映射相关对象映射中定义的对象上的两 (2) 个字段。 | 可以在 Vault 和 MDL 中访问。 |
相关令牌 | Relationaltoken | 确定 Vault 如何在执行支持的操作时创建或填充对象记录。 | 在 Vault 中部分可访问,有些功能只能在 MDL 中访问。 |
关系令牌设置 | Relationatokensetting | 为支持的操作定义根关系令牌。 | 只能在 MDL 中访问。 |
注册属性 | Registrationattribute | 定义本地影响评估和全球变化影响评估的注册项字段属性。 | 只能在 MDL 中访问。 |
定义对象映射和字段映射
“对象映射”组件定义了源对象和目标对象。字段映射是一些子组件,它们的父级组件是用于在相关对象映射中定义的源对象与目标对象之间映射字段的对象映射。您必须首先创建一个对象映射,然后将“字段映射”子组件添加到此对象映射。
您可以在您的注册和档案管理 Vault 和 MDL 中访问、创建和修改对象映射和字段映射。您必须使用 MDL 删除或停用对象映射和字段映射。请参阅定义对象映射和字段映射,以了解有关如何在 Vault 中使用字段映射创建对象映射的详细信息。
定义关系令牌
注意:创建必要的关系令牌之后,您必须将每个受支持的操作链接到一个根令牌。如果不将受支持的操作链接到一个根令牌,当用户触发时,此操作将失败。
“关系令牌”组件利用对象之间的层次结构关系,以使用户能够在执行受支持的操作时,基于令牌解析来自动生成和填充记录。当创建递归关系令牌时,Vault 会将令牌应用于所创建的全部记录,这是因为系统通过指定对象的层次结构解析令牌,直到无法创建更多其他记录为止。您还可以指定在创建新记录时或在创建递归记录后,是否应用关系令牌上的任何 VQL 标准。
您可以在注册和档案管理 Vault 中创建非递归关系令牌。您也可以在 MDL 中创建关系令牌。您必须使用 MDL 在创建之后访问和修改关系令牌以及创建递归关系令牌。请参阅定义关系令牌,以了解有关如何在 Vault 中创建非递归关系令牌的详细信息。
“关系令牌”组件属性
“关系令牌”组件包含以下属性:
属性 | API 名称 | 字段类型 | 描述 |
名称 | name | 字符串(最大长度为 128 个字符) | API 名称。 |
令牌标签 | label | 字符串(最大长度为 60 个字符) | UI 友好的字符串。 |
活动 | active | 布尔值 | 表明组件是否处于活动状态。 |
描述 | description | 字符串(最大长度为 1500 个字符) | 对此令牌的可选描述。 |
对象 | object | 对象 | 此令牌引用的对象的 API 名称。 |
字段标签 | field_label | Object.field | 在解析令牌时用作令牌标签的对象字段的 API 名称。只有当用户执行生成要求操作时,才会引用此属性。 |
VQL 标准 | vql_criteria | 字符串(最大长度为 1500 个字符) | (可选)要在解析此令牌时应用于对象记录的 VQL 标准。 |
父级令牌引用字段类型 | parent_token_object | 枚举 | 确定如何相对于此令牌处理父级令牌:
|
父级令牌 | parent_token | Relationaltoken | 父级令牌的令牌标签。对于自身 类型的父级令牌引用字段类型,请将此属性留空。 |
父级令牌引用字段 | parent_token_reference_field | Object.field | 父级令牌的字段标签。 |
父级令牌对象 | parent_token_object | 对象 | 父级令牌的对象的 API 名称。 |
父级令牌子级字段 | parent_token_child_field | Object.field | 父级令牌的字段标签的 API 名称。 |
请求要求对象映射 | request_requirement_object_mapping | Objectmapping | 所选的对象映射指向 request_requirement__v 对象。 |
EDL 对象映射 | edl_object_mapping | Objectmapping | 所选的对象映射指向 edl__v 对象。 |
EDL 项对象映射 | edl_item_object_mapping | Objectmapping | 所选的对象映射指向 edl_item__v 对象。 |
请求对象映射 | request_object_mapping | Objectmapping | 所选的对象映射指向 request__v 对象。 |
递归类型 | recursion_type | 枚举 | 指定要应用于此关系令牌的递归类型:
|
递归对象 | recursion_object | 对象 | 入站对象的 API 名称。对于成分递归类型,此属性将指定此令牌的入站关系的对象。 |
递归引用字段 | recursion_reference_field | Object.field | 对其应用递归的字段的 API 名称。 |
递归子级字段 | recursion_child_field | Object.field | 入站对象字段的 API 名称。对于成分递归类型,此属性将指定此令牌的入站关系的对象字段。 |
递归后使用 VQL 标准 | use_vql_criteria_post_recursion | 布尔值 | 指定是在创建记录后还是创建记录时应用 VQL 标准。 |
定义关系令牌设置
“关系令牌设置”组件类型定义了支持关系令牌的对象操作的设置。您必须将每个受支持的操作链接到适当的根关系令牌,以指定在解析关系令牌时每个操作引用哪个根令牌。这允许您定义间接引用对象的关系令牌。您可以根据需要将关系令牌设置组件中引用的关系令牌用于其他用途。
您必须使用 MDL 访问、创建和修改关系令牌设置。
建议将下面这两 (2) 个“关系令牌”组件(一个父级和一个子级)用作要链接到受支持的操作的根令牌。如果您的 Vault 中还没有这些组件,您可能需要予以创建:
属性 | 父级令牌 | 子级令牌 |
令牌标签 | registration_objective__c | registration_item__c |
API 名称 | registration_objective__c | registration_item__c |
对象 | registration__v | request__v |
父级令牌引用字段类型 | none | self |
父级令牌引用字段 | id__v | registration_objctive__v |
父级令牌 | 空 | registration_objective__c |
“关系令牌设置”组件属性
“关系令牌设置”组件包含以下属性:
属性 | API 名称 | 字段类型 | 描述 |
名称 | name | 字符串(最大长度为 128 个字符) | API 名称。 |
标签 | 标签 | 字符串(最大长度为 60 个字符) | UI 友好的字符串。 |
活动 | active | 布尔值 | 表明组件是否处于活动状态。 |
操作 | 操作 | 枚举 | 要对其应用此设置的受支持操作:
|
根令牌 | root_token | Relationaltoken | 指定的操作的根关系令牌。 |
关联对象类型 RIR | associated_object_type_rir | 对象类型 | 对象类型 Vault 将指定给指定操作生成的注册项要求记录。此属性仅适用于 GENERATE_REQUIREMENT 和 GENERATE_REQUIREMENT_FOR_RO 操作,必须在这些操作的关系令牌设置组件上填充唯一值。填充后,该值就无法更改。 |
将操作链接到根令牌
注意:如果不将受支持的操作链接到一个根令牌,当用户触发时,此操作将失败。
您必须创建关系令牌设置,并为以下受支持的操作设置操作 (action
) 和根令牌 (root_token
) 属性:
- 为注册项生成要求 (
GENERATE_REQUIREMENT
):注册项 (request__v
) 对象上的生成要求操作。根令牌(例如registration_item__c
)必须引用request__v
对象。 - 为注册目标生成要求 (
GENERATE_REQUIREMENT_FOR_RO
):注册 (registration__v
) 对象记录上的生成要求操作。根令牌(例如registration_objective__c
)必须引用registration__v
对象。 - 拆分注册项 (
SPLIT_REGISTRATION
):注册项 (request__v
) 对象上的拆分注册项操作。根令牌(例如registration_item__c
)必须引用request__v
对象。
如果正在使用推荐的关系令牌(registration_objective__c
和 registration_item__c
),我们还建议使用以下“关系令牌设置”组件,将受支持的操作链接到根令牌。如果您的 Vault 中还没有这些组件,您可能需要予以创建:
属性 | 为注册项生成要求 | 为注册目标生成要求 | 拆分注册项 |
标签 | generate_requirement | generate_requirement_for_ro | split_registration |
名称 | generate_requirement__c | generate_requirement_for_ro__c | split_registration__c |
操作 | GENERATE_REQUIREMENT | GENERATE_REQUIREMENT_FOR_RO | SPLIT_REGISTRATION |
根令牌 | registration_item__c | registration_objective__c | registration_item__c |
关联对象类型 RIR | 活动注册项请求对象类型的名称 | 活动注册项请求对象类型的名称 | 不适用 |
关系令牌中引用的任何对象必须直接或间接与受支持操作的根关系令牌所定义的对象相关,才能在执行此操作时解析关系令牌。例如,当在一个注册项记录上执行生成要求操作,而且一个相关的要求在名称字段中使用 packaging__c
关系令牌时,packaging__c
关系令牌必须是 registration_item__c
关系令牌的一个直接或间接子级。
重要提示:GENERATE_REQUIREMENT
和 GENERATE_REQUIREMENT_FOR_RO
操作的关系令牌设置组件必须在关联的对象类型 RIR 属性中引用不同的注册项请求对象类型。填充关联对象类型 RIR 值后,您不能对其进行更改。
定义注册属性
注册属性组件类型定义注册项字段属性,并将其映射到对象字段。您必须定义相关注册属性才能成功运行以下操作:
- 本地影响评估:根据您链接到每个组件的受监管类别属性影响确定注册和注册目标相匹配。
- 生成注册数据:基于链接到为组件指定的关系令牌的对象映射,填充源注册项记录上的指定字段。
- 运行全局操作更改:基于为每个组件指定的预定义全局操作更改字段,标识可能受全局操作更改影响的注册项。
对于每个注册项字段,您只能创建一 (1) 个“注册属性”组件。
“注册属性”组件属性
“注册属性”组件包含以下属性:
属性 | API 名称 | 字段类型 | 描述 |
名称 | name | 字符串(最大长度为 128 个字符) | API 名称。 |
标签 | 标签 | 字符串(最大长度为 60 个字符) | UI 友好的字符串。 |
活动 | active | 布尔值 | 表明组件是否处于活动状态。 |
对象 | object | object | 引用注册项对象。此值必须始终是 Object.request__v 。 |
字段 | field | object.field | 作为属性使用的注册项字段的名称,例如 Field.made_in__c 。此属性仅支持某些字段类型。如果您输入查找字段,则必须将关系令牌属性留空。 |
相关令牌 | relational_token | object.field | 活动关系令牌的名称。此属性为可选。如果您填充此属性,则确保为关系令牌上的请求对象映射字段填充一个有效的对象映射。对象映射确定 Vault 如何基于令牌解析在注册项上填充指定字段。Vault 根据用户运行的支持操作应用关系令牌:
|
全局操作更改对象 | global_operational_change_object | object | 引用全局操作更改对象。此值必须始终是 Object.global_operational_change__v 。仅当用户执行运行全球影响评估操作时,才会引用此属性。如您未配置全球变化影响评估,请将此属性留空。 |
全局操作更改字段 | global_operational_change_field | object.field | 活动自定义全局操作更改对象字段的名称,如 Field.made_in__c 。该属性仅支持某些字段类型,必须与作为组件字段属性输入的注册项字段类型相同。仅当用户执行运行全球影响评估操作时,才会引用此属性。如您未配置全球变化影响评估,请将此属性留空。 |
支持的字段类型
Vault 仅支持某些类型的注册属性属性对象字段:
Vault 为字段属性支持以下类型的对象字段:
- 日期
- 数字
- 对象(不包括对用户对象的引用)
- 选项列表(单值)
- 文本(包括长文本和富文本)
- 查找(只要该类型属于上面列出的受支持类型)
Vault 为全局操作更改字段属性支持以下类型的对象字段:
- 数字
- 对象(不包括对父对象和用户对象的引用)
- 选项列表(单值)
- 文本(包括长文本和富文本)
如果您在组件中包含全局操作更改字段属性,则其类型必须与添加到组件中的字段属性相同。