CSV インポーターを利用して課題を作成する

課題とサブタスクを作成する

このページの内容

お困りですか?

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

コミュニティに質問

関連プロジェクトに関して、課題の作成プロジェクト権限一括変更グローバル権限を持っている場合、コンマ区切り値 (CSV) ファイルを使用して課題を一括作成できます。お持ちの権限について知りたい場合は、Jira 管理者にお問い合わせください。

CSV ファイルは、表形式データを表すテキスト ファイルで、Microsoft Excel、Numbers、データベースなどの表形式データを処理するほとんどのアプリでサポートされています。

Jira の CSV インポーター (CSV ファイル インポート ウィザード) では、データを表形式でエクスポートする外部システムからデータをインポートできます。また、独自の CSV ファイルを作成して、課題を一括作成または更新することもできます。

Jira 管理者は課題をインポートするためのより高度な機能にアクセスできます。外部アプリから多数の課題をインポートする予定がある場合は Jira 管理者にお問い合わせください。

Jira 管理者向けの高度なインポート機能の詳細については、「他の課題トラッカーからの移行」および「CSV からのデータのインポート」をご確認ください。

CSV インポーターを利用するには 2 つの手順を実行します。

  1. CSV ファイルの準備
  2. CSV インポート ウィザードの実行

このページの内容

CSV ファイルの準備

CSV インポーターは、CSV ファイルが既定の Microsoft Excel 形式の CSV ファイルに基づいているものと想定します。

  • フィールドはコンマで区切ります
  • コンマや改行の/ (「キャリッジ リターン」など)、山括弧などの文字どおりに扱う必要があるコンテンツは引用符で囲みます。

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

CSV ファイルの要件

CSV ファイルは「正しいフォーマット」であることに加えて、次の要件を満たす必要があります。

  • ファイルには見出し行が必要です。CSV インポーターは見出し行を使用してCSV ファイルの 2 行目以降のデータを Jira フィールドにマッピングする方法を決定します。
  • 見出し行には課題の要約が含まれる要約列が必要です。
  • 列やフィールドを区切るコンマを除いて、見出し行には句読点を含めないでください。インポートが正常に行われない場合があります。 
  • 列またはフィールドの区切り記号としてのコンマはファイルのどの場所でも省略できません。  
展開して、有効な例をご確認ください
Summary, Assignee, Reporter, Issue Type, Description, Priority
"Test issue", admin, admin, 1, ,
展開して、無効な例をご確認ください
Summary, Assignee, Reporter, Issue Type, Description, Priority
"Test issue", admin, admin, 1


CSV ファイルで Jira データ構造をカプセル化する

課題を正しくインポートするには、CSV ファイルにさまざまなデータをカプセル化する方法を知っておく必要があります。これにより、データを Jira で処理し、課題を正しく作成または更新できます。  

ここでは、複数行フィールド、特殊文字、複数選択フィールドなどを含む CSV ファイルを構築するためのヒントと例を紹介します。  

課題フィールドの詳細については、「CSV データを課題フィールドにインポートするためのヒント」をご覧ください

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

複数行にまたがるデータを取り込むには、二重引用符 (") をCSV ファイルで使用します。たとえば、Jira はインポート中に、次のような例を単一レコードの有効な CSV ファイルとして扱います。

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

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

これらの文字を文字どおりに扱うには、特殊文字を含むテキスト部分を二重引用符 ("") で囲みます。Jira にインポートされると、これらの特殊文字は Jira のフィールド値の一部として保存されます。特殊文字の例としては、キャリッジリターンや改行文字、コンマなどがあります。

テキストに引用符で囲まれた単語または語句が含まれていて、Jira でこれらの引用符を文字どおりに扱う場合は、これらの単語またはフレーズを別の引用符で囲みます。 

  • CSV ファイルには、"Clicking the ""Add"" button results in a page not found error" のような値が含まれている場合がありますボタンの名前は 2 組の引用符で囲まれています。
  • インポート後、Jira はこの値を Clicking the "Add" button results in a page not found error として保存します。ボタンの名前は、本来あるべき姿の 1 組の引用符になっています。

複数の値を単一の課題フィールドに集約する

複数の値を受け入れる課題フィールドには複数の値をインポートできます。たとえば、修正 (対象) バージョン影響を受けたバージョンコンポーネントラベルなどです。これを行うには、マッピングされる課題フィールドに集約する各値について、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 番目の課題の修正バージョンの各フィールドが、インポート後に該当する課題フィールドに複数の値を生成します。

複数の値をサポートしている JIRA フィールドは限定されているので注意してください。CSV インポートでは、単一の値のみをサポートしている JIRA フィールド上で集約したデータのインポートができません。

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

CSV ファイルのインポートを通じて、課題を CSV ファイルから様々な JIRA プロジェクトにインポートできます。この操作を行うには:

  • CSV ファイルには、 プロジェクト名プロジェクト キーの 2 つの列を追加する必要があります。これらは、CSV ファイルから特定の Jira プロジェクトに課題を正しくインポートするために必要な必須の値です。
  • CSV ファイルにあるすべての課題で、インポート先のプロジェクト用の列に適切な名前とキーが含まれていることをご確認ください。

    If you aren’t a Jira administrator, you won’t be able to map the fields Project Name and Project Key to Jira’s fields. You’ll need to select different fields for mapping. Learn more about this in Tips for importing CSV data into issue fields.

例:

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

この例では、CSV ファイル インポート ウィザードの実行中に、CSV ファイルの [プロジェクト名] と [プロジェクト キー] の各フィールドを [プロジェクト名] と [プロジェクト キー] の各課題フィールドに一致させている場合は、1 番目と 2 番目の課題が「Sample」プロジェクト (プロジェクト キー「SAMP」) に、3 番目の課題が「Example」プロジェクト (プロジェクト キー「EXAM」) にインポートされます。

作業ログエントリーをインポートする

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

If you aren’t a Jira administrator, you won’t be able to map the Worklog field to Jira’s field. You’ll need to select different fields for mapping. Learn more about this in Tips for importing CSV data into issue fields.

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

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

-> セパレーターによって階層をインポートできます。

現在、Jira では CSV を経由したマルチレベルのカスケード選択フィールドのインポートをサポートしていません ( JRA-34202 - 課題詳細の取得… ステータス)。

CSV ファイル インポート ウィザードを実行する

ご利用の Jira インストールに既存のデータがある場合は、次のステップに進む前にそのデータをバックアップする必要があります。 


Jira 課題を含む CSV ファイルをインポートするには、次の手順に従います。 

  1. [課題] > [CSV から課題をインポート] の順に選択して [一括作成のセットアップ] ページを開きます。オプション [課題を CSV からインポート] がない場合は、Jira 管理者が Jira Importers プラグインをバージョン 6.2.3 以降にアップデートする必要があります。

  2. [一括作成のセットアップ] ページで CSV ソース ファイルを選択します。
    設定ファイルがない、または新しい設定ファイルを作成する場合は、[既存の設定ファイルを使用] チェックボックスをオフにしてください。設定ファイルは、CSV ファイルの見出し行の列名と Jira のフィールド間のマッピングを指定します。

    [既存の設定ファイルを使用] チェックボックスをオンにすると、既存の設定ファイルをアップロードするように求められます。このオプションを選択しない場合、Jira は将来のインポートに使用できる設定ファイルを自動で作成します。

  3. [次へ] を選択して、CSV ファイル インポート ウィザードの「設定」ステップに進みます。
  4. [設定] ページで必要なフィールドに入力して [次へ] を選択します

    展開してインポート設定を表示する
    • プロジェクトにインポート: 課題を作成または更新するプロジェクトを選択します。
    • ファイル エンコーディング: CSV ファイルの文字エンコーディングのタイプ。
    • 区切り文字: CSV ファイルの列またはフィールドを区切る文字。区切り文字がタブの場合は /t と指定します
    • 日付形式: CSV ファイルの日付形式。

  5. [フィールドをマッピング] ページで、CSV ファイルのフィールドを選択したプロジェクトの課題フィールドにマッピングします。これらのフィールドの値もマッピングする場合は、[フィールド値のマッピング] チェックボックスをオンにします。終了したら [次へ] を選択します

    必ず [要約] フィールドをマッピングしてください。課題の作成または更新には必須です。

    オプション [このフィールドをマッピングしない] は、CSV ファイルのフィールドをプロジェクトのどの課題フィールドにもマッピングしないことを意味します。これを選択すると、インポート後も課題にマッピングされていないフィールドは表示されません。

    このオプションは次の場合に使用します。 

  6. 値をマッピングするページでは、前のページで [フィールド値をマッピング] チェックボックスを選択した課題フィールドの目標値を確認してリセットできます。このチェックボックスをオンにしていない場合は、次のステップに進みます。

    課題タイプに [機能リクエスト] の CSV フィールド値がある場合は、これを課題タイプ フィールド値「機能」にマッピングすることをお勧めします。

    • このページには「フィールドをマッピングするページの [フィールド値をマッピング] チェックボックスをオンにした、すべてのフィールドのすべての値が表示されます。
    • インポート後にフィールドを空にする場合は、[Jira のターゲット値] [空としてインポート] を選択します
    • [報告者] [担当者] などのユーザー名ベースのフィールド値のマッピングを選択していない場合は、ファイルのユーザー名が Jira における既存のユーザー名 (小文字) に自動でマッピングされます。
    • 改行付きの説明をインポートする場合は、[説明] フィールドの [フィールド値をマッピング] チェックボックスを選択しないでください。選択すると、Jira がインポート中に改行を削除する場合があります。
    • [フィールド値をマッピング] チェックボックスを選択するかどうかにかかわらず、ユーザー名が Jira で定義されていない場合、Jira は CSV ファイルのデータに基づいてユーザー名を自動で作成します。

  7. インポートの実行前に、設定にエラーや警告がないか確認することをお勧めします。これを実行するには [検証] を選択しますファイルに警告やエラーが含まれている場合は、それらを修正してからファイルを再度アップロードすることをお勧めします。詳細については、検証の詳細ログをダウンロードしてください。

    この手順で使用したものと同じ (または類似の) 設定を持つ別の CSV ファイルをインポートする必要がある場合は、[設定を保存] リンクを選択して CSV 設定ファイルをダウンロードします。CSV 設定ファイルは、CSV ファイル インポート ウィザードの最初のステップで使用できます。たとえば、同じフィールドまたは値のマッピングを次のインポートでも使用することをお勧めします。

  8. CSV ファイルのデータが正しいことをご確認のうえ、[インポートを開始] を選択します。インポーターはインポートが進行するにつれて更新を表示して、インポートが完了すると成功を知らせるメッセージを表示します。
    インポートが完了したら、Jira で作成または更新された課題を確認できます。また、インポートの詳細なログをダウンロード、または今後使用するために設定を保存できます。
  9. これで、CSV データを Jira に正常にインポートできました。ご不明な点や問題が生じた場合は、アトラシアン サポートにご連絡ください。

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

ここでは、CSV ファイルから特定の課題フィールドにデータをインポートする際に役立つヒントをいくつか説明します。 

課題フィールド

インポート時の注意

プロジェクト

CSV データはプロジェクト単位でインポートされます。既存のプロジェクトをターゲットとして指定するか、インポーターによってプロジェクトがインポート中に自動で作成されます。

要約

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

コンポーネント

個別の列に各コンポーネントを入力することで、複数のコンポーネントを持つ課題をインポートできます。

影響バージョン

影響を受けたバージョンが複数ある課題をインポートするには、各バージョンを単独の列に入力します。

修正バージョン

修正バージョンが複数ある課題をインポートするには、各バージョンを単独の列に入力します。

期日

CSV インポート ウィザードの 2 番目のステップで指定した日付形式を使用してください: dd/MMM/yy h:mm a

課題タイプ

CSV ファイルで指定していない場合は、インポートされた課題が Jira システムで指定された既定の (例: 最初の) 課題タイプに設定されます。詳細は課題タイプ フィールドの値を定義」をご参照ください。 

また、新しい値をインポートの処理中にその場で作成できます。

ラベル

複数のラベルを持つ課題をインポートするには、各ラベルを個別の列に入力するか、すべてのラベルをスペースで区切って 1 つの列に配置します。

Priority

CSV ファイルで指定していない場合、インポートされた課題は Jira システムで指定された既定の (例: 最初の) 優先度に設定されます。詳細は優先度フィールドの値を定義」をご参照ください。 

また、新しい値をインポートの処理中にその場で作成できます。

初期見積り

この値を合計秒数として設定します。

残余見積り

この値を合計秒数として設定します。

ユーザー

選択して、[担当者] または [報告者] の各フィールドの任意の値から、Jira ユーザーを自動で作成します。

展開してユーザー作成のヒントを表示する
  • ユーザーは、Jira のアクティブなアカウントとして作成されます。ユーザーは、Jira への初回ログイン時にパスワードが記載されたメールを受信する必要があります。 
  • 実名のないユーザーの氏名を作成するために、Jira はメール アドレスの @ 文字の前の部分を使用します。 
  • 外部ユーザー管理システムを使用している場合は、Jira ユーザーがインポート中に作成されません。代わりに、インポート ウィザードによって、作成する必要がある新しいユーザーのリストが提供されます。インポートの実行前に、ユーザーを外部のユーザー リポジトリで作成する必要があります。
  • ユーザー数に制限のあるライセンス (パーソナル ライセンス) を持っていてユーザー数が制限を超える場合は、インポートが停止します。作成できないユーザーのリストが表示されます。 
  • 担当者および報告者がマッピングされない場合、ユーザー名は作成されません。

その他のフィールド

その他のフィールドをインポートする場合は、1 つ以上の Jira カスタム フィールドへのマッピングを選択できます。カスタム フィールドが Jira にまだ存在していない場合は、インポーターがカスタム フィールドを自動で作成します。

カスタム フィールドが日付フィールドの場合は、CSV インポート ウィザードの 2 番目のステップで指定した日付形式を使用してください: dd/MMM/yy h:mm a

Jira 管理者でない場合は、CSV ファイルの次のフィールドを Jira で対応するフィールドにマッピングできません。

  • 添付ファイル 
  • コメント本文 
  • 作成日 
  • 更新日 
  • 解決日 
  • プロジェクト キー 
  • プロジェクト名 
  • プロジェクト タイプ 
  • ソリューション 
  • ステータス 
  • 作業ログ 

フィールドのマッピングを完了するには、他の利用可能なフィールドを選択するか [このフィールドをマッピングしない] オプションを選択します。

既知の問題

複数選択フィールドの入力についての問題

課題が作成されても複数選択フィールドが入力されない場合は、管理者にお問い合わせください。管理者は Jira 管理ツールによってインポートを再実行できます。

制限されたカスタム フィールドのインポート

課題タイプが 1 つしかなくコンテキストのある必須カスタム フィールドがあるプロジェクトでは、CSV インポートは正しく実行されない場合があります。詳細と回避策については JRASERVER-41584 をご参照ください。 

最終更新日 2022 年 8 月 3 日

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

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