Jira Cloud 製品のご紹介
Jira Cloud の製品、機能、プラン、および移行の詳細をご確認ください。
CSV からのデータのインポート
Data Center は、Cloud 以外で提供しているアトラシアンの主力製品です。Server バージョンの製品はサポートを終了しました。
別の課題トラッカーから移行する場合、データをカンマ区切り値 (CSV) ファイルにエクスポートし、そのファイルを Jira Cloud アプリケーションにインポートすることができます。CSV ファイルは表形式データを表すテキストファイルで、表形式データを処理するほとんどのアプリケーションでサポートされます。
多数の課題を Jira Cloud アプリにインポートする場合は、ファイルを小さなチャンクに分割し、その CSV ファイルを個別にインポートします (毎回インポートできる課題の数に明確な制限はありません。カスタム フィールドの数など、各課題の複雑さによって異なります。通常、毎回 10,000 課題をインポートできます)。
CSV ファイルを準備する
Jira にインポートする CSV ファイルを作成する場合、すべてのフィールドがカンマで区切られていることと、すべてのコンテンツ (カンマと改行を含む) が引用符で囲まれていることを確認してください。特定のファイル要件とデータ構造の詳細については、下記を参照してください。
Microsoft Excel と OpenOffice を使用する場合、セル内の値を引用符で囲む必要はありません。これらのアプリケーションでは、自動でこの処理が行われます。
CSV ファイルの要件
各 CSV ファイルには、要約列を持つ見出し行が存在する必要がある
CSV ファイルのインポート ウィザードは、CSV ファイルの見出し行を使用して、ファイルの 2 行目以降のデータを Jira のフィールドにどのようにマッピングするかを決定します。
見出し行には句読点を含まないようにします (各列を区切るコンマは除く)。これを行わない場合、インポーターが正しく機能しない可能性があります。
見出し行には要約データの列が含まれている必要があります。
列/フィールドのセパレーターとしてのコンマは省略不可
たとえば、以下は有効です。
1
2
Summary, Assignee, Reporter, Issue Type, Description, Priority
"Test issue", bob@example.com, bob@example.com, 1, ,しかし、以下は無効です。
1
2
Summary, Assignee, Reporter, Issue Type, Description, Priority
"Test issue", bob@example.com, bob@example.com, 1CSV ファイルの構造
複数行にまたがるデータを取得する
CSV ファイルで二重引用符 (") を使用して、複数行にまたがるデータを囲みます。たとえば、Jira では以下を単一レコードを持つ有効な CSV ファイルとして扱います。
1
2
3
Summary, Description, Status
"Login fails", "This is on
a new line", Open特殊文字を文字どおりに扱う
テキスト部分を二重引用符 (") で囲むと、その範囲の特殊文字を文字どおりに扱うように指定できます。このデータがインポートされると、これらの特殊文字は Jira のフィールド データの一部として保存されます。特殊文字の例としては、キャリッジ リターン/改行文字、コンマなどがあります。
二重引用符を文字どおり扱うには、もう 1 つ二重引用符を追加することができます。
1
"Clicking the ""Add"" button results in a page not found error"...これをインポートすると、次のように Jira に保存されます。
1
Clicking the "Add" button results in a page not found error 複数の値を単一のフィールドに集約する
複数の値を許可する単一の Jira フィールド (修正対象バージョン、影響バージョン、コンポーネント、ラベルなど) には複数の値をインポートできます。これを行うには、同じフィールドにインポートしたいそれぞれの値について、CSV ファイルで同じ列名を指定する必要があります。指定される列名の数は、マッピングされるフィールドに集約される値の最大数と一致している必要があります。
例:
1
2
3
4
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 を指定します。
1
2
3
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;<your email address or 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;<your email address or 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 ファイルの「課題 ID」フィールドと「親」フィールドを、Jira の対応する「課題」および「親」フィールドに一致させた場合、4 番目の課題が 2 番目の課題の子になります。同様に、「課題 ID」フィールドと「親」フィールドを一致させると、2 番目の課題が 5 番目の課題の子になります。
1
2
3
4
5
6
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 ファイル内でプロジェクト横断型の親/子関係を作成できます。
以前の CSV ファイルのインポート操作ですでにインポートされている親課題を、外部 ID を使用して参照しても、親/子関係をインポートすることはできません。
複数の Jira プロジェクトに課題をインポートする
以下を行うことで、課題を CSV ファイルから様々な Jira プロジェクトにインポートできます。
CSV ファイルに見出し "プロジェクト名" および "プロジェクト キー" の 2 つの列を追加
CSV ファイル内のすべての課題で、対応する Jira プロジェクトの名前とキーそれらの列に含める
プロジェクト名とキーのデータが、特定の Jira プロジェクトに課題を CSV からインポートするための最小限の Jira プロジェクト データとなります。
この例では、CSV ファイルの "プロジェクト名" と "プロジェクト キー" フィールドを Jira の対応するプロジェクト名およびプロジェクト キー フィールドに一致させている場合、1 番目と 2 番目の課題は "Sample" プロジェクト (プロジェクト キー "SAMP") にインポートされ、3 番目の課題は "Example" プロジェクト (プロジェクト キー "EXAM") にインポートされます。
1
2
3
4
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 ファイルには作業ログ エントリを含めることができます。例:
1
2
3
4
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 つの複数選択カスタムフィールドへの複数のエントリを含めることができます。例:
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"->" セパレーターを使用すると、 階層をインポートできます。
既存の課題の更新
既存の課題を更新するには、CSV ファイルに課題キーにマップする列が含まれている必要があります。所定のキーに対応する課題が存在する場合、その課題が更新されます。
この例では、2 行目によって課題 TT-1 が作成され、3 行目で投票数が 7 に設定されて 2 つのラベルが追加され、4 行目で課題の要約が変更されます。次の行では、2 つのラベルが付いた課題 TT-2 が作成されます。最後の行で、<<!clear!>> 特殊文字マーカーの付いたラベルが削除されます。
1
2
3
4
5
6
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] の順にクリックします。
CSV ソース ファイルを選択します。
設定ファイルがない場合や、新しく設定ファイルを作成する場合は、[既存の設定ファイルの使用] チェックボックスは選択しないでください。設定ファイルは、CSV ファイルの見出し行の列名と Jira サイトのフィールド間のマッピングを指定します。CSV インポートプロセスの最後に、次回以降の CSV インポートで使用できる設定ファイルが Jira によって作成されます。
詳細設定セクションを展開してファイルのエンコード (既定では UTF-8) および CSV 区切り記号を変更します。CSV ファイルでコンマ以外の別の区切り文字を使用する場合、CSV 区切り記号フィールドでその文字を指定します。
[次へ] をクリックします。
プロジェクトのマッピングのセットアップ
すべての課題を 1 つの (新規または既存の) Jira プロジェクトにインポートするか、複数の Jira プロジェクトにインポートするかを選択します。このステップを完了するには、以下を入力します。
Jira プロジェクトにインポート - すべての課題を 1 つの Jira プロジェクトにインポートする場合は [プロジェクトを選択] を選択できます。Jira に存在するプロジェクトの名前またはキーを入力するか、ドロップダウンから [新規作成] を選択して新しいプロジェクトを追加します。新しいプロジェクトには名前、キー、リードが必要です。
課題を複数の Jira プロジェクトにインポートする場合は [CSV で定義] を選択します。CSV ファイルのすべての課題に、プロジェクト名とキーのデータが含まれていることを確認します。新しいユーザー用のメール サフィックス - 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 値を作成することもできます。 |
課題ランク | 課題ランクは保持されないので、Jira Software プロジェクト ボードの手動によるランク付けはすべて失われます。 |
ラベル | 単独の列に各ラベルを入力することで、複数のラベルを持つ課題をインポートできます。 |
優先度 | CSV ファイルで指定されていない場合、インポートされた課題には、Jira サイトで指定されている既定 (1 番目) の優先度が設定されます。インポート処理中に新しい Jira 値を作成することもできます。 |
ソリューション | CSV ファイルで指定されていない場合、インポートされた課題には、Jira サイトで指定されている既定 (1 番目) の解決状況が設定されます。インポート処理中に新しい Jira 値を作成することもできます。 役立つヒントとして「未解決の課題の処理方法」をご参照ください。 |
ステータス | Jira の既存のワークフロー ステータスにのみマッピングできます。CSV ファイルでステータスが指定されていない場合、インポートされた課題には、Jira システムで指定されている既定 (1 番目) のステータスが設定されます。 |
初期見積 (Original Estimate) | このフィールドの値は、秒数で指定する必要があります。 |
残余見積 (Remaining Estimate) | このフィールドの値は、秒数で指定する必要があります。 |
所要時間 (Time Spent) | このフィールドの値は、秒数で指定する必要があります。 |
ユーザー | サポート対象のユーザー タイプ
ユーザーを作成 担当者または報告者フィールドの値として、インポーターに Jira ユーザーを自動で作成させることも可能です。
ユーザーの更新 Jira Service Management のポータルのみの顧客のデータの挙動は、ほかのユーザー アカウント データとは異なります。ポータルのみの顧客のデータがインポート データと宛先サイトとで異なる場合、宛先サイトのデータが使用されます。 |
ウォッチャー | ウォッチャーに指定されたユーザーが CSV ファイルに含まれているが、Jira には存在しない場合、このユーザーはインポートされません。特定の課題のウォッチャーとしてインポートする前に、ユーザーを Jira で利用可能にしておく必要があります。 |
その他のフィールド | その他のフィールドをインポートする場合は、特定の Jira カスタム フィールドへのマッピングを行うことができます。Jira にカスタム フィールドが存在しない場合、インポーターによってカスタム フィールドが自動的に作成されます。カスタム フィールドが日付フィールドの場合、CSV インポーター ウィザードの 2 番目の手順で指定した日付形式を使用してください。 |
この内容はお役に立ちましたか?