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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

課題内のコメントのデータを構造化する

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

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

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

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

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

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

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

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

例:

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

課題階層のインポートに課題 ID と親の列を含める

課題タイプと課題間の親子関係を課題タイプ列とともにインポートする場合は、課題 ID と親の列を CSV ファイルに含めます。

課題 ID は各課題の識別に役立ちます。「親」は親子関係の識別に役立つ、親課題の課題 ID です。ID は、依存関係を確立し、関連する作業を結びつけるに役に立ちます。階層が確実にインポートされるように、ID が各課題に固有であることをご確認ください。CSV レイアウトの例は次のとおりです。

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

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

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

サービス プロジェクトでは、課題にリクエスト タイプが添付されています。これらのリクエスト タイプは、サービス プロジェクトの報告者列によって異なります。

CSV ファイルからデータをインポートする際には、課題をスムーズにインポートできるように、報告者列を追加してください。

サービス プロジェクトのリクエスト タイプに課題タイプを割り当てる

CSV ファイルからサービス プロジェクトにデータをインポートする際には、各課題タイプがリクエスト タイプと課題ステータスにマッピングされます。

割り当て先となるリクエスト タイプに基づいて、CSV ファイルの課題タイプを変更してください。課題タイプが TASK、SUBTASK、またはその他の値である場合、リクエスト タイプは既定で NO REQUEST TYPE になります。課題タイプが GENERAL REQUEST である場合、既定のリクエスト タイプ EMAILED REQUEST が割り当てられます。

既定のステータスが割り当てられていない場合、課題には IN PROGRESS ステータスが割り当てられます。

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

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