Prepare a CSV file for import

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

When creating a CSV file that can be imported into Jira, make sure all fields are separated by commas and that any piece of content, including commas and new lines, is enclosed in quotes. Read about specific file requirements and data structure

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

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

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

要約フィールドは課題の簡単な説明で、課題がどのようなものかを手短に説明するために使用します。これは通常、課題を閲覧するときに最初に目にする情報です。フィールドは簡潔でわかりやすく、課題の本質を理解するのに十分な情報を提供する必要があります。

The CSV importer uses the file header row to determine how to map data from the file's 2nd row and beyond to fields in Jira.

If you’re importing data that includes parent and subtasks, other fields may also be required depending on the configuration of your instance. Read about creating issues and subtasks

課題にユーザーを割り当てる

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 issues created. Read about importing CSV data into Jira fields

If a CSV file doesn’t contain email addresses in user fields, you can manually add email addresses to the relevant user IDs during the import.

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

To prevent inaccuracies in your imports, avoid including any punctuation in the header row (apart from the commas separating each column).

課題の説明やコメントでユーザーにメンションする

課題の説明やコメントのフィールドでメンションを使用するには、データ内のユーザー メンションをメールベースのメンション形式「~email: user@example.com」に置き換えてください。
インポート後、メンションは指定のメール アドレスに関連付けられているユーザーにリンクされます。

CSV ファイルを構成するためのヒント

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

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

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

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

複数の値を単一の課題フィールドに集約する

You can import multiple values into a single Jira field that accepts multiple values (e.g. Watchers, Component, Labels). To do this, your CSV file must specify the same column name for each value you wish to import to the same field. The number of column names specified must match the maximum number of values to be aggregated into the mapped field.

例:

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

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

When importing data into your business or software project you can choose to create new custom fields. Custom fields allow you to add information specific to your team's needs. You can also import data to a variety of existing custom fields created previously within your instance.