詳細検索では、Jira クエリ言語 (JQL: JIRA Query Language) を使用して構造的なクエリを作成して課題を検索できます。クイック検索やベーシック検索では定義できない検索条件を指定することができます (例: ORDER BY 句)。 

  • 複雑な検索条件でない場合は、クイック検索の代わりにこの検索を利用することができます
  • If you are not comfortable with the Jira Query Language (JQL), you may want to use basic search instead.

JQL の構文は SQL に似ていますが、データベース クエリ言語ではありません。 

スクリーンショット: 詳細検索

On this page:

詳細検索

  1. [課題] > [課題を検索] を選択します。
    • 既存の検索条件が表示されている場合、[新しいフィルター] ボタンをクリックして検索条件をリセットします。

    • ヒント: 詳細検索ではなくベーシック検索が表示されている場合、[アドバンス] (検索ボタンの横) をクリックします。

      一般に、 ベーシック検索を使用して作成したクエリを詳細検索に変換し、再度ベーシック検索に戻すことが可能です。ただし、詳細検索を使用して作成したクエリの中には、ベーシック検索に変換できないものがあります。これには次のような例があります。

      • クエリに OR 演算子が含まれる場合 (IN 演算子は含めることができ、それは変換される点にご注意ください。例: project in (A, B))。
        • クエリ(project = JRA OR project = CONF) はクエリ (project in (JRA, CONF)) と等しいですが、2 つめのクエリのみが変換されます。
      • NOT 演算子を含むクエリ
      • EMPTY 演算子を含むクエリ
      • 比較演算子 (!=、IS、IS NOT、>、>=、<、<=) を含むクエリ
      • 特定のプロジェクト固有のフィールドおよび値を指定している (バージョン、コンポーネント、カスタム フィールドなど) が、そのプロジェクト名が明確に指定されていないクエリ (例: fixVersion = "4.0" に AND project=JRA の指定がない場合)。カスタム フィールドはプロジェクト / 課題タイプ レベルで構成されるため、この制限の影響を受けやすくなることににご注意ください。一般に、ベーシック検索で作成できないクエリを、詳細検索からベーシック検索に変換することで作成することはできません。

  2. JQL クエリを入力します。Jira は、入力中の JQL のコンテキストを元にオートコンプリートの候補を表示します。オートコンプリートはアルファベット順に最初の 15 件の候補のみを表示するため、探しているものが候補に表示されないときにはさらに文字を追加することをおすすめします。

    • ご利用の Jira インスタンスで管理者が JQL のオートコンプリート機能を無効にしているかも可能性があります。
    • オートコンプリートは、関数パラメーターでは利用できません。
    • オートコンプリートは、すべてのフィールドに対して機能するわけではありません。フィールドを参照して、どのフィールドがオートコンプリートに対応しているか確認してください。
  3. Enter キーを押すか [検索] をクリックしてクエリを実行します。課題ナビゲーターに検索結果が表示されます。

詳細検索について理解する

詳細検索を最大限に活用するために、次のトピックをご参照ください。

JQL クエリの構築 | JQL クエリの優先順位 | 制限されている言葉および文字 | テキスト検索の実行

JQL クエリの構築

シンプルな JQL クエリ ('句') は、フィールドと、それに続く演算子、1 つ以上の値または関数で構成されます。例えば以下のようなものがあります。

project = "TEST"

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

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

project = "TEST" AND assignee = currentuser()

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

フィールド、演算子、キーワード、関数に関する詳細は以下の 参考 をご覧ください。

JQL クエリの優先順位

JQL クエリの優先順位は句を結合するのに使用するキーワードに依存します (例: project = “Teams in Space” などの句)。これを確認するための最も簡単な方法は、AND キーワードを 1 つのグループ句として、それらを分割する句として OR を扱うことです。AND キーワードは句をグループ化して本質的に 1 つの結合句に変換するため、他のキーワードよりも優先されます。

例 1

status=resolved AND project=“Teams in Space” OR assignee=captainjoe

このクエリは、"Teams in Space" プロジェクトのすべての解決済みの課題 (AND によってグループ化された句) と、captainjoe に割り当てられたすべての既存の課題を返します。OR キーワードに続く句は別の句として扱われます。

例 2

status=resolved OR project="Teams in Space" AND assignee=captainjoe

一方、このクエリは、"Teams in Space" プロジェクトの captainjoe の課題 (AND でグループ化された句) と、すべての既存の解決済みの課題を返します (OR で分けられた句)。

例 3

status=resolved OR projects="Teams in Space" OR assigne=captainjoe

OR キーワードのみを使用する場合、すべての句が別々に扱われ、優先順位は等しくなります。

優先順位の設定

かっこを使用すると、JQL クエリの優先順位を設定できます。かっこは特定の句をグループ化し、優先的に扱います。

例 1

以下のように、かっこで JQL クエリの優先度を変えることができます。このクエリは、"Teams in Space" プロジェクトに属しているか、captainjoe に割り当てられている、解決済みの課題を返します。

status=resolved AND (project="Teams in Space" OR assignee=captainjoe)

例 2

以下の例のようにかっこを使用した場合、かっこで囲まれた句はすでに AND で接続されているため、効果はありません。このクエリはかっこの有無にかかわらず同じ結果が得られます。

(status=resolved AND project="Teams in Space") OR assignee=captainjoe

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

予約文字

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

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

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

  • これらの文字を一重引用符(') または二重引用符 (") で囲む必要があります。
    また、

  • if you are searching a text field and the character is on the list of special characters in text searches, precede them with two backslashes. This will let you run the query that contains a reserved character, but the character itself will be ignored in your query. For more info, see Special characters in Search syntax for text fields.


例:

  • version = "[example]"
  • summary ~ "\\[example\\]"

予約語

JQL には予約語もあります。これらの言葉をクエリで利用する場合は、引用符 (シングルクォテーションもしくはダブルクォテーション) で囲む必要があります。

"abort", "access", "add", "after", "alias", "all", "alter", "and", "any", "as", "asc", "audit", "avg", "before", "begin", "between", "boolean", "break", "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", "join", "last", "left", "less", "like", "limit", "lock", "long", "max", "min", "minus", "mode", "modify", "modulo", "more", "multiply", "next", "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", "sum", "synonym", "table", "then", "to", "trans", "transaction", "trigger", "true", "uid", "union", "unique", "update", "user", "validate", "values", "view", "when", "whenever", "where", "while", "with"

Jira 管理者向けの注意: この一覧は JqlStringSupportImpl.java ファイル内でハードコードされています。

テキスト検索の実施

次のフィールドの検索時には、CONTAINS 演算子を使って Lucene のテキスト検索機能を利用できます。

概要、説明、環境、コメント、"Free Text Searcher" を使用するカスタム フィールド (組み込みのカスタム フィールド タイプのうち、フリー テキスト フィールド、テキスト フィールド、読み取り専用のテキスト フィールドを使用しているカスタム フィールド)

詳しくはテキストフィールドの検索構文を参照してください。

リファレンス


説明 リファレンス
フィールドJQL におけるフィールドとは、Jira フィールド (または Jira で定義済みのカスタム フィールド) です。

フィールド リファレンス ページ 

演算子JQL における演算子とは、その左側に記載されるフィールドと右側に記載される値とを比較する 1 文字以上の記号または文字です。句は、真となる結果のみを取得します。一部の演算子では NOT キーワードを利用できます。

演算子リファレンス ページ

キーワード

JQL のキーワードは、次のいずれかを行う単語または語句です。

  • 2 つ以上の句を結合して複雑な JQL クエリを形成する
  • 1 つ以上の句のロジックを変更する
  • 演算子のロジックを変更する
  • JQL クエリ内に明確な定義がある
  • JQL クエリの結果を変更する特定の関数を実行する

キーワード リファレンス ページ

関数

JQL における関数とは、言葉に丸括弧が続くもので、1 つ以上の値や Jira フィールドを含むことがあります。

関数は特定の Jira データまたは関数内のコンテンツの計算を実行し、関数または関数を利用する句では真となる結果のみを取得します。

関数 リファレンス ページ

保存された検索条件の実行

保存した検索（フィルターとして保存）は、高度な検索の利用時に、左側のパネルに表示されます。左側にパネルが表示されていない場合は、マウスを画面左側にかざして表示させてください。

フィルターを実行するには (例: 私のオープンな課題)、対象のフィルターをクリックします。詳細検索用の JQL が設定され、検索結果が表示されます。


次のステップ

関連トピックをご確認ください。