【Jira】解決状況を変更しても課題が完了扱いにならない時の設定確認

Jiraで課題の解決状況を「解決済み(Resolved)」に変更したのに、課題が完了(Closed)として扱われず、ダッシュボードやフィルターで「未完了」のまま表示されることがあります。この現象は、ワークフローの設定やトランジションの定義が原因であることがほとんどです。本記事では、解決状況を変更しても課題が完了扱いにならない原因を切り分ける方法と、管理者が確認すべき設定ポイントを具体的に解説します。実際の操作手順やよくある失敗例も紹介しますので、Jiraのプロジェクト管理者やワークフロー設計者の方は参考にしてください。

1. ワークフローの基本構造を理解する

Jiraでは、課題の状態遷移はワークフローによって定義されています。通常、課題は「オープン」→「進行中」→「解決済み」→「完了」のようにステータスを移行しますが、この遷移が正しく設定されていないと、解決済みから完了に自動的には移行しません。まず、ワークフローの基本要素を確認しましょう。

ステータスとトランジションの関係

ワークフローは「ステータス」(課題の状態)と「トランジション」(状態間の遷移)から構成されます。解決済みと完了は別のステータスであり、解決済みから完了に移行するためには、対応するトランジションが定義されている必要があります。もしトランジションが存在しない場合、解決済みの課題はいつまでも「未完了」扱いになります。

分解能(Resolution)フィールドの役割

Jiraでは「Resolution」(解決状況)というフィールドがあり、これはステータスとは独立しています。課題を解決済みにすると自動的にResolutionフィールドに値(例:「Fixed」「Done」)が設定されますが、これだけでは完了ステータスにはなりません。完了にするには、別途トランジションを使用してステータスを変更する必要があります。

2. 原因の切り分け:3つの確認ポイント

問題の原因を特定するために、以下の3つの観点で確認を進めてください。

確認1:トランジションの存在

ワークフローエディターで「解決済み」から「完了」へのトランジションが定義されているか確認します。多くの標準ワークフローでは、「解決済み」から「クローズ」へのトランジションが存在しますが、カスタマイズされたワークフローでは欠落していることがあります。

1. プロジェクトに移動し、「プロジェクト設定」→「ワークフロー」を開きます。
2. 現在アクティブなワークフローを選択し、「編集」をクリックしてワークフローエディターを起動します。
3. キャンバス上で「解決済み」ステータスをクリックし、そこから「完了」ステータスへ向かう矢印(トランジション)があるか確認します。
4. 矢印がない場合、トランジションが未定義です。追加する必要があります。
5. 矢印がある場合でも、そのトランジションのプロパティをダブルクリックして詳細を確認します。

確認2:トランジションの条件(Conditions)とバリデータ

トランジションに条件やバリデータが設定されていると、特定の条件下でのみ遷移が許可されます。例えば「担当者だけが完了にできる」「特定のフィールドが必須」などの条件が満たされていないと、ユーザーがトランジションを実行できません。

• トランジションの設定画面で「Conditions」タブを開き、設定されている条件を確認します。
• 「Only the assignee can execute this transition」などの条件がある場合、自分が担当者でなければトランジションを実行できません。
• 「Validators」タブでは、必須フィールドのチェックなどが設定されている場合があります。
• 条件やバリデータが原因でトランジションが表示されない、またはグレイアウトされることがあります。

確認3:権限(Permissions)設定

トランジションの実行には適切なパーミッションが必要です。権限が不足していると、トランジション自体が表示されません。

• プロジェクト設定の「権限」で、ワークフローに関する権限(例:「Transition issues」「Close issues」)がユーザーに付与されているか確認します。
• トランジションのプロパティで「Permissions」がさらに細かく設定されている場合もあります。
• 権限がない場合、管理者に適切な権限を依頼してください。

3. 比較表:トランジションあり・なしの動作違い

設定状態	ユーザーの操作	結果
解決→完了のトランジションあり(条件・権限正常)	解決済みに変更後、ワークフローボタンから「完了」を選択	ステータスが完了に変わり、Resolutionフィールドが設定される
トランジションはあるが条件でブロックされている	ワークフローボタンに「完了」が表示されない、またはグレイアウト	ステータスは解決済みのまま。原因は条件または権限
解決→完了のトランジションがない	解決済みに変更後、完了に遷移する手段がない	課題は解決済みのまま「未完了」扱い。管理者がワークフローを修正する必要あり

4. よくある失敗パターンと対処法

失敗パターン1:「解決済み」から「完了」へのトランジションがそもそもない

特にカスタムワークフローを自分で作成した場合、トランジションを追加し忘れることがあります。この場合、ユーザーは解決済みにしかできず、完了にはできません。対処法としては、ワークフローエディターで「解決済み」から「完了」へのトランジションを追加し、適切な画面設定を行います。トランジション追加後はワークフローのドラフトを公開する必要があります。

失敗パターン2:「自動トランジション」を期待している

一部のユーザーは、解決状況を「Done」に設定すれば自動的にステータスが完了になると誤解しています。しかし、Jiraの標準動作では、ワークフローによる明示的なトランジションがなければ自動完了は行われません。解決状況とステータスは別物であることを理解してください。

失敗パターン3:条件が厳しすぎる

例えば、「課題の担当者のみが完了にできる」という条件が設定されている場合、他のユーザーがトランジションを実行できません。また、「サブタスクがすべて完了していること」などのバリデータが設定されていると、条件を満たさない場合にエラーになります。これらの設定はプロジェクトのルールに合わせて調整が必要です。

5. 管理者へ伝える情報と確認依頼のポイント

もし自分でワークフローを編集できない場合、管理者に調査を依頼する必要があります。その際、以下の情報を伝えるとスムーズです。

• 問題が発生しているプロジェクト名と課題キー(例:PROJ-123)
• 現在のステータス(解決済み)と希望するステータス(完了)
• トランジションの実行を試みた際の具体的な動作(ボタンが表示されない、エラーメッセージなど)
• 該当ユーザーのアカウント情報とロール
• ワークフローのスクリーンショット(可能であれば)

管理者は、ワークフローの「解決済み」から「完了」へのトランジション、その条件・バリデータ・権限を確認し、必要に応じて修正します。

6. よくある質問(FAQ)

Q1. 解決済みに変更した時点で、自動的に完了にしてほしいのですが、可能ですか?

Jiraの標準機能では、解決状況を変更しても自動でステータスは変わりません。しかし、ワークフローに「トリガー」や「後処理関数」を設定することで、解決状況変更時に自動的に完了トランジションを実行するようにカスタマイズすることが可能です。ただし、これは高度な設定であり、互換性や意図しない動作を避けるため、十分なテストが必要です。

Q2. 一般ユーザーでもワークフローの編集はできますか?

ワークフローの編集は、プロジェクト管理者権限(またはJira全体の管理者権限)が必要です。一般ユーザーは編集できません。問題がある場合は管理者に連絡してください。

Q3. ワークフローを修正した場合、過去の課題にも影響しますか?

ワークフローの変更はすべての課題に適用されますが、過去の課題は変更前のステータスを保持します。変更前に完了していなかった課題は、新しいワークフローに従って遷移できるようになります。ただし、一部のワークフロー変更(特にトランジションの削除)は過去の課題のステータスに影響を与える可能性があるため、変更前にバックアップを取ることをおすすめします。

まとめ

Jiraで解決状況を変更しても課題が完了扱いにならない原因は、主にワークフロー上のトランジション不足、条件・権限制限、またはユーザーの誤解の3つです。まずはワークフローエディターで「解決済み」から「完了」へのトランジションの有無を確認し、次にそのトランジションに設定された条件や権限を見直してください。自分で修正できない場合は、管理者に具体的な情報を伝えて確認を依頼しましょう。正しいワークフロー設定により、課題管理の精度と効率が向上します。