Mantis からのデータのインポート

Jira にバンドルされている Jira Importers プラグインを使用すれば、ライブ Mantis データベースに接続することで、Mantis からデータをインポートできます。

Our main website highlights some top reasons why people migrate from Mantis to Jira. Version 4.2 or later of the Jira Importers plugin is compatible with Mantis versions 1.1.8 to 1.2.16. The Jira Importers plugin requires that your Mantis database is MySQL, PostgreSQL or Microsoft SQL Server. We have also received reports that the Jira Importers plugin works with Oracle and DB2 databases. However, we have not tested this plugin against these databases.

Mantis を Jira にインポートする Jira インポーター プラグインでは新しいバージョンの MySQL コネクタ (7.0 以降) がサポートされていないことにご注意ください。これによって、インポーター プラグインによる Jira への Mantis のインポートが失敗する可能性があります。代わりに mysql-connector-java-5.1.46 ドライバ バージョンを使用することをおすすめします。 

Mantis からのインポートのプロセスで必要なのは、Mantis インポート ウィザード の実行（下記）だけです。

• インポートプロセスでは個々のフィールドやフィールド値のマッピングを選択できます。一部は必須です。
• Mantis Import Wizard の最後に、Mantis 設定ファイルを作成するオプションが表示されます。このファイルには、Mantis Import Wizard を通じて行った設定が含まれます。これは、本番システムでインポートを実行する前にテスト用 Jira サーバーで Mantis のインポートをテストする必要がある場合に便利です。

Mantis インポート ウィザードの実行

開始する前に、Jira データをバックアップします。

1. Jira 管理者グローバル権限を持つユーザーとしてログインします。
2. > [システム] を選択します。[インポートとエクスポート] > [外部システム インポート] を選択し、[外部プロジェクトのインポート] ページを開きます。
3. Mantis を選択して Mantis インポート ウィザード: セットアップページを開きます。

4. On the Mantis Import Wizard: Setup page, complete the following fields/options:

   Mantis URL	Mantis サイトの URL を指定します。これは、Web ブラウザで Mantis にアクセスするのに通常使用する URL です。
   Specify credentials	Mantis の課題を Jira にインポートする場合、このチェックボックスを選択します。この場合、Mantis サイトで課題にアクセスするためのユーザー認証情報が必要です。 このチェックボックスを選択すると、ユーザー認証情報を指定する Mantis Login および Mantis Passwod フィールドの表示/非表示が切り替わります。
   データベースタイプ	Mantis インストールで使用するデータベースの種類を選択します。 PostgreSQL Microsoft SQL Server MySQL
   ホスト名	Mantis サイトのデータベース サーバーを実行しているサーバーのホスト名または IP アドレスを指定します。
   ポート	Specify the TCP/IP port that the Mantis site's database server is listening on.  This field is automatically populated with the default port value based on the Database Type you choose above.
   データベース	Specify the name of your Mantis database (into which Mantis saves its data).  The database name, username and user password can usually be found in the Mantis file config_inc.php. (Typically, the default username is "root" and the default password is empty). See also http://www.mantisbt.org/manual/manual.configuration.database.php
   ユーザ名	Mantis がデータベースに接続するために使用するデータベース ユーザーを指定します。
   パスワード	Mantis がデータベースに接続するために使用するデータベースユーザー（上記）のパスワードを指定します。
   既存の設定ファイルを使用する	Leave this checkbox cleared if you do not have a configuration file or if you want to create a new configuration file. Configuration files specify a mapping between fields in Mantis and those in Jira.   Note: このオプションを選択すると、既存の設定ファイルを指定するかどうか尋ねられます。 このオプションを選択しない場合、Mantis Import Wizard の最後に、以降のインポート (Mantis Import Wizard のこのステップでの再利用) に使用できる設定ファイルが作成されます。
   JDBC 接続パラメーター （展開した 詳細設定 タブ内）	The Mantis Import Wizard will construct a JDBC-based database URL from the Mantis database server details you specify above. Jira uses this URL to connect to and import issues from Mantis. If you need to specify any additional connection parameters to your Mantis database, specify them here.  If you chose MySQL (above), the Mantis Import Wizard will add several additional connection parameters by default.

5. 次へ ボタンをクリックして、 Mantis インポート ウィザードの プロジェクト マッピングの設定 ステップに進みます。

6. On the Set up project mappings page, select which Mantis projects you wish to import into Jira.
    All Mantis projects are selected by default, so clear the checkboxes under Import of the Mantis projects you do not wish to import into Jira.
   For Mantis projects you wish to import into Jira, click in Select a project and then do either of the following:
   
   • Jira に存在するプロジェクトの名前 (またはキー) を入力するか、ドロップダウン メニューを使用して既存の Jira プロジェクトを選択します。
   • ドロップダウンメニューから Create New を選択し、 Add A New Project ダイアログボックスで次の項目を入力します。
     
     1. 新規プロジェクトの名前
     2. A new project Key 
         This will be used as the prefix for all issue IDs in your Jira project.
     3. プロジェクトリード
7. Click the Next button to proceed to the Set up custom fields step of the Mantis Import Wizard.
    This step will almost always appear because at least one Mantis field is not likely match an existing Jira field.
   
   
8. [カスタム フィールドの設定] ページで、Mantis Import Wizard が既存の Jira フィールドに一致させることができない Mantis の外部フィールドごとに、次のいずれかを選択します。
   
   • Mantis Import Wizard で、Mantis のフィールド名に基づき、Jira のカスタム フィールドを自動的に新しく作成します。これが既定のオプションです。自動的に作成された Jira カスタム フィールドの名前が [Jira フィールド] ドロップダウン リストに表示されます。
   • Jira で独自のカスタム フィールドを作成し、Mantis のフィールドからデータをマッピングします。これを行うには、[Jira フィールド] ドロップダウン リストから [その他] を選択し、[その他] のすぐ下に表示される新規フィールドでカスタム フィールドの名前を指定します。
9. 次へ ボタンをクリックして、Mantis インポート ウィザードの フィールド マッピングの設定 ステップに進みます。
10. On the Set up field mappings page, if there External fields in Mantis whose values you wish to modify before they are imported into Jira, select the Map field value checkboxes next to the appropriate fields.
     Please note that it is mandatory to map Mantis's status (i.e. Status) field to specific Jira Status field values as the Jira Status field is an integral part of Jira workflows.
    

    • フィールド マッピング設定 ページに表示される可能性がある Mantis のその他の 外部フィールド は、以下のとおりです。

      Mantis の外部フィールド	「フィールド値のマッピング」チェックボックスをオフにします。
      username	Mantis Import Wizard により、Mantis ユーザー名が Jira ユーザー名 (小文字) に自動的にマッピングされます。
      優先度	Mantis Import Wizard により、Jira に不足している値が自動的に作成され、課題に適切な優先度 (例: Mantis の"Normal" が Jira で新規作成された "Normal") が設定されます。
      重大度	Mantis インポート ウィザードは、このフィールドの値をマッピングしません。
      resolution	既存の解決状況を使用する代わりに、インポーターにより Jira に対応する解決状況が作成されます。

    • Select the appropriate Jira Workflow Scheme in that will be used by the Mantis issues you will import into your Jira project.
       If you are importing your Mantis issues into an existing Jira project, ensure that you choose the Jira workflow scheme used by that existing Jira project.

11. 次へ ボタンをクリックして、Mantis インポート ウィザードの 値マッピングの設定 ステップに進みます。
12. On the Set up value mappings page, specify Jira field values for each Mantis field value (as detected by the Mantis Import Wizard).
     Any fields whose Map field value checkboxes were selected in the previous step of the Mantis Import Wizard will be presented on this page, including the mandatory status Mantis field.
13. 次へ ボタンをクリックして、 Mantis インポート ウィザードの リンクの設定 ステップに進みます。
14. [リンクの設定] ページで、Mantis Import Wizard で検出された Mantis の各リンク タイプに対応する Jira のリンク タイプを指定します。Jira のリンク タイプの詳細については、「課題リンクの設定」を参照してください。
15. Click the Begin Import button when you are ready to begin importing your Mantis data into Jira. The importer will display updates as the import progresses, then a success message when the import is complete.
     Note:
    
    • インポートで問題が生じた場合（または関心がある場合）、詳細ログのダウンロードリンクをクリックして、Mantis インポート ウィザードのプロセスに関する詳細情報を表示します。
    • この手順を通じて使用した設定と同じ（または類似の）設定で、別の Mantis 製品/プロジェクトまたはサイトからインポートする必要がある場合は、設定を保存  リンクをクリックして、Mantis 設定ファイルをダウンロードします。この設定ファイルは、Mantis インポート ウィザードの 最初のステップ で使用できます。

これで、Mantis データを Jira に正常にインポートできました。ご不明な点や、問題が生じた場合は、アトラシアン サポートにご連絡ください。

Mantis データを Jira フィールドにインポートするためのヒント

インポート プロセスでは、次のデータが Mantis データベースから Jira にコピーされます。