Map CSV data to Jira fields
In the new import experience, you can connect the information from the columns in your CSV to issue fields in Jira by mapping the information. This allows you to customize how the data is presented and organized in your Jira project.
You need to be an organization, site, or Jira administrator to use the new import experience.
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 に日付と時刻のデータをインポートするには、[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 an issue 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 列の横にあるドロップダウンを選択して、既存のフィールドを選択するか、カスタム フィールドを作成します。
[Jira フィールド] ドロップダウンの [リンク タイプにマッピング] でリンク タイプを選択することで、課題間のリンク関係を確立できます。
列をインポートから除外する場合は、[ インポートに含める ] チェックボックスをオフにします。
注: [要約] は Jira の必須フィールドです。通常、このフィールドにはタスク名またはタスクの概要が含まれます。インポートを続行するには、必ず要約フィールドを CSV 列にマッピングしてください
マッピングされていない列は、自動的にインポートから除外されます。
課題をリンクする
課題をリンクして、依存関係や関連作業を Jira に表示できます。CSV ファイルのデータを Jira のフィールドにマッピングする際に、blocks、is blocked by、clones、is cloned、duplicates、is duplicated by、relates などのリンク タイプを設定できます。
課題間のリンクされた関係を確立するには、[Jira フィールド] ドロップダウンの [リンク タイプにマッピング] でリンク タイプを選択します。
リンクされた関係をインポートするには、必ず CSV 列を Jira の課題 ID フィールドにマッピングします。課題リンクをインポートする場合、これは必須フィールドです。
Establishing issue types
To import issue types, you must map a column from the CSV file to issue type field in the Map project fields screen. If you’d like to establish hierarchy levels, map columns to issue ID and parent fields in addition to the issue type field. The issue ID and parent information helps bring in the “parent” and “child” relationships among issues. The values within the column mapped to the issue type field can be mapped to specific Jira issue types in the next screen (Map values to issue types).
Make sure to map the right columns to issue ID, parent, and issue type fields. This information will establish the structure of your project.
カスタム フィールド
Jira のカスタム フィールドを使用して、チームや組織のニーズに合った追加情報を追跡、管理できます。
Jira には、ほとんどの目的に使用できる一連の標準フィールドが用意されていますが、カスタム フィールドを使用すると、ワークフローやビジネス プロセスに固有のデータを取得してレポートすることができます。カスタム フィールドは、テキスト、数値、日付、ドロップダウン リストなど、さまざまな種類のデータ用に作成でき、必要に応じて画面、課題タイプ、プロジェクトに追加できます。カスタム フィールドを使用すると、インスタンスの柔軟性が高まり、チームの要件に合わせて調整できるため、データの精度が向上し、情報に基づいた意思決定を行えるようになります。
カスタム フィールド作成のヒント
インポートでのカスタム フィールドの数を制限できます。
既存のカスタム フィールドや標準 Jira フィールドの名前が重複しないようにしてください。
カスタム フィールドには、他の場所で再利用できる汎用的な名前を使用してください。例えば、「マーケティング目標」ではなく「目標」とします。
列データをカスタム フィールドにマッピング
カスタム フィールドにマッピングする CSV 列の横にあるドロップダウンを選択します。
ドロップダウンで [新しいカスタム フィールドを作成] を選択してから、自分の列フィールドに最適なフィールド タイプを選択します。
新しいカスタム フィールドが作成され、CSV 列ヘッダーと同じ名前が付けられます。
複数選択カスタム フィールドへのインポート
CSV ファイルには、複数のエントリを 1 つの複数選択カスタム フィールドに含められます。例:
1
2
Summary,Multi Select,Multi Select,Multi Select
Sample issue,Value 1,Value 2,Value 3
これは、複数の値を持つ複数選択カスタム フィールドにデータを追加します。
カスケード選択カスタム フィールドへのインポート
次の構文を使用して、カスケード選択カスタム フィールドに値をインポートできます。
1
2
Summary, My Cascading Custom Field
Example Summary, Parent Value -> Child Value
"->" セパレーターを使用すると、 階層をインポートできます。
区切り記号「->」がない場合は、子の値も親の値としてインポートされます。
区切り記号「->」の前に親の値がない場合は、エラーが表示されます。必ず親の値を追加して、インポートを再開してください。
Jira のシステム フィールドとカスタム フィールド
Jira で現在サポートされているシステム フィールドとカスタム フィールドのリストと、有用なヒントをご紹介します。
システム フィールド | 説明 |
---|---|
SUMMARY | Jira の要約フィールド タイプにマッピングします。あらゆるテキスト コンテンツをサポートします。 |
DESCRIPTION | Jira の説明フィールド タイプにマッピングします。あらゆるテキスト コンテンツをサポートします。 |
ENVIRONMENT | Jira の環境フィールド タイプにマッピングします。あらゆるテキスト コンテンツをサポートします。 |
ISSUE_TYPE | Jira の課題タイプ フィールド タイプにマッピングします。あらゆるテキストコンテンツがサポートされています (タスク、バグ、ストーリーなど)。 |
STATUS | Jira のステータス フィールド タイプにマッピングします。あらゆるテキスト コンテンツがサポートされています (作業前、進行中、完了など)。 |
PRIORITY | Jira の優先度フィールド タイプにマッピングします。あらゆるテキスト コンテンツをサポートします。 |
DUE_DATE | Jira の日付フィールド タイプにマッピングします。時間のないあらゆる日付がサポートされています (11/03/2023 など)。 |
LABELS | Jira のラベル フィールド タイプにマッピングします。あらゆるテキスト コンテンツをサポートします。 |
COMMENT | Jira のコメント フィールド タイプにマッピングします。作成者や日付とともに、あらゆるテキスト コンテンツがサポートされています (date-time;author;body など)。 |
STATUS_CATEGORY | Jira のステータス カテゴリ フィールド タイプにマッピングします。あらゆる文字列コンテンツがサポートされています (ToDo、IN_Progress、Done など)。 |
CREATED | Jira の日時フィールド タイプにマッピングします。あらゆる日付と時刻がサポートされています (11/03/2023 11:53pm など)。 |
UPDATED | Jira の日時フィールド タイプにマッピングします。あらゆる日付と時刻がサポートされています (11/03/2023 11:53pm など)。 |
RESOLUTION | Jira の日時フィールド タイプにマッピングします。時間のないあらゆる日付がサポートされています (11/03/2023 など)。 |
CREATOR | Jira のユーザー フィールド タイプにマッピングします。あらゆるユーザーの Atlassian アカウント ID がサポートされています。 |
REPORTER | Jira のユーザー フィールド タイプにマッピングします。あらゆるユーザーの Atlassian アカウント ID がサポートされています。 |
ASSIGNEE | Jira のユーザー フィールド タイプにマッピングします。あらゆるユーザーの Atlassian アカウント ID がサポートされています。 |
WATCHES | Jira のウォッチ フィールド タイプにマッピングします。あらゆる複数ユーザー フィールド形式がサポートされています。 |
WORKLOG | Jira の Worklog フィールド タイプにマッピングします。次の形式がサポートされています。
|
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 のラジオ ボタン フィールド タイプにマッピングします。任意の有効な文字列をサポートし、列にあるすべての一意の値に対してオプションを作成します。 |
Jira フィールドへの Airtable フィールドのマッピング
Airtable フィールドと Jira フィールドの対応関係は次のとおりです。
ここに記載されているフィールドは、インポート中に自動的にマッピングされます。ここに記載されていないフィールドをインポートする場合は、手動でマッピングして Jira プロジェクトに追加してください。
Airtable フィールド | Jira フィールド |
---|---|
名前 | 要約 |
ステータス | ステータス |
優先度 | 優先度 |
開始日 | 開始日 |
担当者 | 担当者 |
URL | URL (Jira カスタム フィールド - URL) |
Jira フィールドへの Azure DevOps フィールドのマッピング
Azure DevOps フィールドと Jira フィールドの対応関係は次のとおりです。
ここに記載されているフィールドは、インポート中に自動的にマッピングされます。ここに記載されていないフィールドをインポートする場合は、手動でマッピングして Jira プロジェクトに追加してください。
Azure DevOps フィールド | Jira フィールド |
---|---|
Work item type | 課題タイプ |
タイトル | 要約 |
担当者 | 担当者 |
状態 | ステータス |
Tags | ラベル |
Jira フィールドへの GitHub フィールドのマッピング
GitHub フィールドと Jira フィールドの対応関係は次のとおりです。
ここに記載されているフィールドは、インポート中に自動的にマッピングされます。ここに記載されていないフィールドをインポートする場合は、手動でマッピングして Jira プロジェクトに追加してください。
GitHub フィールド | Jira フィールド |
---|---|
タイトル | 要約 |
担当者 | 担当者 |
ステータス | ステータス |
優先度 | 優先度 |
見積り | ソフトウェア プロジェクトのストーリー ポイントの見積 見積 (ビジネス プロジェクトの Jira カスタム フィールド - 数値) |
サイズ | サイズ (Jira のカスタム テキスト フィールド) |
ラベル | ラベル |
reviewers | ウォッチャー |
開始日 | 開始日 |
終了日 | 期限 |
Jira フィールドへの GitLab フィールドのマッピング
GitLab フィールドと Jira フィールドの対応関係は次のとおりです。
ここに記載されているフィールドは、インポート中に自動的にマッピングされます。ここに記載されていないフィールドをインポートする場合は、手動でマッピングして Jira プロジェクトに追加してください。
GitLab フィールド | Jira フィールド |
---|---|
タイトル | 要約 |
説明 | 説明 |
URL | URL (Jira カスタム フィールド - URL) |
状態 | ステータス |
Author username | 報告者 |
Assignee username | 担当者 |
期限 | 期限 |
作成時刻 | created |
作成日時 | 更新日 |
重み | ソフトウェア プロジェクトのストーリー ポイントの見積 重み (ビジネス プロジェクトの Jira カスタム フィールド - 数値) |
ラベル | ラベル |
timeestimate | 初期見積 |
消費時間 | 消費時間 |
Jira フィールドへの Linear フィールドのマッピング
Linear フィールドと Jira フィールドの対応関係は次のとおりです。
ここに記載されているフィールドは、インポート中に自動的にマッピングされます。ここに記載されていないフィールドをインポートする場合は、手動でマッピングして Jira プロジェクトに追加してください。
Linear フィールド | Jira フィールド |
---|---|
タイトル | 要約 |
説明 | 説明 |
ステータス | ステータス |
優先度 | 優先度 |
作成者 | 報告者 |
担当者 | 担当者 |
ラベル | ラベル |
created | created |
更新日 | 更新日 |
開始 | 開始日 |
期限 | 期限 |
完了 | 解決済 |
Notion のフィールドを Jira のフィールドにマッピングする
Notion のフィールドを Jira のフィールドにマッピングする方法は次のとおりです。
ここに記載されているフィールドは、インポート中に自動的にマッピングされます。ここに記載されていないフィールドをインポートする場合は、手動でマッピングして Jira プロジェクトに追加してください。
Notion フィールド | Jira フィールド |
---|---|
タスク名 | 要約 |
注意 | 説明 |
状態 | ステータス |
優先度 | 優先度 |
担当者 | 担当者 |
開始日 | 開始日 |
期限 | 期限 |
Progress | 進捗 (Jira カスタム フィールド - テキスト) |
終了日 | 解決済 |
カテゴリー | ビジネス プロジェクトのカテゴリ カテゴリ (ソフトウェア プロジェクトの Jira カスタム フィールド - 単一選択) |
Tags | ラベル |
Smartsheet フィールドを Jira フィールドにマッピングする
Smartsheet フィールドを Jira フィールドにマッピングする方法は次のとおりです。
ここに記載されているフィールドは、インポート中に自動的にマッピングされます。ここに記載されていないフィールドをインポートする場合は、手動でマッピングして Jira プロジェクトに追加してください。
Smartsheet フィールド | Jira フィールド |
---|---|
Name/Task name/Story (名前/タスク名/ストーリー) | 要約 |
Description/Notes (説明/メモ) | 説明 |
タイプ | 課題タイプ |
ステータス | ステータス |
優先度 | 優先度 |
createdDate | created |
最終変更日 | 更新日 |
担当者 | 担当者 |
開始日 | 開始日 |
終了日 | 期限 |
At risk (リスクあり) | リスクあり (Jira カスタム フィールド - 単一選択) |
作成元 | 報告者 |
Approved by (承認者) | 承認者 (Jira カスタム フィールド - ユーザー ピッカー) |
Modified by (変更者) | 変更者 (Jira カスタム フィールド - ユーザー ピッカー) |
部署 | 部署 (Jira カスタム フィールド - 単一選択) |
カテゴリー | ビジネス プロジェクトのカテゴリ カテゴリ (ソフトウェア プロジェクトの Jira カスタム フィールド - 単一選択) |
Approval status (承認状況) | 承認ステータス (Jira カスタム フィールド - 単一選択) |
予算 | 予算 (Jira カスタム フィールド - テキスト) |
Variance/Actual variance (差異/実際差異) | 差異/実際差異 (Jira カスタム フィールド - テキスト) |
% Allocation (割当率) | 割り当て率 (Jira カスタム フィールド - 数値) |
% Completion/% Complete (完了率/完了済み率) | 完了率/完了済み率 (Jira カスタム フィールド - 数値) |
Duration (期間) | 期間 (Jira カスタム フィールド - テキスト) |
Predecessors (先行項目) | 先行項目 (Jira カスタム フィールド - テキスト) |
Target start date (目標開始日) | 目標開始日 (Jira カスタム フィールド - 日付) |
Target end date (ターゲット終了日) | 目標終了日 (Jira カスタム フィールド - 日付) |
Schedule delta (スケジュール差分) | スケジュール差分 (Jira カスタム フィールド - 数値) |
Actuals (実績) | 実績 (Jira カスタム フィールド - テキスト) |
マネージャー | マネージャー (Jira カスタム フィールド - ユーザー ピッカー) |
アクティブ | アクティブ (Jira カスタム フィールド - 単一選択) |
Days of work (作業日数) | 作業日数 (Jira カスタム フィールド - 数値) |
Sprint | スプリント (ビジネス プロジェクトの Jira カスタム フィールド - 単一選択) ソフトウェア プロジェクトでのスプリント |
ストーリー ポイント | ストーリー ポイント (ビジネス プロジェクトの Jira カスタム フィールド - 数値) ソフトウェア プロジェクトのストーリー ポイント |
Points capacity (ポイント キャパシティ) | ポイント キャパシティ (Jira カスタム フィールド - 数値) |
Points availability (ポイントの有無) | ポイントの有無 (Jira カスタム フィールド - 数値) |
コメント | コメント |
Jira フィールドへの Wrike フィールドのマッピング
Wrike フィールドと Jira フィールドの対応関係は次のとおりです。
ここに記載されているフィールドは、インポート中に自動的にマッピングされます。ここに記載されていないフィールドをインポートする場合は、手動でマッピングして Jira プロジェクトに追加してください。
Wrike フィールド | Jira フィールド |
---|---|
タイトル | 要約 |
説明 | 説明 |
ステータス | ステータス |
優先度 | 優先度 |
担当者 | 担当者 |
開始日 | 開始日 |
終了日 | 期限 |
予算 | 予算 (Jira カスタム フィールド - テキスト) |
影響 | 影響 (Jira カスタム フィールド - 単一選択) |
YouTrack フィールドを Jira フィールドにマッピングする
YouTrack フィールドと Jira フィールドの対応関係は次のとおりです。
ここに記載されているフィールドは、インポート中に自動的にマッピングされます。ここに記載されていないフィールドをインポートする場合は、手動でマッピングして Jira プロジェクトに追加してください。
YouTrack フィールド | Jira フィールド |
---|---|
要約 | 要約 |
説明 | 説明 |
課題タイプ | 課題タイプ |
状態 | ステータス |
優先度 | 優先度 |
担当者 | 担当者 |
報告者 | 報告者 |
Tags | ラベル |
created | created |
更新日 | 更新日 |
解決済 | 解決済 |
文字数制限
Jira ではフィールドごとに文字数制限があります。制限を超えるデータはすべてトリミングされ、インポートから除外されます。データをインポートする際にこの文字数制限に注意することで、プロジェクト内で情報を正確かつ完全に表すことができます。
次に示すのは、各フィールド タイプの文字数です。
Jira フィールド | 文字数制限 |
---|---|
要約 | 255 |
説明、環境 | 3万 |
課題タイプ | 60 |
課題のステータス | 60 |
優先度 | 60 |
ソリューション | 60 |
ラベル | 255 |
テキスト フィールド | 255 |
Textarea | 3万 |
カスタム フィールド | 255 |
この内容はお役に立ちましたか?