CSV からのデータのインポート

Data Center は、Cloud 以外で提供しているアトラシアンの主力製品です。Server バージョンの製品はサポートを終了しました。

別の課題トラッカーから移行する場合、データをカンマ区切り値 (CSV) ファイルにエクスポートし、そのファイルを Jira Cloud アプリケーションにインポートすることができます。CSV ファイルは表形式データを表すテキストファイルで、表形式データを処理するほとんどのアプリケーションでサポートされます。

推奨データサイズ

大規模なプロジェクトをインポートする際は、データを分割してパフォーマンスの問題を軽減し、最適なインポート速度を確保することをお勧めします。

ファイルあたりの推奨される課題数	1500 件の課題
インポートにかかる推定時間	約 1 時間 (これはデータと設定のサイズと複雑さによっても異なります)

CSV ファイルを準備する

新しい Jira インポートエクスペリエンスを試す

Asana や Notion などのサードパーティアプリから Jira のビジネスプロジェクトやソフトウェアプロジェクトにデータを移動するために、新しいスピーディーなインポートエクスペリエンスを利用できるようになりました。新しい Jira インポートエクスペリエンスについて読む

Jira にインポートできる CSV ファイルを作成する場合は、次の点をご確認ください。

すべてのフィールドがカンマで区切られている
すべてのコンテンツ (カンマと改行を含む) は引用符で囲まれます。

Microsoft Excel と OpenOffice を使用する場合、セル内の値を引用符で囲む必要はありません。これらのアプリケーションでは、自動でこの処理が行われます。

CSV ファイルの要件

各 CSV ファイルには、要約列を持つ見出し行が存在する必要がある

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

見出し行には句読点を含まないようにします (各列を区切るコンマは除く)。これを行わない場合、インポーターが正しく機能しない可能性があります。

見出し行には要約データの列が含まれている必要があります。

列/フィールドのセパレーターとしてのコンマは省略不可

たとえば、以下は有効です。

Summary, Assignee, Reporter, Issue Type, Description, Priority
"Test issue", bob@example.com, bob@example.com, 1, ,

しかし、以下は無効です。

Summary, Assignee, Reporter, Issue Type, Description, Priority
"Test issue", bob@example.com, bob@example.com, 1

CSV ファイルの構造

複数行にまたがるデータを取得する

CSV ファイルで二重引用符 (") を使用して、複数行にまたがるデータを囲みます。たとえば、Jira では以下を単一レコードを持つ有効な CSV ファイルとして扱います。

Summary, Description, Status
"Login fails", "This is on
a new line", Open

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

テキスト部分を二重引用符 (") で囲むと、その範囲の特殊文字を文字どおりに扱うように指定できます。このデータがインポートされると、これらの特殊文字は 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 ファイルで同じ列名を指定する必要があります。指定される列名の数は、マッピングされるフィールドに集約される値の最大数と一致している必要があります。

例:

IssueType, Summary, FixVersion, FixVersion, FixVersion, Component, Component
bug, "First issue", v1, , , Component1,
bug, "Second issue", v2, , , Component1, Component2
bug, "Third issue", v1, v2, v3, Component1,

上記の例では、2 番目の課題のコンポーネントフィールドと 3 番目の課題の修正対象バージョンフィールドはインポート後に、関連するフィールドに複数の値を生成します。

添付ファイルをインポートする

CSV ファイルから作成された課題には、ファイルを添付できます。これを行うには、CSV ファイル内の添付ファイル列で、添付ファイルの URL を指定します。

Assignee, Summary, Description, Attachment, Comment
bob@example.com, "Issue demonstrating the CSV attachment import", "Please check the attached image below.", "https://jira-server:8080/secure/attachment/image-name.png", "01/01/2012 10:10;<Atlassian account ID>; This comment works"
bob@example.com, "CSV attachment import with timestamp,author and filename", "Please check the attached image below.", "01/01/2012 13:10;<Atlassian account ID>;image.png;file://image-name.png", "01/01/2012 10:10;<Atlassian account ID>; This comment works"

添付ファイルの URL では HTTP と HTTPS プロトコルがサポートされ、Jira Cloud サイトがアクセス可能な場所であればどこにでも配置できます。

お使いの Atlassian アカウント ID がわからない場合は、Jira Could サイトにログインし、ページの右上隅にあるアバターをクリックして [プロファイル] に移動してください。[プロファイル] ページの URL の最後の部分がお使いの Atlassian アカウント ID です。

例: https://<yoursitename>.atlassian.net/jira/people/<Your Atlassian account ID>

親/子関係の構築

親/子関係を指定することで、インポートされた課題の階層を作成できます。

CSV ファイルに、「課題 ID」、「課題タイプ」、「親」という見出しの付いた 3 つの列を追加する
CSV の各課題の「課題 ID」列に一意の (連続した) 番号が付けられていることを確認する
「親」列で課題の一意の「課題 ID」番号を参照する
ファイル内で親課題は子課題よりも上存在している必要があります

詳細と必要なマッピングの例については、「 CSV インポートの親子マッピング」を参照してください。

次の例では、CSV ファイルの "課題 ID" フィールドと "親" フィールドを、Jira の対応する "課題 " および "親 " フィールドに一致させた場合、 4 番目の課題が 2 番目の課題の子になります。同様に、「課題 ID」フィールドと「親」フィールドを一致させると、 2 番目の課題が 5 番目の課題の子になります。

IssueType, Summary, FixVersion, FixVersion, FixVersion, Component, Component, Issue ID, Parent, Reporter
Bug, "First issue", v1, , , Component1, , 1, , abcde-12345-fedcba
Story, "Second issue", v2, , , Component1, Component2, 2, 5, fedcb-12345-edcba
Bug, "Third issue", v1, v2, v3, Component1, , 3, , abcde-12345-fedcba
Sub-task, "Fourth issue", v1, v2, , Component2, , , 2, fedcb-12345-edcba
Epic, "Fifth issue", v1, v2, v3, Component1, , 5, , abcde-12345-fedcba

複数のプロジェクトのデータをインポートする場合、CSV ファイル内でプロジェクト横断型の親/子関係を作成できます。

複数の Jira プロジェクトに課題をインポートする

以下を行うことで、課題を CSV ファイルから様々な Jira プロジェクトにインポートできます。

CSV ファイルに見出し "プロジェクト名" および "プロジェクトキー" の 2 つの列を追加
CSV ファイル内のすべての課題で、対応する Jira プロジェクトの名前とキーそれらの列に含める

プロジェクト名とキーのデータが、特定の Jira プロジェクトに課題を CSV からインポートするための最小限の Jira プロジェクトデータとなります。

この例では、CSV ファイルの "プロジェクト名" と "プロジェクトキー" フィールドを Jira の対応するプロジェクト名およびプロジェクトキーフィールドに一致させている場合、1 番目と 2 番目の課題は "Sample" プロジェクト (プロジェクトキー "SAMP") にインポートされ、3 番目の課題は "Example" プロジェクト (プロジェクトキー "EXAM") にインポートされます。

IssueType, Summary, Project Name, Project Key
bug, "First issue", Sample, SAMP
bug, "Second issue", Sample, SAMP
task, "Third issue", Example, EXAM

未解決の課題の処理方法

解決状況、優先度、課題タイプへのフィールドマッピングについては、Jira で利用可能な値を示す一覧が提供されます。緑色のプラス記号をクリックすれば、Jira に存在しない値を作成できます。

また、ステータスにマッピングするフィールドの利用可能な値のリストも表示されます。ただし、新しいステータス値を作成することはできません。

[解決状況]、[優先度]、[課題タイプ]、および [ステータス] フィールドでは、次の項目を選択できます。

空白としてインポート－これによって、そのフィールドの Jira の値は空白になります。未解決の課題をインポートする場合、解決状況フィールドをマッピングするフィールドを作成し、値を "未解決" から "空白としてインポート" に変更する必要があります。
マッピングなし－これは CSV ファイルの値をそのままインポートしようとするものです。対象の値をサポートしていない Jira フィールドにフィールド値をマッピングするとインポートが失敗するので注意してください。ステータスと課題タイプへのフィールドマッピングについては、 "空白としてインポート" を選択した場合、既定値が使用されます。

作業ログエントリのインポート

CSV ファイルには作業ログエントリを含めることができます。例:

Summary,Worklog
Only time spent (one hour),3600
With a date and an author,2012-02-10 12:30:10;wseliga;120
With an additional comment,Testing took me 3 days;2012-02-10 12:30:10;wseliga;259200

消費時間の追跡には秒を使用する必要があることに注意してください。

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

CSV ファイルには、1 つの複数選択カスタムフィールドへの複数のエントリを含めることができます。例:

Summary,Multi Select,Multi Select,Multi Select
Sample issue,Value 1,Value 2,Value 3

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

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

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

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

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

既存の課題の更新

既存の課題を更新するには、CSV ファイルに課題キーにマップする列が含まれている必要があります。所定のキーに対応する課題が存在する場合、その課題が更新されます。

この例では、2 行目によって課題 TT-1 が作成され、3 行目で投票数が 7 に設定されて 2 つのラベルが追加され、4 行目で課題の要約が変更されます。次の行では、2 つのラベルが付いた課題 TT-2 が作成されます。最後の行で、<<!clear!>> 特殊文字マーカーの付いたラベルが削除されます。

issue key,summary,votes,labels,labels
TT-1,Original summary,1,label1,label2
TT-1,,7,label-1,label-2
TT-1,Changed summary,,,
TT-2,Original summary 2,1,label-1,label-2
TT-2,,<<!clear!>>,<<!clear!>>,

CSV ファイルのインポート

CSV ファイルの準備ができたら、Jira 管理者として Jira Cloud サイトにログインし、インポートプロセスを開始します。

ファイルのアップロード

> [システム] の順に選択します。
[インポートとエクスポート] セクションで、[外部システムのインポート] > [CSV] の順にクリックします。
1. 新しいインポートエクスペリエンスが表示される場合は [ 旧エクスペリエンスに切り替える] を選択して、CSV ファイルインポートウィザードに進みます。
CSV ソースファイルを選択します。
設定ファイルがない場合や、新しく設定ファイルを作成する場合は、[既存の設定ファイルの使用] チェックボックスは選択しないでください。設定ファイルは、CSV ファイルの見出し行の列名と Jira サイトのフィールド間のマッピングを指定します。CSV インポートプロセスの最後に、次回以降の CSV インポートで使用できる設定ファイルが Jira によって作成されます。
詳細設定セクションを展開してファイルのエンコード (既定では UTF-8) および CSV 区切り記号を変更します。CSV ファイルでコンマ以外の別の区切り文字を使用する場合、CSV 区切り記号フィールドでその文字を指定します。
[次へ] をクリックします。

プロジェクトのマッピングのセットアップ

すべての課題を 1 つの (新規または既存の) Jira プロジェクトにインポートするか、複数の Jira プロジェクトにインポートするかを選択します。このステップを完了するには、以下を入力します。
1. Jira プロジェクトにインポート - すべての課題を 1 つの Jira プロジェクトにインポートする場合は [プロジェクトを選択] を選択できます。Jira に存在するプロジェクトの名前またはキーを入力するか、ドロップダウンから [新規作成] を選択して新しいプロジェクトを追加します。新しいプロジェクトには名前、キー、リードが必要です。
  
  課題を複数の Jira プロジェクトにインポートする場合は [CSV で定義] を選択します。CSV ファイルのすべての課題に、プロジェクト名とキーのデータが含まれていることを確認します。
2. 新しいユーザー用のメールサフィックス - CSV ファイルで指定され、インポート中に Jira に追加される新規ユーザー用のメールアドレスのドメインを入力します。
  - インポートファイルの日付形式 - CSV ファイルで使用される日付形式を指定します。Java SimpleDateFormat に準拠した構文を使用します。
[次へ] をクリックします。

課題のインポート先として選択したプロジェクトが課題キーに対応しているかどうかを確認します。対応していない場合、Jira は選択したプロジェクトに課題をインポートし、新しい課題キーを与えます。

フィールドのマッピングのセットアップ

[インポート] 列で、選択した Jira プロジェクトにインポートする各 CSV フィールド (CSV ファイルの見出し行によって決定) にチェックを入れます。選択したフィールドのうち 1 つ以上に [要約] フィールドのデータが含まれている必要があります。CSV ファイルで見出し行に同じフィールド名が複数含まれている場合、CSV インポートプロセスではこれらを 1 つのフィールドに結合してでマークします。
CSV ファイルで定義したフィールド (前のステップで選択した各 CSVフィールド) に一致させたい Jira フィールドを、[Jira フィールド] 列から選択します。次の手順に進むには、サマリーフィールドを選択する必要があります。インポートプロセスで集約された CSV フィールドに対しては、複数の値をサポートする Jira フィールドのみ選択できます。
CSV ファイルのフィールドの値を Jira にインポートされる前に変更する場合、該当のフィールドの横にある [フィールドの値のマッピング] チェックボックスを選択します。
[次へ] をクリックします。

CSV ファイルがコメント付きの Jira Service Management プロジェクトで構成されていて [Jira フィールド] 列の [コメント本文] にマッピングされている場合は、CSV のインポート後にインポートファイルのすべてのコメントが公開されます。

CSV フィールドと Jira フィールドのマッチングに関する詳細については、以下の「CSV データを Jira フィールドにインポートするためのヒント」をご参照ください。

フィールド値のマッピングのセットアップ

企業管理対象の課題タイプをチーム管理対象の課題タイプにマッピングすることはできません。不完全または不適切なマッピングを防ぐため、データをチーム管理対象プロジェクトにインポートする際に新しい課題タイプを作成したり、課題タイプをそのままマッピングしたりする機能は削除されました。課題タイプはすでに存在する課題タイプにマッピングする必要があります。

前のステップで選択した各 CSV ファイルフィールド値に Jira フィールド値を指定します。値をそのままインポートする場合は空欄のままにしておきます。
新しい優先度または解決状況の値を Jira に作成するには、該当するフィールドの横にある [Add new... (新規追加)] をクリックします。
CSV データを Jira にインポートする準備ができたら、[インポート開始] をクリックします。
インポート中、詳細なログをダウンロードして処理の詳細な情報を表示することができます。また、同様の設定で別の CSV ファイルをインポートする必要がある場合は、このインポートの設定を保存することができます。

ご質問がある場合や、問題が発生した場合は、アトラシアンサポートにお問い合わせください。

CSV データを Jira フィールドにインポートするためのヒント

データを CSV ファイルから特定の Jira フィールドにインポートする場合に役立つヒントを以下に示します。

Jira フィールド	インポート時の注意
Project	CSV データはプロジェクト単位でインポートされます。既存の Jira プロジェクトを指定できます。指定しない場合、インポート時にインポーターが自動的に新規プロジェクトを作成します。
要約	これは唯一の必須フィールドです。
課題キー	インポートされた課題の課題キーを設定できます。対象のキーの課題がすでに存在する場合、その課題が更新されます。
Component	単独の列に各コンポーネントを入力することで、複数のコンポーネントを持つ課題をインポートできます。
影響バージョン	単独の列に各バージョンを入力することで、複数の "影響バージョン" 値を持つ課題をインポートできます。
Fix Version (修正バージョン)	単独の列に各バージョンを入力することで、複数の "修正バージョン" を持つ課題をインポートできます。
コメント本文	単独の列に各コメントを入力することで、複数のコメントを持つ課題をインポートできます。
作成日	CSV インポートウィザードの 2 番目の手順で指定した日付形式を使用してください。
更新日	CSV インポートウィザードの 2 番目の手順で指定した日付形式を使用してください。
期限	CSV インポートウィザードの 2 番目の手順で指定した日付形式を使用してください。
課題タイプ	CSV ファイルで指定されていない場合、インポートされた課題には、JIRA サイトで指定されているように、既定の（すなわち、1番目）課題タイプが設定されます。インポート処理中にオンザフライで新しい JIRA 値を作成することもできます。
課題ランク	課題ランクは保持されないので、ソフトウェアプロジェクトボードの手動によるランク付けはすべて失われます。
ラベル	単独の列に各ラベルを入力することで、複数のラベルを持つ課題をインポートできます。
優先度	CSV ファイルで指定されていない場合、インポートされた課題には、Jira サイトで指定されている既定 (1 番目) の優先度が設定されます。インポート処理中に新しい Jira 値を作成することもできます。
ソリューション	CSV ファイルで指定されていない場合、インポートされた課題には、Jira サイトで指定されている既定 (1 番目) の解決状況が設定されます。インポート処理中に新しい Jira 値を作成することもできます。役立つヒントとして「未解決の課題の処理方法」をご参照ください。
ステータス	Jira の既存のワークフローステータスにのみマッピングできます。CSV ファイルでステータスが指定されていない場合、インポートされた課題には、Jira システムで指定されている既定 (1 番目) のステータスが設定されます。
初期見積 (Original Estimate)	このフィールドの値は、秒数で指定する必要があります。
残余見積 (Remaining Estimate)	このフィールドの値は、秒数で指定する必要があります。
所要時間 (Time Spent)	このフィールドの値は、秒数で指定する必要があります。
ユーザー	サポート対象のユーザータイプメールアドレス Atlassian アカウント ID ユーザーを作成担当者または報告者フィールドの値として、インポーターに Jira ユーザーを自動で作成させることも可能です。ユーザーは、Jira のアクティブなアカウントとして作成されます。ユーザーは Jira への初回のログイン時にパスワードをメールで通知してもらう必要があります。実名でないユーザーは、メールアドレス (ログイン名) の "@" 文字の前の部分を Jira でのフルネームとして取得します。外部のユーザー管理機能を使用している場合、インポートのプロセスで Jira ユーザーを作成することはできません。代わりに、作成が必要な新規ユーザーの一覧がインポーターによって提供されます。インポートを開始する前に外部のユーザーリポジトリでユーザーを作成する必要があります。ユーザー数制限付きライセンス（例: パーソナルライセンス）で、必要なユーザー数が制限数を超える場合、インポートは停止されます。作成できないユーザーのリストを示すページが表示されます。担当者および報告者がマッピングされない場合、ユーザーは作成されません。ユーザーの更新 Jira Service Management のポータルのみの顧客のデータの挙動は、ほかのユーザーアカウントデータとは異なります。ポータルのみの顧客のデータがインポートデータと宛先サイトとで異なる場合、宛先サイトのデータが使用されます。
ウォッチャー	ウォッチャーに指定されたユーザーが CSV ファイルに含まれているが、Jira には存在しない場合、このユーザーはインポートされません。特定の課題のウォッチャーとしてインポートする前に、ユーザーを Jira で利用可能にしておく必要があります。
その他のフィールド	その他のフィールドをインポートする場合は、特定の Jira カスタムフィールドへのマッピングを行うことができます。Jira にカスタムフィールドが存在しない場合、インポーターによってカスタムフィールドが自動的に作成されます。カスタムフィールドが日付フィールドの場合、CSV インポーターウィザードの 2 番目の手順で指定した日付形式を使用してください。

この内容はお役に立ちましたか?

正確ではなかった

明確ではなかった

関係なかった

さらにヘルプが必要ですか?

アトラシアンコミュニティをご利用ください。

コミュニティに質問