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 プロジェクトについては、[プロジェクトを選択] をクリックし、次のいずれかの操作を行います。- 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 にインポートする前に変更する場合、[フィールド マッピングの設定] ページで、該当するフィールドの横の [フィールド値のマッピング] チェックボックスを選択します。
FogBugz の sStatus (ステータス) フィールドを Jira ステータス フィールドとして Jira の特定のステータス フィールド値にマッピングすることが、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 に Bugzilla コンポーネントを自動的に作成するか、Jira のコンポーネントにバグをインポートしないかを選択できます。 |
マイルストーン | 修正対象バージョン | 選択すると、FogBugz からバージョンがインポートされます。インポート後、Jira で必要に応じて適切なバージョンをリリース済みに手動で設定できます。 |
ケース | 課題 | FogBugz のすべてのケースが Jira の課題になります。 |
ケース ID | Bug Import ID | インポートした各課題 ("ケース") には新しい Jira ID が与えられ、古い FogBugz Server ID は "Bug Import ID" という Jira カスタム フィールドに保存されます。このカスタム フィールドは検索可能なため、旧 FogBugz ID で Jira の課題を検索できます。このカスタム フィールドが不要な場合は、削除または "非表示" にすることができます (「フィールド動作の指定」で説明)。 |
要約 | 要約 | |
コメント | コメント | FogBugz では、"bug issueId"バグ課題Id" または "case issue id" を使用して、他の課題へのリンクを自動的に生成します。インポート後、このパターンにマッチする任意の文字列は、新しい Jira キーに書き換えられます。たとえば、"case 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 にカスタム フィールドがまだ存在していない場合、インポーターによって自動的にカスタム フィールドが作成されます。 |