在配置过程中,有些 RegulatoryOne 注册和档案管理功能要求为特定的组件类型创建组件。组件类型是 Vault 的配置元素,可扩展 Vault 的功能行为。组件是包含特定配置详细信息的组件类型的实例。有些组件在子组件中存储其他数据。组件与其子组件之间存在父子关系,这意味着一个子组件总是属于一个父级组件。

您可以在注册和档案管理 Vault 中查看、创建和编辑某些组件;但有些组件只能在 MDL 中访问。您必须使用 MDL 停用、重新激活和删除本文中包含的任何组件类型。请参阅关于 Vault 组件,以了解有关如何在 MDL 中访问、创建和修改组件的更多详细信息。

组件类型

注册和档案管理 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_labelObject.field在解析令牌时用作令牌标签的对象字段的 API 名称。只有当用户执行生成要求操作时,才会引用此属性。
VQL 标准vql_criteria字符串(最大长度为 1500 个字符)(可选)要在解析此令牌时应用于对象记录的 VQL 标准。
父级令牌引用字段类型parent_token_object枚举确定如何相对于此令牌处理父级令牌:
  • 自身:父级令牌引用字段与此令牌位于同一个对象上。
  • 父级:父级令牌引用字段位于父级令牌的对象上。
  • 成分:父级令牌引用字段位于一个与此令牌的对象有关系的联合对象或成分对象上。
  • :此令牌没有任何父级,父级令牌引用字段是“ID”。
父级令牌parent_tokenRelationaltoken父级令牌的令牌标签。对于自身类型的父级令牌引用字段类型,请将此属性留空。
父级令牌引用字段parent_token_reference_fieldObject.field父级令牌的字段标签。
父级令牌对象parent_token_object对象父级令牌的对象的 API 名称。
父级令牌子级字段parent_token_child_fieldObject.field父级令牌的字段标签的 API 名称。
请求要求对象映射request_requirement_object_mappingObjectmapping所选的对象映射指向 request_requirement__v 对象。
EDL 对象映射edl_object_mappingObjectmapping所选的对象映射指向 edl__v 对象。
EDL 项对象映射edl_item_object_mappingObjectmapping所选的对象映射指向 edl_item__v 对象。
请求对象映射request_object_mappingObjectmapping所选的对象映射指向 request__v 对象。
递归类型recursion_type枚举指定要应用于此关系令牌的递归类型:
  • 自身:递归引用字段位于此令牌的对象上。
  • 成分:递归引用字段位于一个与此令牌的对象相关的联合对象或成分对象上。
递归对象recursion_object对象入站对象的 API 名称。对于成分递归类型,此属性将指定此令牌的入站关系的对象。
递归引用字段recursion_reference_fieldObject.field对其应用递归的字段的 API 名称。
递归子级字段recursion_child_fieldObject.field入站对象字段的 API 名称。对于成分递归类型,此属性将指定此令牌的入站关系的对象字段。
递归后使用 VQL 标准use_vql_criteria_post_recursion布尔值指定是在创建记录后还是创建记录时应用 VQL 标准。

定义关系令牌设置

“关系令牌设置”组件类型定义了支持关系令牌的对象操作的设置。您必须将每个受支持的操作链接到适当的根关系令牌,以指定在解析关系令牌时每个操作引用哪个根令牌。这允许您定义间接引用对象的关系令牌。您可以根据需要将关系令牌设置组件中引用的关系令牌用于其他用途

您必须使用 MDL 访问、创建和修改关系令牌设置。

建议将下面这两 (2) 个“关系令牌”组件(一个父级和一个子级)用作要链接到受支持的操作的根令牌。如果您的 Vault 中还没有这些组件,您可能需要予以创建:

属性父级令牌子级令牌
令牌标签registration_objective__cregistration_item__c
API 名称registration_objective__cregistration_item__c
对象registration__vrequest__v
父级令牌引用字段类型noneself
父级令牌引用字段id__vregistration_objctive__v
父级令牌registration_objective__c

“关系令牌设置”组件属性

“关系令牌设置”组件包含以下属性:

属性API 名称字段类型描述
名称name字符串(最大长度为 128 个字符)API 名称。
标签标签字符串(最大长度为 60 个字符)UI 友好的字符串。
活动active布尔值表明组件是否处于活动状态。
操作操作枚举要对其应用此设置的受支持操作:
  • GENERATE_REQUIREMENT
  • GENERATE_REQUIREMENT_FOR_RO
  • SPLIT_REGISTRATION
根令牌root_tokenRelationaltoken指定的操作的根关系令牌。
关联对象类型 RIRassociated_object_type_rir对象类型对象类型 Vault 将指定给指定操作生成的注册项要求记录。此属性仅适用于 GENERATE_REQUIREMENTGENERATE_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__cregistration_item__c),我们还建议使用以下“关系令牌设置”组件,将受支持的操作链接到根令牌。如果您的 Vault 中还没有这些组件,您可能需要予以创建:

属性为注册项生成要求为注册目标生成要求拆分注册项
标签generate_requirementgenerate_requirement_for_rosplit_registration
名称generate_requirement__cgenerate_requirement_for_ro__csplit_registration__c
操作GENERATE_REQUIREMENTGENERATE_REQUIREMENT_FOR_ROSPLIT_REGISTRATION
根令牌registration_item__cregistration_objective__cregistration_item__c
关联对象类型 RIR活动注册项请求对象类型的名称活动注册项请求对象类型的名称不适用

关系令牌中引用的任何对象必须直接或间接与受支持操作的根关系令牌所定义的对象相关,才能在执行此操作时解析关系令牌。例如,当在一个注册项记录上执行生成要求操作,而且一个相关的要求名称字段中使用 packaging__c 关系令牌时,packaging__c 关系令牌必须是 registration_item__c 关系令牌的一个直接或间接子级。

定义注册属性

注册属性组件类型定义注册项字段属性,并将其映射到对象字段。您必须定义相关注册属性才能成功运行以下操作:

  • 本地影响评估:根据您链接到每个组件的受监管类别属性影响确定注册注册目标相匹配。
  • 生成注册数据:基于链接到为组件指定的关系令牌的对象映射,填充源注册项记录上的指定字段。
  • 运行全局操作更改:基于为每个组件指定的预定义全局操作更改字段,标识可能受全局操作更改影响的注册项

对于每个注册项字段,您只能创建一 (1) 个“注册属性”组件。

“注册属性”组件属性

“注册属性”组件包含以下属性:

属性API 名称字段类型描述
名称name字符串(最大长度为 128 个字符)API 名称。
标签标签字符串(最大长度为 60 个字符)UI 友好的字符串。
活动active布尔值表明组件是否处于活动状态。
对象objectobject引用注册项对象。此值必须始终是 Object.request__v
字段fieldobject.field作为属性使用的注册项字段的名称,例如 Field.made_in__c。此属性仅支持某些字段类型。如果您输入查找字段,则必须将关系令牌属性留空。
相关令牌relational_tokenobject.field活动关系令牌的名称。此属性为可选。如果您填充此属性,则确保为关系令牌上的请求对象映射字段填充一个有效的对象映射。对象映射确定 Vault 如何基于令牌解析在注册项上填充指定字段。Vault 根据用户运行的支持操作应用关系令牌:
  • 生成要求:忽略此属性。
  • 生成注册数据:根据令牌解析确定使用哪个对象映射填充注册项上的指定字段。
  • 运行全局操作更改:生成的注册项上的映射字段为空。
全局操作更改对象global_operational_change_objectobject引用全局操作更改对象。此值必须始终是 Object.global_operational_change__v。仅当用户执行运行全球影响评估操作时,才会引用此属性。

如您未配置全球变化影响评估,请将此属性留空。

全局操作更改字段global_operational_change_fieldobject.field活动自定义全局操作更改对象字段的名称,如 Field.made_in__c。该属性仅支持某些字段类型,必须与作为组件字段属性输入的注册项字段类型相同。仅当用户执行运行全球影响评估操作时,才会引用此属性。

如您未配置全球变化影响评估,请将此属性留空。

支持的字段类型

Vault 仅支持某些类型的注册属性属性对象字段:

字段属性

Vault 为字段属性支持以下类型的对象字段:

  • 日期
  • 数字
  • 对象(不包括对用户对象的引用)
  • 选项列表(单值)
  • 文本(包括长文本和富文本)
  • 查找(只要该类型属于上面列出的受支持类型)

全局操作更改字段属性

Vault 为全局操作更改字段属性支持以下类型的对象字段:

  • 数字
  • 对象(不包括对父对象和用户对象的引用)
  • 选项列表(单值)
  • 文本(包括长文本和富文本)

如果您在组件中包含全局操作更改字段属性,则其类型必须与添加到组件中的字段属性相同。