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

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

(info) Our main website highlights some top reasons why people migrate from FogBugz to JIRA.

 Version 4.2 or later of the JIRA Importers plugin is compatible with Fogbugz for Your Server versions 7.3.6 to 8.7.60. The JIRA Importers plugin requires that your FogBugz for Your Server database is MySQL, Microsoft SQL Server or Microsoft SQL Server Express. 

The FogBugz for Your Server import process consists of simply running the FogBugz Import Wizard (below):

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

(info) These instructions refer to a FogBugz for Your Server, which is an installable implementation of FogBugz that operates behind your firewall. To import from a FogBugz On Demand (SaaS) issue tracker site, please follow the instructions for here.

On this page:

Running the FogBugz for Your Server Import Wizard

  1. Before you begin, please backup your JIRA data.
  2. Log in to JIRA as a user with the JIRA Administrators global permission.
  3. 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 external system import
  4. Select the Import button associated with the FogBugz for Your Server option to open the FogBugz Import Wizard: Setup page.
  5. On the FogBugz Import Wizard: Setup page, complete the following fields/options:

    データベースタイプ

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

    • PostgreSQL
    • Microsoft SQL Server
    • MySQL
    ホスト名FogBugz サイトのデータベースサーバーを実行しているサーバーのホスト名または IP アドレスを指定します。
    ポートSpecify the TCP/IP port that the FogBugz 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 FogBugz database (into which FogBugz for Your Server saves its data).
    (info) If you need to specify an instance ID for your database, do so using the syntax fogbugz;instance=sqlexpress (where fogbugz is the name of your FogBugz database and sqlexpress is your FogBugz database's instance ID. The database name can usually be found in the Windows registry. See http://bugs.movabletype.org/help/topics/setup/WindowsWhatSetupDoes.html and then search for 'Initialize Registry Settings' (for details on how to access the relevant registry keys and values).
    ユーザ名FogBugz がデータベースを接続するために使用するデータベース ユーザーを指定します。
    パスワードFogBugz がデータベースを接続するために使用するデータベースユーザー (前記) のパスワードを指定します。
    既存の設定ファイルを使用する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 FogBugz for Your Server and those in JIRA.
    (info) Note:
      • このオプションを選択すると、既存の設定ファイルを指定するかどうか尋ねられます。
      • このオプションを選択しない場合、FogBugz Import Wizard の最後に、この後のインポート (FogBugz Import Wizard のこのステップでの再利用) に使用できる設定ファイルが作成されます。
    JDBC connection parameters
    (展開した Advanced タブ)
    The FogBugz Import Wizard will construct a JDBC-based database URL from the FogBugz database server details you specify above. JIRA uses this URL to connect to and import issues from FogBugz for Your Server. If you need to specify any additional connection parameters to your FogBugz database, specify them here.
    (info) If you chose MySQL (above), the FogBugz Import Wizard will add several additional connection parameters by default.
  6. Click the Next button to proceed to the Set up project mappings step of the FogBugz Import Wizard.


  7. On the Set up project mappings page, select which FogBugz projects you wish to import into JIRA.
    (info) All projects are selected by default, so clear the check boxes under Import of the FogBugz projects you do not wish to import into JIRA.
    For FogBugz 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
        (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 Set up custom fields step of the FogBugz Import Wizard.
  9. カスタムフィールドの設定ページで、FogBugz Import Wizard が既存の JIRA フィールドと一致させることのできない FogBugz の外部フィールドごとに、次のいずれかを選択できます。
    • have the FogBugz Import Wizard automatically create new custom fields in JIRA based on the names of FogBugz'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. Click the Next button to proceed to the Set up field mappings step of the FogBugz Import Wizard.
  11. On the Set up field mappings page, if there External fields in FogBugz 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 FogBugz's sStatus (i.e. Status) field to specific JIRA Status field values as the JIRA Status field is an integral part of JIRA workflows.
    • フィールドマッピングの設定ページ に表示される、FogBugz のその他の 外部フィールドは次のとおりです。

      FogBugz の外部フィールド「フィールド値のマッピング」チェックボックスをオフにします。
      sCategoryFogBugz Import Wizard により、JIRA で欠落している課題タイプが自動的に作成され、課題が適切な課題タイプで移行されます。
      sCustomerEmailFogBugz インポートウィザードは、このフィールドの値をマッピングしません。
      sComputerFogBugz インポートウィザードは、このフィールドの値をマッピングしません。
      sFullNameFogBugz Import Wizard により、FogBugz ユーザー名が JIRA ユーザー名 (小文字) に自動的にマッピングされます。
      sPriorityFogBugz Import Wizard により、JIRA で欠落している値が自動的に作成され、課題が適切な優先度 (例: FogBugz の"Normal" が JIRA で新規作成された "Normal") で移行されます。
      sStatus (Resolution)既存の解決状況を使用する代わりに、インポーターにより JIRA での対応する解決状況が作成されます。
    • Select the appropriate JIRA Workflow Scheme in that will be used by the FogBugz issues you will import into your JIRA project.
      (info) If you are importing your FogBugz issues into an existing JIRA project, ensure that you choose the JIRA workflow scheme used by that existing JIRA project.

  12. Click the Next button to proceed to the Set up value mappings step of the FogBugz Import Wizard.
  13. On the Set up value mappings page, specify JIRA field values for each FogBugz field value (as detected by the FogBugz Import Wizard).
    (info) Any fields whose Map field value check boxes were selected in the previous step of the FogBugz Import Wizard will be presented on this page, including the mandatory sStatus FogBugz field.
  14. 次へボタンをクリックして、FogBugz Import Wizard のリンクの設定ステップに進みます。
  15. On the Set up links page, specify the JIRA link type for each FogBugz link type (as detected by the FogBugz Import Wizard). To learn more about JIRA link types, please see Configuring Issue Linking.
  16. Click the Begin Import button when you are ready to begin importing your FogBugz data into JIRA. The importer will display updates as the import progresses, then a success message when the import is complete.

    (info)Note:
    • インポートで問題が生じた場合 (または関心がある場合)、詳細ログのダウンロードリンクをクリックして、FogBugz Import Wizard プロセスに関する詳細情報を表示します。
    • If you need to import data from another FogBugz 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 FogBugz configuration file, which you can use at the first step of the FogBugz Import Wizard.

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

Tips for importing FogBugz for Your Server data into JIRA fields

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

FogBugz

JIRA 内

インポート時の注意

プロジェクト

プロジェクト

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

エリア

コンポーネント

インポーターが JIRA に FogBugz コンポーネントを自動作成する、または JIRA でコンポーネントなしでインポートする、などの選択が可能です。

マイルストーン

修正対象バージョン

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

ケース

課題

Every FogBugz case becomes a JIRA issue.

ケース ID
ixBug

Bug Import ID

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

要約

要約

 

コメント

コメント

FogBugzは、自動的にフォーマット「バグ課題Id」または「ケース課題ID」を使用することによって生成される他の課題へのリンクを可能にします。インポート後、このパターンにマッチする任意の文字列は、新しいJIRAキーに書き換えられます。たとえば、コメントは「ケース100 を参照してください」は、 IMP-100 を参照してください」に書き換えることができます。

添付ファイル

添付ファイル

Attachments are extracted from the FogBugz database and saved to disk. Any e-mail issues will be parsed for attachments and the e-mail text saved as a comment. The dates and user attaching the attachments will be retained.To specify the location on disk, see Configuring File Attachments.

カテゴリ

課題タイプ

特定のケースカテゴリから特定の課題タイプへのマッピングを設定できます。

Priority

Priority

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

ステータス

ステータス

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

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

ソリューション

ソリューション

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

重複
バグリレーション

リンク

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

コンピューター

コンピューター

FogBugz の Computer フィールドは、JIRA の 'Computer' というカスタムフィールドにインポートされます。

カスタマーEメール

カスタマーEメール

FogBugz の Customer Email フィールドは、JIRA の 'Customer Email' というカスタムフィールドにインポートされます。

ユーザー

ユーザー

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

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

その他のフィールド

カスタム フィールド

If your FogBugz 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.
Please note that the FogBugz Custom Field plugin is not supported.