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

The Jira Importers plugin, which is bundled with Jira, allows you to import data from Bugzilla by connecting to a live Bugzilla database.

Our main website highlights some top reasons why people migrate from Bugzilla to Jira. Version 4.1 or later of the Jira Importers plugin is compatible with Bugzilla 2.20 to 4.4.4. Users of older Bugzilla versions will need to first upgrade the Bugzilla database tables to a supported version, using Bugzilla's checksetup.pl script. The Jira Importers plugin requires that your Bugzilla database is MySQL, PostgreSQL or Microsoft SQL Server.

Jira is able to import data from Bugzilla 2.20 only if it's using a supported database.

Jira does not bundle the MySQL driver anymore. If the Bugzilla data is located in a MySQL database, follow the instructions in Connecting Jira to MySQL to install the MySQL database driver before attempting to import from Bugzilla

Bugzilla インポートプロセスでは、次のように Bugzilla Import Wizard を実行するだけです。

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

注意:

• Jira の文字エンコーディングは既定で UTF-8 に設定されています。Jira インストールの文字エンコーディングが UTF-8 以外に設定されている場合、Bugzilla からのデータのインポートに問題が発生する可能性があります。詳細については、JIM-5 を参照してください。UTF-8 以外の Jira インストールへの Bugzilla データのインポートはサポートされません。

Bugzilla Import Wizard の実行

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

1. Bugzilla システムで Bugzilla の 'サニティーチェック' を実行し、データにエラーがないことを確認します。
2. Jira 管理者グローバル権限を持つユーザーとしてログインします。
3. > [システム] を選択します。[インポートとエクスポート] > [外部システム インポート] を選択し、[外部プロジェクトのインポート] ページを開きます。
4. Select Bugzilla to open the Bugzilla Import Wizard: Setup page.
    

5. Bugzilla Import Wizard: Setup ページで、次のフィールド/オプションを入力します。

   Bugzilla URL	Bugzilla サイトの URL を指定します。これは、Web ブラウザを通じて Bugzilla にアクセスするために通常使用する URL です。
   Specify credentials	Select this checkbox if you want to import Bugzilla issues into Jira, which require user credentials on your Bugzilla site to access them. Selecting this checkbox reveals/hides the Bugzilla Login and Bugzilla Password fields, into which you should specify these user credentials. If your Bugzilla site requires credentials and you do not specify them here, Bugzilla "Big File" attachments will not be imported.
   データベース タイプ	Bugzilla インストールで使用するデータベースのタイプを選択します。 PostgreSQL Microsoft SQL Server MySQL
   ホスト名	Bugzilla サイトのデータベースサーバーを実行しているサーバーのホスト名および IP アドレスを指定します。
   ポート	Specify the TCP/IP port that the Bugzilla 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 Bugzilla database (into which Bugzilla saves its data). This database name can usually be found in the 'localconfig' file in Bugzilla's root directory, for example, /etc/bugzilla/
   ユーザ名	Specify the database user that Bugzilla uses to connect to its database. This database user can usually be found in the 'localconfig' file in Bugzilla's root directory, for example, /etc/bugzilla/
   パスワード	Specify the password of the database user (above) that Bugzilla uses to connect to its database.  This password can usually be found in the 'localconfig' file in Bugzilla's root directory, for example, /etc/bugzilla/
   既存の設定ファイルを使用する	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 Bugzilla and those in Jira.   Note: このオプションを選択すると、既存の設定ファイルを指定するかどうか尋ねられます。 このオプションを選択しない場合、Bugzilla Import Wizard の最後に、以降の Bugzilla インポート (Bugzilla Import Wizard のこのステップでの再利用) に使用できる設定ファイルが作成されます。
   JDBC connection parameters (展開した Advanced タブ)	The Bugzilla Import Wizard will construct a JDBC-based database URL from the Bugzilla database server details you specify above. Jira uses this URL to connect to and import issues from Bugzilla. If you need to specify any additional connection parameters to your Bugzilla database, specify them here. If you chose MySQL (above), the Bugzilla Import Wizard will add several additional connection parameters by default.

6. 次へボタンをクリックして、Bugzilla Import Wizard のプロジェクトマッピングの設定ステップに進みます。

7. On the Setup project mappings page, select which Bugzilla projects you wish to import into Jira.
   All Bugzilla projects are selected by default, so clear the checkboxes under Import of the Bugzilla projects you do not wish to import into Jira.
   For Bugzilla projects you wish to import into Jira, click in Select a project and then do either of the following:
   
   • Jira に存在するプロジェクトの名前 (またはキー) を入力するか、ドロップダウン メニューを使用して既存の Jira プロジェクトを選択します。
   • ドロップダウンメニューから 新規作成 を選択し、表示される 新規プロジェクトの追加 ダイアログボックスで、次の項目を入力します。
     
     1. 新規プロジェクトの名前
     2. A new project Key
        This will be used as the prefix for all issue IDs in your Jira project.
     3. プロジェクト リーダー。
8. Click the Next button to proceed to the Setup custom fields step of the Bugzilla Import Wizard.
   This step will almost always appear because at least one Bugzilla field is not likely match an existing Jira field.
9. [カスタム フィールドの設定] ページで、Bugzilla Import Wizard が既存の Jira フィールドに一致させることができない Bugzilla の外部フィールドごとに、次のいずれかを選択します。
   
   • Bugzilla Import Wizard で、Bugzilla のフィールド名に基づき、Jira のカスタム フィールドを自動的に新しく作成します。これが既定のオプションです。自動的に作成された Jira カスタム フィールドの名前が [Jira フィールド] ドロップダウン リストに表示されます。
   • create your own custom fields in Jira to map data from Bugzilla's fields. To do this, choose Other from the Jira field drop-down list and specify the name of your custom field in the new field appearing immediately below Other.
     For more information about matching Bugzilla fields to Jira fields, see Tips for importing Bugzilla data into Jira fields below.
10. 次へボタンをクリックして、Bugzilla Import Wizard のフィールドマッピングの設定ステップに進みます。

11. On the Setup field mappings page, if there External fields in Bugzilla 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 Bugzilla's bug_status (i.e. Status) field to specific Jira Status field values as the Jira Status field is an integral part of Jira workflows.

    
    

    • フィールドマッピングの設定ページに表示される、Bugzilla のその他の外部フィールドは次のとおりです。

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

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

12. 次へボタンをクリックして、Bugzilla Import Wizard の値マッビングの設定ステップに進みます。

13. On the Setup value mappings page, specify Jira field values for each Bugzilla field value (as detected by the Bugzilla Import Wizard).
    Any fields whose Map field value checkboxes were selected in the previous step of the Bugzilla Import Wizard will be presented on this page, including the mandatory bug_status Bugzilla field.

14. 次へボタンをクリックして、Bugzilla Import Wizard のリンクの設定ステップに進みます。

15. [リンクの設定] ページで、Bugzilla Import Wizard で検出された Bugzilla の各リンク タイプに対応する Jira のリンク タイプを指定します。Jira のリンク タイプの詳細については、「課題リンクの設定」を参照してください。

16. Click the Begin Import button when you are ready to begin importing your Bugzilla data into Jira. The importer will display updates as the import progresses, then a success message when the import is complete.
    
    Note:
    
    • If you experience problems with the import (or you are curious), click the download a detailed log link to reveal detailed information about the Bugzilla Import Wizard process.
    • この手順を通じて使用した設定と同じ (または類似の) 設定で、別の Bugzilla 製品/プロジェクトまたはサイトをインポートする必要がある場合は、設定を保存リンクをクリックして、Bugzilla 設定ファイルをダウンロードします。この設定ファイルは、Bugzilla Import Wizard の最初の手順で使用できます。

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

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

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