インポート用の CSV ファイルを準備する
コンマ区切り（CSV）ファイルは、表形式データを表すテキスト ファイルで、スプレッドシートやデータベースなどの表形式データを処理するほとんどのシステムでサポートされています。CSV ファイルの構造は、Microsoft Excel の既定の CSV 形式に基づいて作成できます。
ここでは、新しいインポート エクスペリエンスを使用してデータを移動するために、CSV ファイルを準備する際に役立つヒントをいくつか紹介します。
新しいインポート エクスペリエンスを使用するには、組織、サイト、または Jira 管理者である必要があります。
In addition to administrators, users with permission to create team-managed projects can create and import data into team-managed business projects but won’t be able to move users. Instead, user fields in the new project 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
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 work items created. Read about importing CSV data into Jira fields
CSV ファイルのユーザー フィールドにメール アドレスが含まれていない場合は、インポート中にメール アドレスを関連するユーザー ID に手動で追加できます。
ヘッダー行に句読点を含めない
インポートが正しく行われるよう、見出し行には句読点を含めないでください (各列を区切るコンマは除く)。
Mention users in the description or comments of a work item
To use mentions in the description or comment fields of a work item, replace the user mention in your data with the following email-based mention format: [~email:user@example.com]
Once imported, the mention will be linked to the user associated with the provided email address.
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.
Work item ID helps identify each work item. Parent helps identify the parent relationship and is simply the work item ID of the parent work item. The IDs help establish dependencies and connect related work. Make sure that the IDs are unique to each work item to ensure that the hierarchies are imported. Here is an example CSV layout:
作業タイプ | ステータス | 要約 | 作業項目 ID | 親 |
テーマ | 作業前 | 画面 1 の UI コンテンツ | 1 |
|
イニシアチブ | 作業前 | 画面 1 のレビュー | 2 | 1 |
エピック | 作業前 | テスト画面 1 | 3 | 2 |
エピック | 作業前 | 画面 2 の UI コンテンツ | 4 |
|
ストーリー | 作業前 | 画面 3 の UI コンテンツ | 5 |
|
組織名は 200 文字以下にする
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 work items. 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 work items.
Assign work types to request types in service projects
While importing data from a CSV file into a service project, 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.
If there is no default status assigned, work types will be assigned IN PROGRESS status.
カスタム フィールドの扱い
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.
この内容はお役に立ちましたか?