詳細検索
詳細検索では、Jira クエリ言語 (JQL: JIRA Query Language) を使用して構造的なクエリを作成して課題を検索できます。クイック検索やベーシック検索では定義できない検索条件を指定することができます (例: ORDER BY 句)。
- 複雑な検索条件ではない場合、クイック検索を利用することをおすすめします。
- JIRA クエリ言語 (JQL: JIRA Query Language) を使いたくない場合は、代わりにベーシック検索を利用することが出来ます。
JQL の構文は SQL に似ていますが、データベース クエリ言語ではありません。
スクリーンショット: 詳細検索
On this page:
詳細検索
- [課題] > [課題を検索] を選択します。
- 既存の検索条件が表示されている場合、[新しいフィルター] ボタンをクリックして検索条件をリセットします。
ヒント: 詳細検索ではなくベーシック検索が表示されている場合、[詳細] (
アイコンの横) をクリックします。
JQL クエリを入力します。入力中の JQL の文脈から JIRA はオートコンプリートの候補を表示します。オートコンプリートはアルファベット順に最初の 15 個の候補のみを表示するため、探しているものが候補に見つからないときはもっと多くの文字列を入力する必要があります。
- Enter キーを押すか、 をクリックしてクエリを実行します。課題ナビゲーターに検索結果が表示されます。
詳細検索について理解する
詳細検索を最大限に活用するために、次のトピックをご参照ください。
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=captainjoeOR キーワードのみを使用する場合、すべての句が別々に扱われ、優先順位は等しくなります。
優先順位の設定
かっこを使用すると、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 (" ") | + | . | , | ; | ? | | | * | / | % | ^ | $ | # | @ | [ | ] |
これらの文字をクエリで利用したい場合、次のようにする必要があります。
- これらの文字を一重引用符(
') または二重引用符 (") で囲む必要があります。
また、 - テキスト フィールドでの検索を行おうとしていて、その文字がテキスト検索の特殊文字の一覧に含まれる場合は、そのテキストの前に 2 つのバックスラッシュを付けます。こうすると、予約文字を含むクエリを実行できますが、文字自体はクエリで無視されます。詳細については、「テキスト フィールドの検索構文」の「特殊文字」を参照してください。
例:
version = "[example]"
summary ~ "\\[example\\]"
予約語
JQL には予約語もあります。これらの言葉をクエリで利用する場合は、引用符 (シングルクォテーションもしくはダブルクォテーション) で囲む必要があります。
Jira 管理者向けの注意: この一覧は JqlStringSupportImpl.java ファイル内でハードコードされています。
テキスト検索の実施
次のフィールドの検索時には、CONTAINS 演算子を使って Lucene のテキスト検索機能を利用できます。
概要、説明、環境、コメント、"Free Text Searcher" を使用するカスタム フィールド (組み込みのカスタム フィールド タイプのうち、フリー テキスト フィールド、テキスト フィールド、読み取り専用のテキスト フィールドを使用しているカスタム フィールド)
詳しくはテキスト フィールドの検索構文を参照してください。
リファレンス
| 説明 | リファレンス | |
|---|---|---|
| フィールド | JQL におけるフィールドとは、JIRA フィールド（もしくは JIRA が定義したカスタムフィールド）のことです。 | |
| 演算子 | JQL における演算子とは、その左側に記載されるフィールドと右側に記載される値とを比較する 1 文字以上の記号または文字です。句は、真となる結果のみを取得します。一部の演算子では NOT キーワードを利用できます。 | |
| キーワード | JQL のキーワードは、次のいずれかを行う単語または語句です。
| |
| 関数 | JQL における関数は、言葉のあとに丸括弧が続くもので、１つ以上の値や JIRA フィールドを含むことがあります。 関数は特定の JIRA データまたは関数内のコンテンツの計算を実行するもので、関数または関数が利用される節が真となる結果だけが取得されます。 |
保存された検索条件の実行
保存した検索 (検索をフィルターとして保存) は、詳細検索の利用時に、左側のパネルに表示されます。左側にパネルが表示されていない場合は、カーソルを画面の左側に重ねて表示することができます。
フィルターを実行するには (例: 私のオープンな課題)、対象のフィルターをクリックします。詳細検索用の JQL が設定され、検索結果が表示されます。
次のステップ
関連トピックをご確認ください。
- 課題の検索
- 基本検索
- テキスト フィールドの検索構文
- JQL: 最も柔軟に JIRA を検索する方法 (アトラシアン ブログで)
- 検索条件をフィルターとして保存する
- 検索結果に対して作業する ー 課題ナビゲーターの使い方、検索結果のエクスポート方法、複数の課題の一括更新の方法、検索結果を共有する方法が説明されています。