Last updated Sep 23, 2021

Rate this page:

Understanding the app assessment user interface

Your customers use the Assess your apps screen in the Jira/Confluence Cloud Migration Assistant to assess and make a decision about migrating their current Marketplace Partner apps to cloud. This page provides information about the statuses that display on the Cloud Migration Assistant (CMA) while customers assess their apps.

Use the table below to understand the icons that appear in the ‘Exists in cloud’ and ‘Can be migrated’ columns of the Assess your apps screen in the Cloud Migration Assistant. These icons inform users about the availability of your:

  • cloud app
  • migration path and documentation

The table also suggests solutions to accurately surface your app's status in the Cloud Migration Assistant.

Description of columns in 'Assess your apps' screen of Cloud Migration AssistantsAssessment criteria & suggested action
Exists in cloud
column
Can be migrated
column

The View differences label links customers to your feature differences documentation or your Marketplace listing

The Automated path label links the user to your documentation about migrating app data using the App migration platform.
Assessment criteria: The columns in the user interface display the icons shown in this row if:
  • You have a cloud app listing in Marketplace
  • Your customers can migrate data to your cloud app
  • Your customers can use the CMA to migrate data to your cloud app
  • You have linked to your feature differences documentation.
    If you have not linked to your feature differences documentation, the 'View differences' label links to your Marketplace listing.
  • You have linked to your migration instructions documentation
  • Your app is placed in Stage 1 based on its migration success rate


  • The View differences label links customers to your feature differences documentation or your Marketplace listing

    The Automated path label links the user to your documentation about migrating app data using the App migration platform.
    Assessment criteria: The columns in the user interface display the icons shown in this row if:
  • You have a cloud app listing in Marketplace
  • Your customers can migrate data to your cloud app
  • Your customers can use the CMA to migrate data to your cloud app
  • You have linked to your feature differences documentation.
    If you have not linked to your feature differences documentation, the 'View differences' label links to your Marketplace listing.
  • You have linked to your migration instructions documentation
  • Your app is placed in Stage 2 based on its migration success rate


  • The View differences label links customers to your feature differences documentation or your Marketplace listing

    The Automated path label links the user to your documentation about migrating app data using the App migration platform.
    Assessment criteria: The columns in the user interface display the icons shown in this row if:
  • You have a cloud app listing in Marketplace
  • Your customers can migrate data to your cloud app
  • Your customers only need to use the CMA to install the cloud app, and app data migration occurs with core product migration.
  • You have linked to your feature differences documentation.
    If you have not linked to your feature differences documentation, the 'View differences' label links to your Marketplace listing.
  • You have linked to your migration instructions documentation


  • The View differences label links customers to your feature differences documentation or your Marketplace listing

    The Automated path label link is disabled and the customer will not be able to access any of your migration instructions documentation
    Assessment criteria: The columns in the user interface display the icons shown in this row if:
  • You have a cloud app listing in Marketplace
  • Your customers can migrate data to your cloud app
  • Your customers can use the CMA to migrate data to your cloud app
  • You have linked to your feature differences documentation. If you have not linked to your feature differences documentation, the 'View differences' label links to your Marketplace listing.
  • You have not linked to your migration instructions documentation

  • Recommended action:
  • To surface links in the CMA to your migration instructions documentation, use the Marketplace API endpoint's migrationDocumentation parameter.
  • To surface links in the CMA to your feature difference documentation, use the Marketplace API endpoint’s featureDifferenceDocumentation parameter.

  • The View differences label links customers to your feature differences documentation or your Marketplace listing

    The View path label links customers to your documentation that explains your migration workaround instructions that does not use the CMA
    Assessment criteria: The columns in the user interface display the icons shown in this row if:
  • You have a cloud app listing in Marketplace
  • Your customers can migrate data to your cloud app
  • Your customers cannot use the CMA to migrate data to your cloud app
  • You have linked to your feature differences documentation.
    If you have not linked to your feature differences documentation, the 'View differences' label links to your Marketplace listing.
  • You have linked to your migration instructions documentation

  • Recommended action:
  • Use the Marketplace API endpoint’s cloudMigrationAssistantCompatibility parameter to allow the CMA to change the status from View path to Automated path when applicable.
  • To surface links in the CMA to your migration instructions documentation, use the Marketplace API endpoint's migrationDocumentation parameter.
  • To surface links in the CMA to your feature difference documentation, use the Marketplace API endpoint’s featureDifferenceDocumentation parameter.

  • The View differences label links customers to your feature differences documentation or your Marketplace listing

    The Upgrade app label links customers to upgrade options in the ‘Manage your apps’ section within their server instance.
    Assessment criteria: The columns in the user interface display the icons shown in this row if:
  • You have a cloud app listing in Marketplace
  • Your customers can migrate data to your cloud app
  • Your customer is using a server app version that is not compatible with the CMA. The customer must upgrade to a server app version that supports the CMA
  • You have linked to your feature differences documentation.
    If you have not linked to your feature differences documentation, the 'View differences' label links to your Marketplace listing.
  • The CMA will not surface your migration instructions documentation if customers aren't using a CMA-supported server app version.

  • Recommended action:
  • Use the Marketplace API endpoint’s cloudMigrationAssistantCompatibility parameter to allow the CMA to identify if the customer is using a server app version that supports the CMA. The Upgrade app icon is displayed if the customer's server app is not compatible with the CMA and needs upgrade. The status will change from Upgrade app to Automated path when the customer upgrades their app version.
  • To surface links in the CMA to your migration instructions documentation, use the Marketplace API endpoint's migrationDocumentation parameter.
  • To surface links in the CMA to your feature difference documentation, use the Marketplace API endpoint’s featureDifferenceDocumentation parameter.

  • The View differences label links customers to your feature differences documentation.

    The Contact vendor label links customers to the support section of the Marketplace Partner listing.
    Assessment criteria: The columns in the user interface display the icons shown in this row if:
  • You have a cloud app listing in Marketplace
  • Your customers cannot migrate data to your cloud app
  • You have linked to your feature differences documentation. If you have not linked to your feature differences documentation, the 'View differences' label links to your Marketplace listing.

  • Recommended action:
    Provide key dates and/or roadmaps in your support section documentation of your Marketplace listing that informs customers about the availability of your app data migration path.
    Assessment criteria: The columns in the user interface display the red cross icons to indicate that your app does not exist in cloud, and hence customers cannot migrate their app data to cloud.
    Assessment criteria: The columns in the user interface display the icons shown in this row if:
  • the CMA cannot retrieve information from the server app due to technical reasons
  • Rate this page: