Jira クエリ言語 (JQL) チート シート

Jira クエリ言語 (JQL) を使用すると、柔軟かつ強力なクエリによって Jira ワークスペース内の課題の検索、フィルタリング、レポートの作成を行い、精度の高い結果を得ることができます。これは、フィルターをクリックするだけでは不十分な場合に、Jira を検索する方法です。

JQL は、ステータス レポートを抽出するプロジェクト マネージャー、バックログを監査する管理者、特定のリリースに関連付けられたすべてのバグを探し出すエンジニアなど、作業項目全体で正確かつ反復可能な検索を必要とするすべてのユーザー向けに設計されています。

Jira を無料で入手する

JQL クエリの 4 つの構成要素

すべての JQL 句は、同じ 4 つの要素で構成されています。

構成要素

動作

例

フィールド

検索対象の属性

priority、assignee、fixVersion

演算子

フィールドを値に関連付ける

=、!=、<、IN

値または関数

照合対象

"High"、currentUser()

キーワード

複数の句を結合する

AND、OR、ORDER BY

一般的な演算子

演算子により、Jira がフィールドと検索対象の値を比較する方法が定義されます。演算子を使用して、完全一致の検索、条件の組み合わせ、値のリスト全体の検索、またはフィールドが空であるかどうかの確認を行います。

演算子

意味

例

=

完全一致

project = "マーケティング キャンペーン"

!=

等しくない

assignee != currentUser()

AND

条件の組み合わせ (すべてを満たす必要がある)

priority = High AND status = Open

OR

条件の組み合わせ (いずれかを満たす必要がある)

status = Open OR status = Reopened

IN

リストにある値と一致する

priority IN (High, Highest)

~

含む (テキスト検索)

summary ~ "ログイン エラー"

IS EMPTY

フィールドに値がない

assignee IS EMPTY

主要な JQL 関数とその使用方法

JQL 関数は、ユーザーによる複雑な演算の実行、結果のソート、動的な基準に基づくフィルタリングを可能にすることで、クエリ機能を強化します。これらの関数には次のものがあります。

機能

説明

例

ORDER BY

結果をフィールドでソートします。

project = "マーケティング" ORDER BY created DESC

WAS

過去に特定のステータスであった課題を検索します。

status WAS "解決済み" AND status = "オープン"

CHANGED

ある期間内に変更された課題を特定します。

status CHANGED AFTER -1w

MEMBERSOF

課題をグループ メンバーシップでフィルタリングします。

assignee IN MEMBERSOF("開発者")

一般的な Jira ユース ケースの JQL の例

Jira で JQL を使用する方法についていくつかご紹介します。

ユースケース

JQL クエリ

自分に割り当てられた優先度の高い課題をすべて検索する

priority = High AND assignee = currentUser()

特定のプロジェクトの期限切れの課題を一覧表示する

project = "カスタマー サポート" AND duedate < now() AND status != Closed

最近作成された課題を表示する

created >= -7d ORDER BY created DES

高度な JQL テクニック

カスタム フィールドや複雑なクエリを活用するには、JQL による高度な検索を使用します。

手法

例

使い方

カスタム フィールドの使用

"カスタム フィールド名" ~ "検索語句"

カスタム フィールド内を検索して、よりカスタマイズされたクエリを可能にします。

サブクエリ

project IN subTaskIssueTypes() AND assignee = currentUser()

別のクエリの結果に基づいて課題をフィルタリングします。

特定の課題タイプ

issuetype = Epic AND status != Done

特定の課題タイプとステータスを対象にします。

検索を実行する前にミスを見つける方法

JQL エディタでのエラーの検出

Jira Cloud の現在の JQL エディターは、検索を実行した後ではなく、入力中に問題を見つけるように構築されています。

  • エラー チェック: 無効な構文はすぐにフラグが付けられ、修正するためのガイダンスが表示される

  • 構文ハイライト: フィールド、演算子、値、関数は色分けされる

  • オートコンプリート: 入力中に関連するキーワードや関数が表示される

  • 複数行の編集: エディターを展開し、行番号を使用してエラーを見つける

  • 読みやすいユーザー参照: 生のアカウント ID の代わりに名前とアバターが表示される

  • JQL デバッガー: クエリがエラーを返した場合、Rovo によってユーザーがレビューして承認できる修正済みのクエリが提案される

Rovo による検索

正確な検索を実行するために、上記の JQL 構文を覚える必要はありません。アトラシアンの AI である Rovo は、入力した内容を自動的に JQL に変換します。Jira の検索バーから [Rovo に質問] を選択し、普段話すような自然な言葉で質問を入力してください。次に例を示します。

「今月モバイル アプリ プロジェクトで報告されたすべてのバグを検索してください」

Rovo はそれを一致する JQL に変換して検索を実行し、結果と生成された JQL の両方を下に表示します。この最後の部分は重要です。なぜなら、平易な日本語で入力した質問がどのフィールド、演算子、関数にマッピングされたかを正確に確認できるため、実例を通して JQL を学ぶ上で非常に役立つ方法だからです。クエリが複雑すぎて Rovo が基本モードで解決できない場合、自動的に JQL モードに切り替わり、より正確な結果を提供します。その他の操作メニューからいつでも [基本] に切り替えることができます。

Rovo 検索が最も効果的な場合

直接 JQL に切り替えるタイミング

探したいものは大体わかっているが、正確なフィールド名や構文がわからない場合

保存されたフィルター、ボード、またはダッシュボードに正確で繰り返し使用できるクエリが必要なとき

日常的な言葉や、作業項目、スペース、またはボードのキーワードを使用して検索している場合

クエリに、自然言語では確実に表現できない関数やロジックが必要なとき

JQL 構文を使いながら学びたい場合

英語以外の言語で検索しているとき

JQL: よくある質問

Jira で特定の課題を検索するために、JQL はどのように役立ちますか?

JQL を使用すると、担当者、ステータス、プロジェクト、日付などのフィールドで課題をフィルタリングするカスタム クエリを作成できるため、最も重要な課題をすばやく見つけることができます。

JQL クエリを保存してチームと共有できますか?

JQL 検索をフィルターとして保存してチーム メイトと共有することで、全員が一連の同じ課題に簡単にアクセスできるようになります。

プロジェクト管理における JQL の一般的なユース ケースにはどのようなものがありますか?

チームは多くの場合、JQL を使用して期限切れのタスクを追跡し、スプリントの進捗を監視し、ブロッカーを特定して、ワークフローに合ったレポートを生成します。

より高度な JQL クエリを作成するためのヒントはありますか?

演算子や関数を使用し、AND/OR で複数の条件を組み合わせることで、詳細な課題トラッキングとレポート作成のための複雑なクエリを構築できます。