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

The JIRA Importers plugin, which is bundled with JIRA, allows you to import data from Trac from a compressed Trac environment.

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

On this page:

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. A new project Key.
        (info) This will be used as the prefix for all issue IDs in your JIRA project.
      3. プロジェクト リーダー
  8. Click the Next button to proceed to the Setup custom fields step of the Trac Import Wizard.
    (info) This step will almost always appear because at least one Trac field is not likely match an existing JIRA field.
  9. カスタムフィールド: Tracシステムに、任意のカスタムフィールドが含まれている場合は、既存のJIRAカスタムフィールドにインポートするか、インポーターが自動的にJIRAに新しいカスタムフィールドを作成か、選択することができます。
  10. (info) Regardless of whether you specify mapping, the importer will automatically create a JIRA custom field for each extra Trac field, unless you un-check the 'Create new custom fields' option on the final 'Import Data' screen (see Screenshot 2 below).
  11. フィールド値のマッピング:
    • 「優先度」フィールドー マッピングを指定しない場合、インポーターは自動的にJIRAに欠損値を作成し、課題が正しく優先的に移行されることを保証します
    • Usernames — If you don't specify mapping, the importer will automatically map Trac usernames to JIRA usernames (lowercase).
      (info) Regardless of whether you specify mapping, JIRA will automatically create usernames for missing users.
    • 「ステータス」フィールド — Trac の「ステータス」フィールドを JIRA の「ステータス」フィールドの特定の値にマップするために必須です。これは、JIRA の「ステータス」フィールドが JIRA ワークフローに不可欠であるからです (詳細は、「ワークフローで作業する」および「ワークフローを管理する」を参照)。
    • 「解決状況」フィールド ー マッピングを指定しない場合、インポーターは既存のものは使用せず、対応する解決状況を作成します。
    • ' 課題の最大数と失敗 ' - ご希望の場合は、インポーターが停止された後失敗した課題の最大数を指定します。失敗に関係なく、インポートを継続したい場合は、このフィールドを空白のままにします。Tracのインスタンスに課題が多くある場合、それは課題の限られた数で、最初のインポートツールを実行するには、一般的には良いアイデアです。(例えば、100)、その後、手動で設定ファイルが正しく指定されているかどうかを確認するために、インポートの問題を検査します。結果は満足のいくものであるときは、制限なしでインポートを実行することができます。
  12. インポーターは、インポートの進行に合わせて更新状況を示し、インポートが完了すると、正常完了したことを示すメッセージを表示します。ご希望の場合は、インポート・ログをダウンロードすることができます。

Congratulations, you have successfully imported your Trac projects into JIRA! If you have any questions or encounter any problems, please contact Atlassian support.

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

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

Trac 内

JIRA 内

インポート時の注意

プロジェクト環境

プロジェクト

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

チケット タイプ

課題タイプ

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

チケット番号External issue IDTrac チケット番号は 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

ウォッチャー

 

キーワード

ラベル

 

ユーザー

ユーザー

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

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

その他のフィールド

カスタム フィールド

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

最終更新日: 2018 年 1 月 31 日

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

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