Skip to main content
Gainsight Inc.

Migrate CTA Layouts and Success Plan Layouts

Overview

This article describes the process of migrating CTAs and Success Plan layouts, using Gainsight's X-Org Migration tool.

X-Org is Gainsight's migration tool which can be used to migrate data from a source object to a target object. (The source object can be a sandbox org and the target object can be a production org). To learn more about the X-Org tool refer to the X-org Migration Overview article in the Additional Resources section.

You can migrate CTA Types and Success Plan Types, as well as their corresponding layouts from a source org to a target org. 

Note: If you have included any custom fields in the migration task, you must ensure that the corresponding custom field is created in the target org as well. If the corresponding custom field is not present in the target org, the migration task fails.

Migrate CTA and Success Plan Layouts

Take the following steps to migrate CTA and Success Plan layouts: 

  1. Create a new CTA type within the source org. For the purposes of this tutorial, we created a CTA type called “High Risk”. For more information on how to create CTA Types, refer to the Create Custom CTA Types article in the Additional Resources section.

  2. Create a new Success plan type within the source org. For the purposes of this tutorial, we created a success plan type called “High Risk”. For more information on how to create Success Plan types, refer to the Configure Success Plan Types article in the Additional Resources section.

  3. Within the Target Org, navigate to Administration > Operations > Migration.

  4. Click GENERATE TOKEN.

  5. Click the copy icon to copy the token and click CLOSE.

Note: If you have already generated the token for the target org, you can use the existing token.

Screenshot 2023-03-01 at 2.26.13 PM.png

  1. Within the source org, navigate to Administration > Operations > Migration.

  2. Select New Migration from the ADD MIGRATION menu.

  3. Enter a name for the Migration.

  4. Enter the Migration Token.

  5. Click AUTHENTICATE. This will display the Migration Assets window.

Screenshot 2023-03-01 at 2.27.05 PM.png

  1. (Optional) Click RUN, to execute the Delta process. This process returns the difference in assets and other data between source and target orgs. For more information on this process, refer to the Run Delta Process Overview article in the Additional Resources section.

NXT Migrate cta success plan Delta Process.jpg

  1. (Optional) Select an entity type from the Select Entity Type dropdown menu. All the assets related to selected entity type are displayed.

  2. (Optional) Select the checkbox for the assets to be migrated.

  3. Click CONTINUE. The Configurations window is displayed.

  4. Expand CTA Configuration and click CTA Type. You can view a list of CTA types which are migrated and yet to be migrated. 

Screenshot 2023-03-01 at 2.29.09 PM.png

  1. Select the CTA Type checkbox. The High Risk CTA Type (and all other CTA Types) is selected for migration. You can clear the checkbox for CTA Types which are already migrated.
    Note: The layout corresponding to High Risk CTA Type is migrated by default.

Screenshot 2023-03-01 at 2.32.17 PM.png

  1. Expand Success Plan Configuration and select Success Plan Type. You can view a list of Success Plan Types which are migrated and yet to be migrated.

Screenshot 2023-03-01 at 2.34.14 PM.png

  1. Select the Success Plan Type checkbox. The High Risk (and all other Success Plan Types) are selected for migration.

Note: The layout corresponding to the High Risk Success Plan Type is migrated by default. 

Screenshot 2023-03-01 at 2.36.04 PM.png

  1. Click CONTINUE. The Objects section is displayed.

  2. (Optional) Select the Objects to be migrated.

  3. Click CONTINUE. The Summary section is displayed.

  4. Verify if all the items selected in the prior sections are included in the Summary section.

  5. Click MIGRATE. The Migrate window is displayed.

    • (Optional) Select the Test Run check box to perform a test/dummy migration. This process will not migrate any assets but will inform you if the migration will succeed or fail, if performed. The migration logs are identical to the logs of an actual migration.

    • (Optional) Select the Send Copy of Migration Status Email check box to send the migration status email to additional recipients. By default, only the logged in user receives an email on the status of the migration task. In the Email ID field enter the email addresses of an additional recipient.

  6. Click MIGRATE, to start the migration process. This displays the Migrations List page. The migration you initiated should be displayed with the status In Queue.

    Note: If you selected the Test Run option in the previous step, only a test migration will be performed.

Screenshot 2023-03-01 at 2.37.12 PM.png

When the Migration fails due to an absence of the respective custom field in the target org, you can view the error message in the Migration logs as shown below.

Note: The above error message is displayed on the Meta Config tab of the log file.

  • Was this article helpful?