Zenn
💭

Jira：テンプレート的にプロジェクトをコピーしたい（CSVエクスポートしてインポートする）

2024/02/02に公開
Jira
tech

やりたいこと

定期的に行うイベントのような、まとまった量でやることが決まっているプロジェクトをテンプレートとして、次に行う際に使いまわしたい。しかし、調べた限りでは「プロジェクトのコピー」や「プロジェクトをテンプレートとして保存」のような機能はない。
代わりにCSVのエクスポートとインポートの機能があり、これを組み合わせることでやりたいことが実現できたので備忘録として残す。

なお、この記事は実現方法および構成ともにJira：バックアップ的にプロジェクトをコピーしたい（CSVエクスポートしてインポートする）を参考にさせてもらった。この場を借りてお礼申し上げます。

環境

  • Jiraの製品: Jira Work Management（無料プラン）
  • テンプレート: プロジェクト管理
  • タイプ： チーム管理対象
  • OS: Mac
  • ブラウザ: Safari

コピー対象となるプロジェクトのタスク

要約（タスクのタイトル）とその説明、およびサブタスクが設定されているだけのシンプルなプロジェクトが対象

手順

コピー元のプロジェクトを「ソース」、コピー先のプロジェクトを「ターゲット」とする。

1. ソースプロジェクトからCSVエクスポート

「課題」ページの上部 「課題をエクスポート」 > 「Excel CSV のエクスポート」 をクリック
→ "Jira.csv" という名称でデフォルトのダウンロードフォルダにダウンロードされる

2. ターゲットプロジェクトを作成

  • テンプレート: プロジェクト管理
  • タイプ： チーム管理対象

3. ダウンロードしたCSVを整える

CSVファイルをNumbersで開いて編集した後、「ファイル」 > 「書き出す」 > 「CSV...」 で保存。
今回、残した項目は以下のとおり

  • 要約
  • 課題ID
  • 課題タイプ
  • ステータス
  • 報告者
  • 説明
  • 親*
    • 親には親タスクの課題IDが入る。そのため、子タスクより上の行に親タスクがないとインポートするときにエラーになるので注意

4. ターゲットプロジェクトにCSVインポート

4-1. CSVファイルのインポート

  1. ダッシュボード右上の歯車（設定）　> システム > 外部システムインポート > CSV とクリック
  2. CSVソースファイルに 3. で整えたCSVファイルを選択
  3. (2回目以降)「既存の設定ファイルを使用する」にチェックを入れ、設定ファイル(.csv)を選択
  4. Advanced の項目は必要に応じて変更（今回は変更せず）し、「次へ」をクリック

4-2. プロジェクトのマッピング

  1. 「プロジェクトにインポート」に 2. で作成したターゲットプロジェクトを選択
  2. その他の項目は必要に応じて変更（今回は変更せず）し、「次へ」をクリック
  3. インポートするcsvのフィールドと、ターゲットプロジェクト(Jira)のフィールドをマッピングし、「次へ」をクリック
    ← 各csvフィールド名の下(e.g.)に自分がアップロードしたファイル内の該当する項目例が表示されている
    今回は以下で設定。
CSVフィールド Jiraフィールド
ステータス ステータス
報告者 報告者
要約 要約
親 親
説明 説明
課題ID 課題ID
課題タイプ 課題タイプ

4-3. 値のマッピング

値のマッピングを確認し、「インポート開始」をクリック

4-4. インポート結果の確認

これで完了。ターゲットプロジェクトを開くと、タスクがインポートされていることが確認できる　　
ここで「設定を保存」をクリックすると設定ファイル(CSV-configuration-YYYYMMDDxxxx.csv)がダウンロードされ、次回以降の 4-1-3. で選択するとマッピング作業を省略できる

終わりに

  • 今回対象となるプロジェクトのタスクがシンプルなものであったため、今後コピーしたい項目が増える場合は都度ここの記事をアップデートしていきたい
  • やり直したい時は、ターゲットプロジェクトの課題を全削除 → インポートし直しで問題ない

Discussion