What is advanced search in Jira Cloud?

The advanced search allows you to build structured queries using the Jira Query Language (JQL) to search for issues. 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 issues. JQL can help gain key project insights and help you find not just issues but also important information in projects.

JQL is not a database query language, even though it uses SQL-like syntax. In advanced search, you can use queries to find your issues. Queries are a series of elements or parts, like fields, operators, and values, that are strung together to form a structure. Learn more about constructing JQL queries.

JQL を使用すると、プロジェクト「Assassin's guild」で次のすべての課題を検索できます。

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

• 作成日に応じた昇順または降順での表示

1. Switch between Basic and JQL

2. JQL エディター

3. エディターを開く/折りたたむ

4. 構文ヘルプ

5. [検索] ボタン

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

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

Perform advanced searching with JQL queries

The syntax-powered advanced search or JQL is a powerful tool for getting specific information from projects. Learn more about constructing JQL queries.

To use advanced search or JQL to find your issues:

1. Select Search 🔍 in the navigation bar (or press / on your keyboard). Alternatively, select Filters in the navigation bar.

2. [高度な課題検索] を選択します。

   • If the basic search is shown instead of the advanced search, select JQL (next to the 🔍  icon). If advanced or JQL search is already enabled, you'll see the option to switch to basic.

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

4. Press Enter or select 🔍 to run your query. Your search results will be displayed based on the criteria in your JQL query.

Construct JQL queries

Get the most out of advanced searching by learning how to structure your JQL query. A simple query in JQL (also known as a 'clause') consists of a field, followed by an operator, followed by one or more values or functions.

例:

このクエリは "TEST" プロジェクトのすべての課題を検索します。この JQL は "project" フィールドと、EQUALS 演算子と、"TEST" という値を利用しています。

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

このクエリは "TEST" プロジェクトの中で、現在ログインしているユーザーが担当者である課題を検索します。この JQL は "project" フィールド、EQUALS 演算子、"TEST", という値に加えて、"AND" キーワードと "currentuser()" 関数で構成されます。

Learn more about fields, operators, keywords and functions.

Set the precedence of operators

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

例えば、'Sysadmin' プロジェクトのすべての解決済み課題と、システム管理者 (ユーザー名は bobsmith) に割り当てられたすべての課題 (ステータスとプロジェクトは問わない) を検索する場合、以下のように括弧を使用して boolean 演算子の優先順位を設定します。

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

予約文字

JQLには次の一連の予約文字があります。

space (" ") + . , ; ? | * / % ^ $ # @ [ ]

これらの文字をクエリで利用したい場合、次のようにする必要があります。

• これらの文字を一重引用符(') または二重引用符 (") で囲む必要があります。
  また、テキスト フィールドでの検索を行おうとしていて、検索対象が予約文字の一覧に含まれる場合、

• 2 つのバックスラッシュを直前に配置します。

例:

• 1 version = "[example]"

予約語

JQL also has a list of reserved words. These words need to be surrounded by quotation marks (single or double) if you wish to use them in queries:

"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"

Perform a text search

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

Summary, Description, Environment, Comments, and custom fields that use the "Free Text Searcher"

Learn more about using search syntax for text fields

Troubleshooting in advanced search

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

一般的に、簡易検索を使用して作成したクエリは、詳細な 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 エディターの下にクエリ内の無効なテキストの行と文字番号と併せてエラーの詳細を表示します。