Trac からのデータ インポート

JIRA にバンドルされているJIRA Importers プラグインを使用すれば、圧縮 Trac 環境から Tracのデータをインポートできます。

(info)当社のメイン Web サイトでは、 Trac から JIRA に移行する理由の上位を占める項目をいくつか取り上げています。バージョン 2.6.1 以降の JIRA Importers プラグインはバージョン 0.12.2 ~ 1.0.1 の Trac と互換性があります。

このページの内容:

JIRA へのデータのインポートに使用する Trac の準備

Tracの環境を圧縮:

  1. Tracの環境にアクセスします。
  2. If you use SQLite (the Trac default), PostgreSQL or MySQL for your Trac database, ensure your database URL (defined in Trac's conf/trac.ini file) is also reachable from JIRA server (using 'localhost' or a UNIX socket will not work).
  3. 先頭のディレクトリなしのTrac環境の内容をzip形式で圧縮します。

Trac Import Wizard を実行する

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

  1. JIRA 管理者グローバル権限を持つユーザーとしてログインします。
  2. 管理 > システム > インポートとエクスポート > 外部システム インポートを選択します。
  3. Trac を選択してTrac インポートウィザード: セットアップページを開きます。
  4. Trac Import Wizardでは、ページを設定し、上記で準備した、圧縮Tracの環境ファイルを選択します。
  5. 設定ファイルがない場合や、新しい設定ファイルを作成する場合は、既存の設定ファイルの使用チェックボックスは選択しないでください。設定ファイルにより、Trac のフィールドと JIRA のフィールド間のマッピングが指定されます。
    • このオプションを選択すると、既存の設定ファイルを指定するかどうか尋ねられます。
    • このオプションを選択しない場合、Tracインポート ウィザードの最後に、今後の Trac インポート(Trac インポート ウィザードの本ステップでの再利用)に使用できる設定ファイルが作成されます。
  6. 次へボタンをクリックして、 Trac Import Wizard の プロジェクトマッピングの設定 ステップに進みます。
  7. プロジェクトマッピングの設定 ページで、JIRA にインポートする Trac プロジェクトを選択します。
    • JIRA にすでに存在するプロジェクトの名前(またはキー)を入力するか、ドロップダウンメニューを使用して、既存の JIRA プロジェクトを選択します。
    • ドロップダウンメニューから新規作成を選択し、表示される新規プロジェクトの追加ダイアログボックスで、次の項目を入力します。
      1. 新規プロジェクトの名前
      2. 新規プロジェクト キー
        (情報)これは JIRA プロジェクトのすべての課題 ID のプレフィックスとして使用されます。
      3. プロジェクト リーダー
  8. 次へ ボタンをクリックして、 Trac Import Wizard の カスタムフィールドの設定 ステップに進みます。(情報)少なくとも1つの Trac フィールドは既存の JIRA フィールドと一致しない可能性があるため、このステップは常に表示されます。
  9. カスタムフィールド: Tracシステムに、任意のカスタムフィールドが含まれている場合は、既存のJIRAカスタムフィールドにインポートするか、インポーターが自動的にJIRAに新しいカスタムフィールドを作成か、選択することができます。
  10. (情報)マッピングを指定するかどうかにかかわらず、追加の Tracフィールドごとに JIRA カスタムフィールドが自動的に作成されます。ただし、最後のImport Data 画面で'Create new custom fields' オプションをオフにした場合はそのようにはなりません 。(スクリーンショット2 を参照してください。)
  11. フィールド値のマッピング:
    • 「優先度」フィールドー マッピングを指定しない場合、インポーターは自動的にJIRAに欠損値を作成し、課題が正しく優先的に移行されることを保証します
    • ユーザー名 - マッピングを指定しないと、Trac のユーザー名が JIRA のユーザー名 (小文字) に自動的にマッピングされます。
      (情報)マッピングを指定するかどうかにかかわらず、欠落しているユーザーのユーザー名が自動的に作成されます。
    • 「ステータス」フィールド — Trac の「ステータス」フィールドを JIRA の「ステータス」フィールドの特定の値にマップするために必須です。これは、JIRA の「ステータス」フィールドが JIRA ワークフローに不可欠であるからです (詳細は、「ワークフローで作業する」および「ワークフローを管理する」を参照)。
    • 「解決状況」フィールド ー マッピングを指定しない場合、インポーターは既存のものは使用せず、対応する解決状況を作成します。
    • ' 課題の最大数と失敗 ' - ご希望の場合は、インポーターが停止された後失敗した課題の最大数を指定します。失敗に関係なく、インポートを継続したい場合は、このフィールドを空白のままにします。Tracのインスタンスに課題が多くある場合、それは課題の限られた数で、最初のインポートツールを実行するには、一般的には良いアイデアです。(例えば、100)、その後、手動で設定ファイルが正しく指定されているかどうかを確認するために、インポートの問題を検査します。結果は満足のいくものであるときは、制限なしでインポートを実行することができます。
  12. インポーターは、インポートの進行に合わせて更新状況を示し、インポートが完了すると、正常完了したことを示すメッセージを表示します。ご希望の場合は、インポート・ログをダウンロードすることができます。

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

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

インポートプロセスでは、次のように Trac データが変換されます。

Trac 内

JIRA 内

インポート時の注意

プロジェクト環境

Project

各 Tracker 環境は JIRA プロジェクトとしてインポートされます。ターゲットとして既存の JIRA プロジェクトを指定できますが、指定しなくても、インポート時にインポーターによって新規プロジェクトが自動的に作成されます。

チケット タイプ

課題タイプ

Trac チケット タイプから特定の JIRA 課題タイプへのマッピングを設定できます。

チケット番号 External issue ID Trac チケット番号は JIRA カスタムフィールドに取り込まれます。インポートでは JIRA 課題番号が Trac チケット番号と一致するように設定されていません。

ステータス

ステータス

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

要約

要約

 

説明

説明

 

バージョン

バージョン

(選択した場合は)Trac からバージョンがインポートされ、Un-Released および Un-Archived 状態に設定されます。

Component

コンポーネント

インポーターが JIRA に Trac コンポーネントを自動作成するか、または JIRA のコンポーネントにバグがインポートされないようにするかについて選択できます。

コメント

コメント

 

優先度

優先度 (またはカスタムフィールド)

Trac 優先度フィールドと Trac 重大度フィールド(下記)のうち、一方を組み込みの JIRA 優先度フィールドにマッピングし、もう一方をカスタムフィールドにマッピングする選択ができます。 (または、Trac 優先度フィールドと Trac 重大度フィールドの両方を JIRA カスタムフィールドにマッピングできます)。 JIRA 優先度フィールドにインポートする場合、Trac の特定の値から JIRA の特定の値へのマッピングを設定できます。

重大度

優先度 (またはカスタムフィールド)

Trac 優先度フィールドと Trac 重大度フィールド(下記)のうち、一方を組み込みの JIRA 優先度フィールドにマッピングし、もう一方をカスタムフィールドにマッピングする選択ができます。 (または、Trac 優先度フィールドと Trac 重大度フィールドの両方を JIRA カスタムフィールドにマッピングできます)。 JIRA 優先度フィールドにインポートする場合、Trac の特定の値から JIRA の特定の値へのマッピングを設定できます。

マイルストーン

マイルストーン

JIRA はこれをカスタムフィールドとして作成します。

添付ファイル

添付ファイル

Trac Environment から添付ファイルが抽出され、ディスクに保存されます。ディスク上の場所を指定するには、 「ファイル添付を設定する」を参照してください

ソリューション

ソリューション

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

CC

ウォッチャー

 

キーワード

ラベル

 

ユーザー

ユーザー

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

  • パスワードは Trac からインポートされません。Trac のユーザーはパスワードをメールで通知してもらう必要があります。
  • 外部ユーザー管理を使用している場合、インポートのプロセスで JIRA ユーザーを作成できません。代わりに、作成の必要がある新規ユーザーの一覧がインポーターによって提供されます。インポートを開始する前に外部のユーザー リポジトリでユーザーを作成する必要があります。
  • ユーザー数制限付きライセンス(例: パーソナルライセンス)で、必要なユーザー数が制限数を超える場合、インポートは停止されます。作成できないユーザーのリストを示すページが表示されます。

その他のフィールド

カスタム フィールド

Trac システムにカスタムフィールドがある場合、このフィールドを特定の JIRA カスタムフィールドにマッピングする選択が可能です。JIRA にカスタムフィールドがまだ存在していない場合、インポーターによってカスタムフィールドが自動的に作成されます。

最終更新日: 2018 年 2 月 12 日

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

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