# Original Record Id Rule Tools

The Original Record Id Rule tool is used to create a custom field in the target Salesforce and populate the new custom field with record Ids from the CopyStorm backup database. This is useful in a number of migration scenarios when the original Id of records being migrated must be maintained.

For example:

* The Original Id may be used after the migration to correlate data between the source and target orgs.
* Salesforce Id may be used as a key by an external system which must be able to access the original Salesforce Id.

![](https://2924009365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5FyPmqVkPxhj2oT8fbgB%2Fuploads%2Fgit-blob-a4826ebd9bd9831787239c260ff62cb3a2831338%2F3da94828-OriginalRecordIdRulePicture1.png?alt=media)

## Original Id Field Configuration

Original Id field creation is enabled by checking the “Enable this Feature” checkbox. Available options include:

![](https://2924009365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5FyPmqVkPxhj2oT8fbgB%2Fuploads%2Fgit-blob-94d04bfa522cdaf7e72bf33029ec8b0c55e7c178%2Fa09238e3-OriginalRecordIdRulePicture2.png?alt=media)

| Configuration Option | Description                                                                                                                                                                                                                                                            |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Enable This Feature  | Check this checkbox to enable Original Id column creation and population.                                                                                                                                                                                              |
| Field API Name       | The Salesforce API Name of the Original Id field. This field will be created automatically if it does not already exist.                                                                                                                                               |
| Field Label          | The Label to use when creating the Original Id field.                                                                                                                                                                                                                  |
| Permission Set Name  | When creating an Original Id field on a Salesforce Object, CopyStorm/Restore will update this Permission Set to allow access to the new field. This permission set will be created and assigned to the CopyStorm/Restore Salesforce User if it does not already exist. |
| Field Description    | The Description to use when creating the Original Id field.                                                                                                                                                                                                            |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learn.capstorm.com/copystorm-restore/reference/migration-setup-tab/original-record-id-rule-tools.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.