インポート用の CSV ファイルを準備する
コンマ区切り（CSV）ファイルは、表形式データを表すテキスト ファイルで、スプレッドシートやデータベースなどの表形式データを処理するほとんどのシステムでサポートされています。CSV ファイルの構造は、Microsoft Excel の既定の CSV 形式に基づいて作成できます。
ここでは、新しいインポート エクスペリエンスを使用してデータを移動するために、CSV ファイルを準備する際に役立つヒントをいくつか紹介します。
新しいインポート エクスペリエンスを使用するには、組織、サイト、または Jira 管理者である必要があります。
In addition to administrators, users with permission to create team-managed spaces can create and import data into team-managed business spaces but won’t be able to move users. Instead, user fields in the new space will be unassigned and user tags in comments will appear as plain text.
CSV を作成するためのヒント
Jira にインポート可能な 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
CSV ファイルにユーザーを担当者、報告者、または作成者などとして追加する際は、メール アドレスをご使用ください。これにより、作成されたスペースと作業項目にマッピングできます。Jira フィールドへの CSV データのインポートに関する詳細をご確認ください。
CSV ファイルのユーザー フィールドにメール アドレスが含まれていない場合は、インポート中にメール アドレスを関連するユーザー ID に手動で追加できます。
ヘッダー行に句読点を含めない
インポートが正しく行われるよう、見出し行には句読点を含めないでください (各列を区切るコンマは除く)。
作業項目の説明やコメントでユーザーにメンションする
作業項目の説明やコメントのフィールドでメンションを使用するには、データ内のユーザー メンションをメールベースのメンション形式「~email: user@example.com」に置き換えてください。
インポート後、メンションは指定のメール アドレスに関連付けられているユーザーにリンクされます。
Structure data for comments within a work item
コメントが正しくインポートされるように、コメントのデータを次のように構造化してください。
createdDate;Creator;commentBodyデータがこの形式で構造化されていない場合、コメント作成者の名前は匿名と表示されます。
特殊文字を文字どおりに扱う
テキスト部分を二重引用符 (") で囲むと、その範囲の特殊文字を文字どおりに扱うように指定できます。このデータがインポートされると、これらの特殊文字は Jira のフィールド データの一部として保存されます。特殊文字の例としては、キャリッジ リターン/改行文字、コンマなどがあります。
二重引用符を文字どおり扱うには、もう 1 つ二重引用符を追加することができます。
"Clicking the ""Add"" button results in a page not found error"...これをインポートすると、次のように Jira に保存されます。
Clicking the "Add" button results in a page not found error 複数の値を単一のフィールドに集約する
複数の値を許容する単一の Jira フィールドには複数の値をインポートできます (例: ウォッチャー、コンポーネント、ラベル)。これを行うには、同じフィールドにインポートされる各値について、CSV ファイルで同じ列名を指定する必要があります。指定される列名の数は、マッピングされるフィールドに集約される値の最大数と一致している必要があります。
例:
WorkType, Summary, Label, Label, Label, Component, Component
bug, "First work item", v1, , , Component1,
bug, "Second work item", v2, , , Component1, Component2
bug, "Third work item", v1, v2, v3, Component1,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.
作業項目 ID は各作業項目の識別に役立ちます。「親」は親子関係の識別に役立つ、親作業項目の作業項目 ID です。ID は、依存関係を確立し、関連する作業を結びつける際に役に立ちます。階層が確実にインポートされるように、ID が各作業項目に固有であることを確認してください。CSV レイアウトの例は次のとおりです。
作業タイプ | ステータス | 要約 | 作業項目 ID | 親 |
テーマ | 作業前 | 画面 1 の UI コンテンツ | 1 |
|
イニシアチブ | 作業前 | 画面 1 のレビュー | 2 | 1 |
エピック | 作業前 | テスト画面 1 | 3 | 2 |
エピック | 作業前 | 画面 2 の UI コンテンツ | 4 |
|
ストーリー | 作業前 | 画面 3 の UI コンテンツ | 5 |
|
組織名は 200 文字以下にする
CSV ファイルを Jira Service Management スペースにインポートするときは、組織名を 200 文字以下にしてください。組織名が 200 文字を超える場合は、データをインポート用にマッピングする際にエラーが表示されます。
サービス スペースの報告者列を CSV ファイルに追加する
Service spaces have request types attached to the work items. These request types are dependent upon the reporters column in the service space.
While importing data from your CSV file, add the reporters column to ensure a smooth import of your work items.
サービス スペースのリクエスト タイプに作業タイプを割り当てる
While importing data from a CSV file into a service space, 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.
既定のステータスが割り当てられていない場合、作業タイプには IN PROGRESS ステータスが割り当てられます。
カスタム フィールドの扱い
When importing data into your business or software space 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.
この内容はお役に立ちましたか?