CSV ファイルを使用して Jira にデータをインポートする

With the new import experience, you can easily transfer information from other project management tools into Jira, saving time and effort. This page provides instructions on how to import data using a CSV file.

このインポート エクスペリエンスは Jira と Jira Service Management で利用できます。Jira Product Discovery にデータをインポートする場合は、古いインポート エクスペリエンスを使用してください。

Import data into a new project in Jira

You need to be an organization, site, or Jira administrator to use the new import experience.

In addition to administrators, users with permission to create team-managed projects can create and import data into team-managed business projects but won’t be able to move users. Instead, user fields in the new project will be unassigned and user tags in comments will appear as plain text.

Jira のグローバル権限についてご一読ください

To import data into a new project in Jira using a CSV file:

  1. ナビゲーション バーから、サイドバーの [プロジェクト] > [プロジェクトの作成] > [データをインポート] を選択します。

    • 設定からこのページに移動することもできます。サイドバーから 設定 (⛭) > [システム ] > [外部システム インポート ] を選択します。

  2. データのインポート元になるアプリを選択します。

    • リストにアプリが見つからない場合は、[CSV] を選択して、任意の CSV ファイルを使用してデータをインポートします。

    • If you select Asana, ClickUp, monday, or Trello, you can directly import data without a CSV file. Read about directly importing data from Asana, ClickUp, monday, or Trello into a software or business project.

CSV ファイルをアップロード

Upload the CSV file to begin the import. Make sure to prepare and structure your CSV file before uploading and select Next.

前のステップでアプリを選択した場合は、表示される指示に従ってアプリから CSV ファイルをエクスポートしてください。

[設定ファイルのアップロード] で設定ファイルをアップロードして、以前のインポートから設定を取り込むこともできます。設定ファイルとは

Set up a new project in Jira

作成する Jira プロジェクトを選択します。ビジネス プロジェクト、サービス プロジェクト、またはソフトウェア プロジェクトを選択できます。ソフトウェア プロジェクトを選択した場合は、テンプレートも選択する必要があります。利用できるテンプレートは「カンバン」と「スクラム」です。

Select Show more to change your Project type, Access, and Key. The default Access is Open, and the Key will automatically be selected for you. You can modify the Project name and Key later in the Project Settings. Once you’re done, select Next.

Map project fields

After setting up the project, you will need to map the column data to fields in Jira. Select Next once you’re done. More on how to map data

カスタム フィールド

カスタム フィールドを作成するには、一覧表示されている CSV 列の横にあるドロップダウンを選択し、[新しいカスタムフィールドの作成] を選択してからカスタム フィールド タイプを選択します。カスタム フィールドに関する詳細はこちらをご確認ください。

Enable value mapping

If you’d like to further map column values to issue types, make sure to map a column from the CSV to the issue type field. If you’d like to establish hierarchy levels, map columns to issue ID and parent fields in addition to the issue type field. Read about mapping values to issue types

Map values to issue types

If you mapped issue ID, parent, and issue type fields in the previous step, you’ll be able to map values from the selected column to issue types in Jira in this step. If you didn’t map these fields, this step will be skipped and you’ll be directly led to the Move users to Jira screen.

In this step, you will need to map the data within the column mapped to issue type field in the Map project fields screen to issue types in Jira. Select Next once you’re done.

This step is available only for software and business project imports. This screen will be skipped by default during service project imports.

Depending on your Jira Cloud plan, you can also create custom issue types by selecting “Create a new issue type” in the dropdown menu. Read about structuring issue hierarchy

If you skip this step or don’t map some values to issue types, they will be mapped to Task by default.

Move users to Jira

Move users into your new project by adding a valid email address for each user to import their information into Jira. You can also choose not to add users in this step. Select Next when you’re done.

製品管理者は、サイトから既存のユーザーのみを追加できます。新しいユーザーを追加するには、インポートを続行する前に、組織の管理者に連絡して招待します。製品管理者によってこのページに追加された新規ユーザーの情報はインポートされません。

Jira Service Management プロジェクトでは、必ずメール アドレスを追加し、ユーザー ロールを選択してください。メール アドレスやユーザー ロールが欠落しているユーザーはインポートされません。

Manual vs. auto-population of email addresses

CSV のユーザー情報を含む列にメール アドレスがある場合は、自動的に入力されます。 メール アドレスを手動で追加する場合は、データの損失を防ぎ、適切なユーザーをプロジェクトにインポートするために、各ユーザーに正しいメール情報を入力してください。

User data when users are not imported

ユーザーをインポートしないことを選択した場合、担当者や報告者などのユーザー フィールドの割り当ては解除され、コメント内のユーザー @mentionsはプレーン テキストに変換され、コメント作成者名は匿名として表示されます。

Review project details

In this step, review how your data will be imported into Jira. If you’d like to save a configuration file on your device to use for your next import, select Download a configuration file. Select Import when you’re ready to begin the import.

インポーターではバックグラウンドで自動的にデータの移動が開始されます。インポートのステータスはプロジェクト ページに表示されます。インポートが完了するとメールも届きます。

データがインポートされると、課題が Jira ではボード ビューに、Jira Service Management ではキューに表示されます。

添付ファイルをインポートする

If your CSV file contains attachment links, publically available files will be imported into your new project. Otherwise, they will be imported as web links.

Fixing import errors

When importing, the first 30 rows of your CSV file are checked based on how you map column headers to Jira fields. Errors in the first 30 rows will be displayed in the Map project fields step for you to resolve. Your import can fail if errors are present after 30 rows. If your import fails or is partially complete, you should be able to download an error log at the end of the import. Use the troubleshooting guide to fix errors and try importing your project again.

インポートで問題が発生した場合は、サポートにご連絡ください。

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。