A field map is generated for all organizations during a backup job. This map indicates a link between each object and a corresponding field that can be used as a mapping field, i.e., has the same value across sandbox and production organizations. Field mappings determine how data from a source corresponds to data in a destination.
This map is generated during the backup process, and eligible mapping fields are prioritized based on following criteria:
-
Field, which is an external Id, is unique and required
-
Field, which is unique and required
If no fields for the object matches this criterion, the Commvault Cloud software creates a new field called CvExternalId. To modify the generated field map, click Edit Field Mappings in the Restore options window. New fields can be added and existing fields modified. Any changes made this way are retained for subsequent jobs to the destination organization.
The source organization record ID is stored in the CvExternalId field as part of a restore job. Later, in subsequent jobs, this field is used to map the records with the source organization's ID. If a match is found, the record is updated. Otherwise, a new record is inserted. This is similar to an incremental restore job.
CvPermissionSet is used to create a new permission set for newly created CvExternalId fields on the restored objects. This permission set is then assigned to the logged in user of the destination organization, allowing that user account to access or insert values in this field later during the restore job.
The API name associated with CvExternalId is CvExternalId__c.