robotsnoindex

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

tip/resting Created with Sketch.

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

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

Jira のチーム管理対象プロジェクトを使用する? チーム管理対象プロジェクトは現在も開発中のため、以下に記載されている機能には (まだ) アクセスできないものもある場合があります。

JQL を使用して課題を検索する

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

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

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

プロジェクトで JQL を使用して課題を検索する

Jira クエリ言語 (JQL) を使用して構造化クエリを構築し、プロジェクト内の課題を検索できます。クイック検索や基本検索では定義できない検索条件を指定できます (例: ORDER BY 句)。 

JQL は SQL に似た構文を使用しますが、データベース クエリ言語ではありません。高度な JQL 検索の詳細をご確認ください

JQL を使用して課題を検索するには、次の手順に従います。

  1. プロジェクトのサイドバーから [課題] を選択します。

  2. 基本検索モードの場合は [JQL] を選択します。

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

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

クエリを入力すると、Jira は入力中のクエリのコンテキストに基づいた「オートコンプリート」候補のリストを表示します。オートコンプリート候補はアルファベット順に最初の 15 件のみを表示するため、探しているものが候補に表示されない場合はさらに文字を追加する必要がある場合があります。また、Jira はクエリにエラーがあるかどうかを通知します。

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

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

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

  1. 基本または JQL の切り替え

  2. JQL エディター

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

  4. 構文ヘルプ

  5. [検索] ボタン

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

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

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

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

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

この方法では、テキスト フィールド内の多くの特殊文字を検索できません。検索構文を使用したテキスト フィールドに関する詳細をご確認ください

予約語

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"

テキスト検索の実施

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

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

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

フィールド

JQL におけるフィールドとは、Jira フィールド (または Jira で定義済みのカスタム フィールド) のことを指します。フィールドを使用した詳細検索の詳細をご確認ください

演算子

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

キーワード

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

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

キーワードを使用した詳細検索の詳細をご確認ください

関数

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

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

関数を使用した詳細検索の詳細をご確認ください

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

保存した検索 (フィルターとして保存) は、高度な検索の利用時に、サイドバーに表示されます。サイドバーが表示されていない場合は、カーソルを画面の左側に合わせてクリックすることで展開できます。

[オープンな担当課題] などのフィルターを実行したい場合は、フィルターをクリックします。詳細検索用の JQL が設定され、検索結果が表示されます。

トラブルシューティング

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

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