【Jira】かんばんボードのバックログが空になる時のフィルター見直し

Jiraのかんばんボードは、進行中の作業を可視化する強力なツールですが、時としてバックログが空っぽになる現象に遭遇することがあります。この状態になると、チームメンバーは次に何をすべきか把握できず、業務に支障をきたします。この問題の原因は多岐にわたりますが、最も頻繁に発生するのはボードに設定されたフィルターの誤りです。フィルターはJQLと呼ばれるクエリ言語で記述されており、表示する課題を選択する役割を担っています。本記事では、このフィルターを見直す具体的な手順を解説します。さらに、よくあるミスのパターンや、問題を未然に防ぐための運用ルールについても触れます。

バックログが空になる主な原因とフィルターの役割

バックログが空になる原因はフィルターだけではありませんが、多くの場合はフィルター設定が適切でないことによります。フィルターは、ボードに表示する課題を選択するための条件です。例えば、特定のプロジェクト、特定の課題タイプ、特定のステータスなどです。この条件が厳しすぎたり、間違っていたりすると、表示される課題がゼロになります。

原因1 プロジェクトの指定ミス

フィルターにプロジェクトが指定されていない場合、全プロジェクトの課題が対象になりますが、逆に誤ったプロジェクトキーを指定すると課題が見つかりません。プロジェクトキーは大文字小文字を区別し、存在しないキーを使用するとJiraはエラーを表示せずに空の結果を返します。また、複数のプロジェクトを指定する際にANDとORを間違えるケースもあります。

原因2 ステータスの不一致

ボードのカラムに割り当てられたステータスとフィルターで指定したステータスが一致しない場合があります。例えば、カラムは「To Do」と「In Progress」なのにフィルターでstatus = “Open”と指定してしまうと、該当する課題が存在しない可能性があります。ステータス名は正確に一致する必要があり、スペルミスや未定義のステータスはエラーにならずに0件になります。

原因3 スプリントの設定

かんばんボードではスプリントを使わないこともありますが、フィルターにsprint in openSprints()が含まれていると、スプリントがアクティブでない場合に課題が表示されません。スプリントを使わない場合は、この条件を削除する必要があります。また、スプリントを使っている場合でも、バックログにスプリント未割り当ての課題を表示したい場合は、sprint is EMPTYを追加することを検討してください。

フィルタークエリを確認する手順

それでは、実際にフィルターを確認する手順を見ていきます。以下の手順は、Jiraの管理画面で行われます。

1. Jiraの画面上部のメニューから「プロジェクト」を選択し、対象のプロジェクトを開きます。
2. プロジェクト画面の左サイドバーから「ボード」を選択し、該当のかんばんボードを開きます。
3. ボード画面の右上にある「その他」(三点リーダー)をクリックし、「ボード設定」を選択します。
4. 設定画面の左側のメニューから「フィルター」タブをクリックします。
5. 表示された「フィルタークエリ」の内容を確認します。ここにJQLが記述されています。
6. クエリ全体をコピーし、画面上部の検索バーに貼り付けて実行し、どの課題がヒットするか確認します。
7. 結果が0件であれば、クエリに問題があります。結果が複数件あれば、ボードの他の設定(カラムやスプリント)が原因かもしれません。

この手順を実行する際、検索バーでテストする前に現在のフィルターをメモしておくことをおすすめします。また、検索結果が0件の場合、クエリの各部分を順に削除して原因を特定すると効率的です。

よくあるフィルター設定の失敗パターンと比較表

ここでは、実際に起こりがちな失敗パターンをまとめます。以下の比較表を参考に、自身のフィルターと照らし合わせてください。

設定の種類	正常なフィルター例	問題のあるフィルター例	問題の説明
プロジェクト指定	project = “MYPROJ”	project = “MYPROJ” AND project = “OTHER”	複数プロジェクトをANDで指定すると、両方に属する課題は通常存在しない。
ステータス指定	status in (“To Do”, “In Progress”)	status = “Open”	“Open”というステータスが存在しない場合、該当課題はゼロになる。
スプリント指定	sprint is not EMPTY	sprint in openSprints()	openSprints()が空の場合、結果はゼロ。スプリントを使わないボードではsprint条件を外す必要がある。
課題タイプ指定	issuetype in (Story, Task, Bug)	issuetype = “Epic”	Epicのみ指定すると、バックログにEpic以外の課題が表示されない。
担当者指定	assignee = currentUser()	assignee = “someone”	特定の担当者のみ表示すると、他の担当者の課題が表示されない。

失敗パターンの詳細

さらに、いくつかの失敗パターンを具体的に解説します。

フィルターが完全に間違っている場合:存在しないプロジェクトキーやタイポがあると、Jiraがエラーを返さずに空の結果になることがあります。例えば、project = “MYPROJ”が正しいのに、project = “MYPRJ”と書いてしまうと、該当するプロジェクトがないため0件になります。必ずJQLを検索バーでテストし、期待する課題が返るか確認してください。

カラムとフィルターの不一致:ボードのカラム設定で、各カラムに対応するステータスが定義されています。フィルターで指定したステータスがこれらのカラムに含まれていないと、課題は表示されてもカラムに割り当てられず、バックログに残り続けるか、あるいは表示されない場合があります。カラム設定は「ボード設定」の「カラム」タブで確認できます。

スプリントのアクティブ状態:スプリントを使っている場合、バックログにはスプリントに割り当てられていない課題が表示されることがあります。フィルターにsprint is EMPTYを追加することで、スプリント未割り当ての課題を表示できます。逆に、スプリントをアクティブにしていないと、sprint in openSprints()は空になり、何も表示されません。

管理者に確認すべき設定と再発防止策

管理者に確認すべき設定

フィルターの変更はプロジェクト管理者が行うことが多いため、管理者に確認すべき事項をまとめます。

• ボード設定の権限:フィルターを編集できるのは、プロジェクトの管理権限を持つユーザーのみです。一般ユーザーは表示のみ可能な場合があります。権限がない場合は管理者に連絡し、問題の状況を具体的に伝えてください。
• 共有フィルター:チームでフィルターを共有している場合、別の誰かが変更してしまう可能性があります。フィルターが適切かどうか定期的にレビューすることを勧めます。特に、プロジェクトに新しく参加したメンバーが誤って変更することがあるため、変更履歴を確認できると安心です。
• バックログの表示設定:ボード設定の「バックログ」タブで、バックログに表示する課題の条件をさらに絞り込むことができます。ここで設定が加わっている場合、フィルターと合わせて確認する必要があります。例えば、エピックのみ表示する設定になっていると、他の課題タイプが表示されません。

再発防止策

再発防止策としては、以下のような運用ルールを設定すると良いでしょう。

• ボード作成時にはテンプレートを使用する:テンプレートには標準的なフィルターが設定されているため、誤りが少ないです。特にスクラムやかんばんのテンプレートは、一般的な運用に合わせて最適化されています。
• フィルターの変更履歴を確認する:Jiraの監査ログ機能を使うと、誰がいつフィルターを変更したか追跡できます。問題が発生した場合、原因を特定するのに役立ちます。
• 変更前に現在のフィルターをメモしておく:変更後問題が発生した場合、元に戻しやすくなります。特に、複雑なJQLを使っている場合は、変更前のクエリをテキストファイルなどに保存しておくと安心です。
• 定期的なフィルターレビュー:プロジェクトの進行に伴い、フィルターの条件が適切でなくなることがあります。例えば、新しい課題タイプが追加された場合、フィルターに含める必要があります。月に一度程度、フィルターの内容を確認する習慣をつけましょう。

よくある質問(Q&A)

• Q1: フィルターが正しいのにバックログが空のままです。他に原因はありますか?
  A1: フィルターが正しくても、ボードのカラム設定やスプリント設定が原因でバックログが空に見えることがあります。例えば、全課題がすでに完了ステータスになっている場合、バックログに表示する条件と合わない可能性があります。また、プロジェクトの課題タイプがボード設定で除外されているかもしれません。ボード設定の「カラム」タブと「バックログ」タブも確認してみてください。
• Q2: フィルターを変更する権限がありません。どうすればよいですか?
  A2: プロジェクト管理者にフィルターの見直しを依頼してください。その際、観察した現象(いつから空になったか、どのような操作をしたかなど)を具体的に伝えるとスムーズです。また、管理者が変更する前に、現在のフィルターをコピーしてメモしておくことも有効です。
• Q3: 検索バーでフィルターを試すと課題が表示されるのに、ボードでは空です。なぜですか?
  A3: ボード固有の設定(例:バックログのサブフィルター、スプリント選択、カラムマッピング)が原因かもしれません。ボード設定の「バックログ」タブで、追加のフィルター条件が設定されていないか確認してください。また、スプリントがアクティブでない場合、ボードが特定のスプリントを表示する設定になっていると、課題が表示されないことがあります。
• Q4: スプリントを使っていませんが、フィルターにsprint in openSprints()が含まれています。どうすればよいですか?
  A4: スプリントを使用しないかんばんボードでは、スプリント関連の条件をフィルターから削除してください。代わりに、例えばproject = “MYPROJ” AND status in (“To Do”, “In Progress”)のようにシンプルな条件にします。管理者に依頼して、フィルターを編集してもらいましょう。
• Q5: フィルターを変更した後に元に戻せますか?
  A5: Jiraの監査ログを使えば過去のバージョンを確認できますが、直接元に戻す機能はありません。変更前のクエリをメモしておくことをおすすめします。もしメモがない場合、プロジェクト管理者が過去のフィルターを復元できる可能性があります。

まとめ

この記事では、Jiraのかんばんボードでバックログが空になる問題の主要な原因としてフィルター設定に焦点を当て、その確認手順と修正方法を解説しました。フィルタークエリはボード設定画面から簡単に確認でき、JQLを直接検索してテストすることで問題の特定が容易になります。また、よくある失敗パターンを知っておけば、変更時のミスを減らせます。バックログが空で困った際は、まずフィルターを見直すことをおすすめします。日頃からフィルターの内容を把握し、チーム内で変更履歴を共有することで、安定したボード運用が可能になります。