Documentation for JIRA 4.4. Documentation for other versions of JIRA is available too.

About importing from Trac

JIRA ships with the JIRA Importers Plugin pre-installed, so that you can easily import your bugs from Trac.Version 2.6.1 or later of the JIRA Importers Plugin is compatible with Trac version 0.12.2.If you have an earlier version you can upgrade it via the Universal Plugin Manager.

On this page:

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

Trac 内

JIRA 内

インポート時の注意

プロジェクト環境

プロジェクト

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

チケット タイプ

課題タイプ

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

ステータス

ステータス

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 はこれをカスタムフィールドとして作成します。

添付ファイル

添付ファイル

Attachments are extracted from the Trac Environment and saved to disk. To specify the location on disk, see Configuring File Attachments.

ソリューション

ソリューション

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

CC

ウォッチャー

 

キーワード

ラベル

 

ユーザー

ユーザー

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

  • パスワードは Trac からインポートされません。Trac のユーザーはパスワードをメールで通知してもらう必要があります。
  • If you are using External User Management, the import process will not be able to create JIRA users; instead, the importer will give you a list of any new users that need to be created. You will need to create the users in your external user repository before commencing the import.
  • ユーザー数に制限のあるライセンス (例: パーソナル ライセンス) で、必要なユーザー数が制限を超える場合、インポートは停止されます。作成できないユーザーの一覧を示すページが表示されます。

その他のフィールド

カスタム フィールド

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

How to import from Trac

First you will need to ZIP up the contents of your Trac environment

  1. Go to your Trac Environment.
  2. If you use SQLite(Trac default) PostgreSQL or MySQL database make sure your database URL saved in conf/trac.ini is also reachable from JIRA server (using localhost or unix socket won't work).
  3. ZIP contents of Trac Environment without any leading directories.

Import into JIRA

  1. Before you begin, please backup your JIRA data.
  2. Log in to JIRA as as a user with the 'JIRA Administrators' global permission.
  3. Select 'Administration' > 'System' > 'Import & Export' > 'External System Import' > 'Trac'.
  4. The 'Trac Import Wizard' page will be displayed.
    • If you don't have a configuration file (or to create a new one, or update the one you have), leave the 'Existing Configuration File' field blank and click 'Next'.
      Screenshot 1: the 'Trac Import Wizard' page
  5. Project Key Mappings: For each Trac project that you wish to import into a new JIRA project, select the JIRA 'Project category' (if applicable) and type in a unique JIRA 'Name' and 'Key'.
    • (info) The JIRA 'Project key' will be the prefix for the IDs of all issues in the given project.
    • To import into an existing JIRA project, type a project key and project name that already exists in JIRA.
  6. Custom Fields: If your Trac system contains any custom fields, you can either choose to import into an existing JIRA custom field or have the importer automatically create a new custom field in JIRA.
    (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).
  7. フィールド値のマッピング:
    • 「優先度」フィールドー マッピングを指定しない場合、インポーターは自動的に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 unless you un-check the'Create new users' option on the final 'Import Data' screen.
    • 'Status' field — It is mandatory to map the Trac 'Status' field to specific values of the JIRA 'Status' field, as the JIRA 'Status' field is integral to JIRA workflow (to learn more, please see What is Workflow and Configuring Workflow).
    • 「解決状況」フィールド ー マッピングを指定しない場合、インポーターは既存のものは使用せず、対応する解決状況を作成します。
  8. The 'Import Data' page will be displayed:
    Screenshot 2: the 'Import Data' page

    • 'Create new users/versions' — Leave 'ON' to create new users/versions/custom fields that do not yet exist in JIRA. (This is the generally recommended setting for these options.) Only select 'OFF' if you do not want JIRA to automatically create these new items for you.
    • 'Create new users/versions/custom fields' — It is generally recommended that you leave this set to 'ON'. Only select 'OFF' if you do not want JIRA to automatically create new versions for Trac 'milestones' which do not already exist in JIRA.
    • ' 課題の最大数と失敗 ' - ご希望の場合は、インポーターが停止された後失敗した課題の最大数を指定します。失敗に関係なく、インポートを継続したい場合は、このフィールドを空白のままにします。Tracのインスタンスに課題が多くある場合、それは課題の限られた数で、最初のインポートツールを実行するには、一般的には良いアイデアです。(例えば、100)、その後、手動で設定ファイルが正しく指定されているかどうかを確認するために、インポートの問題を検査します。結果は満足のいくものであるときは、制限なしでインポートを実行することができます。
  9. インポーターは、インポートの進行に合わせて更新状況を示し、インポートが完了すると、正常完了したことを示すメッセージを表示します。ご希望の場合は、インポート・ログをダウンロードすることができます。

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