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

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

(info) Our main website highlights some top reasons why people migrate from Mantis to JIRAVersion 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.

Note that the JIRA importer plugin that imports Mantis to JIRA does not yet support newer versions of MySQL connector (7.0 and later). That might cause importing Mantis to JIRA with the importer plugin to fail. We recommend using the mysql-connector-java-5.1.46 driver version instead. 

このページの内容:

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

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

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

開始する前に、JIRA データをバックアップしてください。

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

    Mantis URL Mantis サイトの URL を指定します。これは、Web ブラウザで Mantis にアクセスするのに通常使用する URL です。
    Specify credentials

    Manti の課題を JIRA にインポートする場合、このチェックボックスをオンにします。課題にアクセスするには、Manti サイトでのユーザー認証情報が必要です。
    このチェックボックスをオンにすると、ユーザー認証情報を指定する Mantis Login および Mantis Password フィールドの表示/非表示が切り替わります。

    データベースタイプ

    Mantis インストールで使用するデータベースの種類を選択します。

    • PostgreSQL
    • Microsoft SQL Server
    • MySQL
    ホスト名 Mantis サイトのデータベース サーバーを実行しているサーバーのホスト名または IP アドレスを指定します。
    ポート Mantis サイトのデータベース サーバーがリッスンしている TCP/IP ポートを指定します。
    (tick) このフィールドには、前に選択した データベースタイプ に基づいて既定のポート値が自動的に入力されます。
    データベース (Mantis がデータを保存する) Mantis データベースの名前を指定します。
    (info) データベース名、ユーザー名、ユーザー パスワードは通常、Mantis ファイル config_inc.php にあります (一般に、既定のユーザー名は "root"、既定のパスワードは空です)。http://www.mantisbt.org/manual/manual.configuration.database.php も参照してください。
    ユーザ名 Mantis がデータベースに接続するために使用するデータベース ユーザーを指定します。
    パスワード Mantis がデータベースに接続するために使用するデータベースユーザー(上記)のパスワードを指定します。
    既存の設定ファイルを使用する 設定ファイルがない場合や、新しい設定ファイルを作成する場合は、このチェックボックスをオフのままにします。設定ファイルにより、Mantis のフィールドと JIRA のフィールドの間のマッピングを指定します。
    (info)注:
      • このオプションを選択すると、既存の設定ファイルを指定するかどうか尋ねられます。
      • このオプションを選択しない場合、Mantis インポート ウィザードの最後に、今後の Mantis インポート(Mantis インポート ウィザードの本ステップでの再利用)に使用できる設定ファイルが作成されます。
    JDBC 接続パラメーター
    (展開した 詳細設定 タブ内)
    Mantis インポート ウィザードは、上で指定した Mantis データベース サーバーの詳細から JDBC ベースのデータベース URL を作成します。JIRA はこの URL を使用してMantis に接続し、その課題をインポートします。 Mantis データベースに追加の接続パラメータを指定する必要がある場合、ここで指定します。
    (info) MySQL(上記)を選択すると、Mantis インポート ウィザードは既定で接続パラメーターをいくつか追加します。
  5. 次へ ボタンをクリックして、 Mantis インポート ウィザードの プロジェクト マッピングの設定 ステップに進みます。

  6. Set up project mappings ページで、JIRA にインポートする Mantis プロジェクトを選択します。
    (info)既定ではすべてのプロジェクトが選択されているので、JIRA にインポートしないMantis プロジェクトのインポートの下のチェックボックスをオフにします。
    JIRA にインポートする Mantis プロジェクトについては、Select a project  をクリックし、次のいずれかの操作を行います。
    • JIRA にすでに存在するプロジェクトの名前(またはキー)を入力するか、ドロップダウンメニューを使用して、既存の JIRA プロジェクトを選択します。
    • ドロップダウンメニューから Create New を選択し、 Add A New Project ダイアログボックスで次の項目を入力します。
      1. 新規プロジェクトの名前
      2. 新規プロジェクト キー
        (info) これは JIRA プロジェクトのすべての課題 ID の接頭語として使用されます。
      3. プロジェクトリード
  7. 次へ ボタンをクリックして、Mantis インポート ウィザードのカスタム フィールド設定ステップに進みます。
    (info) Mantis フィールドの少なくとも 1 つは 既存の JIRA フィールドと一致しない可能性があるため、このステップはたいてい表示されます。

  8. カスタムフィールド設定ページで、Mantis インポート ウィザードが既存の JIRA フィールドと一致させることができない Mantis の外部フィールドごとに、次のいずれかを選択します。
    • Mantis Import Wizard で、Mantis のフィールド名に基づき、JIRA の新規カスタムフィールドを自動的に作成します。これは既定のオプションです。自動的に作成された JIRA カスタムフィールドの名前がJIRA フィールド ドロップダウンリストに表示されます。
  9. 次へ ボタンをクリックして、Mantis インポート ウィザードの フィールド マッピングの設定 ステップに進みます。
  10. Set up field mappingsページで、Mantis の外部フィールドの値を JIRA にインポートするに変更する場合、該当するフィールドの横のフィールド値のマッピングチェックボックスをオンにします。
    (info)Mantis のstatus (ステータス) フィールドを JIRA のステータスフィールドとして JIRA の特定のステータスフィールド値にマッピングすることは、JIRA ワークフローに不可欠です。
    • フィールド マッピング設定 ページに表示される可能性がある Mantis のその他の 外部フィールド は、以下のとおりです。

      Mantis の外部フィールド
      「フィールド値のマッピング」チェックボックスをオフにします。
      ユーザ名 Mantis インポート ウィザードにより、Mantis ユーザー名が JIRA ユーザー名(小文字)に自動的にマッピングされます。
      priority Mantis インポート ウィザードにより、JIRA で欠落している値が自動的に作成され、課題は適切な優先度で(例: Mantis の "Normal" が JIRA で新規作成された "Normal" へと)移行されるようになります。
      重大度 Mantis インポート ウィザードは、このフィールドの値をマッピングしません。
      resolution 既存の解決状況を使用する代わりに、インポーターにより JIRA での対応する解決状況が作成されます。
    • JIRA プロジェクトにインポートする Mantis の課題が使用する適切な JIRA ワークフロー スキームを選択します。
      (info) Mantis の課題を既存の JIRA プロジェクトにインポートする場合、その既存の JIRA プロジェクトが使用する JIRA ワークフロー スキームを選択するようにします。

  11. 次へ ボタンをクリックして、Mantis インポート ウィザードの 値マッピングの設定 ステップに進みます。
  12. 値マッピングの設定ページで、(Mantis Import Wizard で検出された) 各 Mantis フィールド値に対応する JIRA フィールド値を指定します。
    (info)Mantis Import Wizard の前のステップでフィールド値のマッピングチェックボックスがオンになっているフィールドは、このページに表示されます (Mantis で必須の status フィールドなど)。
  13. 次へ ボタンをクリックして、 Mantis インポート ウィザードの リンクの設定 ステップに進みます。
  14. リンクの設定ページで、(Mantis Import Wizard で検出された) Mantis の各リンクタイプに対応する JIRA のリンクタイプを指定します。JIRA のリンクタイプの詳細については、「課題リンクの設定」を参照してください。
  15. Mantis データを JIRA にインポートする準備ができたら、インポート開始 ボタンをクリックします。インポーターは、インポートの進行に合わせて更新状況を示し、インポートが完了すると、正常完了したことを示すメッセージを表示します。
    (info) 注意:
    • インポートで問題が生じた場合(または関心がある場合)、詳細ログのダウンロードリンクをクリックして、Mantis インポート ウィザードのプロセスに関する詳細情報を表示します。
    • この手順を通じて使用した設定と同じ(または類似の)設定で、別の Mantis 製品/プロジェクトまたはサイトからインポートする必要がある場合は、設定を保存  リンクをクリックして、Mantis 設定ファイルをダウンロードします。この設定ファイルは、Mantis インポート ウィザードの 最初のステップ で使用できます。

お疲れ様でした。Mantis データが JIRA に正常にインポートされました!ご不明な点や、問題が生じた場合は、Atlassian サポートにご連絡ください。

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

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

Mantis の場合

JIRA 内

インポート時の注意

プロジェクト
サブプロジェクト

Project

Mantis データはプロジェクト単位でインポートされます。ターゲットとして既存の JIRA プロジェクトを指定できますが、指定しなくても、インポート時にインポーターによって自動的に新規プロジェクトが作成されます。JIRA プロジェクトの詳細については、「プロジェクトの定義」を参照してください。

カテゴリ

Component

インポーターが JIRA に Mantis コンポーネントを自動作成する、または JIRA のコンポーネントにバグがインポートされないようにする、などの選択が可能です。

VERSION (バージョン)

Fix Version

Mantis からバージョンがインポートされます(選択した場合)。インポート後、必要に応じて、該当のバージョンを JIRA のリリース済み状態に手動設定できます。

バグ

Issue

Mantis のバグはすべて JIRA で 'Bug' タイプの課題になります。

ID

Bug Import ID

インポートした各課題には新しい JIRA ID が与えられ、古い Mantis ID は 'Bug Import ID' という JIRA カスタムフィールドに保存されます。このカスタムフィールドは検索可能であり、旧 Mantis ID で JIRA の課題を検索できます。 このカスタムフィールドが不要な場合は、削除または「非表示」にすることができます (「フィールド動作の指定」で説明しています)。

概要

概要


説明

説明

テキスト内で、Mantis リンク(# 1234 など)は JIRA リンク(TST- 123 など)に変換されます。

コメント

コメント

テキスト内で、Mantis リンク(# 1234 など)は JIRA リンク(TST- 123 など)に変換されます。

添付ファイル

添付ファイル

Mantis データベースから添付ファイルが抽出され、ディスクに保存されます。ディスク上の場所を指定するには、「ファイル添付を設定する」を参照してください。

Priority

優先度
(またはカスタムフィールド)

Mantis 優先度フィールドと Mantis 重大度フィールド(下記)のうち、一方を組み込みの JIRA 優先度フィールドにマッピングし、もう一方をカスタムフィールドにマッピングする選択ができます。 (または、Mantis 優先度フィールドと Mantis 重大度フィールドの両方を JIRA カスタムフィールドにマッピングできます)。 JIRA 優先度フィールドにインポートする場合、Mantis の特定の値から JIRA の特定の値へのマッピングを設定できます。

重大度

優先度
(またはカスタムフィールド)

Mantis 優先度フィールド(上記参照)と Mantis 重大度フィールドのうち、一方を組み込みの JIRA 優先度フィールドにマッピングし、もう一方をカスタムフィールドにマッピングする選択ができます。 (または、Mantis 優先度フィールドと Mantis 重大度フィールドの両方を JIRA カスタムフィールドにマッピングできます)。 JIRA 優先度フィールドにインポートする場合、Mantis の特定の値から JIRA の特定の値へのマッピングを設定できます。

Status

Status

インポーターを実行する前に JIRA でワークフローを作成している場合、Mantis の特定の値から JIRA の特定の値へのマッピングを設定できます。

  • JIRA のステータスフィールドは JIRA ワークフローに不可欠です。
  • JIRA ワークフロー を作成するには、 「ワークフローで作業する」 を参照してください。
  • (適切なプロジェクトや課題タイプに関連付けられる) JIRA ワークフロースキームを作成するには、「ワークフローを管理する」を参照してください。

ソリューション

ソリューション

Mantis の特定の値から JIRA の特定の値へのマッピングを設定できます。

関係

リンク

Mantis の特定の関係タイプから JIRA のリンクタイプへのマッピングを設定できます。

CC List

Watchers


ユーザー

ユーザー

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

  • Mantis システムを使用するユーザーは、JIRA のアクティブ アカウントとして作成されます。 他のユーザーは "mantis-import-unused-users" という特別なグループにインポートされ、非アクティブ化されます。
  • Mantis のパスワードはインポートされません(データベースでハッシュ化されているためです)。 Mantis ユーザーは、JIRA への初回のログイン時にパスワードをメールで通知してもらう必要があります。
  • Mantis で実名を保存していないユーザーの場合、メール アドレス(ログイン名)の "@" 文字の前の部分が JIRA でのフルネームとして取得されます。
  • 外部ユーザー管理 を使用している場合、インポート プロセスでは JIRA ユーザーを作成できません。代わりに、作成の必要がある新規ユーザーの一覧が、インポーターから提供されます。インポートを開始する前に、ユーザーは外部ユーザー リポジトリでユーザーを作成する必要があります。
  • ユーザー数制限付きライセンス(例: パーソナルライセンス)で、必要なユーザー数が制限数を超える場合、インポートは停止されます。作成できないユーザーのリストを示すページが表示されます。

その他のフィールド

カスタム フィールド

Mantis システムにカスタムフィールドがある場合、特定の JIRA カスタムフィールドへのマッピングを行うことができます。JIRA にカスタムフィールドがまだ存在していない場合、インポーターによって自動的にカスタムフィールドが作成されます。


最終更新日 2018 年 9 月 5 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.