CSV ファイルを使用して Jira にデータをインポートする
新しいインポート エクスペリエンスを使用すると、その他のプロジェクト管理ツールから Jira に情報を簡単に転送して、時間と労力を節約できます。このページでは、CSV ファイルを使用してデータをインポートする方法について手順を説明します。
このインポート エクスペリエンスは Jira と Jira Service Management で利用できます。Jira Product Discovery にデータをインポートする場合は、旧バージョンのインポート エクスペリエンスを使用してください。
Jira の新しいスペースにデータをインポートする
新しいインポート エクスペリエンスを使用するには、組織、サイト、または Jira 管理者である必要があります。
In addition to administrators, users with permission to create team-managed spaces can create and import data into team-managed business spaces but won’t be able to move users. Instead, user fields in the new space will be unassigned and user tags in comments will appear as plain text.
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 行より後にエラーがあると、インポートが失敗することがあります。インポートが失敗した場合、または部分的に完了した場合は、インポートの最後にエラー ログをダウンロードできます。トラブルシューティング ガイドを使用してエラーを修正し、スペースをもう一度インポートしてみてください。
インポートで問題が発生した場合は、サポートにお問い合わせください。
この内容はお役に立ちましたか?