Last updated Apr 13, 2023

Rate this page:

Progress reporting

If you implement the listener interface, your cloud app must use the Status API to report on the overall progress of your app migration to the Jira/Confluence admin user in the Cloud Migration Assistant user interface.

Your cloud app must send the following to settle the transfer at the end of the migration:

  • SUCCESS, FAILED, or INCOMPLETE status
  • a percentage
  • an optional message

Note that there is a 14-day time-limit after you receive the first notification of your server app being triggered to access progress reports. After the 14-day period, the App migration platform will return a 400 error response to all requests for information using transferId.

About the Status API

Use the following endpoint of the Status API to send your App migration report to the Cloud Migration Assistant.

MethodEndpointPayload
POST/migration/progress/{transferId}{"status": "IN_PROGRESS/SUCCESS/FAILED/INCOMPLETE", "message": "string?", "percent" : int [ 0-100 ]}

In the endpoint above, specify the {transferId} that you want to send progress status about.

  • Sample request

    1
    2
    curl -X POST 'https://your-site.atlassian.net/rest/atlassian-connect/1/migration/progress/26925583-10bd-49fb-b67c-15fc2447a97b' \
    --header 'Content-Type: application/json' \
    --data-raw '{
                    "status" : "IN_PROGRESS",
                    "percent": 90,
                    "message" : "Migration is at the last stage. Refer this link {{link:http://myapp.com}} for different stages of migration."
                }'
    
  • Sample response

    1
    2
    200 OK
    

Status messages

You can use status messages for the following:

  • Report on the progress of your app migration to the Jira/Confluence admin user
  • Provide links to sites or entities involved in the migration

This page provides details about the types and format of status messages.

A preview of how status messages are displayed in the Cloud Migration Assistant
Above is a preview of how status messages are displayed in the Cloud Migration Assistant

Format of status messages

A status message can combine text, and elements to incorporate links. See the format of an element below.

Element format

{{[type]:[value]}}

The following table explains the above element format.

typeRepresents the type of element
valueThe value that the user interface needs to render

The Status API supports the following element type:

Note: http://documentation.mycompany.com/ in the above table is sample placeholder text that you can replace with your own link.

Length of status messages

We recommend restricting the length of your status message (inclusive of links) to 250-300 characters to ensure that it displays within the text area on the Jira/Confluence user interface.

App migration status update in Cloud Migration Assistant user interface

The Jira/Confluence Cloud Migration Assistant user interface does not display status updates from your cloud app in real-time.

There can be an interval of up to 90 seconds between the time your cloud app provides a status update and when the message is displayed on the Jira/Confluence Cloud Migration Assistant user interface.

Rate this page: