Documentation for JIRA 5.1.x. Documentation for other versions of JIRA is available too.

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

(info) 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.0.2. 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 your Bugzilla database to be MySQL or PostgreSQL.

 

The Bugzilla import process consists of simply running the Bugzilla Import Wizard (below).

  • インポートプロセスでは個々のフィールドやフィールド値のマッピングを選択できます。一部は必須です。
  • At the end of the Bugzilla Import Wizard, you will be given the option of creating a Bugzilla configuration file, which contains the settings you configured whilst running through the Bugzilla Import Wizard. This is useful if you need to test your Bugzilla import on a test JIRA server first before performing the import on a production system.

(warning) 注意:

  • JIRA's character encoding is set to UTF-8 by default. If, however, your JIRA installation's character encoding is set to something other than UTF-8, you may encounter problems with importing data from Bugzilla. For more information, please refer to JIM-5. Importing Bugzilla data into a non-UTF-8 JIRA installation is not supported.

On this page:

(warning) The information on this page does not apply to JIRA OnDemand.

Bugzilla Import Wizard の実行

If your JIRA installation has existing data, then before you begin, back up your existing JIRA data.

  1. Before you begin, please backup your JIRA data.
  2. Bugzilla システムで Bugzilla の 'サニティーチェック' を実行し、データにエラーがないことを確認します。
  3. Log in to JIRA as a user with the JIRA Administrators global permission.
  4. Select Administration > System > Import & Export > External System Import > Import button associated with the Bugzilla option to open the Bugzilla Import Wizard: Setup page.
    (tick) Keyboard shortcut: g + g + start typing external system import
  5. Bugzilla Import Wizard: Setup ページで、次のフィールド/オプションを入力します。

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

    Select this check box if you want to import Bugzilla issues into JIRA, which require user credentials on your Bugzilla site to access them.
    Selecting this check box reveals/hides the Bugzilla Login and Bugzilla Password fields, into which you should specify these user credentials.
    (info) If your Bugzilla site requires credentials and you do not specify them here, Bugzilla "Big File" attachments will not be imported.

    データベースタイプ

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

    • PostgreSQL
    • MySQL
    • Microsoft SQL Server
    ホスト名Bugzilla サイトのデータベースサーバーを実行しているサーバーのホスト名および IP アドレスを指定します。
    ポートSpecify the TCP/IP port that the Bugzilla site's database server is listening on.
    (tick) 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).
    (info) 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.
    (info) 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.
    (info) This password can usually be found in the 'localconfig' file in Bugzilla's root directory, for example, /etc/bugzilla/
    既存の設定ファイルを使用するLeave this check box 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.
    (info)  Note:
      • このオプションを選択すると、既存の設定ファイルを指定するかどうか尋ねられます。
      • このオプションを選択しない場合、Bugzilla Import Wizard の最後に、この後の Bugzilla インポート (Bugzilla Import Wizard のこのステップでの再利用) に使用できる設定ファイルが作成されます。
    JDBC connection parameters
    (in expanded Advanced tab)

    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.
    (info) If you chose MySQL (above), the Bugzilla Import Wizard will add several additional connection parameters by default.
  6. Click the Next button to proceed to the Setup project mappings step of the Bugzilla Import Wizard.
  7. On the Setup project mappings page, select which Bugzilla projects you wish to import into JIRA.
    (info) All Bugzilla projects are selected by default, so clear the check boxes 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 プロジェクトを選択します。
    • Select Create New from the dropdown menu and in the resulting Add A New Project dialog box, type the following:
      1. 新規プロジェクトの名前
      2. A new project Key
        (info) 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.
    (info) 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 の外部フィールドごとに、次のいずれかを選択できます。
    • have the Bugzilla Import Wizard automatically create new custom fields in JIRA based on the names of Bugzilla's fields. This is the default option - whereby the names of the JIRA custom fields to be automatically created appear in the JIRA field dropdown lists.
  10. 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 check boxes next to the appropriate fields.
    (info) 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_nameBugzilla 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.
      (info) 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.

  11. Click the Next button to proceed to the Setup value mappings step of the Bugzilla Import Wizard.
  12. On the Setup value mappings page, specify JIRA field values for each Bugzilla field value (as detected by the Bugzilla Import Wizard).
    (info) Any fields whose Map field value check boxes were selected in the previous step of the Bugzilla Import Wizard will be presented on this page, including the mandatory bug_status Bugzilla field.

  13. Click the Next button to proceed to the Setup links step of the Bugzilla Import Wizard.
  14. On the Setup links page, specify the JIRA link type for each Bugzilla link type (as detected by the Bugzilla Import Wizard). To learn more about JIRA link types, please see Configuring Issue Linking.

  15. 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.

    (info) 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.
    • If you need to import data from another Bugzilla product/project or site with the same (or similar) settings to what you used through this procedure, click the save the configuration link to download a Bugzilla configuration file, which you can use at the first step of the Bugzilla Import Wizard.

Congratulations, you have successfully imported your Bugzilla projects into JIRA! If you have any questions or encounter any problems, please contact Atlassian support.

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

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

Bugzilla

JIRA 内

インポート時の注意

製品

プロジェクト

Bugzilla 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.)

External Project

Project Category

 

バージョン影響バージョン 

コンポーネント

コンポーネント

インポーターによって JIRA に Bugzilla コンポーネントを自動作成するか、JIRA のコンポーネントにバグをインポートしないかを選択できます。

マイルストーン

修正対象バージョン

(選択した場合は) Bugzilla からバージョンがインポートされ、Un-Released および Un-Archived 状態に設定されます。

バグ

課題

Every Bugzilla bug becomes a JIRA issue of type 'Bug', with one exception: a Bugzilla issue with severity 'Enhancement' becomes a JIRA issue of type 'Improvement' and priority 'Major'.

ID

External issue ID

Each imported issue will be given a new JIRA ID, and the old Bugzilla ID will be saved into a JIRA custom field called 'External issue ID'. This custom field is searchable, so you can search for JIRA issues by their old Bugzilla ID. If you don't need this custom field, delete it or 'hide' it (as described in Specifying Field Behaviour).

要約

要約

 

説明

説明

 

コメント

コメント

 

添付ファイル

添付ファイル

Attachments are extracted from the Bugzilla database and saved to disk. To specify the location on disk, see Configuring File Attachments.

Priority

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

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

深刻度

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

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

ステータス

ステータス

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

ソリューション

ソリューション

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

Duplicates
Depends on
Blocks

Link

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

Work History

Work Log

Bugzilla の各作業ログレポートは JIRA では別の作業ログエントリとして表示されます。

見積

初期見積り

See Configuring Time Tracking.

残り

残余見積り

See Configuring Time Tracking.

記録済

消費時間

See Configuring Time Tracking.

投票数

Voters

If a user has voted one or more times for a Bugzilla issue, a JIRA vote is stored for that user.

CC List

ウォッチャー

 

ユーザー

ユーザー

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

  • Bugzilla システムで扱うユーザーは、JIRA のアクティブアカウントとして作成されます。 他のユーザーは "bugzilla-import-unused-users" という特別なグループにインポートされ、非アクティブ化されます。
  • Bugzilla のパスワードは Bugzilla v2.16+ ではインポートされません (データベースでハッシュされます)。 Bugzilla ユーザーは JIRA への初回のログイン時にパスワードを電子メールで通知してもらう必要があります。
  • Bugzilla でユーザーの実名が保存されていない場合、電子メールアドレス (ログイン名) の "@" 文字の前の部分が 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 (this way, votes etc can be imported correctly).
  • ユーザー数に制限のあるライセンス (例: パーソナル ライセンス) で、必要なユーザー数が制限を超える場合、インポートは停止されます。作成できないユーザーの一覧を示すページが表示されます。

Status Whiteboard

Status Whiteboard

'Status Whiteboard' という JIRA カスタムフィールドが作成されます。

その他のフィールド

カスタム フィールド

If your Bugzilla 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.