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

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

Here are a few tips to help you prepare your CSV file in order to move data using the new import experience.

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

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

ファイルをインポートする場合は、要約フィールドは常に必須です。課題の概要が含まれています。

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

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

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

CSV ファイルにユーザーを担当者、報告者、または作成者などとして追加する際は、メール アドレスをご使用ください。これは、作成されたプロジェクトや課題にそれらのユーザーをマッピングするのに役立ちます。Jira フィールドへの CSV データのインポートに関する詳細をご確認ください。

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

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

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

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

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

Structure data for comments within an issue

To ensure your comments are imported correctly, structure data in comments in this manner:

If the data isn’t structured in this format, the comment creator’s name will display as Anonymous.

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

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

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

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

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

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

例:

上記の例では、インポート後に最初の課題のラベル フィールドとコンポーネント フィールドと 3 番目の課題のコンポーネント フィールドから、対応するフィールドに複数の値が生成されます。

Keep the organization names less than or equal to 200 characters

While importing a CSV file into a Jira Service Management project, keep the names of your organization equal to or less than 200 characters. If the organization name is greater than 200 characters, you will see an error while mapping your data for import.

Add reporters column to your CSV file for a service project

Service projects have request types attached to the issues. 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 issues.

Assign issue types to request types in service projects

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

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

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

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

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