App migration platform Developer

App migration platform Developer

Last updatedFeb 17, 2021

Rate this page:

Understand the App migration platform terminology

This page provides information about common terms in the docs.

Atlassian Connect
The framework that your cloud app uses to interact with the App migration platform and the cloud products. It also contains all the endpoints for migration.

App cloud migration library
Used to implement the interfaces to enable communication between your server app and the App migration platform.

App migration platform
The set of Atlassian libraries and APIs provided to vendors in view to help them implement their app data migration from server to cloud.

Cloud app
A vendor app installed on the cloud site.

Container
A group of steps (transfers) in a migration to fully migrate a group of related entities. For instance, a project container in the context of Jira will contain all the transfers needed to migrate its issues, workflows, attachments, etc. Every migration must contain at least one container. In the context of app migration, each app migration is represented by a container which contains a single transfer. The execution of this transfer is delegated to Marketplace Partners through the App migration platform.

Core data
In the context of the migrations, the Jira or Confluence product data migrated from a server location to a cloud product, prior to app data migration.

Mapping
A combination of a source and a destination ID for an entity that details how the App migration platform identifies an entity in server and in cloud.

Migration
In the context of the App migration platform, this involves moving app data from a server location to a cloud app.

Migration assistant
Can refer to the Jira Cloud Migration Assistant (JCMA) or the Confluence Cloud Migration Assistant (CCMA). Contains all the libraries and functions you'll require to migrate data, and provides a user interface that displays the data to be migrated on a server instance.

Server app
A vendor app that's hosted with Jira or Confluence on a user's server instance.

Transfer
A single step in a migration that processes a collection of uniform entities. Transfers are grouped in containers.

  • Active transfer: A transfer that allows you to make calls to APIs of the App migration platform with a specific transferId for 14 days after you receive the first notification that your server app has been triggered. After the 14-day period, active transfers will expire. The App migration platform will return a 4XX response code to any requests that contain the transferId of an expired transfer.
  • Expired transfer: A transfer for which the 14-day time-limit period has passed. Any request made using the transferId of an expired transfer will return a 4XX response code.

APIs

App data retrieval API
Provides endpoints to access files exported from the server (files not exported as part of the migration).

Feedback channel API
Provides endpoints to send information from your cloud app to your server app.

Mapping API
Provides endpoints to retrieve mappings.

Notification API
Provides endpoints to register/deregister your cloud app, and to receive notifications about migration events.

Status API
Provides a status of your migration to the server product.

Rate this page: