Import Issue Data

On this page:

Issue data

With Configuration Manager you can migrate the issue data for one or more projects from one Jira instance to another, preserving all comments, links, history, worklog, custom field values, agile data and more.

The following use cases are supported:

  • New project deployment - аdd a new project and import all of its issues.

  • Incremental deployment - import new issues into an existing project.

When you deploy a Projects with Issues snapshot, in the Analyze import data page of the deployment wizard you can review the issue data related changes, which will be applied to the current Jira instance.

Changes are organized in a table with each row representing a single project from the snapshot. For each project, you can review issue counters and a summary of the planned changes if required.

Issue import states

Issue data from the snapshot might be imported for projects that are new to this system and for existing projects, and depending on that, there are different states for the projects:

Add project and its issues

A new project will be added to the target Jira instance, and all of its issues will be imported into it.

Modify existing project

Issues from the snapshot will be imported into an existing project on the target Jira instance.

No issues to import

There are no issues in the snapshot for the specific project, or the existing project already contains the same issues as in the snapshot.

Counters

For each project from the snapshot, there are three issue counters displayed during deployment.

The counters are:

  • Snapshot - shows the count of issues in the snapshot for the specific project.

  • Existing - shows the count of issues in the existing project on the target Jira instance. Issue number is used to determine if an issue should be deployed or skipped: e.g. if issue PRJ-1 exists both in the snapshot and in the target instance, it will be skipped.

  • New - shows the count of new issues, which will be imported to the existing project on the target Jira instance.


Deploying multiple projects

Deploying multiple projects with issue data is fully supported. During the deployment CMJ searches for existing projects on the target instance. If a snapshot project is already present, CMJ add only the new issues into the target project. Otherwise a new project is created and all its issue data is deployed.

During the deployment CMJ creates all issue links that are exported with the snapshot, as long as the destination issues exist in the target instance or in the snapshot.

Example:
In my instance Project A and Project B have linked issues. I deploy only Project A to my target instance. Then I deploy Project B. All issue links between Project A and Project B will be created, as long as the project keys are not changed during the deployment!


For more information on migrating projects with issue data please refer to the following article:
https://botronsoft.atlassian.net/wiki/spaces/CMJ/pages/1179746406

For more details on reviewing the results of an issue data migration see:
https://botronsoft.atlassian.net/wiki/spaces/CMJ/pages/1125613587/Review+Imported+Issue+Data