Skip to content

Latest commit

 

History

History
102 lines (68 loc) · 5.58 KB

readme.md

File metadata and controls

102 lines (68 loc) · 5.58 KB

Jira to Azure DevOps work item migration tool

image

The Jira to Azure DevOps work item migration tool lets you export data from Jira and import it as work items in Azure DevOps or Microsoft Team Foundation Server.

Build Quality Release
Build Status SonarCloud Badge CodeQL Deployment status

Features

This tool lets you migrate work item from Jira to Azure DevOps or Microsoft Team Foundation Server. The tool has two parts, first Jira issues are exported to files then we import the files to Azure DevOps/TFS. We believe this is a good approach to migration since it allows you to export the data to migrate and validate it before importing it. It also makes it easy to migrate in batches.

Some of the capabilities include:

  • Export Jira issues from Jira queries
  • Map users from Jira to users in Azure DevOps/TFS
  • Migrate work item field data
  • Migrate links and attachments
  • Migrate history

Getting the tools

Getting started

The tools are provided as-is and will require detailed understanding of how to migrate work items between different systems in order to do a successful migration.

Support

If you need help with migrations, feel free to contact the team at Solidify for expert consulting services.

Support and bug reporting are managed via GitHub Issues. Please create a new issue and fill in the corresponding issue template.

Note: We do not answer Discussions, as these have less traceability than Issues. Discussions are instead reserved for community discussions.

Jira Azure DevOps Migrator PRO

The Jira Azure DevOps Migrator PRO offering from Solidify offers more features and utilities to further increase your migration capabilities and streamline the migration workflow. Contact us for more information

Features

Jira Azure DevOps Migrator PRO contains all the features in the Community Edition, plus the following additional functionality:

  • Priority support for bug reports
  • Composite field mapper (consolidate multiple Jira fields into a single ADO field)
  • Migrate Releases and the fixes version field
    • Release date, start date, release status and release description
  • Migrate Remote Links (Web links) to Work Item hyperlinks.
  • Correct any Embedded Links to Jira Issues in text fields such as Description, Repro Steps and comments, so that they point to the correct Work Item in Azure DevOps.
  • Select any property for object- and array-type fields for mapping. This allows for:
    • More possibilities when mapping the fixes version and components fields.
    • More possibilities when mapping custom user picker fields.
  • Utilities for automating user mapping between Jira and Azure DevOps
  • Utilities for automatically generating the Jira Azure DevOps Migrator configuration file, thus enabling you to get started migrating faster
  • Utilities for viewing the Jira workflow and assisting with field and state mapping

Additional tools in the Jira Azure DevOps Migrator PRO package:

  • Migrate Jira test data to Azure DevOps Test Plans, including the QMetry, Zephyr and Xray frameworks
  • Migrate Confluence pages to Azure DevOps Wikis

FAQ - Frequently Asked Questions

Telemetry

In order to improve the tool we collect some telemetry data using Microsoft Application Insights. See Telemetry for more details, including how to disable telemetry collection.

Contributions are welcome

Here is how you can contribute to this project:

  • Fork the repo and submit pull requests for bug fixes and features
  • Submit bugs and help us verify fixes
  • Discuss existing issues/proposals
  • Test and share migration configurations

Please refer to Contribution guidelines and the Code of Conduct for more details, including how to build and debug the tools locally.

Supported versions of ADO/Jira

The Jira to Azure DevOps work item migration tool is officially supported on the following platforms:

  • Atlassian Jira Cloud
  • Atlassian Jira Server
    • 7.x
    • 8.x
    • 9.x
  • Azure DevOps Services
  • Azure DevOps Server
    • 2022
    • 2020
    • 2019
  • Team Foundation Server 2018 update 3