インポート用の CSV ファイルを準備する

コンマ区切り（CSV）ファイルは、表形式データを表すテキスト ファイルで、スプレッドシートやデータベースなどの表形式データを処理するほとんどのシステムでサポートされています。CSV ファイルの構造は、Microsoft Excel の既定の CSV 形式に基づいて作成できます。

ここでは、新しいインポート エクスペリエンスを使用してデータを移動するために、CSV ファイルを準備する際に役立つヒントをいくつか紹介します。

CSV を作成するためのヒント

ヘッダー行に要約フィールドを含める

When importing a file, the summary field is always required. It provides an overview of the work item.

The summary field is a short description of a work item that is used to provide a quick overview of what the work item is about. It is typically the first piece of information you’ll see when browsing work items. The field should be concise and descriptive and should provide enough information to understand the nature of the work item.

CSV インポーターは、CSV ファイルの見出し行を使用して、ファイルの 2 行目以降のデータを Jira のフィールドにマッピングする方法を決定します。

Assign users to work items

Use email addresses when adding people as assignees, reporters, or creators to your CSV file. This will help us map them to the project and work items created. Read about importing CSV data into Jira fields

CSV ファイルのユーザー フィールドにメール アドレスが含まれていない場合は、インポート中にメール アドレスを関連するユーザー ID に手動で追加できます。

ヘッダー行に句読点を含めない

インポートが正しく行われるよう、見出し行には句読点を含めないでください (各列を区切るコンマは除く)。

Mention users in the description or comments of a work item

To use mentions in the description or comment fields of a work item, replace the user mention in your data with the following email-based mention format: [~email:user@example.com]
Once imported, the mention will be linked to the user associated with the provided email address.

Structure data for comments within a work item

コメントが正しくインポートされるように、コメントのデータを次のように構造化してください。

データがこの形式で構造化されていない場合、コメント作成者の名前は匿名と表示されます。

特殊文字を文字どおりに扱う

テキスト部分を二重引用符 (") で囲むと、その範囲の特殊文字を文字どおりに扱うように指定できます。このデータがインポートされると、これらの特殊文字は Jira のフィールド データの一部として保存されます。特殊文字の例としては、キャリッジ リターン/改行文字、コンマなどがあります。

二重引用符を文字どおり扱うには、もう 1 つ二重引用符を追加することができます。

...これをインポートすると、次のように Jira に保存されます。

Aggregate multiple values into single fields

複数の値を許容する単一の Jira フィールドには複数の値をインポートできます (例: ウォッチャー、コンポーネント、ラベル)。これを行うには、同じフィールドにインポートされる各値について、CSV ファイルで同じ列名を指定する必要があります。指定される列名の数は、マッピングされるフィールドに集約される値の最大数と一致している必要があります。

例:

In the above example, the Label and Component fields in the first work item and the Component field of the third work item will generate multiple values in the relevant field after importing.

Include work item ID and parent columns to import hierarchies

If you’d like to import work types and parent-child relationships between work items, along with the work type column, include the work item ID and parent columns in your CSV file.

Work item ID helps identify each work item. Parent helps identify the parent relationship and is simply the work item ID of the parent work item. The IDs help establish dependencies and connect related work. Make sure that the IDs are unique to each work item to ensure that the hierarchies are imported. Here is an example CSV layout:

組織名は 200 文字以下にする

CSV ファイルを Jira Service Management プロジェクトにインポートするときは、組織名を 200 文字以下にしてください。組織名が 200 文字を超える場合は、データをインポート用にマッピングする際にエラーが表示されます。

サービス プロジェクトの報告者列を CSV ファイルに追加する

Service projects have request types attached to the work items. These request types are dependent upon the reporters column in the service project.

While importing data from your CSV file, add the reporters column to ensure a smooth import of your work items.

Assign work types to request types in service projects

While importing data from a CSV file into a service project, each work type is mapped to a request type and status.

Make sure to change the work types in the CSV file based on the request type you’d like to assign to. If the work type is TASK, SUBTASK or any other value, the request type will default to NO REQUEST TYPE. If the work type is GENERAL REQUEST, the default request type EMAILED REQUESTwill be assigned.

If there is no default status assigned, work types will be assigned IN PROGRESS status.

カスタム フィールドの扱い

ビジネス プロジェクトまたはソフトウェア プロジェクトにデータをインポートする際は、新しいカスタム フィールドを作成できます。カスタム フィールドを使用して、チームのニーズに応じた情報を追加できます。インスタンス内で以前に作成した、さまざまな既存のカスタム フィールドにデータをインポートすることもできます。