# Restoring Metadata/Data to a Salesforce Org

## Overview <a href="#overview" id="overview"></a>

This article discusses the procedure for restoring metadata and data to your Salesforce organization and the menu options available for restoring information in Vault.

## Before You Begin <a href="#before-you-begin" id="before-you-begin"></a>

Ensure you have the following:

* Salesforce Org registered with Vault.&#x20;
* Backup configured for your Salesforce Org. \[[Learn More](https://knowledgebase.autorabit.com/~/revisions/HjllPHzLVe0LqFYH7gIg/product-guides/vault/configuring-vault/registering-salesforce-org/setup-backup-configuration-for-salesforce-org)]
* At least one backup operation is triggered for your Salesforce Org in Vault.

## How do I restore data / metadata? <a href="#how-to-do-it" id="how-to-do-it"></a>

1. Log in to your Vault account.
2. Click **`Restore`** from the Vault dashboard page and click on **`Restore Now`**.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2Fkv8KUF3BGS1bR0kiPe1J%2Fimage.png?alt=media&#x26;token=00b9848f-32b1-41df-9694-2f6b689c02c8" alt=""><figcaption></figcaption></figure>

3. On the next screen, select your source [**`Salesforce Org`**](https://knowledgebase.autorabit.com/~/revisions/HjllPHzLVe0LqFYH7gIg/product-guides/vault/configuring-vault/registering-salesforce-org).

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FBcrt9aamdMWoFpZJWVwJ%2Fimage.png?alt=media&#x26;token=e47c4813-b46b-4377-a74b-07949360f2dd" alt="" width="563"><figcaption></figcaption></figure>

4. Next, select the **`restore source`** and its **`configuration`** from the dropdown.\\

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FAXUi6lJkjeRzyBHTcux9%2Fimage.png?alt=media&#x26;token=88c38951-a808-4531-ad22-1f41aa74f584" alt=""><figcaption></figcaption></figure>
5. Click **`Get Details`**.
6. The configured list will be displayed based on the restore source and configuration selection.

   * To restore the **source** as **`backup`**, select multiple backups for restoration.

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FXffMAgeEp9nuNhwvrnK3%2Fimage.png?alt=media&#x26;token=b893103a-000e-416f-a5db-1753a5877989" alt=""><figcaption></figcaption></figure>

   * For **`hierarchical backup`** and **`archival`**, you can choose only one from the list.

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2Fv0YgGEC38fB4gkl8m3xk%2Fimage.png?alt=media&#x26;token=eb74f435-9ae3-423a-85b0-c3cd0ef044aa" alt=""><figcaption></figcaption></figure>

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FFavzwRp49WHpnLQZF9mt%2Fimage.png?alt=media&#x26;token=36384222-7ba4-430c-80cc-79a33914c18f" alt=""><figcaption></figcaption></figure>
7. Click on either **`EZ Restore`** or **`Selective Restore`**.

{% hint style="info" %}
**Important Note**: Restore Source as **`nCino features`** will be displayed only for Salesforce Orgs configured with nCino objects. For detailed nCino restore features, refer to the article: [nCino Restore Features](https://knowledgebase.autorabit.com/~/revisions/HjllPHzLVe0LqFYH7gIg/product-guides/vault/ncino/restoring-ncino-features).
{% endhint %}

### EZ-Restore <a href="#ezrestore" id="ezrestore"></a>

EZ-Restore copies everything from the source to the destination, including new, updated, and existing data.

#### **EZ-Restore Steps:**

1. Select the backup(s) from the list and click on the **`EZ Restore`** button.\\

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FLZm0re74gzinx2Ut5Lvu%2Fimage.png?alt=media&#x26;token=5ec8aab4-137e-48ea-9e15-8f949774aa7a" alt=""><figcaption></figcaption></figure>
2. The **restore checklists** are displayed on the next pop-up screen, which must be considered before proceeding with the restoration operation. Once you're done, click the **`Got It`** button. \\

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FG2VMBHsirfaHFyO2Sps8%2Fimage.png?alt=media&#x26;token=0ad4530f-9627-4088-a173-b80b0f940d2b" alt=""><figcaption></figcaption></figure>
3. 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 from the **`Email notification`** dropdown which **recipients** should receive notifications whenever the action is performed. The currently logged-in recipient will automatically be checked by default.
4. Next, you can select the **criteria** for the restore to be performed:
   * **`Disable Workflows:`** On selection, all the workflows of the Salesforce objects are deactivated, and the data is transferred from the source to the destination sandbox. Once the restore is completed, workflows are reactivated.
   * **`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 are deactivated, and the data will be transferred from the source to the destination sandbox. Once the restore is done, validation rules are reactivated.
   * **`Enable serial mode for Bulk API:`** Serial mode processes batch one at a time; however, it increases the processing time for a load.
   * **`Disable Relationship Mapping:`** The child objects related to selected objects will not be fetched on selection.
   * **`Disable Triggers:`** To ensure a successful recovery when working with data and metadata, you may wish to disable any triggers you have set. *This feature disables Salesforce triggers only.  Any managed package triggers will not be disabled.*
5. The list of **metadata** and **data** objects replicated will be displayed for the last time before the restore process begins. You will not have options to select individual objects as it is an entire restore process.
6. Click **`Restore Now`**.\\

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FJIOzY6o23QTAytlahYZV%2Fimage.png?alt=media&#x26;token=5680a527-c551-434a-8938-59f80bc05207" alt=""><figcaption></figcaption></figure>

### Selective Restore <a href="#selective-restore" id="selective-restore"></a>

This option allows you to select specific metadata or data that gets restored only to the target organization.&#x20;

Select the backup(s) from the list and click on the **`Selective Restore`** button.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2Fu1PGd4dUl6YM1YY1ZJ12%2Fimage.png?alt=media&#x26;token=1f179abc-47ab-4c5f-8121-76a714e88b3c" alt=""><figcaption></figcaption></figure>

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 members) that will be restored.

1. Under the **`Metadata`** tab, choose the metadata members for each metadata type.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FfsIdlXXzPka8vGuop7kg%2Fimage.png?alt=media&#x26;token=b4a5adec-e366-496b-b7ec-e072e85370ae" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FnLQSGlQFQBmWd8V9XOZX%2Fimage.png?alt=media&#x26;token=135dc8a8-546f-4511-acd5-c9f42a9a1cf3" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FnOwMKlY10Ax1guDNC4xO%2Fimage.png?alt=media&#x26;token=724bf1c8-c51b-4020-83f0-caff0175bcdb" alt=""><figcaption></figcaption></figure>

2. Under the **`Data`** tab, you have multiple configurations to choose from:

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2F9iELUQpOWp9uiQFUSCuL%2Fimage.png?alt=media&#x26;token=1e1f4e6c-8a8a-4985-b04d-2423007f4358" alt=""><figcaption></figcaption></figure>

* **`Schema:`** The schema will allow you to view your selected object's corresponding child objects. With the **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.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FzgtdZOQFGPeZ3U7Gbm2t%2Fimage.png?alt=media&#x26;token=c64c8e47-23ee-415c-8f11-f762a3c23ba8" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FTdtAU6UkpIMFA5P5S6R5%2Fimage.png?alt=media&#x26;token=066a2e2c-efdc-4625-b3d8-943798d44e20" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
**Important Note:**

1. You may notice in the *schema* view that some objects are auto-selected by default and cannot be unchecked. These are child objects of a parent object, which will be restored if its parent object is selected. However, for other objects related to the selected object in some other way, you can choose them manually.
2. When you click the **`Save`** button, a warning popup appears, stating that you must select the appropriate hierarchy for the restore procedure or the process will fail. Click **`OK`** to dismiss the popup notification and return to the previous screen.

<img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2F61KPGQ8YQSYhtTaDQlwu%2Fimage.png?alt=media&#x26;token=efe38ff9-25bd-4097-a447-ab6e5c087e21" alt="" data-size="original">
{% endhint %}

* **`Selected Records:`** By default, all the records available in the objects will be auto-selected. To choose specific records, click **`All`** under **`Selected Records,`** which will lead you to a pop-up box where you can select the record. Post selection, the summary table should show the number of records set.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FDtbUkqIRrCG0xTyCej1K%2Fimage.png?alt=media&#x26;token=2be73c4b-ad94-414a-b26e-1509d2b04316" alt=""><figcaption></figcaption></figure>

You also have the option of importing records from a CSV file. To upload the CSV from your local system, click the **`Choose File`** button in the top right corner of the screen.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2Fqb7AvIOVGmN1VKWmb8dC%2Fimage.png?alt=media&#x26;token=28beaf5a-70aa-4f88-8943-93cee584a567" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FRE4WJwh6XOtmvPC3efLR%2Fimage.png?alt=media&#x26;token=d8befd2d-64bb-4691-8a93-6797a0991afa" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FcxO6vUtO3wmZXcTQq3IW%2Fimage.png?alt=media&#x26;token=95de4649-1a99-44a3-a1c9-6dcec1b65231" alt=""><figcaption></figcaption></figure>

* **`Selected Fields:`** By default, all the fields will be chosen for the objects selected. Clicking **`“All”`** under the **`Selected Fields`** column will open a pop-up window with all the fields listed for the selected objects. You can also use the **search** filter to search for a specific field faster. Here, you can map your source field with the destination field. The destination field should default to be mapped based on the source field name.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FQOW0l7WXrfbZdDgFdTZW%2Fimage.png?alt=media&#x26;token=67dcb9ef-8e85-4a18-a9c1-3540816231fc" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Important Note:**

1. The mandatory fields are auto-selected, so you do not have the option to disable them. For example, the **`ID`** field.
2. It is mandatory to select at least one field; if no field is selected and you try to proceed further, a warning popup will be displayed stating, **`“Select at least one field to proceed.”`**
3. The unchecked fields will have a null value in the record.
   {% endhint %}

Based on your selection, the restore will happen only for selected fields. Post selection, the summary table should show the number of fields selected.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FvkoumSDikWdMQk8e4d55%2Fimage.png?alt=media&#x26;token=655e848c-e0d9-4c3c-b45a-601eedc64999" alt=""><figcaption></figcaption></figure>

3. Click on **`Trigger Restore`**.

<figure><img src="https://cdn.document360.io/8711f4e7-c040-4616-aac9-d947f87e4619/Images/Documentation/image-1644318580634.png" alt=""><figcaption></figcaption></figure>

* The restore checklists are displayed on the next pop-up screen, which must be considered before proceeding with the restoration operation. Click **`Got It`** to dismiss the popup. \\

  <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2F1kdVluINwdwF0xfrWvAs%2Fimage.png?alt=media&#x26;token=895ccce9-e128-4a20-af49-28bfe2d60679" alt=""><figcaption></figcaption></figure>

4. 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, select the criteria for the restore to be performed:
     1. **`Disable Workflows:`** On selection, all the workflows of the Salesforce objects are deactivated, and the data will be transferred from the source to the destination sandbox. Once the restore is completed, workflows are reactivated.
     2. **`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 are deactivated, and the data will be transferred from the source to the destination sandbox. Once the restore is done, validation rules are reactivated.
     3. **`Enable serial mode for Bulk API:`** Serial mode processes batch one at a time; however, it increases the processing time for a load.
     4. **`Disable Relationship Mapping:`** The child objects related to selected objects are not fetched on selection.
     5. **`Disable Triggers:`** To ensure a successful recovery when working with data and metadata, you may disable any triggers you have set. *This feature disables Salesforce triggers only. Any managed package triggers are not disabled.*
5. Click **`Restore Now`**.\\

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FvOcWAkEB3fjnGQpzDpwg%2Fimage.png?alt=media&#x26;token=f1d84d30-83f9-4a85-8186-260fb67d5ec9" alt=""><figcaption></figcaption></figure>
6. You'll be taken to the **`Restore Summary`** screen, which will display the status of the recently triggered restore activity.

## Excluding System-Generated Feed Items – Restore

The Vault application now automatically identifies and excludes system-generated FeedItems during the Restore processes. This ensures that, these items do not cause any failures during these operations.

### **Key Features**

1. **Automatic Identification**: System-generated FeedItems are detected and excluded without requiring manual intervention.
2. **Error Prevention**: By excluding these FeedItems, potential errors during Restore processes are avoided.
3. **Logging for Transparency**: All excluded FeedItems are logged for tracking purposes, providing clear visibility into the process.

### Logs

The following is a sample log for reference, showing the excluded system-generated Feeditems:

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2Fa39Vn1nDFPX8O4cq07qc%2Fimage.png?alt=media&#x26;token=f92ca8de-f684-4a7c-96ce-13f06d720a1e" alt=""><figcaption></figcaption></figure>

### Restore Log

Refer to these logs to verify the exclusions and ensure smooth operations during the Restore process.

## Restore Summary <a href="#restore-summary" id="restore-summary"></a>

For each restore activity triggered in Vault, you will find the details below:

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2Ftp0pSPPU5YoNjrc2iX7l%2Fimage.png?alt=media&#x26;token=a48d4738-7bb0-4baa-be5a-25ec623a7fee" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FpjuhDCoHoIKSPaPQXUie%2Fimage.png?alt=media&#x26;token=2c8886a7-91bd-4c2f-9cce-ef639bdb98b9" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="210">Attribute</th><th>Description</th></tr></thead><tbody><tr><td><code>Label</code></td><td>The label name you assigned for your restore activity.<br>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 <strong>export</strong> to save the restored metadata/data info in CSV format locally. </td></tr><tr><td><code>Backup Info</code></td><td>Get a snapshot of your restore operation</td></tr><tr><td><code>Date/Time</code></td><td>Date and time stamp for your restore operation</td></tr><tr><td><code>Duration</code></td><td>Total time to complete the restore operation</td></tr><tr><td><code>MetaSuccess</code></td><td>The total count of metadata objects successfully restored</td></tr><tr><td><code>MetaFailure</code></td><td>Total count of metadata objects that failed to restore</td></tr><tr><td><code>SuccessRecords</code></td><td>The total count of data objects successfully restored</td></tr><tr><td><code>FailedRecords</code></td><td>Total count of data objects that was unable to restore</td></tr><tr><td><code>Status</code></td><td>Restore status (success or failure)</td></tr><tr><td><code>Actions</code></td><td><p>Additional actions:</p><ul><li><strong><code>Restore summary:</code></strong> View the restore summary report</li><li><strong><code>Log:</code></strong> Find the log details for your restore operation</li><li><strong><code>Abort:</code></strong> For an ongoing replicate operation, you can abort the process in between using the <strong><code>Abort</code></strong> icon</li></ul></td></tr></tbody></table>

\\
