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

お困りですか?

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

コミュニティに質問

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

CSV ファイルを準備する

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 ファイル構造

複数行にまたがるデータをキャプチャーする

Use double-quote marks (") in your CSV file to capture data that spans multiple lines. For example, Jira will treat the following as a valid CSV file with a single record:

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;Admin; 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;Admin;image.png;file://image-name.png", "01/01/2012 10:10;Admin; This comment works"

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

サブタスクの作成

以下を行うことで、課題のサブタスクを作成することができます。

  • CSV ファイルに見出し「課題 ID」および「親 ID」の2列を追加
  • 通常の各課題(非サブタスク課題)の課題 ID 列に固有の(通し)番号が付けられていることを確認します。通常の課題の 「親 ID」 フィールドに値を含めないでください。
  • 通常の課題に設定された固有の 「課題 ID」 番号を、サブタスクの 「親 ID」 列で参照します。サブタスクの 「課題 ID」 フィールドに値を設定しないでください。

この例では、CSV ファイルの「課題 ID」フィールドと「親 ID」フィールドを、Jira の対応する課題 ID および親 ID フィールドに一致させた場合、4 番目の課題は 2 番目の課題のサブタスクになります。

IssueType, Summary, FixVersion, FixVersion, FixVersion, Component, Component, Issue ID, Parent ID, Reporter
Bug, "First issue", v1, , , Component1, , 1, , abcde-12345-fedcba
Bug, "Second issue", v2, , , Component1, Component2, 2, , 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

複数の 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 で指定されていないと、列はリセットされ、既定値に設定されます


CSV ファイルのインポート

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

ファイルのアップロード

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

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

  1. すべての課題を1つ(新しいまたは既存)の Jira プロジェクトにインポートするか、複数の Jira プロジェクトにインポートするかを選択します。このステップを実施するには、以下を入力します。

    1. Import to Jira Project - You can choose Select a project if importing all issues into a single Jira project. Start typing the name or key of a project that already exists in Jira, or select Create New from the dropdown to add a new project. Note that new projects require a name, key, and lead.'

      If you want to import issues into multiple Jira projects, choose Defined in CSV. Make sure that every issue in your CSV file includes project name and key data.

    2. Email Suffix for New Users - Enter the email address domain for any new users specified in the CSV file who will be added to Jira during the import.

    3. Date format in import file - Specify the date format used in your CSV file using syntax that complies with the Java SimpleDateFormat.
  2. 次へ をクリックします。

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

  1. [インポート] 列で、選択した Jira プロジェクトにインポートしたい、CSV ファイルの見出し行で定義された各 CSV フィールドを確認します。選択したフィールドの 1 つ以上にサマリー フィールドを含める必要があることに注意してください。CSV ファイルで見出し行に同じフィールド名が複数含まれている場合、CSV インポート プロセスでは、これらを 1 つのフィールドに結合し、(warning) でマークします。

  2. CSV ファイルで定義したフィールド (前のステップで選択した各 CSVフィールド) に一致させたい Jira フィールドを、[Jira フィールド] 列から選択します。次の手順に進むには、サマリー フィールドを選択する必要があります。インポート プロセスで集約された CSV フィールドに対しては、複数の値をサポートする Jira フィールドのみ選択できます。 

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

  3. To modify the values of any field in the CSV file before importing into Jira, select the Map field value checkboxes next to the appropriate fields. 

  4. 次へ をクリックします。

フィールド値のマッピングを設定する

  1. 前のステップで選択した各 CSV ファイル フィールド値に Jira フィールド値を指定します。値をそのままインポートする場合は空欄のままにしておきます。 

  2. 新しい優先度、解決状況、または課題タイプ値を Jira に作成するには、該当するフィールドの隣りにある新規追加をクリックします。 

  3. CSV データを Jira にインポートする準備ができたら、[インポート開始] をクリックします。 

  4. インポート中、詳細なログをダウンロードして処理の詳細な情報を表示することができます。また、同様の設定で別の CSV ファイルをインポートする必要がある場合は、このインポートの設定を保存することができます。 

    ご不明な点や、問題が生じた場合は、Atlassian サポートにご連絡ください。

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

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

Jira フィールド

インポート時の注意

Project

CSV データはプロジェクト単位でインポートされます。既存の Jira プロジェクトを指定できます。指定しない場合、インポート時にインポーターが自動的に新規プロジェクトを作成します。

要約

これは唯一の必須フィールドです。

Issue Key (課題キー) インポートされた課題の課題キーを設定できます。対象のキーの課題がすでに存在する場合、その課題は更新されます。

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)

このフィールドの値は、秒数で指定する必要があります。

ユーザー情報

Supported user types

  • メール アドレス

  • Atlassian Account ID

ユーザーを作成

担当者または報告者フィールドの値として、インポーターに Jira ユーザーを自動で作成させることも可能です。

  • ユーザーは、Jira のアクティブなアカウントとして作成されます。ユーザーは Jira への初回のログイン時にパスワードをメールで通知してもらう必要があります。
  • 実名でないユーザーは、メールアドレス (ログイン名) の "@" 文字の前の部分を Jira でのフルネームとして取得します。
  • 外部のユーザー管理機能を使用している場合、インポートのプロセスで Jira ユーザーを作成することはできません。代わりに、作成が必要な新規ユーザーの一覧がインポーターによって提供されます。インポートを開始する前に外部のユーザー リポジトリでユーザーを作成する必要があります。
  • ユーザー数制限付きライセンス(例: パーソナルライセンス)で、必要なユーザー数が制限数を超える場合、インポートは停止されます。作成できないユーザーのリストを示すページが表示されます。
  • If Assignee and Reporter are not mapped, then no users are created.

ユーザーの更新

Jira Service Desk のポータル専用カスタマーのデータは、ほかのユーザー アカウント データとは異なる挙動となります。ポータル専用カスタマーのデータがインポート データと宛先サイトとで異なる場合、宛先サイトのデータが使用されます。

ウォッチャー ウォッチャーに指定されたユーザーが CSV ファイルに含まれているが、Jira には存在しない場合、このユーザーはインポートされません。特定の課題のウォッチャーとしてインポートする前に、ユーザーを Jira で利用可能にしておく必要があります。

その他のフィールド

その他のフィールドをインポートする場合は、特定の Jira カスタム フィールドへのマッピングを行うことができます。Jira にカスタム フィールドが存在しない場合、インポーターによってカスタム フィールドが自動的に作成されます。カスタム フィールドが日付フィールドの場合、CSV インポーター ウィザードの 2 番目の手順で指定した日付形式を使用してください。

最終更新日 2019 年 7 月 29 日

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

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.