CSV データを Jira フィールドにマッピングする

In the new import experience, you can connect the information from the columns in your CSV to work item fields in Jira by mapping the information. This allows you to customize how the data is presented and organized in your Jira project.

新しいインポートエクスペリエンスを使用するには、組織、サイト、または 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.

Jira のグローバル権限についてご一読ください

日付と時刻をインポート

Jira に日付と時刻のデータをインポートするには、[Date time format options (日時形式のオプション)] を選択し、日付と時刻の形式を CSV ファイルに合わせて調整し、ファイルで使用される日付形式を Java SimpleDateFormat 構文で指定します。Jira では、CSV フィルに設定された言語設定と地域設定に基づいて日付と時刻を読み取ります。

列をフィールドにマッピング

When importing data into Jira using a CSV file, each row of data from the CSV file will be imported as a work item into your new business, service, or software project. In the Map project fields screen, all the column headers from the CSV file are listed.

リストされているアプリのいずれかからデータをインポートするか、インポートに設定ファイルをアップロードすると、CSV ファイルのデータの一部が自動的にマッピングされます。列が正しくマッピングされていることを再確認してください。CSV ファイルの残りの列を Jira フィールドにマッピングする必要があります。

CSV 列を Jira フィールドにマッピングするには、次の手順に従います。

マッピングする CSV 列の横にあるドロップダウンを選択して、既存のフィールドを選択するか、カスタムフィールドを作成します。
You can establish linked relationships between work items by selecting a link type under Map to a link type in the Jira fields dropdown.
列をインポートから除外する場合は、[ インポートに含める ] チェックボックスをオフにします。

注: [要約] は Jira の必須フィールドです。通常、このフィールドにはタスク名またはタスクの概要が含まれます。インポートを続行するには、必ず要約フィールドを CSV 列にマッピングしてください
マッピングされていない列は、自動的にインポートから除外されます。

Linking work items

You can link work items to show dependencies and related work in Jira. You can set link types, such as blocks, is blocked by, clones, is cloned by, duplicates, is duplicated by, and relates to while mapping data from your CSV file to fields in Jira.

To establish linked relationships between work items, select a link type under Map to a link type in the Jira fields dropdown.

To import linked relationships, make sure to map a CSV column to work item ID field n Jira. This is a required field if you want to import work item links.

Establishing work types

To import work types, you must map a column from the CSV file to work type field in the Map project fields screen. If you’d like to establish hierarchy levels, map columns to work item ID and parent fields in addition to the work type field. The work item ID and parent information helps bring in the “parent” and “child” relationships among work items. The values within the column mapped to the work type field can be mapped to specific Jira work types in the next screen (Map values to work types).

Make sure to map the right columns to work item ID, parent, and work type fields. This information will establish the structure of your project.

カスタムフィールド

Jira のカスタムフィールドを使用して、チームや組織のニーズに合った追加情報を追跡、管理できます。

Jira provides a set of standard fields that can be used for most purposes, but custom fields allow you to capture and report on data that is unique to your workflow or business processes. Custom fields can be created for various types of data, such as text, numbers, dates, and dropdown lists, and can be added to screens, work types, and projects as needed. With custom fields, you can enhance your instance's flexibility and tailor it to your team's requirements, improving data accuracy and helping you make informed decisions.

カスタムフィールド作成のヒント

インポートでのカスタムフィールドの数を制限できます。
既存のカスタムフィールドや標準 Jira フィールドの名前が重複しないようにしてください。
カスタムフィールドには、他の場所で再利用できる汎用的な名前を使用してください。例えば、「マーケティング目標」ではなく「目標」とします。

列データをカスタムフィールドにマッピング

[新しいカスタムフィールドを作成] オプションが選択された Jira フィールドのドロップダウンメニュー。

カスタムフィールドにマッピングする CSV 列の横にあるドロップダウンを選択します。
ドロップダウンで [新しいカスタムフィールドを作成] を選択してから、自分の列フィールドに最適なフィールドタイプを選択します。

新しいカスタムフィールドが作成され、CSV 列ヘッダーと同じ名前が付けられます。

複数選択カスタムフィールドへのインポート

CSV ファイルには、複数のエントリを 1 つの複数選択カスタムフィールドに含められます。例:

Summary,Multi Select,Multi Select,Multi Select
Sample work item,Value 1,Value 2,Value 3

これは、複数の値を持つ複数選択カスタムフィールドにデータを追加します。

カスケード選択カスタムフィールドへのインポート

次の構文を使用して、カスケード選択カスタムフィールドに値をインポートできます。

Summary, My Cascading Custom Field
Example Summary, Parent Value -> Child Value

"->" セパレーターを使用すると、階層をインポートできます。

区切り記号「->」がない場合は、子の値も親の値としてインポートされます。
区切り記号「->」の前に親の値がない場合は、エラーが表示されます。必ず親の値を追加して、インポートを再開してください。

Jira のシステムフィールドとカスタムフィールド

Jira で現在サポートされているシステムフィールドとカスタムフィールドのリストと、有用なヒントをご紹介します。

システムフィールド	説明
`SUMMARY`	Maps to Jira Summary field. Supports any text content.
`DESCRIPTION`	Maps to Jira Description field. Supports any text content.
`ENVIRONMENT`	Maps to Jira Environment field. Supports any text content.
`WORK_TYPE`	Maps to Jira work type field. Supports any text content (e.g., Task, Bug, Story)
`STATUS`	Maps to Jira Status field. Supports any text content (e.g., To do, In progress, Done)
`PRIORITY`	Maps to Jira Priority field. Supports any text content.
`DUE_DATE`	Maps to Jira Date field. Supports any date without the time (e.g., 11/03/2023).
`LABELS`	Maps to Jira Labels field. Supports any text content.
`COMMENT`	Maps to Jira Comment field. Supports any text content along with author and date (e.g., `date-time;author;body`).
`STATUS_CATEGORY`	Maps to Jira Status category field. Supports any string content (e.g., ToDo, IN_Progress, Done)
`CREATED`	Maps to Jira Date time field. Supports any date and time (e.g., 11/03/2023 11:53pm)
`UPDATED`	Maps to Jira Date time field. Supports any date and time. (e.g., 11/03/2023 11:53pm)
`RESOLUTION`	Maps to Jira Date time field. Supports any date without the time (e.g., 11/03/2023).
`CREATOR`	Maps to Jira User field. Supports any user Atlassian account ID.
`REPORTER`	Maps to Jira User field. Supports any user Atlassian account ID.
`ASSIGNEE`	Maps to Jira User field. Supports any user Atlassian account ID.
`WATCHES`	Maps to Jira Watches field. Supports any multi-user field format.
`WORKLOG`	Maps to Jira Worklog field. Supports these formats: `body;date-time;user;timelogged` `date-time;user;timelogged` `user;timelogged` `timelogged`
`TIME_ORIGINAL_ESTIMATE`	Jira の元の見積時間にマッピングします。秒単位の任意の整数値をサポートします。60 秒未満の値は 0 分として表されます。
`TIME_REMAINING_ESTIMATE`	Jira の残り時間見積にマッピングします。秒単位の任意の整数値をサポートします。60 秒未満の値は 0 分として表されます。
`TIME_SPENT`	Jira の経過時間にマッピングします。秒単位の任意の整数値をサポートします。60 秒未満の値は 0 分として表されます。

カスタムフィールド	説明
テキストフィールド	Jira の短いテキストフィールドタイプにマッピングします。あらゆるプレーンテキストコンテンツがサポートされています。
段落	Jira の段落フィールドタイプにマッピングします。あらゆるリッチテキストコンテンツがサポートされています。
日付	Jira の日付フィールドタイプにマッピングします。時間のないあらゆる日付がサポートされています (11/03/2023 など)。
タイムスタンプ	Jira の日時フィールドタイプにマッピングします。あらゆる日付と時刻がサポートされています (11/03/2023 11:53pm など)。
数値	Jira の番号フィールドタイプにマッピングします。あらゆる有効な番号がサポートされています (1234 など)。
ラベル	Jira のラベルフィールドタイプにマッピングします。あらゆる有効な文字列がサポートされています。ラベルが複数ある場合は、ラベルごとに列が存在する複数選択形式に従ってください。
ドロップダウン	Jira の選択フィールドタイプにマッピングします。任意の有効な文字列をサポートし、列にあるすべての一意の値に対してオプションを作成します。
複数選択	Jira の複数選択フィールドタイプにマッピングします。CSV に含まれる値ごとに列が存在する、以下の複数選択形式に従ってください。
選択リスト	Jira のカスケード選択フィールドタイプにマッピングします。`parent -> child` 形式をサポートします。
複数ユーザー選択機能	Jira の複数ユーザーフィールドタイプにマッピングします。複数ユーザーをサポートするには、CSV に含まれるユーザーごとに列が存在する、以下の複数選択形式に従ってください。値が Atlassian アカウント ID またはメールのいずれかであることを確認してください
ユーザーピッカー	Jira のユーザーフィールドタイプにマッピングします。値がメールであることを確認してください。
チェックボックス	Jira の複数チェックボックスフィールドタイプにマッピングします。フィールドの値ごとに列が存在する、以下の複数選択形式に従ってください。
URL	Jira の URL フィールドタイプにマッピングします。値が有効な URL であることを確認してください。
ラジオ	Jira のラジオボタンフィールドタイプにマッピングします。任意の有効な文字列をサポートし、列にあるすべての一意の値に対してオプションを作成します。