CSV ファイルを使用して Jira にデータをインポートする
新しいインポート エクスペリエンスを使用すると、その他のプロジェクト管理ツールから Jira に情報を簡単に転送して、時間と労力を節約できます。このページでは、CSV ファイルを使用してデータをインポートする方法について手順を説明します。
このインポート エクスペリエンスは Jira と Jira Service Management で利用できます。Jira Product Discovery にデータをインポートする場合は、旧バージョンのインポート エクスペリエンスを使用してください。
Jira の新しいスペースにデータをインポートする
新しいインポート エクスペリエンスを使用するには、組織、サイト、または Jira 管理者である必要があります。
管理者に加えて、チーム管理対象スペースを作成する権限を持つユーザーは、データを作成してチーム管理対象ビジネス スペースにインポートすることはできますが、ユーザーを移動することはできません。新しいスペースのユーザー フィールドはすべて割り当てが解除され、コメント内のユーザー タグはプレーン テキストで表示されます。
CSV ファイルを使用して Jira の新しいスペースにデータをインポートするには、次の手順に従います。
サイドバーの [スペース] の横にある [スペースの作成] () を選択します。
サイドバーの一番下までスクロールして、[データをインポート] を選択します。
設定からこのページに移動することもできます。サイドバーから [設定] (⛭) > [システム] > [外部システム インポート] を選択します。
データのインポート元になるアプリを選択します。
CSV ファイルをアップロード
インポートを開始するには、CSV ファイルをアップロードします。必ず、アップロードする前に CSV ファイルを準備して構造化し、[次へ] を選択します。
前のステップでアプリを選択した場合は、表示される指示に従ってアプリから CSV ファイルをエクスポートしてください。
[設定ファイルをアップロードする] で設定ファイルをアップロードして、以前のインポートから設定を取り込むこともできます。設定ファイルとは
Jira で新しいスペースを設定する
作成する Jira スペースを選択します。ビジネス スペース、サービス スペース、またはソフトウェア スペースを選択できます。ソフトウェア スペースを選択した場合は、テンプレートも選択する必要があります。利用できるテンプレートは「カンバン」と「スクラム」です。
[スペース タイプ]、[アクセス]、[キー] を変更するには、[さらに表示] を選択します。既定ではアクセスは [オープン] になっており、キーは自動的に選択されます。スペース名とキーは、[スペース設定] で後から変更できます。完了したら [次へ] を選択します。
スペース フィールドをマッピングする
スペースを設定したら、列データを Jira のフィールドにマッピングする必要があります。完了後、[次へ] を選択します。データをマッピングする方法の詳細をご確認ください。
カスタム フィールド
カスタム フィールドを作成するには、一覧表示されている CSV 列の横にあるドロップダウンを選択し、[新しいカスタム フィールドの作成] を選択してからカスタム フィールド タイプを選択します。カスタム フィールドの詳細をご確認ください。
値のマッピングを有効にする
列の値を作業タイプにさらにマッピングしたい場合は、CSV の列を [作業タイプ] フィールドにマッピングする必要があります。階層レベルを設定する場合は、[作業タイプ] フィールドに加えて、[作業項目 ID] フィールドと [親] フィールドに列をマッピングします。作業タイプに値をマッピングする方法をご確認ください。
作業タイプに値をマッピングする
前のステップで "作業項目 ID" フィールド、"親" フィールド、"作業タイプ" フィールドにマッピングしていた場合、このステップでは、選択した列の値を Jira の作業タイプにマッピングできるようになります。これらのフィールドにマッピングしていない場合は、このステップがスキップされ、「ユーザーを Jira に移動する」画面に移動します。
このステップでは、「スペース フィールドをマッピング」画面の "作業タイプ" フィールドにマッピングされた列内のデータを Jira の作業タイプにマッピングする必要があります。完了後、[次へ] を選択します。
このステップは、ソフトウェアとビジネス スペースのインポートでのみ使用できます。この画面は、サービス スペースのインポート中は既定でスキップされます。
ご利用の Jira Cloud プランによっては、ドロップダウン メニューで [新しい作業タイプを作成] を選択して、カスタム作業タイプを作成することもできます。階層の構造化についてご確認ください。
このステップをスキップするか、一部の値を作業タイプにマッピングしない場合、それらは既定でタスクにマッピングされます。
ユーザーを Jira に移動する
新しいスペースにユーザーを移動するには、各ユーザーの有効なメール アドレスを追加して、ユーザーの情報を Jira にインポートします。このステップでユーザーを追加しなくてもかまいません。完了したら、[次へ] を選択します。
アプリ管理者は、サイトから既存のユーザーのみを追加できます。新しいユーザーを追加するには、インポートを続行する前に、組織管理者に連絡して招待します。アプリ管理者によってこのページに追加された新規ユーザーの情報はインポートされません。
Jira Service Management スペースでは、必ずメール アドレスを追加し、ユーザー ロールを選択してください。メール アドレスやユーザー ロールが欠落しているユーザーはインポートされません。
メール アドレスの手動入力と自動入力
CSV のユーザー情報を含む列にメール アドレスがある場合は、自動的に入力されます。メール アドレスを手動で追加する場合は、データの損失を防ぎ、適切なユーザーをスペースにインポートするために、各ユーザーに正しいメール情報を入力してください。
ユーザーがインポートされない場合のユーザー データ
ユーザーをインポートしないことを選択した場合、担当者や報告者などのユーザー フィールドの割り当ては解除され、コメント内のユーザー @mentionsはプレーン テキストに変換され、コメント作成者名は匿名として表示されます。
スペースの詳細を確認する
このステップでは、Jira へのデータのインポート方法を確認します。デバイスに設定ファイルを保存して次回のインポートに使用したい場合は、[設定ファイルのダウンロード] を選択してください。インポートを開始する準備ができたら [ インポート] を選択します。
インポーターではバックグラウンドで自動的にデータの移動が開始されます。インポートのステータスはページに表示されます。インポートが完了するとメールも届きます。
データがインポートされると、作業項目が Jira ではボード ビューに、Jira Service Management ではキューに表示されます。
添付ファイルをインポートする
CSV ファイルに添付ファイルのリンクが含まれている場合、公開されているファイルは新しいスペースにインポートされます。それ以外の場合は、Web リンクとしてインポートされます。CSV にトークンを追加することは控えてください。
インポート エラーを修正する
インポート時には、CSV ファイルの最初の 30 行が、列ヘッダーを Jira フィールドにマッピングする方法に基づいてチェックされます。最初の 30 行のエラーは [スペース フィールドをマッピング] のステップで表示され、解決する必要があります。30 行より後にエラーがあると、インポートが失敗することがあります。インポートが失敗した場合、または部分的に完了した場合は、インポートの最後にエラー ログをダウンロードできます。トラブルシューティング ガイドを使用してエラーを修正し、スペースをもう一度インポートしてみてください。
インポートで問題が発生した場合は、サポートにお問い合わせください。
この内容はお役に立ちましたか?