Trac からのデータ インポート
Jira へのデータ インポートのための Trac の準備
Tracの環境を圧縮:
- Tracの環境にアクセスします。
- Trac のデータベースに SQLite (Tracのデフォルト)、PostgreSQL、または MySQL を使用する場合は、データベースの URL (Trac の
conf/trac.ini
のファイルで定義) が Jira サーバからも到達可能であることを確認します ("localhost" または UNIX ソケットは動作しません)。 - 先頭のディレクトリなしのTrac環境の内容をzip形式で圧縮します。
Trac Import Wizard を実行する
開始する前に、Jira データをバックアップします。
- Jira 管理者グローバル権限を持つユーザーとしてログインします。
- [管理] > [システム] > [インポートとエクスポート] > [外部システム インポート] を選択します。
- Trac を選択してTrac インポートウィザード: セットアップページを開きます。
- Trac Import Wizardでは、ページを設定し、上記で準備した、圧縮Tracの環境ファイルを選択します。
- 設定ファイルがない場合や、新しい設定ファイルを作成する場合は、[既存の設定ファイルを使用] チェックボックスは選択解除したままにします。設定ファイルは、Trac のフィールドと Jira のフィールドの間のマッピングを指定します。
- このオプションを選択すると、既存の設定ファイルを指定するかどうか尋ねられます。
- このオプションを選択しない場合、Trac Import Wizard の最後に、以降のインポート (Trac Import Wizard のこのステップでの再利用) に使用できる設定ファイルが作成されます。
- 次へボタンをクリックして、 Trac Import Wizard の プロジェクトマッピングの設定 ステップに進みます。
- [プロジェクト マッピングの設定] ページで、Jira にインポートする Trac プロジェクトを選択します。
- Jira に存在するプロジェクトの名前 (またはキー) を入力するか、ドロップダウン メニューを使用して既存の Jira プロジェクトを選択します。
- ドロップダウンメニューから新規作成を選択し、表示される新規プロジェクトの追加ダイアログボックスで、次の項目を入力します。
- 新規プロジェクトの名前
- 新規プロジェクトのキー
これは Jira プロジェクトのすべての課題 ID の接頭辞として使用されます。 - プロジェクト リーダー。
- [次へ] ボタンをクリックして、Trac Import Wizard の [カスタム フィールドの設定] ステップに進みます。
通常、少なくとも 1 つの Trac フィールドが既存の Jira フィールドに一致しないため、このステップはほとんどの場合表示されます。 - カスタム フィールド: Trac システムに任意のカスタム フィールドが含まれている場合、既存の Jira カスタム フィールドにインポートするか、インポーターが自動的に Jira に新しいカスタム フィールドを作成するかを選択できます。
- マッピングの指定にかかわらず、追加の Trac フィールドごとに Jira カスタム フィールドが自動的に作成されます。ただし、最後の [データのインポート] 画面で [新しいカスタム フィールドの作成] オプションを選択解除している場合、これは行われません (次のスクリーンショット 2 を参照)。
- フィールド値のマッピング:
- "優先度" フィールドー マッピングを指定しない場合、インポーターは不足している値を自動的に Jira に作成し、課題が正しい優先度で移行されるようにします。
- ユーザー名 — マッピングを指定しない場合、Trac のユーザー名が Jira のユーザー名 (小文字) に自動的にマッピングされます。
マッピングの指定にかかわらず、不足しているユーザーのユーザー名が自動的に作成されます。 - "ステータス" フィールド — Trac の "ステータス" フィールドを Jira の "ステータス" フィールドの特定の値にマップするために必須です。これは、Jira の "ステータス" フィールドが Jira ワークフローに必須であるためです (詳細は、「ワークフローで作業する」および「ワークフローを管理する」を参照)。
- "解決状況" フィールド ー マッピングを指定しない場合、インポーターは既存のものは使用せず、Jira 内に対応する解決状況を作成します。
- ' 課題の最大数と失敗 ' - ご希望の場合は、インポーターが停止された後失敗した課題の最大数を指定します。失敗に関係なく、インポートを継続したい場合は、このフィールドを空白のままにします。Tracのインスタンスに課題が多くある場合、それは課題の限られた数で、最初のインポートツールを実行するには、一般的には良いアイデアです。(例えば、100)、その後、手動で設定ファイルが正しく指定されているかどうかを確認するために、インポートの問題を検査します。結果は満足のいくものであるときは、制限なしでインポートを実行することができます。
- インポーターは、インポートの進行に合わせて更新状況を示し、インポートが完了すると、正常完了したことを示すメッセージを表示します。ご希望の場合は、インポート・ログをダウンロードすることができます。
これで、Trac データを Jira に正常にインポートできました。ご不明な点や、問題が生じた場合は、アトラシアン サポートにご連絡ください。
Trac データを Jira フィールドにインポートするためのヒント
インポートプロセスでは、次のように Trac データが変換されます。
Trac 内 | Jira 内 | インポート時の注意 |
---|---|---|
プロジェクト環境 | プロジェクト | 各 Tracker 環境が 1 つの Jira プロジェクトとしてインポートされます。ターゲットとして既存の Jira プロジェクトを指定できますが、指定しない場合、インポート時にインポーターが自動的に新規プロジェクトを作成します。 |
チケット タイプ | 課題タイプ | Trac チケット タイプから特定の Jira 課題タイプへのマッピングを設定できます。 |
チケット番号 | External issue ID | Trac チケット番号は Jira カスタム フィールドに取り込まれます。インポートでは、Jira 課題番号と Trac のチケット番号との一致は行われません。 |
ステータス | ステータス | Trac の特定の値から Jira の特定の値へのマッピングを設定できます。 |
要約 | 要約 | |
説明 | 説明 | |
バージョン | バージョン | (選択した場合は)Trac からバージョンがインポートされ、Un-Released および Un-Archived 状態に設定されます。 |
コンポーネント | コンポーネント | インポーターによって Jira に Trac コンポーネントを自動的に作成するか、Jira のコンポーネントにバグをインポートしないかを選択できます。 |
コメント | コメント | |
Priority | 優先度 (またはカスタムフィールド) | Trac の優先度フィールドと Trac の重要度フィールド (前述) のうち一方を組み込みの Jira 優先度フィールドにマッピングし、もう一方をカスタム フィールドにマッピングするように選択できます (Trac 優先度フィールドと Trac 重要度フィールドの両方を Jira カスタム フィールドにマッピングすることもできます)。Jira 優先度フィールドにインポートする場合、Trac の特定の値から Jira の特定の値へのマッピングを設定できます。 |
深刻度 | 優先度 (またはカスタムフィールド) | Trac の優先度フィールドと Trac の重要度フィールド (前述) のうち一方を組み込みの Jira 優先度フィールドにマッピングし、もう一方をカスタム フィールドにマッピングするように選択できます (Trac 優先度フィールドと Trac 重要度フィールドの両方を Jira カスタム フィールドにマッピングすることもできます)。Jira 優先度フィールドにインポートする場合、Trac の特定の値から Jira の特定の値へのマッピングを設定できます。 |
マイルストーン | マイルストーン | Jira はこれをカスタム フィールドとして作成します。 |
添付ファイル | 添付ファイル | Trac Environment から添付ファイルが抽出され、ディスクに保存されます。ディスク上の場所を指定するには、 「ファイル添付を設定する」を参照してください。 |
ソリューション | ソリューション | Trac の特定の値から Jira の特定の値へのマッピングを設定できます。 |
CC | ウォッチャー | |
キーワード | ラベル | |
ユーザー | ユーザー | インポーターは、Jira に存在しない Trac ユーザーに対して Jira ユーザーを自動的に作成します。
|
その他のフィールド | カスタム フィールド | Trac システムにカスタム フィールドがある場合、特定の Jira カスタム フィールドへのマッピングを行うことができます。Jira にカスタム フィールドがまだ存在していない場合、インポーターによって自動的にカスタム フィールドが作成されます。 |