Documentation for JIRA 5.2. Documentation for other versions of JIRA is available too.

The JIRA Redmine Importer plugin allows you to import data from the Redmine Issue Tracker product into your local JIRA site.

On this page:

はじめる前に

  • Redmineのバージョンが 1.3.+ と 2.0+. であることを確認してください。
  • 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.
    (click for larger image)

  • If your JIRA installation has existing data — Back up your existing JIRA data.

  • (tick) Tip: Redmine supports hierarchical issues. During the Redmine Import Wizard, you are given the option to recreate this issue hierarchy through JIRA issue links. Hence, before commencing the Redmine Import Wizard, you may wish to configure an custom issue link to replicate this hierarchy — for example:

    • 名前 - 'Hierarchy'
    • 外側リンクの説明 - 'parent of'
    • 内側リンクの説明 - 'child of'

Running the Redmine import wizard

  1. Log in to JIRA as as a user with the JIRA Administrators global permission.
  2. Choose Administration at the top right of your screen. Then choose System > Import & Export from the menu bar and click the External System Import tab to open the 'Import external projects' page.
    (tick)Keyboard shortcutg + g + start typing redmine
  3. Select the Import button associated with the Redmine option. The first screen of the Redmine import wizard will be displayed: Connect with Redmine.
  4. Complete the wizard. Each screen of the wizard is described below.

In this section:

1. Connect with Redmine

Screenshot: 'Connect with Redmine' screen (click to view larger image)

Complete the fields as follows, then click Next.

Redmine URLSpecify the URL of your Redmine server.
Redmine UsernameSpecify the user account that JIRA will use to access issues on your Redmine instance.
Redmine Passwordユーザー(上記)のパスワードを指定します。

2. Set up projects mappings

Screenshot: 'Set up projects mappings' screen (click to view larger image)

Select the Redmine projects that you wish to import into JIRA (note, all Redmine projects are selected by default, so clear the check boxes for Redmine projects you do not wish to import into JIRA.). For each Redmine project that you wish to import into JIRA, click Select a project and then do either of the following:

  • Select an existing project — Start typing the name (or key) of a project that already exists in JIRA or use the dropdown menu to select an existing JIRA project.
  • Create a new project — Select Create New from the dropdown menu. In the Add A New Project dialog box that appears, enter the name, key (this key will be used as the prefix for all issue IDs in your JIRA project) and project lead for your new project.

3. Set up custom fields

Screenshot: 'Set up custom fields' screen (click to view larger image)

For each External field  in Redmine you can choose to either:

  • have the Redmine Import Wizard automatically create new custom fields in JIRA based on the names of Redmine's fields. This is the default option — the names of the JIRA custom fields to be automatically created appear in the JIRA field dropdown lists.

Screenshot: 'Set up fields mappings' screen (click to view larger image)

 

Select the appropriate JIRA Workflow Scheme in that will be used by the Redmine issues you will import into your JIRA project. If you are importing your Redmine issues into an existing JIRA project, ensure that you choose the JIRA workflow scheme used by that existing JIRA project. Otherwise, your import may not complete successfully.

Please note that it is mandatory to map Redmine status field to specific JIRA Status field and Redmine tracker field to JIRA Issue type field as those JIRA fields are an integral part of JIRA workflows

5. Set up values mappings

Screenshot: 'Set up fields mappings' screen (click to view larger image)

Specify JIRA field values for each Redmine field value (as detected by the Redmine Import Wizard). Any fields whose Map field value check boxes were selected in the previous step of the Redmine Import Wizard will be presented on this page, including the mandatory status and tracker  Redmine field.

Screenshot: 'Set up links' screen (click to view larger image)

Specify how want to map Redmine's Parent relationships through JIRA issue links. To learn more about JIRA link types, please see Configuring Issue Linking.

You may wish to choose the 'Hierarchy' custom issue link you created before running the Redmine Import Wizard (see the Before you begin section above).

7. Start the import

Click Begin Import on the Set up links page when you are ready to begin importing your Redmine data into JIRA. The importer will display updates as the import progresses, then a success message when the import is complete.

Screenshot: Confirmation screen (click to view larger image)

If you experience problems with the import (or you are curious), click the download a detailed log link to reveal detailed information about the Redmine Import Wizard process.

(tick) Congratulations! You have successfully imported your Redmine projects into JIRA! If you have any questions or encounter any problems, please contact Atlassian support.

Redmine のデータ を JIRA の課題フィールドにインポートするためのヒント

インポートプロセスでは、次のように Redmine データが変換されます。

Redmine

JIRA 内

インポート時の注意

プロジェクト

プロジェクト

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. (For more information about JIRA projects, please see Defining a Project.)

ターゲット バージョン

 

対象バージョンRedmine target version is maped to JIRA affected version

Priority

Priority

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

要約

サマリ概要

Redmine subject is imported as JIRA Issue summary

作業履歴作業履歴See Configuring Time Tracking.
作成者報告者Redmine issue author is mapped as JIRA Issue Reporter

添付ファイル

添付ファイル

Attachments are extracted from Redmine and saved to diskThe dates and user attaching the attachments will be retained.To specify the location on disk, see Configuring File Attachments.

トラッカー

課題タイプ

You can configure mapping of specific Trackers to specific Issue Types.

Priority

Priority

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

ステータス

ステータス

You can configure 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. To learn more, please see What is Workflow.
  • To create a JIRA workflow, please see Configuring Workflow.
  • To create a JIRA workflow scheme (which you can then associate with appropriate projects and Issue Types), please see Activating Workflow.

ユーザー

ユーザー

Redmine ユーザーが JIRA に存在しない場合は、インポーターで対応する JIRA ユーザーを自動的に作成できます。

  • Users who interacted with the Redmine system will be created as active accounts in JIRA. Other users will be imported into a special group called "fredmine-import-unused-users" and will be deactivated.
  • Passwords from Redmine are not imported (as they are not available through the API). Users from REdmine will need to get their passwords emailed to them the first time they log into JIRA.
  • If you are using External User Management, the import process will not be able to create JIRA users; instead, the importer will give you a list of any new users that need to be created. You will need to create the users in your external user repository before commencing the import.
  • ユーザー数に制限のあるライセンス (例: パーソナル ライセンス) で、必要なユーザー数が制限を超える場合、インポートは停止されます。作成できないユーザーの一覧を示すページが表示されます。

その他のフィールド

カスタム フィールド

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.
If redmine