【Jira】バージョンを削除しようとしてエラーになる時の関連課題確認

Jiraでプロジェクトのバージョン管理を行っていると、不要になったバージョンを削除しようとした際にエラーが発生することがあります。特に「関連する課題があります」といったメッセージが表示され、削除操作が完了できないケースが多く見られます。この記事では、バージョン削除エラーの原因を切り分け、具体的な対処手順を解説します。まずは、エラーの原因と確認すべきポイントを整理していきましょう。

バージョン削除エラーの主な原因

関連課題が存在する場合

バージョン削除時に最も多いエラーは、そのバージョンに関連付けられた課題が存在するケースです。Jiraでは、バージョンは課題の「Fix Version」または「Affects Version」として設定されていることがあります。これらの課題が1件でも存在すると、デフォルトの設定ではバージョンを削除できません。削除しようとすると「このバージョンには少なくとも1つの課題が関連付けられています。すべての課題を別のバージョンに移動するか、削除してください。」といったメッセージが表示されます。関連課題には未解決のものだけでなく、クローズ済みの課題や解決済みの課題も含まれます。また、アーカイブされた課題やゴミ箱にある課題も対象となる場合があるため、注意が必要です。

権限不足

バージョンの削除には、プロジェクトに対する適切な権限が必要です。一般的には「プロジェクト管理者」または「システム管理者」の権限が必要です。一般ユーザーが削除を試みると「権限がありません」というエラーが表示されます。所属するグループの権限設定を確認するか、管理者に依頼する必要があります。また、特定のプロジェクトだけで権限が制限されている場合もあるため、複数のプロジェクトで同様のエラーが出るかどうかも確認すると原因を切り分けられます。

システム制約

Jiraのシステム設定によっては、バージョンの削除そのものが許可されていない場合があります。例えば、バージョンを「リリース済み」としてマークした後に削除を禁止する設定や、バージョン管理の運用ポリシーとして削除を制限しているケースです。このような設定は通常、システム管理者の権限でのみ変更可能です。また、Jiraのバージョンによっては、バージョンの削除ではなく「アーカイブ」や「リリース解除」といった代替手段が用意されている場合もあります。

削除前に確認すべき関連課題の一覧

バージョンを削除する前に、どのような課題が関連しているかを把握することが重要です。以下の表に、関連課題の種類と削除への影響をまとめました。

課題の種類	削除への影響	対処方法
未解決の課題(Fix Versionに設定)	削除不可。課題を別のバージョンに移動する必要がある。	JQLで抽出し、一括編集でFix Versionを変更する。
解決済み・クローズ済みの課題	削除不可。同様に移動が必要。	JQLで抽出し、一括編集でFix Versionを変更する。
Affects Versionに設定された課題	削除不可。Fix Versionと同様に扱われる。	JQLで抽出し、一括編集でAffects Versionを変更する。
アーカイブされた課題	削除不可。アーカイブを解除してから移動する必要がある。	アーカイブ解除後、JQLで編集。
ゴミ箱(削除済み)の課題	環境によっては影響する。完全に削除するか復元して移動。	ゴミ箱から完全削除、または復元してバージョン変更。

この表から分かるように、関連課題が1件でも存在する場合、バージョンの削除はできません。ただし、空のバージョン(関連課題が0件)であれば、権限があれば通常は削除可能です。

関連課題を確認する手順

関連課題を確認するには、Jiraの検索機能(JQL)を使用するのが効率的です。以下の手順に沿って実行してください。

1. Jiraの画面上部にある「課題」メニューから「課題を検索」をクリックします。またはキーボードショートカット「g + g」で検索画面を開くこともできます。
2. 検索バーにJQLクエリを入力します。まずはプロジェクトを指定し、Fix Versionに該当バージョンが含まれる課題を抽出します。例えば「project = “プロジェクト名” AND fixVersion = “削除したいバージョン名”」です。バージョン名は正確に入力してください。半角スペースや大文字小文字も一致する必要があります。
3. 同様に、Affects Versionについても確認します。「project = “プロジェクト名” AND affectedVersion = “削除したいバージョン名”」のように入力します。
4. 検索結果の件数を確認します。もし課題が表示された場合は、それらの課題がバージョンに関連付けられています。ステータスや期限に関わらず、すべてが削除の妨げになります。
5. さらに、アーカイブやゴミ箱の課題も確認する必要があります。アーカイブされた課題は通常の検索では表示されないため、JQLに「AND archived = true」などを追加して検索します。ゴミ箱の課題は「issue in trash」で検索できます。ただし、これらの機能はJiraの設定によって利用可否が異なります。
6. 該当する課題を特定したら、それらの課題のFix VersionまたはAffects Versionを別のバージョンに変更します。Jiraの一括操作機能を使うと効率的です。「すべてのX件の課題を選択」から「一括変更」で「Fix Version」フィールドを編集します。

この手順で関連課題をすべて別のバージョンに移動すれば、元のバージョンは空になり削除できるようになります。

失敗パターンと回避方法

バージョン削除の失敗例をいくつか挙げ、その回避方法を説明します。

• 失敗パターン1: 関連課題を確認せずに削除を試みる。エラーメッセージが表示されたら、まずJQLで課題を抽出する習慣をつけましょう。
• 失敗パターン2: 課題のFix Versionを削除後、何も設定しないままにしてしまう。すると、その課題はバージョンなしになる可能性があります。別のバージョンを指定するか、「未割り当て」などの選択肢がある場合はそちらに変更します。
• 失敗パターン3: 課題のFix Versionを別のバージョンに変更する際、誤ったバージョン名を指定してしまう。JQLで変更対象を正確に絞り込み、プレビューで確認してから一括変更を実行してください。
• 失敗パターン4: 権限不足のため削除できない。管理者権限がない場合は、システム管理者に削除を依頼するか、代わりにバージョンを「アーカイブ」するなど別の方法を検討します。
• 失敗パターン5: バージョンが既にリリース済みとしてマークされている場合、削除できない。その場合は「リリースを解除」してから削除を試みるか、リリース済みバージョンは削除せずに残しておく運用も選択肢です。

これらの失敗を避けるには、事前の調査と適切な権限の確認が重要です。

管理者への依頼が必要なケース

自分では解決できない場合は、Jiraの管理者に連絡する必要があります。以下のようなケースが該当します。

• 権限不足で削除操作そのものができない場合。管理者に「プロジェクト管理者権限」の付与を依頼するか、代行を頼みます。
• 大量の課題が関連していて、一括変更に時間がかかる場合。管理者がバルク操作を実行できるか確認します。
• システム設定により削除が禁止されている場合。管理者は設定を変更できる場合がありますが、運用ポリシーに従って判断する必要があります。
• ゴミ箱やアーカイブの課題が原因で削除できない場合。管理者はゴミ箱を空にしたり、アーカイブを解除する権限を持っています。
• データ移行やバックアップが必要な場合。管理者に状況を説明して対応を仰いでください。

管理者に依頼する際は、どのバージョンを削除したいのか、どのようなエラーメッセージが表示されるのか、既に行った対処の内容を伝えるとスムーズです。

よくある質問

Q1. 関連課題をすべて別のバージョンに移動したのに、まだ削除できないのはなぜですか?
A1. アーカイブやゴミ箱に課題が残っている可能性があります。管理画面で「アーカイブ済みの課題を表示」などを有効にして確認してください。また、Jiraのキャッシュの問題で反映に時間がかかる場合もあるため、一度画面をリロードしてから再度試してみてください。

Q2. バージョン名を変更すれば、削除と同じ効果が得られますか?
A2. バージョン名の変更は削除とは異なります。バージョンそのものは残るため、管理画面上に表示され続けます。削除したい場合は、関連課題の移動後に削除操作を行う必要があります。

Q3. 削除できないバージョンを非表示にすることはできますか?
A3. バージョンを「アーカイブ」する機能があります。アーカイブされたバージョンは通常の一覧に表示されなくなりますが、完全に削除されるわけではありません。運用によってはアーカイブで対応するのも一手です。

Q4. エラーメッセージが英語で表示されます。どうすればいいですか?
A4. 設定で言語を変更できますが、エラーメッセージの内容を管理者に伝えるか、翻訳ツールを使って確認してください。多くの場合「cannot delete version because it has associated issues」のような表現です。

Q5. JQLクエリの結果が0件なのにエラーが出るのはなぜですか?
A5. 別のフィールド(例:affectedVersion)に関連付けられているか、サブタスクが該当している可能性があります。また、バージョン名に特殊文字が含まれている場合はエスケープが必要です。一度「Text」検索でバージョン名を検索してみてください。

まとめ

バージョン削除エラーの原因は、ほとんどの場合関連課題の存在です。まずはJQLを使って徹底的に課題を洗い出し、別のバージョンへ移動することで削除できるようになります。権限不足やシステム制約が原因の場合は管理者に相談し、適切な対応を取りましょう。また、安易な強制削除はデータ不整合を引き起こすため、確実な手順を踏むことが重要です。以上のポイントを押さえて、スムーズにバージョン管理を行ってください。