クラウド
Data Center
バージョン

Advanced searching 1

Searching for issues 1

このページの内容

関連コンテンツ

  • 関連コンテンツがありません

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

このヘルプ ページの内容について

従来のスクラムおよびカンバン プロジェクトを使用している場合、このページをお読みください。

アジリティ プロジェクト / 新しい Jira Software の一部である次世代プロジェクトを使用している場合、こちらのページをご参照ください。

プロジェクトが不明な場合、プロジェクト メニューをご確認ください。[フィードバックを提供] および [さらに読む] メニュー項目がある場合、そのプロジェクトは次世代プロジェクトであり、このページの内容は適用されません。




The advanced search allows you to build structured queries using the Jira Query Language (JQL)  to search for issues. You can specify criteria that cannot be defined in the quick or basic searches (e.g. ORDER BY clause). 

  • If you don't have complex search criteria, you may want to use the quick search instead.
  • If you are not comfortable with the Jira Query Language (JQL), you may want to use the basic search instead.

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

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

On this page:

詳細検索

  1. Click the Jira icon in the navigation bar

     
  2. Click Issues > Search.

    • If the basic search is shown instead of the advanced search, click Advanced (next to the  icon)

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

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

      • クエリに 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 の指定がない場合)。カスタム フィールドはプロジェクト / 課題タイプ レベルで構成されるため、この制限の影響を受けやすくなることににご注意ください。一般に、ベーシック検索で作成できないクエリを、詳細検索からベーシック検索に変換することで作成することはできません。

  3. Enter your JQL query. As you type, 

    Jira Software

     will offer a list of "auto-complete" suggestions based on the context of your query. Note, auto-complete suggestions only include the first 15 matches, displayed alphabetically, so you may need to enter more text if you can't find a match.

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

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

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

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

JQL クエリの構築

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

project = "TEST"

This query will find all issues in the "TEST" project. It uses the "project" field, the EQUALS operator, and the value "TEST".

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

project = "TEST" AND assignee = currentuser()

This query will find all issues in the "TEST" project where the assignee is the currently logged in user. It uses the "project" field, the EQUALS operator, the value "TEST",the "AND" keyword and the "currentuser()" function.

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

演算子の優先順位の設定

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

For example, if you want to find all resolved issues in the 'SysAdmin' project as well as all issues (any status, any project) currently assigned to the system administrator (bobsmith), you can use parentheses to enforce the precedence of the boolean operators in your query, i.e.

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

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

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

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

予約文字

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

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

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

例:

  • 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 のテキスト検索機能を利用できます。

Summary, Description, Environment, Comments, custom fields which use the "Free Text Searcher" (i.e. custom fields of the following built-in custom field types: Free Text Field, Text Field, Read-only Text Field).

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

既存の開発情報を使用して課題を検索する

Previously, searching for issues with existing commits and pull requests via a JQL filter included searches such as issue.property[development].commits and issue.property[development].prs.

現在の Jira の最新インフラストラクチャでは、次のような最新の JQL 検索が必要です:

  • development[pullrequests].all (または .open) 
  • development[commits].all
  • development[reviews].all (または .open)
  • development[builds].failing


リファレンス


説明 リファレンスクイックリンク
フィールドJQL におけるフィールドとは、Jira フィールド (または Jira で定義済みのカスタム フィールド) です。フィールド リファレンス ページ 
フィールドの一覧を表示する

 

演算子An operator in JQL is one or more symbols or words which compares the value of a field on its left with one or more values (or functions) on its right, such that only true results are retrieved by the clause. Some operators may use the NOT keyword.演算子リファレンス ページ
演算子の一覧を表示する

 

キーワード

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

  • 2 つ以上の句を結合して複雑な JQL クエリを形成する
  • 1 つ以上の句のロジックを変更する
  • 演算子のロジックを変更する
  • JQL クエリ内に明確な定義がある
  • JQL クエリの結果を変更する特定の関数を実行する
キーワード リファレンス ページ
キーワード一覧を表示する

 

関数

A function in JQL appears as a word followed by parentheses which may contain one or more explicit values or Jira fields.

A function performs a calculation on either specific Jira data or the function's content in parentheses, such that only true results are retrieved by the function and then again by the clause in which the function is used.

関数 リファレンス ページ
関数の一覧を表示する

Error rendering macro 'excerpt-include'

No link could be created for '.Advanced searching - Functions reference vprepub'.

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

Saved searches (also known as filters) are shown in the left panel, when using advanced search. If the left panel is not showing, hover your mouse over the left side of the screen to display it.

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

次のステップ

お困りですか? 必要な回答がドキュメントで見つからなかった場合、他のリソースもご利用いただけます。「ヘルプの活用」をご参照ください。

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

最終更新日 2021 年 6 月 18 日

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

はい
いいえ
この記事についてのフィードバックを送信する

関連コンテンツ

  • 関連コンテンツがありません
Powered by Confluence and Scroll Viewport.