FogBugz からサーバー版へのデータのインポートする

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

(info)当社のメインウェブサイトでは、FogBugz から JIRA に移行する理由の上位に入るものをいくつか取り上げています。バージョン 4.2 以降の JIRA Importers プラグインは、Fogbugz for Your Server バージョン 7.3.6 ~ 8.8.39 と互換性があります。JIRA Importers プラグインでは、FogBugz for Your Server データベースが MySQL、Microsoft SQL Server、Microsoft SQL Server Express のいずれかである必要があります。

このページの内容:

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

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

(info)これらの手順では、FogBugz for Your Server について説明します。これは、ファイアウォールの内側で動作する FogBugz のインストール可能な実装です。FogBugz On Demand (SaaS) 課題トラッカーサイトからインポートするには、こちらの手順に従ってください。

FogBugz for your Server Import Wizard の実行

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

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

    データベースタイプ

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

    • PostgreSQL
    • Microsoft SQL Server
    • MySQL
    ホスト名 FogBugz サイトのデータベースサーバーを実行しているサーバーのホスト名または IP アドレスを指定します。
    ポート FogBugz サイトのデータベースサーバーがリスンしている TCP/IP ポートを指定します。
    (tick)このフィールドには、前に選択したデータベースタイプに基づいて既定のポート値が自動的に入力されます。
    データベース 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 がデータベースを接続するために使用するデータベースユーザー (前記) のパスワードを指定します。
    既存の設定ファイルを使用する 設定ファイルがない場合や、新しい設定ファイルを作成する場合は、このチェックボックスをオフのままにします。設定ファイルにより、FogBugz のフィールドと JIRA のフィールドの間のマッピングを指定します。
    (info)注:
      • このオプションを選択すると、既存の設定ファイルを指定するかどうか尋ねられます。
      • このオプションを選択しない場合、FogBugz Import Wizard の最後に、この後のインポート (FogBugz Import Wizard のこのステップでの再利用) に使用できる設定ファイルが作成されます。
    JDBC connection parameters
    (展開した Advanced タブ)
    FogBugz Import Wizard は、前に指定した FogBugz データベースサーバーの詳細から JDBC ベースのデータベース URL を作成します。JIRA はこの URL を使用して FogBugz for Your Server に接続し、課題をインポートします。 FogBugz データベースに追加の接続パラメータを指定する必要がある場合、ここで指定します。
    (info)MySQL (前記) を選択すると、既定で追加の接続パラメータが追加されます。
  5. 次へボタンをクリックして、FogBugz Import Wizard のプロジェクトマッピングの設定ステップに進みます。

  6. プロジェクトマッピングの設定 ページで、JIRA にインポートする FogBugz プロジェクトを選択します。

  7. (info)既定ではすべてのプロジェクトが選択されているので、JIRA にインポートしないFogBugz プロジェクトの インポートの下のチェックボックスをオフにします。
    JIRA にインポートする FogBugz プロジェクトについては、Select a project をクリックし、次のいずれかの操作を行います。
    • JIRA にすでに存在するプロジェクトの名前(またはキー)を入力するか、ドロップダウンメニューを使用して、既存の JIRA プロジェクトを選択します。
    • ドロップダウンメニューから Create New を選択し、 Add A New Project ダイアログボックスで次の項目を入力します。
      1. 新規プロジェクトの名前
      2. 新規プロジェクトのキー
        (info)これは JIRA プロジェクトのすべての課題 ID の接頭語として使用されます。
      3. プロジェクトリード
  8. 次へ ボタンをクリックして、 FogBugz インポート ウィザードのカスタム フィールドの設定ステップに進みます。
  9. カスタムフィールドの設定ページで、FogBugz Import Wizard が既存の JIRA フィールドと一致させることのできない FogBugz の外部フィールドごとに、次のいずれかを選択できます。
    • FogBugz Import Wizard で、FogBugz のフィールド名に基づき、JIRA の新規カスタムフィールドを自動的に作成します。これは既定のオプションです。自動的に作成された JIRA カスタムフィールドの名前がJIRA フィールド ドロップダウンリストに表示されます。
  10. 次へをクリックして、FogBugz インポート ウィザードのフィールド マッピング設定ステップに進みます。
  11. FogBugz の外部フィールドの値を JIRA にインポートする  に変更する場合、フィールド マッピングの設定 ページで、該当するフィールドの横の フィールド値のマッピング チェックボックスにチェックを入れます。
    (info)JIRA ステータスフィールドはJIRA ワークフローの不可欠な部分であるため、FogBugz のsStatus(すなわち、 ステータス)フィールドを特定の JIRA ステータス フィールドにマッピングすることが必須であることに注意してください。
    • フィールドマッピングの設定ページ に表示される、FogBugz のその他の 外部フィールドは次のとおりです。

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

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

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

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

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

FogBugz

JIRA 内

インポート時の注意

Project

Project

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

エリア

Component

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

マイルストーン

Fix Version (修正バージョン)

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

ケース

Issue

FogBugz のすべてのケースは JIRA の課題になります。

ケース ID
ixBug

Bug Import ID

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

要約

要約

 

コメント

コメント

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

添付ファイル

添付ファイル

FogBugz データベースから添付ファイルが抽出され、ディスクに保存されます。電子メールの課題で添付ファイルが解析され、電子メールのテキストがコメントとして保存されます。ファイルが添付された日付と添付したユーザーに関する情報も保存されます。ディスク上の場所を指定するには、「ファイル添付を設定する」を参照してください。

カテゴリー

課題タイプ

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

優先度

優先度

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

ステータス

ステータス

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

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

ソリューション

ソリューション

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 ユーザーを作成できません。代わりに、作成の必要がある新規ユーザーの一覧がインポーターによって提供されます。インポートを開始する前に外部のユーザー リポジトリでユーザーを作成する必要があります。
  • ユーザー数制限付きライセンス(例: パーソナルライセンス)で、必要なユーザー数が制限数を超える場合、インポートは停止されます。作成できないユーザーのリストを示すページが表示されます。

その他のフィールド

カスタムフィールド

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

最終更新日 2017 年 9 月 3 日

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

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