FogBugz からサーバー版へのデータのインポートする
FogBugz for Your Serverインポートプロセスでは、次のように FogBugz Import Wizard を実行するだけです。
- インポートプロセスでは個々のフィールドやフィールド値のマッピングを選択できます。一部は必須です。
- FogBugz Import Wizard の最後に、FogBugz 設定ファイルを作成するオプションが表示されます。これには、FogBugz Import Wizard を通じて行った設定が含まれています。 これは、プロダクションシステムでインポートを実行する前にテスト用 JIRA サーバーで FogBugz のインポートをテストする必要がある場合に便利です。
これらの手順では、FogBugz for Your Server について説明します。これは、ファイアウォールの内側で動作する FogBugz のインストール可能な実装です。FogBugz On Demand (SaaS) 課題トラッカーサイトからインポートするには、こちらの手順に従ってください。
FogBugz for your Server Import Wizard の実行
開始する前に、JIRA データをバックアップしてください。
- Jira 管理者グローバル権限を持つユーザーとしてログインします。
- > [システム] を選択します。[インポートとエクスポート] > [外部システム インポート] を選択し、[外部プロジェクトのインポート] ページを開きます。
- Select FogBugz for Your Server to open the FogBugz Import Wizard: Setup page.
FogBugz Setup ページで次のフィールド/オプションを入力します。
データベースタイプ FogBugz for Your Server インストールで使用するデータベースのタイプを選択します。
- PostgreSQL
- Microsoft SQL Server
- MySQL
ホスト名 FogBugz サイトのデータベースサーバーを実行しているサーバーのホスト名または IP アドレスを指定します。 ポート FogBugz サイトのデータベースサーバーがリスンしている TCP/IP ポートを指定します。
このフィールドには、前に選択したデータベースタイプに基づいて既定のポート値が自動的に入力されます。データベース FogBugz データベースの名前を指定します (サーバーによるデータの保存先となる FogBugz)。
データベースのインスタンス ID を指定する必要がある場合は、fogbugz;instance=sqlexpress
という構文を使用します (ここで、fogbugz
は FogBugz データベースの名前、sqlexpress
は FogBugz データベースのインスタンス ID です)。データベース名は通常、Windows のレジストリで見つけることができます。関連するレジストリ キーと値にアクセスする方法の詳細については、http://bugs.movabletype.org/help/topics/setup/WindowsWhatSetupDoes.html を参照し、"Initialize Registry Settings" を検索します。ユーザ名 FogBugz がデータベースを接続するために使用するデータベース ユーザーを指定します。 パスワード FogBugz がデータベースを接続するために使用するデータベースユーザー (前記) のパスワードを指定します。 既存の設定ファイルを使用する 設定ファイルがない場合や、新しい設定ファイルを作成する場合は、このチェックボックスをオフのままにします。設定ファイルにより、FogBugz のフィールドと JIRA のフィールドの間のマッピングを指定します。
注:- このオプションを選択すると、既存の設定ファイルを指定するかどうか尋ねられます。
- このオプションを選択しない場合、FogBugz Import Wizard の最後に、この後のインポート (FogBugz Import Wizard のこのステップでの再利用) に使用できる設定ファイルが作成されます。
JDBC connection parameters
(展開した Advanced タブ)FogBugz Import Wizard は、前に指定した FogBugz データベースサーバーの詳細から JDBC ベースのデータベース URL を作成します。JIRA はこの URL を使用して FogBugz for Your Server に接続し、課題をインポートします。 FogBugz データベースに追加の接続パラメータを指定する必要がある場合、ここで指定します。
MySQL (前記) を選択すると、既定で追加の接続パラメータが追加されます。次へボタンをクリックして、FogBugz Import Wizard のプロジェクトマッピングの設定ステップに進みます。
プロジェクトマッピングの設定 ページで、JIRA にインポートする FogBugz プロジェクトを選択します。
- 既定ではすべてのプロジェクトが選択されているので、JIRA にインポートしないFogBugz プロジェクトの インポートの下のチェックボックスをオフにします。
JIRA にインポートする FogBugz プロジェクトについては、Select a project をクリックし、次のいずれかの操作を行います。- JIRA にすでに存在するプロジェクトの名前(またはキー)を入力するか、ドロップダウンメニューを使用して、既存の JIRA プロジェクトを選択します。
- ドロップダウンメニューから Create New を選択し、 Add A New Project ダイアログボックスで次の項目を入力します。
- 新規プロジェクトの名前
- 新規プロジェクトのキー
これは JIRA プロジェクトのすべての課題 ID の接頭語として使用されます。 - プロジェクトリード
- 次へ ボタンをクリックして、 FogBugz インポート ウィザードのカスタム フィールドの設定ステップに進みます。
- カスタムフィールドの設定ページで、FogBugz Import Wizard が既存の JIRA フィールドと一致させることのできない FogBugz の外部フィールドごとに、次のいずれかを選択できます。
- FogBugz Import Wizard で、FogBugz のフィールド名に基づき、JIRA の新規カスタムフィールドを自動的に作成します。これは既定のオプションです。自動的に作成された JIRA カスタムフィールドの名前がJIRA フィールド ドロップダウンリストに表示されます。
- JIRA で独自のカスタムフィールドを作成し、FogBugz のフィールドからのデータをマッピングします。そのために、JIRA フィールドドロップダウンリストからその他を選択し、その他のすぐ下に表示される新規フィールドにカスタムフィールドの名前を指定します。
- 次へをクリックして、FogBugz インポート ウィザードのフィールド マッピング設定ステップに進みます。
- FogBugz の外部フィールドの値を JIRA にインポートする 前 に変更する場合、フィールド マッピングの設定 ページで、該当するフィールドの横の フィールド値のマッピング チェックボックスにチェックを入れます。
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 ワークフロー スキームを選択します。
FogBugz の課題を既存の JIRA プロジェクトにインポートする場合、その既存 JIRA プロジェクトが使用する JIRA ワークフロー スキームを選択するようにします。
- 次へボタンをクリックして、FogBugz Import Wizard の値マッピングの設定ステップに進みます。
- 値マッピングの設定ページで、(FogBugz Import Wizard で検出された) 各 FogBugz フィールド値に対応する JIRA フィールド値を指定します。
FogBugz Import Wizard の前のステップでフィールド値のマッピングチェックボックスがオンになっているフィールドは、このページに表示されます (FogBugz で必須の sStatus フィールドなど)。 - 次へボタンをクリックして、FogBugz Import Wizard のリンクの設定ステップに進みます。
- リンクの設定ページで、(FogBugz Import Wizard で検出された) FogBugz の各リンクタイプに対応する JIRA のリンクタイプを指定します。JIRA のリンクタイプの詳細については、「課題リンクの設定」を参照してください。
- FogBugz データを JIRA にインポートする準備ができたら、インポート開始ボタンをクリックします。インポーターは、インポートの進行に合わせて更新状況を示し、インポートが完了すると、正常完了したことを示すメッセージを表示します。注:
- インポートで問題が生じた場合 (または関心がある場合)、詳細ログのダウンロードリンクをクリックして、FogBugz Import Wizard プロセスに関する詳細情報を表示します。
- この手順を通じて使用した設定と同じ(または類似の)設定で、別の FogBugz 製品/プロジェクトまたはサイトからデータをインポートする必要がある場合は、設定を保存 リンクをクリックして、FogBugz 設定ファイルをダウンロードします。この設定ファイルは、FogBugz ファイルインポート ウィザードの最初のステップで使用できます。
お疲れ様でした。FogBugz データが Jira に正常にインポートされました!ご不明な点や、問題が生じた場合は、アトラシアン サポートにご連絡ください。
FogBugz for your Server データを JIRA フィールドにインポートするためのヒント
インポートプロセスでは、次のデータが FogBugz Server データベースから JIRA にコピーされます。
FogBugz | JIRA 内 | インポート時の注意 |
---|---|---|
プロジェクト | プロジェクト | FogBugz データはプロジェクト単位でインポートされます。ターゲットとして既存の JIRA プロジェクトを指定できますが、指定しなくても、インポート時にインポーターによって自動的に新規プロジェクトが作成されます。JIRA プロジェクトの詳細については、「プロジェクトの定義」を参照してください。 |
エリア | コンポーネント | インポーターが JIRA に FogBugz コンポーネントを自動作成する、または JIRA でコンポーネントなしでインポートする、などの選択が可能です。 |
マイルストーン | 修正対象バージョン | FogBugz からバージョンがインポートされます (選択した場合)。インポート後、必要に応じて JIRA で適切なバージョンをリリース済み状態に手動で設定できます。 |
ケース | 課題 | FogBugz のすべてのケースは JIRA の課題になります。 |
ケース ID | Bug Import ID | インポートした各課題 (「ケース」) には新しい JIRA ID が与えられ、古い FogBugz Server ID は 'Bug Import ID' という JIRA カスタムフィールドに保存されます。このカスタムフィールドは検索可能であり、旧 FogBugz ID で JIRA の課題を検索できます。 このカスタムフィールドが不要な場合は、削除または「非表示」にすることができます (「フィールド動作の指定」で説明しています)。 |
要約 | 要約 |
|
コメント | コメント | FogBugzは、自動的にフォーマット「バグ課題Id」または「ケース課題ID」を使用することによって生成される他の課題へのリンクを可能にします。インポート後、このパターンにマッチする任意の文字列は、新しいJIRAキーに書き換えられます。たとえば、コメントは「ケース100 を参照してください」は、 IMP-100 を参照してください」に書き換えることができます。 |
添付ファイル | 添付ファイル | FogBugz データベースから添付ファイルが抽出され、ディスクに保存されます。電子メールの課題で添付ファイルが解析され、電子メールのテキストがコメントとして保存されます。ファイルが添付された日付と添付したユーザーに関する情報も保存されます。ディスク上の場所を指定するには、「ファイル添付を設定する」を参照してください。 |
カテゴリ | 課題タイプ | 特定のケースカテゴリから特定の課題タイプへのマッピングを設定できます。 |
Priority | Priority | FogBugz の特定の値から JIRA の特定の値へのマッピングを設定できます。 |
ステータス | ステータス | インポーターを実行する前に JIRA でワークフローを作成している場合、FogBugz の特定の値から JIRA の特定の値へのマッピングを設定できます。
|
ソリューション | ソリューション | FogBugz の特定の値から JIRA の特定の値へのマッピングを設定できます。 |
重複 | リンク | FogBugz の特定のリンクタイプから JIRA のリンクタイプへのマッピングを設定できます。
|
コンピューター | コンピューター | FogBugz の Computer フィールドは、JIRA の 'Computer' というカスタムフィールドにインポートされます。 |
カスタマーEメール | カスタマーEメール | FogBugz の Customer Email フィールドは、JIRA の 'Customer Email' というカスタムフィールドにインポートされます。 |
ユーザー | ユーザー | FogBugz ユーザーが JIRA に存在しない場合は、インポーターで対応する JIRA ユーザーを自動的に作成できます。
|
その他のフィールド | カスタム フィールド | FogBugz システムにカスタムフィールドがある場合、特定の JIRA カスタムフィールドへのマッピングを行うことができます。JIRA にカスタムフィールドがまだ存在していない場合、インポーターによって自動的にカスタムフィールドが作成されます。 |