Jira Cloud の高度な検索とは

The advanced search allows you to build structured queries using the Jira Query Language (JQL) to search for work items. You can specify criteria that you can't define in the quick or basic searches. For example, you can use the ORDER BY clause in JQL when you’re searching for work items. JQL can help gain key space insights and help you find not just work items but also important information in spaces.

JQL は SQL に似た構文を使用しますが、データベース クエリ言語ではありません。詳細検索では、作業項目を見つけるためにクエリを使用できます。クエリは、フィールド、演算子、値などの一連の要素またはパーツをつなぎ合わせて構造を形成したものです。JQL クエリの構築に関する詳細をご確認ください。

JQL を使用すると、スペース「Assassin's Guild」で次のすべての作業項目を検索することができます。

• テキスト フィールドに「weaponry」と入力されていて、

• created になった時点に応じて昇順または降順で表示される

1. 基本と JQL を切り替える

2. JQL エディター

3. エディターを展開する/折りたたむ

4. 構文ヘルプ

5. [検索] ボタン

6. JQL クエリが 1 行よりも長い場合の行番号

7. コンテキストに基づくオートコンプリート提案

JQL クエリで詳細検索を実行する

構文を利用した詳細検索または JQL は、スペースから特定の情報を取得するための強力なツールです。

高度な検索または JQL を使用して作業項目を検索するには、次の手順に従います。

1. 上部のナビゲーションで [検索] (🔍) を選択します (または、キーボードで / を押します)。または、サイドバーで [フィルター] を選択します。

2. [すべての作業項目を表示] を選択します。

   • 詳細検索ではなく基本検索が表示されている場合は、[JQL] (🔍 アイコンの横) を選択します。詳細検索または JQL 検索がすでに有効である場合は、基本検索に切り替えるオプションが表示されます。

3. JQL クエリを入力します。

4. Enter キーを押すか 🔍 を選択して、クエリを実行します。検索結果は、JQL クエリの条件に基づいて表示されます。

JQL クエリを構築する

JQL クエリの構築方法を学んで、詳細検索を最大限に活用しましょう。シンプルな JQL クエリ (「句」とも呼ばれる) は、フィールドと、それに続く演算子、1 つ以上の値または関数で構成されます。

例:

このクエリは "TEST" プロジェクト内のすべての作業項目を検索します。「プロジェクト」フィールド、EQUALS 演算子、値 "TEST" を使用します。

より複雑なクエリには以下のようなものがあります。

このクエリは "TEST" プロジェクト内のすべての作業項目のうち、現在ログインしているユーザーが担当者であるものを検索します。"プロジェクト" フィールド、EQUALS 演算子、値 "TEST",、"AND" キーワード、および "currentuser()" 関数を使用します。

演算子の優先順位を設定する

複雑な JQL で優先順位を設定したいときには丸括弧を使用できます。

たとえば、'Sysadmin' プロジェクトにあるすべての解決した作業項目と、システム管理者 (bobsmith) に現在割り当てられているすべての作業項目を (あらゆるステータスとあらゆるプロジェクトを対象として) 検索する場合、括弧を使用して boolean 演算子の優先順位をクエリ内で強制できます。

制限されている言葉および文字

特殊文字

一般に、+ . , * / % ^ $ # @ [ ]などの英数字以外の文字は、検索用のインデックスが作成されず、クエリで無視されます。例外には、メール アドレスと URL が含まれます。

クエリを作成する際は、特殊文字やスペースでフレーズを一重引用符'または二重引用符"で囲むようにしてください (例: field ~ "email@atlassian.com")。また、一部の文字では 2 つのバックスラッシュ \\ を付ける必要がある場合があります (例: field ~ "\\(text")。

予約語

また、JQL には予約語のリストが用意されています。これらの単語をクエリで使用する場合は、引用符 (一重または二重) で囲む必要があります。

"a", "an", "abort", "access", "add", "after", "alias", "all", "alter", "and", "any", "are", "as", "asc", "at", "audit", "avg", "be", "before", "begin", "between", "boolean", "break", "but", "by", "byte", "catch", "cf", "char", "character", "check", "checkpoint", "collate", "collation", "column", "commit", "connect", "continue", "count", "create", "current", "date", "decimal", "declare", "decrement", "default", "defaults", "define", "delete", "delimiter", "desc", "difference", "distinct", "divide", "do", "double", "drop", "else", "empty", "encoding", "end", "equals", "escape", "exclusive", "exec", "execute", "exists", "explain", "false", "fetch", "file", "field", "first", "float", "for", "from", "function", "go", "goto", "grant", "greater", "group", "having", "identified", "if", "immediate", "in", "increment", "index", "initial", "inner", "inout", "input", "insert", "int", "integer", "intersect", "intersection", "into", "is", "isempty", "isnull", "it", "join", "last", "left", "less", "like", "limit", "lock", "long", "max", "min", "minus", "mode", "modify", "modulo", "more", "multiply", "next", "no", "noaudit", "not", "notin", "nowait", "null", "number", "object", "of", "on", "option", "or", "order", "outer", "output", "power", "previous", "prior", "privileges", "public", "raise", "raw", "remainder", "rename", "resource", "return", "returns", "revoke", "right", "row", "rowid", "rownum", "rows", "select", "session", "set", "share", "size", "sqrt", "start", "strict", "string", "subtract", "such", "sum", "synonym", "table", "that", "the", "their", "then", "there", "these", "they", "this", "to", "trans", "transaction", "trigger", "true", "uid", "union", "unique", "update", "user", "validate", "values", "view", "was", "when", "whenever", "where", "while", "will", "with"

JQL のタイプ

制限付き JQL クエリ

制限付き JQL とは、検索制限を必要とする JQL を指します。JQL には少なくとも 1 つの条件が必要です。その左側に "フィールド" の後に演算子、1 つ以上の値 (または関数) が続きます。制限付きクエリの例をいくつか示します。

• project = TEST order by key; ここでは、project = TEST が JQL クエリの検索制限となります。

• reporter = currentUser(); ここでは、reporter = currentUser() が JQL クエリの検索制限となります。

• status IN ("To Do", "IN PROGRESS") AND priority >= Medium ORDER BY created; ここでは、status IN ("To Do", "IN PROGRESS") と priority >= Medium が JQL クエリの検索制限となります。

無制限の JQL クエリ

一方、無制限の JQL は、検索制限のない JQL です。空のクエリや、order by 句のみをリストするクエリを使用できます。例:

• order by createdDate

• order by key

テキスト検索を実行する

以下のフィールドで検索を実行する場合、CONTAINS 演算子を使用してテキスト検索機能を利用することができます。

「フリー テキスト検索ツール」を使用する要約、説明、環境、コメント、カスタム フィールド

テキスト フィールドの検索構文の使用に関する詳細をご確認ください。

詳細検索でトラブルシューティングを行う

ベーシック検索と高度な検索を切り替えられないのはなぜですか?

一般的に、簡易検索を使用して作成したクエリは、詳細な JQL 検索へ変換して再び簡易検索に戻せます。ただし、詳細な JQL 条件を使用して作成した複雑なクエリは、簡易検索に変換できない場合があります。特に次のような場合です。

• OR 演算子が含まれるクエリ。代わりに IN 演算子を使用できます。例: project in (A, B)

• NOT 演算子を含むクエリ

• EMPTY 演算子を含むクエリ

• 比較演算子 (!=、IS、IS NOT、>、>=、<、<=) を含むクエリ

• スペースに関連するフィールドと値を指定するクエリ (バージョン、コンポーネント、カスタム フィールドなど) で、そのスペースが明確に指定されていないクエリ (例: fixVersion = "4.0" に AND project=JRA の指定がない場合)。カスタム フィールドはスペース / 作業タイプ ベースで構成されるため、この制限の影響を受けやすくなることにご注意ください。一般に、基本検索で作成できないクエリを、高度な検索から基本検索に変換することで作成することはできません。

オートコンプリートの候補を表示できないのはなぜですか?

• ご利用の Jira インスタンスで管理者が JQL のオートコンプリート機能を無効にしているかも可能性があります。

• オートコンプリートは、関数パラメーターでは利用できません。

• オートコンプリートの候補は、すべてのフィールドで表示されるわけではありません。フィールド リファレンスをチェックして、どのフィールドがオートコンプリートに対応しているかをご確認ください。

JQL クエリのエラーはどこで確認できますか?

入力中にクエリ内の無効なテキストにカーソルを合わせると、JQL エラーの詳細を表示できます。また、JQL クエリにエラーがある場合、[検索] を押すと Jira は JQL エディターの下にクエリ内の無効なテキストの行と文字番号と併せてエラーの詳細を表示します。

JQL クエリのエラーはどのようにして修正できますか?

クエリを実行し、JQL エディターの下にエラー メッセージがないか確認します。次の方法で JQL エラーを修正できます。

• フィールドの不足、演算子の誤り、タイプミスなどの問題を手動で特定して修正する

• AI が生成したエラーのないクエリ提案を確認し、[承認] を選択して即座に適用する