Importing data from Redmine

The JIRA Redmine Importer plugin allows you to import data from the Redmine Issue Tracker application into your local JIRA instance. Version 5.0.2 or later of the JIRA Importers Plugin is compatible with Redmine versions 1.3.0+ and 2.5.2.

Before you begin

  • Ensure that you are using Redmine versions 1.3.0+ and 2.5.2.
  • Ensure that you are using version 5.0.2 or later of the JIRA Importers Plugin. This plugin is bundled with JIRA. For instructions on how to update a plugin, see Updating apps.
  • Install the JIRA Redmine Importer plugin, if you haven't installed it already. For instructions on how to install a plugin, see Installing Marketplace apps.
  • Enable the REST web service in Redmine in Administration > Settings > Authentication > Enable REST web service, if you haven't already enabled it.
  • If your JIRA installation has existing data, back up your existing JIRA data.

  • (tick) Tip: Redmine supports hierarchical issues. In the Redmine Import Wizard, you are given the option to recreate this issue hierarchy through JIRA issue links. Therefore, before importing Redmine data, you may want to configure a custom issue link to replicate this hierarchy. For example:

    • Name — 'Hierarchy'
    • Outward Link Description — 'parent of'
    • Inward Link Description — 'child of'

Import your Redmine data

The JIRA Redmine Importer plugin provides a wizard that walks you through the process of importing data and integrating it with JIRA. To access the import wizard:

  1. Log into JIRA as a user with the JIRA Administrators global permission.
  2. Choose > System. Select Import & Export > External System Import to open the Import external projects page. 
  3. Select Redmine to open the Redmine import wizard.
  4. Complete the fields as prompted in the wizard. 

If you are importing your Redmine issues into an existing JIRA project, you must choose the JIRA workflow scheme used by that existing JIRA project when you are prompted to select the workflow scheme. Otherwise, your import may not complete successfully.

Please note that it is mandatory to map Redmine status field to a specific JIRA status field and Redmine tracker field to a JIRA issue type field since these JIRA fields are an integral part of JIRA workflows.

Tips for importing Redmine On Demand data into JIRA fields

The import process converts Redmine data as follows:

In Redmine

In JIRA

Import Notes

Project

Project

Redmine data is imported on a per-project basis. You can either specify an existing JIRA project as the target, or the importer will automatically create a project(s) for you at time of import. See Defining a project for more information about JIRA projects.

Target Version

 

Affects VersionRedmine target version is mapped to JIRA "affects version".

Priority

Priority

You can configure mapping of specific Redmine values to specific JIRA values.

Summary

Subject

Redmine subject is imported as the JIRA issue summary.

WorklogWorklogSee Configuring time tracking.
AuthorReporterRedmine issue author is mapped as JIRA Issue Reporter.

Attachments

Attachments

Attachments are extracted from Redmine and saved. Information on the date the file was attached and the user who attached it is retained, as well. To specify the location where the attachments are stored, see Configuring file attachments.

Tracker

Issue Type

You can configure the mapping of specific trackers to specific JIRA issue types.

Priority

Priority

You can configure the mapping of specific Redmine values to specific JIRA values.

Status

Status

You can configure the mapping of specific Redmine values to specific JIRA values, provided you create your workflows in JIRA before running the importer.

  • The JIRA status field is integral to JIRA workflow.d
  • To create a JIRA workflow, see Working with workflows.
  • To create a JIRA workflow scheme (which you can then associate with appropriate projects and Issue Types), see Managing your workflows.
CategoryComponent/sThis mapping is hard-coded and cannot be changed.

User

User

JIRA will automatically import all users from Redmine, unless you are using external user management, in which case JIRA will not import any users. JIRA will then try to work out if the users are required, for example if the user has made a comment, or reported an issue. If the users are not required, JIRA will add them to a group called redmine-import-unused-users, and you can then decide what you'd like to do with these users (you may decide to delete or deactivate them).

Other fields

Custom fields

If your Redmine system contains any custom fields, you can choose to map them to specific JIRA custom field(s). If your custom fields don't yet exist in JIRA, the importer can automatically create them for you.

Last modified on May 8, 2018

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.