詳細検索

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

tip/resting Created with Sketch.

複雑な検索条件が不要な場合は、クイック検索をお試しください。

JQL は SQL に似た構文を使用しますが、データベース クエリ言語ではありません。


Jira の次世代プロジェクトを使用していますか? 次世代プロジェクトは現在も開発中のため、以下に記載されている機能にはアクセスできない場合があります。

詳細検索

  1. Jira アイコン ( または ) > [課題とフィルター] を選択します。
  2. [課題の検索] を選択します。
    • 高度な検索ではなく簡易検索が表示されている場合、[高度な検索] ( アイコンの横) をクリックします。高度な検索がすでに有効な場合、簡易検索に切り替えるオプションが表示されています。

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

  4. Enter キーを押すか、 をクリックしてクエリを実行します。課題ナビゲーターに検索結果が表示されます。

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

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

JQL クエリの構築

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

project = "TEST"

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

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

project = "TEST" AND assignee = currentuser()

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

フィールド、演算子、キーワード、関数に関する詳細は以下のリファレンス セクションをご覧ください。

演算子の優先順位の設定

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

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

(status=resolved AND project=SysAdmin) OR assignee=bobsmith

括弧を使用しない場合、ステートメントは左から右に評価されます。

句をグループ化するために丸括弧を使うこともできます。これは NOT 演算子を使うときなどに利用します。

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

予約文字

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

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

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

例:

  • version = "[example]"

You can't search for many special characters in text fields using this method. For advanced text searches, see Search syntax for text fields.

予約語

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

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

テキスト検索の実施

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

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

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

リファレンス

フィールド

JQL におけるフィールドとは、Jira フィールド (または Jira で定義済みのカスタム フィールド) です。「詳細検索 - フィールド リファレンス」を参照してください。

演算子

JQL における演算子とは、その左側に記載されるフィールドと右側に記載される 1 つ以上の値 (または関数) とを比較する、1 文字以上の記号または文字です。この句で真となる結果のみが返されます。一部の演算子では NOT キーワードを利用できます。「詳細検索 - 演算子リファレンス」を参照してください。

キーワード

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

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

See Advanced searching - keywords reference for more.

関数

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

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

See Advanced searching - functions reference for more.

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

保存した検索(フィルターとして保存)は、高度な検索の利用時に、サイドバーに表示されます。サイドバーが表示されていない場合は、マウスを画面左側にかざし、展開してください。

例えばMy Open Issuesというフィルターを実行するには、これを単にクリックします。高度な検索の画面が開いて JQL が設定され、検索結果が表示されます。

トラブルシューティング

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

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

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

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

  • ご利用の Jira インスタンスで管理者が JQL のオートコンプリート機能を無効にしているかも可能性があります。
  • オートコンプリートは、関数パラメーターでは利用できません。
  • オートコンプリートはすべてのフィールドで利用できるわけではありません。オートコンプリートに対応しているフィールドについては「フィールド リファレンス」をご参照ください。
最終更新日: 2019 年 12 月 11 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.