CSV からのデータのインポート
Data Center は、Cloud 以外で提供しているアトラシアンの主力アプリです。アプリの Server バージョンのサポートは終了しました。
別のプロジェクト管理ツールから移行する場合、データをカンマ区切り値 (CSV) ファイルにエクスポートし、そのファイルを Jira Cloud アプリにインポートできます。 CSV ファイルは表形式データを表すテキスト ファイルで、表形式データを処理するほとんどのアプリでサポートされています。
推奨データ サイズ
大規模なプロジェクトをインポートする場合は、大規模な CSV ファイルのデータを小規模なバッチに分割して個別にインポートすることをお勧めします。これにより、パフォーマンスの問題が軽減され、インポート速度を最適化できます。また、オフピーク時にインポートすることで、パフォーマンスの問題を回避できます。
ファイルあたりの推奨される作業項目数 | 1500 作業項目 |
|---|---|
インポートにかかる推定時間 | 約 1 時間 (これはデータと設定のサイズと複雑さによっても異なります) |
CSV ファイルを準備する
新しい Jira インポート エクスペリエンスを試す
Asana や Notion などのサードパーティ製アプリから Jira のビジネス スペースやソフトウェア スペースにデータを移動するために、新しく高速なインポート エクスペリエンスを利用できるようになりました。新しい Jira インポート エクスペリエンスについて読む
Jira にインポートできる CSV ファイルを作成する場合は、次の点をご確認ください。
すべてのフィールドがカンマで区切られている
すべてのコンテンツ (カンマと改行を含む) は引用符で囲まれます
Microsoft Excel と OpenOffice を使用している場合、セル内の値を引用符で囲む必要はありません。これらのアプリでは、自動でこの処理が行われます。
CSV ファイルの要件
各 CSV ファイルには、要約列を持つ見出し行が存在する必要がある
CSV ファイルのインポート ウィザードは、CSV ファイルの見出し行を使用して、ファイルの 2 行目以降のデータを Jira のフィールドにどのようにマッピングするかを決定します。CSV のすべての列ヘッダーが、Jira スペースに存在するフィールド キーと一致することを確認します。
見出し行には句読点を含まないようにします (各列を区切るコンマは除く)。これを行わない場合、インポーターが正しく機能しない可能性があります。
見出し行には要約データの列が含まれている必要があります。
列/フィールドのセパレーターとしてのコンマは省略不可
たとえば、以下は有効です。
Summary, Assignee, Reporter, Work Type, Description, Priority
"Test work item", bob@example.com, bob@example.com, 1, ,しかし、以下は無効です。
Summary, Assignee, Reporter, Work Type, Description, Priority
"Test work item", bob@example.com, bob@example.com, 1CSV ファイルの構造
複数行にまたがるデータを取得する
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 ファイルで同じ列名を指定する必要があります。指定される列名の数は、マッピングされるフィールドに集約される値の最大数と一致している必要があります。
例:
WorkType, Summary, FixVersion, FixVersion, FixVersion, Component, Component
bug, "First work item", v1, , , Component1,
bug, "Second work item", v2, , , Component1, Component2
bug, "Third work item", v1, v2, v3, Component1,上記の例では、2 番目の作業項目のコンポーネント フィールドと 3 番目の作業項目の修正バージョンフィールドによって、インポート後に関連するフィールドに複数の値が生成されます。
添付ファイルをインポートする
CSV ファイルから作成された作業項目にファイルを添付できます。これを行うには、CSV ファイル内の添付ファイル列で、添付ファイルの URL を指定します。
Assignee, Summary, Description, Attachment, Comment
bob@example.com, "Work item 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 の各作業項目の [Work item ID (作業項目 ID)] 列に一意の (連続した) 番号が付けられていることを確認します
"親" 列で、作業項目の一意の "作業項目 ID" 番号を参照します
CSV では、ファイル内のサブタスクまたは子作業項目の前に親作業項目が表示される必要があります
CSV で参照されている親課題キーが同じファイル内またはスペース内に存在することも再確認してください。
詳細と必要なマッピングの例については、「 CSV インポートの親子マッピング 」を参照してください。
次の例では、CSV ファイルの "作業項目 ID" フィールドと "親" フィールドをそれぞれ Jira の対応する [作業項目] フィールドと [親] フィールドに一致させた場合、4 番目の作業項目が 2 番目の作業項目の子になります。同様に、"作業項目 ID" フィールドと "親" フィールドを一致させると、2 番目の作業項目が 5 番目の作業項目の子になります。
WorkType, Summary, FixVersion, FixVersion, FixVersion, Component, Component, Work item ID, Parent, Reporter
Bug, "First work item", v1, , , Component1, , 1, , abcde-12345-fedcba
Story, "Second work item", v2, , , Component1, Component2, 2, 5, fedcb-12345-edcba
Bug, "Third work item", v1, v2, v3, Component1, , 3, , abcde-12345-fedcba
Sub-task, "Fourth work item", v1, v2, , Component2, , , 2, fedcb-12345-edcba
Epic, "Fifth work item", v1, v2, v3, Component1, , 5, , abcde-12345-fedcba複数のスペースのデータをインポートする場合、CSV ファイル内でスペース横断型の親/子関係を作成できます。
複数の Jira スペースに作業項目をインポートする
次のようにして、CSV ファイル内の作業項目をさまざまな Jira スペースにインポートできます。
CSV ファイルに "スペース名" および "スペース キー" を見出しとする 2 つの列を追加する
CSV ファイル内のすべての作業項目について、対応する Jira スペースの該当する列に名前とキーが含まれていることを確認する
スペースの名前とキーのデータは、CSV ファイルから特定の Jira スペースに作業項目をインポートするために必要な最小限の Jira スペース データです。
この例では、CSV ファイルの " スペース 名" フィールドと " スペース キー" フィールドを Jira の対応する "スペース名 " フィールドと "スペース キー" フィールドに一致させている場合、1 番目と 2 番目の作業項目は "Sample" スペース ( スペース キーは "SAMP") にインポートされ、3 番目の作業項目は "Example" スペース ( スペース キーは "EXAM") にインポートされます:
WorkType, Summary, Space Name, Space Key
bug, "First work item", Sample, SAMP
bug, "Second work item", Sample, SAMP
task, "Third work item", 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 work item,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!>> 特殊文字マーカーの付いたラベルが削除されます。
Work item 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 ソース ファイルを選択します。
設定ファイルがない場合や、新しい設定ファイルを作成する場合は、既存の設定ファイルの使用チェックボックスは選択しないでください。設定ファイルは、CSV ファイルの見出し行の列名と JIRA サイトのフィールド間のマッピングを指定します。CSV インポートプロセスの最後に、次回からの CSV インポートで使用できる設定ファイルが JIRA によって作成されます。
詳細設定セクションを展開してファイルのエンコード (既定では UTF-8) および CSV 区切り記号を変更します。CSV ファイルでコンマ以外の別の区切り文字を使用する場合、CSV 区切り記号フィールドでその文字を指定します。
[次へ] を選択します。
スペース マッピングを設定する
すべての作業項目を 1 つ (新規または既存) の Jira スペース にインポートするか、複数の Jira スペースにインポートするかを選択します。 このステップを実施するには、以下を入力します。
Jira スペースにインポート - すべての作業項目を単一の Jira スペースにインポートする場合は、[スペースを選択] を選択できます。Jira 内にすでに存在するスペースの名前またはキーの入力を開始します。または、サイドバーからプラス アイコン () を選択して新しいスペースを作成します。新しいスペースには名前、キー、リードが必要です。
作業項目を複数の Jira スペースにインポートする場合は、[CSV で定義] を選択します。CSV ファイル内のすべての作業項目に、スペースの名前とキーのデータが含まれていることを確認してください。新しいユーザー用のメール サフィックス - CSV ファイルで指定され、インポート中に Jira に追加される新規ユーザー用のメール アドレスのドメインを入力します。
インポート ファイルの日付形式 - CSV ファイルで使用される日付形式を指定します。Java SimpleDateFormat に準拠した構文を使用します。
[次へ] を選択します。
選択したスペースに、CSV ファイル内の作業項目と同じキーを持つ同じ作業項目が含まれているかどうかを確認します。含まれていない場合、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 フィールド | インポート時の注意 |
|---|---|
スペース | CSV データはスペース単位でインポートされます。既存の Jira スペースを指定できますが、指定しなくても、インポート時にインポーターによって自動的に新規スペースが作成されます。 |
要約 | これは唯一の必須フィールドです。 |
作業項目キー | インポートされた作業項目の作業項目キーを設定できます。所定のキーを持つ作業項目が Jira にすでに存在する場合は、代わりにそのキーが更新されます。 |
Component | 個別の列に各コンポーネントを入力することで、複数のコンポーネントを持つ作業項目をインポートできます。 |
影響バージョン | 複数の "影響バージョン" 値を持つ作業項目をインポートするには、各バージョンをそれぞれ個別の列に入力します。 |
Fix Version (修正バージョン) | 複数の "修正バージョン" 値を持つ作業項目をインポートするには、各バージョンをそれぞれ個別の列に入力します。 |
コメント本文 | 個別の列に各コメントを入力することで、複数のコメントを持つ作業項目をインポートできます。 |
作成日 | CSV インポート ウィザードの 2 番目の手順で指定した日付形式を使用してください。 |
更新日 | CSV インポート ウィザードの 2 番目の手順で指定した日付形式を使用してください。 |
期限 | CSV インポート ウィザードの 2 番目の手順で指定した日付形式を使用してください。 |
作業タイプ | CSV ファイルで指定がない場合、インポートされた作業項目は、Jira サイトで指定された既定の (最初の) 作業タイプに設定されます。 |
作業項目のランク | 作業項目のランクは保持されないため、ソフトウェア スペースボードの手動によるランク付けはすべて失われます。 |
ラベル | 単独の列に各ラベルを入力することで、複数のラベルを持つ作業項目をインポートできます。 |
優先度 | CSV ファイルでステータスが指定されていない場合、インポートされた作業項目には、Jira システムで指定されている既定 (1 番目) の1 番目）優先度が設定されます。インポート処理中にオンザフライで新しい JIRA 値を作成することもできます。 |
ソリューション | CSV ファイルでステータスが指定されていない場合、インポートされた作業項目には、Jira システムで指定されている既定 (1 番目) の1 番目）の解決状況が設定されます。インポート処理中にオンザフライで新しい JIRA 値を作成することもできます。 役立つヒントについては、「未解決の作業項目の取り扱い方法」を参照してください。 |
ステータス | Jira の既存のワークフロー ステータスにのみマッピングできます。CSV ファイルでステータスが指定されていない場合、インポートされた作業項目には、Jira システムで指定されている既定 (1 番目) のステータスが設定されます。 |
初期見積 (Original Estimate) | このフィールドの値は、秒数で指定する必要があります。 |
残余見積 (Remaining Estimate) | このフィールドの値は、秒数で指定する必要があります。 |
所要時間 (Time Spent) | このフィールドの値は、秒数で指定する必要があります。 |
ユーザー | サポート対象のユーザー タイプ
ユーザーを作成 担当者または報告者フィールドの値として、インポーターに Jira ユーザーを自動で作成させることも可能です。
ユーザーの更新 Jira Service Management のポータルのみの顧客のデータの挙動は、ほかのユーザー アカウント データとは異なります。ポータルのみの顧客のデータがインポート データと宛先サイトとで異なる場合、宛先サイトのデータが使用されます。 |
ウォッチャー | ウォッチャーに指定されたユーザーが CSV ファイルに含まれているが、Jira には存在しない場合、このユーザーはインポートされません。特定の作業項目のウォッチャーとしてインポートするためには、該当するユーザーが Jira に存在していなければなりません。 |
その他のフィールド | その他のフィールドをインポートする場合は、特定の Jira カスタム フィールドへのマッピングを行うことができます。Jira にカスタム フィールドが存在しない場合、インポーターによってカスタム フィールドが自動的に作成されます。カスタム フィールドが日付フィールドの場合、CSV インポーター ウィザードの 2 番目の手順で指定した日付形式を使用してください。 |
この内容はお役に立ちましたか?