CSV ファイルを準備して構成する

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

Jira Work Management にインポートできる CSV ファイルを作成する場合、すべてのフィールドがカンマで区切られていることと、すべてのコンテンツ（カンマと改行を含む）が引用符で囲まれていることを確認してください。特定のファイル要件とデータ構造の詳細

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

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

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

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

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

親とサブタスクを含むデータをインポートする場合、インスタンスの構成によっては他のフィールドも必要になることがあります。課題とサブタスクの作成の詳細

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

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

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

インポートが不正確にならないように、ヘッダー行には（各列を区切るカンマは別として）句読点を含めないでください。

ユーザーをインポートされた作業に割り当てる

ユーザーを担当者、報告者、または作成者として追加する際は、メール アドレスをご使用ください。これは、プロジェクトや、プロジェクト内で作成されたタスクに、それらのユーザーを追加するのに役立ちます。


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

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

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

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

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

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

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

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

複数の値を許可する単一の Jira フィールド (修正対象バージョン、影響バージョン、コンポーネント、ラベルなど) には複数の値をインポートできます。これを行うには、同じフィールドにインポートしたいそれぞれの値について、CSV ファイルで同じ列名を指定する必要があります。指定される列名の数は、マッピングされるフィールドに集約される値の最大数と一致している必要があります。

例:

上記の例では、2 番目の課題のコンポーネント フィールドと 3 番目の課題の修正対象バージョン フィールドはインポート後に、関連するフィールドに複数の値を生成します。

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

ビジネス プロジェクトにデータをインポートする際は、新しいカスタム フィールドを作成できます。カスタム フィールドを使用して、チームのニーズに応じた情報を追加できます。カスタム フィールドの作成の詳細

インスタンス内で以前に作成した、さまざまな既存のカスタム フィールドにデータをインポートすることもできます。