RegulatoryOne Registration & Dossier Management Vaults allow you to create Object Mapping MDL components with Field Mapping subcomponents to automate field population of certain records. You can map field values between a source and target object so that records created or populated from supported actions contain the same field values as related source records. You can also link an Object Mapping to a Relational Token so that Vault automatically populates mapped fields based on token resolution when a supported action runs. For example, you can map the ID field on the Claim object to an object reference field on the EDL Item object, then link the mapping to a Relational Token. When users run the Generate Requirements action on a Registration Item record, Vault automatically populates the object reference field on all generated EDL Item records with the same values in the Claim source object based on token resolution.

You can also use MDL to create Object Mappings with Field Mappings. See About RegulatoryOne Component Types for more details.

About Supported Actions

The following actions populate object records based on Object Mappings:

Activating the Object Mappings Tab

You can view, create, and edit Object Mapping and related Field Mappings on the Object Mappings tab. You must activate the tab and ensure that the appropriate Admin users have permission to view the tab as well as the Object Mapping Details and Object Mapping List pages.

Creating Object Mappings & Field Mappings

You must first create an Object Mapping that identifies the source and target objects. Then you can create Field Mappings for that Object Mapping that map specific fields on those objects. Vault automatically populates the fields in target object records with the same value as the source object record when users run supported actions. Some supported actions require you to link the Object Mapping to a Relational Token in order for Vault to automatically populate fields based on token resolution.

You can map multiple fields between two (2) objects but can only map fields of the same data type. For example, you can map a text type to a text type or a number type to a number type but cannot map a text type to a number type. Field Mappings do not support lookup or formula fields.

To create an Object Mapping with Field Mappings:

  1. Navigate to the Object Mappings tab.
  2. Click Create.
  3. Enter a unique Object Mapping Label.
  4. Enter a Source Object name such as claim__v or product__v. If you plan to use this Object Mapping with the Populate Registration Record action, you must enter request__v.
  5. Enter a Target Object name such as edl_item__v or request__v. If you plan to use this Object Mapping with the Populate Registration Record action, you must enter registration__v.
  6. Click Save to reveal the Field Mappings section.
  7. In the Field Mappings section, click Add.
  8. In the New Field Mapping dialog, select a Source Field such as ID and a Target Field such as product__v. The Target Field must be an editable field on the Target Object. The Source Field and Target Field must both be active. If either field is inactive, the job will fail when users attempt to generate new records. There are additional considerations depending on how you plan to use this Object Mapping:
    • To use this Object Mapping with the Populate Registration Record action to populate Registrations, the source and target fields types must be the same. Do not map the Name field if it is a system-managed field on the Registration object.
    • To use this Object Mapping in a Split Rule to split Registration Items, we recommend as a best practice that you map a unique field from the Source Object, such as the ID field, to a corresponding field on the Registration Item (request__v) Target Object. This will help users understand which specific records Vault creates when they trigger the Split Registration Items action.
  9. Click Confirm.
  10. Optional: Click Add to add additional Field Mappings to this Object Mapping.
  11. Click Save.

Names of Object Mappings and Field Mappings are automatically generated by Vault and cannot be changed.

Linking Object Mappings to Relational Tokens

You can link Object Mappings to Relational Tokens so that when users trigger certain supported actions, Vault automatically populates mapped fields on target records with values from source records based on token resolution in supported object records and MDL components. See Defining Relational Tokens for details about how to link an Object Mapping to a Relational Token.

Relational Token Supported Actions

The following actions support Relational Tokens linked to Object Mappings and populates fields based on token resolution:

Relational Token Supported Objects

To use an Object Mapping for a Relational Token in object records, you must specify a Source Object that matches the Object in the Relational Token. Relational Tokens support Object Mappings for the following Target Objects:

  1. Registration Item (request__v)
  2. Registration Item Requirement (request_requirement__v)
  3. EDL (edl__v)
  4. EDL Item (edl_item__v)

Relational Token Supported Component Types

To link an Object Mapping to a Relational Token to use in a Registration Attribute component, you must specify a Source Object that matches the Object in the Relational Token and the Target Object value must be request__v. See Configuring Local Impact Assessments for more details.

You can complete all the steps in this article with the standard System Administrator or Vault Owner security profile. If your Vault uses custom security profiles, your profile must grant the following permissions:

Type Permission Controls
Security Profile Admin: Configuration: All Configuration Ability to create and modify Object Mappings and Field Mappings.
Security Profile Pages: All Pages: Object Mapping List: View Ability to view the Object Mapping List page on the Object Mappings tab.
Security Profile Pages: All Pages: Object Mapping Details: View Ability to view the Object Mapping Details page on the Object Mappings tab.
Security Profile Tabs: All Tabs: Object Mapping: View Ability to view the Object Mappings tab.