【Jira】課題を複製した時に添付ファイルも引き継ぎたい場合の確認点

Jiraで既存の課題を複製した際、添付ファイルが自動的にコピーされず、毎回手動で再添付しなければならないという経験はありませんか。特に、テンプレート的な課題や障害報告を複製して使う場合、添付ファイルの引き継ぎができないと作業効率が大きく低下します。この問題の原因はJiraの標準設定やプロジェクト構成にあり、多くの場合、管理者側の設定変更や複製操作の工夫により解決できます。本記事では、課題複製時に添付ファイルを引き継ぐための確認点を体系的に整理し、具体的な対応手順を紹介します。

課題複製時に添付ファイルが引き継がれない原因

Jiraの標準機能で課題を複製(「複製」アイコン、または「その他」→「複製」)した場合、添付ファイルはデフォルトではコピーされません。これはJiraが「複製」をあくまで課題のフィールド情報のみをコピーする操作と定義しており、添付ファイルは複製範囲に含まれていないためです。ただし、アドオンやスクリプト、あるいはREST APIを利用することで添付ファイルを複製できる環境もあります。原因は主に以下の3つに分類できます。

1. 標準複製機能の制限

Jira本体(Server/Data Center/Cloud)の標準的な複製機能は、添付ファイルをコピーしません。この仕様を認識せずに「複製すれば全部引き継がれる」と思い込んでいると、ファイルが欠落した状態で課題が作成されます。特に、障害報告のテンプレートにスクリーンショットを添付している場合、複製先で画像が失われることが多いです。

2. プロジェクト設定や権限の問題

複製元の課題に添付ファイルが存在していても、複製を実行するユーザーに「添付ファイルの追加」権限がない場合や、複製先のプロジェクトで添付ファイル機能が無効になっている場合があります。また、添付ファイルの保存場所が外部ストレージ(例:S3、NAS)と連携している場合、アクセス権限の不一致でコピーに失敗することもあります。

3. アドオンやカスタムスクリプトの未導入

添付ファイルを複製するためには、Jiraの標準機能だけでは不十分です。多くの組織では、「Copy of Jira Issue」や「Clone for Jira」などのアプリ(アドオン)を導入することでこの問題を解決しています。あるいは、AutomationルールやScriptRunnerなどを用いて、課題作成時に添付ファイルをコピーするカスタムロジックを組んでいる場合もあります。

確認すべきポイントと切り分け手順

問題が発生した際、まずはどの段階でファイルが引き継がれないのかを特定します。以下の手順に沿って確認を進めてください。

1. 使用している複製方法を確認する
   課題画面の「複製」ボタンから行ったのか、それともアプリの「コピー」機能を使っているのかを確認します。標準複製であれば添付ファイルはコピーされません。もしアドオンを使っている場合は、そのアドオンの設定画面で添付ファイルのコピーが有効になっているか確認してください。
2. 複製元と複製先のプロジェクト設定を比較する
   プロジェクト管理者であれば、「プロジェクト設定」→「課題タイプスキーム」で、該当課題タイプが「添付ファイル」フィールドを含んでいるか確認します。また、「画面スキーム」で添付ファイルフィールドが表示される画面(作成画面、編集画面)に設定されているか確認してください。Cloud版の場合は「プロジェクト設定」→「フィールド」からも確認できます。
3. 複製実行ユーザーの権限を確認する
   「プロジェクト設定」→「権限スキーム」で、「課題の添付ファイル追加」権限が複製を実行するユーザーに割り当てられているか確認します。特に、複製先のプロジェクトでそのユーザーが権限を持っていないと、添付ファイルのコピーに失敗する可能性があります。
4. 添付ファイルの保存場所を確認する
   Jiraの管理画面で「添付ファイルの保存先」がどのように設定されているか確認します。Server/Data Center版では「管理」→「システム」→「添付ファイルの設定」から、Cloud版ではプロジェクト管理者は参照できませんが、Jira管理者に問い合わせてください。外部ストレージの場合、アクセス権限の問題が発生しやすいです。
5. ログやエラーメッセージを確認する
   複製処理が完了した後にエラーログが出力されていないか、Jiraのログファイル(atlassian-jira.log)を確認します。クラウド版ではサポートポータルからログを取得することも可能です。エラー内容によっては、ファイルサイズ制限やストレージ容量の問題が原因であることもあります。

管理者に確認・依頼すべき設定と対応策

一般ユーザーでは変更できない設定については、Jira管理者またはプロジェクト管理者に依頼する必要があります。以下の表に、代表的な設定と管理者権限の範囲をまとめました。

設定項目	管理画面の場所	権限	対応策
課題タイプスキームに「添付ファイル」フィールドが含まれているか	プロジェクト設定 > 課題タイプスキーム	プロジェクト管理者	課題タイプに添付ファイルフィールドを追加する
画面スキームで添付ファイルフィールドが表示されるか	プロジェクト設定 > 画面スキーム	プロジェクト管理者	該当画面に添付ファイルフィールドを追加する
添付ファイルの保存先(内部/外部)	管理 > システム > 添付ファイル設定	Jiraシステム管理者	外部ストレージの場合、アクセス権限を見直すか内部保存に変更する
添付ファイルの複製を可能にするアプリの導入	管理 > アドオン管理	Jiraシステム管理者	該当アプリをインストールし、設定を有効にする
Automationルールによる複製時の添付コピー	プロジェクト設定 > オートメーション	プロジェクト管理者(ルール作成)	ルールのアクションに「添付ファイルをコピー」を含める

管理者に依頼する際は、上記のうちどの設定が不足しているかを事前に切り分けて伝えるとスムーズです。

代替手段:添付ファイルを引き継ぐためのワークアラウンド

管理者による設定変更がすぐにできない場合や、アドオンを導入できない環境では、以下の代替手段を検討してください。

1. 手動で添付ファイルをコピーする

複製後に、複製元からファイルをダウンロードし、複製先の課題に再度添付します。この方法は確実ですが、ファイル数が多い場合は手間がかかります。ファイル名に規則性がある場合は、一度ダウンロードしてから一括添付できるツール(例:Jira Cloudの「Bulk Attachment Uploader」など)を利用することもできます。

2. Automationルールを利用する(プロジェクト管理者が設定可能)

Jira CloudおよびData Centerでは、Automation機能を使って課題複製時に添付ファイルをコピーするルールを作成できます。例えば、「課題が作成されたとき」をトリガーにし、「複製元の課題から添付ファイルをコピー」という条件を追加するルールです。ただし、この方法では標準の「複製」操作をトリガーにできない場合があるため、ルールの作成には注意が必要です。

3. REST APIを利用してスクリプトを作成する

JiraのREST APIを呼び出して、複製元の添付ファイルを取得し、複製先にアップロードするスクリプトを作成します。この方法は技術スキルが必要ですが、柔軟性が高く、一度作れば繰り返し使えます。多くの場合、PythonやPowerShellで実装されます。

よくある質問とトラブルシューティング

実際にユーザーから寄せられる質問をいくつかピックアップしました。

• Q: 標準の複製機能で添付ファイルをコピーする方法はありますか?
  A: Jira標準機能ではコピーできません。アドオン(例:Clone for Jira)を導入するか、Automationルールで対応します。どうしても標準だけで行いたい場合は、JiraのバージョンアップやAtlassianへの機能リクエストを検討してください。
• Q: アドオンを導入しても添付ファイルがコピーされません。何が原因ですか?
  A: アドオンの設定で添付ファイルコピーが有効になっていない、またはアドオンが古い可能性があります。アドオンの管理画面で設定を見直し、最新版にアップデートしてください。また、複製先のプロジェクトで添付ファイルフィールドが利用可能かも確認してください。
• Q: 複製元の課題にファイルが存在するのに、複製後に空です。なぜですか?
  A: 複製実行ユーザーに添付ファイルの読み取り権限がない可能性があります。特に、プロジェクト権限「課題の添付ファイル閲覧」が不足していると、ファイルが存在してもコピーできません。権限スキームを見直してください。
• Q: 添付ファイルのサイズが大きすぎると複製に失敗しますか?
  A: はい。Jiraには添付ファイルの最大サイズ制限があります(デフォルトは10MBなど)。大きなファイルは複製前に圧縮するか、外部リンクとして管理することを検討してください。

まとめ

Jiraの課題複製時に添付ファイルを引き継ぐには、標準機能だけでは不十分で、アドオンやAutomationルールなどの追加設定が必要です。まずは現在の複製方法とプロジェクト設定を確認し、権限やフィールド構成に問題がないか切り分けてください。管理者に依頼する際は、本記事の表を参考に必要な設定を具体的に伝えると解決が早まります。手軽なワークアラウンドとしては、手動コピーやAutomationルールの活用が挙げられます。添付ファイルの引き継ぎは業務効率に直結するため、早めに対応することをおすすめします。