Replicating Objects between Two Salesforce Orgs
Overview
The Replication functionality enables you to replicate objects between two Salesforce org capable of replication. During the replication session, Vault reads the object from the replicated session and initiates the replication from the source to the target org.
Before You Begin
Salesforce Org registered with Vault.
Backup configured for your Salesforce Org. [Learn More]
At least one backup operation is triggered for your Salesforce Org in Vault.
How to do it?
Login to your Vault account.
Click on
Replicate
from the Vault dashboard page and click on Replicate Now.
On the next screen, select your
Salesforce Org
.
Next, select the
Destination Org
.
Next, select the
Replicate Source
and itsconfiguration
from the drop-down.
Based on the replicate source and configuration selection, the configured list will get displayed.
For
backup
as the replicate source, you can select multiple backups for replication. However forarchival/hierarchical backup
, you can choose only one from the list.
Click on either
EZ Replicate
orSelective Replicate
.
EZ Replicate
Full replication copies everything from the source to the destination, including new, updated, and existing data.
Select the
backups/hierarchical/archival
to replicate and click on theEZ Replicate
button.
The replicate checklists are displayed on the next pop-up screen, which must be considered before we proceed with the replicate operation. Click
Got It
to close the popup.
On the next screen:
Enter the
label
of your choice or leave the auto-generated default label.Specify the
batch size
for components to retrieve records. The max batch size that you can set per batch is 10K. This option helps run large jobs exceeding normal processing limits. Per the Salesforce governor limit, you can deploy or retrieve up to 10,000 files at once or a max size of 40 MB. Using Batch Size, you can process records in batches to stay within platform limits. If you have a lot of records, processing records through batches is your best solution.Choose the recipients from the
Email notification
dropdown who should receive notifications whenever the action is performed. The currently logged-in recipient will automatically be checked by default
Next, you can select the criteria for the replicate to get performed:
Disable Workflows:
On selection, all the workflows of the Salesforce objects will be deactivated, and the data will be transferred from the source to the destination sandbox. Once the replication is completed, workflows will get activated.Disable Validation rules:
Validation rules verify that the data a user enters in a record meets your specified criteria before the user can save the record. On selection, all the validation rules of the Salesforce objects will be deactivated, and the data will be transferred from the source to the destination sandbox. Once the replicate is done, validation rules will get activated.Enable Serial Mode for Bulk API:
Serial mode processes batch one at a time; however, it can increase the processing time for a load.Disable Triggers:
When working with data and metadata, you may want to disable triggers you have in place to guarantee a successful replicate operation. This feature disables Salesforce triggers only. Any managed package triggers will not be disabled.
The list of metadata and data objects replicated will be displayed for the last time before the replicate process begins. You will not have options to select individual objects as it is an entire replicate process.
Click
Replicate Now
.
Selective Replicate
This option allows you to select specific metadata/data that gets replicated only to the target org.
Select the backups/archival to replicate and click the
Selective Replicate
button.
The next screen displays the metadata and data objects that will be replicated. From the list of Metadata and Data type components, the user needs to select the components (along with their member) that will get replicated.
Under the
Metadata
tab, you can choose the metadata members for each metadata type.
On the
Data
tab, you additionally have the below configurations:Schema:
The Schema will allow you to view your selected object's corresponding child objects. With the most recent Vault 23.1 release, we improved the schema representation by showing one level of the child/parent objects at a time. The tree can now be expanded based on your selection rather than the entire tree, which speeds up the download of the schema data and improves the UI.
You may notice in the schema view that some objects are auto-selected by default and cannot be unchecked. These are the child objects of its parent object, which will be replicated if its parent object is selected. However, for other objects which are related to the selected object in some other way, you may have the option to choose them manually for replication. A warning popup appears when you click the
Save
button, stating you must select the appropriate hierarchy for the replicate procedure, or the process will fail. ClickOK
to dismiss the popup notification and return to the previous screen.
Mappings:
Map your source fields to your destination fields. Any matching headers from your source fields and your destination fields map automatically.
Records:
View the list of records for the object selected. Here, you can choose the records you wish to replicate to the destination org. You also have the option of importing records from a CSV file. To upload the CSV, click theChoose File
button in the top right corner of the screen.
Next, click on either the
Next
orReplicate
button. If you chooseNext
, you will be navigated to a new screen where you can add a new masking rule. Data masking refers to changing certain data elements within a data store so that the structure remains similar while the information is changed to protect sensitive information. It ensures that sensitive customer information is unavailable beyond the permitted production environment.However, if you want to skip the masking steps, click
Replicate
.
Let's create a masking rule before we conclude the replicate process. To do so, click on
Next
. Now, click on theNew Masking Rule
button available in the top right corner.
In the
Masking Form
screen, do the following:
Select the
object
for masking and choose thefield type
(string, date, phone, etc.).Choose the
Masking Style
:Prefix:
This option will add the character before the selected field name. For example, if the field value in source org is ABC, and the prefix masking value is kept as 123, then the final field value being deployed will be 123.ABCSuffix:
This option will add the character after the selected field name. For example, if the field value in source org is ABC, and the suffix masking value is kept as 123, then the final field value being deployed will be ABC.123Substitution:
This option will substitute the selected field name with the character you enter in the Masking Value field. For example, if the field value in source org is ABC, and the replace masking value is kept as 123, then the final field value being deployed will be 123Random:
This option helps mask the original value with a random value within a specified range. For example, if the field value in source org is ABC, and the random string length value is set to 7, then the deployed field value would be similar to 15d3aRG.
Choose the fields for which the masking will be applicable.
Once done, click on the
Add
button.
Now, click on the
Replicate
button.
The following popup screen displays the restore checklists, which must be considered before we continue with the replicate operation. Click on
Got It
button to close the popup.
On the next screen, you will need to:
On the next screen, enter the
Replicate label
of your choice or leave the auto-generated default label.Specify the
batch size
for components to retrieve records. 10K is the max batch size that you can set per batch. This option helps run large jobs that would exceed normal processing limits. As per the Salesforce governor limit, you can deploy or retrieve up to 10,000 files at once or a max size of 40 MB. Using Batch Size, you can process records in batches to stay within platform limits. If you have a lot of records, processing records through batches are your best solution.Choose the recipients from the
Email notification
dropdown who should receive notifications whenever the action is performed. The currently logged-in recipient will automatically be checked by default.Next, you can select the criteria for the replicate to get performed:
Disable Workflows:
On selection, all the workflows of the Salesforce objects will be deactivated, and the data will be transferred from the source to the destination sandbox. Once the replication is completed, workflows will get activated.Disable Validation rules:
Validation rules verify that the data a user enters in a record meets your specified criteria before the user can save the record. On selection, all the validation rules of the Salesforce objects will be deactivated, and the data will be transferred from the source to the destination sandbox. Once the replicate is done, validation rules will get activated.Enable Serial Mode for Bulk API:
Serial mode processes batch one at a time; however, it can increase the processing time for a load.Disable Triggers:
When working with data and metadata, you may want to disable triggers you have in place to guarantee a successful replicate operation. This feature disables Salesforce triggers only. Any managed package triggers will not be disabled.
Click
Replicate Now
.
You will be redirected to the
Replicate Summary
homepage, which will show you the progress of the replicate operation recently triggered.Click on the
Replicate Label
to view the list of metadata/data being replicated to the org. Click onExport
to locally save the restored metadata/data info in CSV format.
Replicate Summary
For each Replicate activity triggered in Vault, you will find the below details:
Attribute | Description |
---|---|
| The label name that you have assigned for your restore activity. Click on the label to find the list of successful/failed metadata and data members that are part of the restore operation. Also, you can export to save the restored metadata/data info in CSV format locally. |
| Get a snapshot of your restore operation |
| Date and time stamp for your restore operation |
| Total time taken to complete the restore operation |
| Total count of metadata objects that were successfully restored |
| Total count of metadata objects that failed to restore |
| Total count of data objects that were successfully restored |
| Total count of data objects that failed to restore |
| Restore status (success or failed) |
| Additional actions: |
Last updated