Performing the Data Migration
This page provides instructions for performing a Data Migration from one instance to another using an app created with the Data Migration Wizard. Instructions may vary slightly depending on if any customizations were made to the app outside of the Wizard. For help with specific user actions or action flows, refer to the appropriate section in this guide.
Prerequisites
- The app is to be activated for use by the user doing the migration.
- The user must also have access to the X-Author for Excel Designer tab.
To perform a data migration
-
From the X-Author Designer tab, export the app to your
computer and Import the app to the instance where your source data resides. Follow
the instructions under Importing
and Exporting an Application, then move to step 2 on this page.
Note:
Import Best Practice
To avoid errors using the app in the new org, make sure to click Sync App (from the Admin menu) after the import is complete. This will identify any existing mismatches in objects and fields defined in the app. If you do encounter errors upon validation, check the objects and fields affected, make changes to your app or in your org as needed, and perform the import process again. - Click on the X-Author for Excel tab to switch to the runtime view.
-
Select App > (your Data Migration App Name)to open the app.
-
Populate the app by choosing one of two options:
- Export Selective - Choose this action if you want to
search for and select specific records to export from the source org for each
Object in the data migration app. After making your selections, click
Next to retrieve data into the app.Tip:
Use this option when there are Filter criteria defined for any of the Objects in the app. User actions defined for Objects in the app (like Search & Select) only execute when this option is chosen.
- Export All - Choose this action if you want to export
ALL records from the source org for each Object in the data migration app. No
filters are applied.Note:
This option may take an unusually long amount of time to retrieve data if there are a large number of records in your Org.
- Export Selective - Choose this action if you want to
search for and select specific records to export from the source org for each
Object in the data migration app. After making your selections, click
Next to retrieve data into the app.
- From the Source Org section of the X-Author Excel tab, click Save Source Data.
-
Browse to a location on your system to save the workbook. Name the file and click Save. All data retrieved by the Export action is saved to the app.
- Close the app.
- From the X-Author Designer tab, click on Switch Connection and select the target org for data migration. Enter your credentials and connect.
-
You must now import the Data Migration app you exported in Step 1 into the target
org. Select Migrate > Import and browse to the app file.
-
Click Import. Verify the app imported successfully and click OK.
- Click on the X-Author for Excel tab to switch to the runtime view.
- Connect to the target org.
- Click on Apps > Open App and open the imported app.
-
From the Edit section, click on Paste and select
Paste from Mapping.
-
Browse to the app file save in Step 5 (saved source data) and click Open.
Note:Note
Source data that you exported is pasted into the app without Target Record ID. Record IDs will be assigned to all new records that are created when you migrate that data to the Target Org (but will not be represented in the app).
-
From the Target Org section of the ribbon, click Save All. The exported records from the source org are migrated to the target org. Depending on how much data you are migrating, this can take some time. When data migration is complete, a separate success message is shown for each Object being migrated. Click on Show details to view details.
Note:Note
The success message may not be shown if settings have been changed in X-Author Excel to suppress messages. Refer to Application Settings for more information.