高度な検索 - キーワード参照
JQL のキーワードは、次のいずれかを行う単語または語句です。
- 2 つ以上の句を結合して複雑な JQL クエリを形成する
- 1 つ以上の句のロジックを変更する
- alters the logic of operators
- JQL クエリ内に明確な定義がある
- JQL クエリの結果を変更する特定の関数を実行する
キーワードのリスト:
AND
複数の句を組み合わせて検索を絞り込むために使用します。
Note that you can use parentheses to control the order in which clauses are executed.
例
"New office" プロジェクト内のすべてのオープンな課題を検索:
project = "New office" and status = "open"jsmith に割り当てられたオープンかつ緊急のすべての課題を検索:
status = open and priority = urgent and assignee = jsmithjsmith に割り当てられていない、特定のプロジェクト内のすべての課題を検索:
project = JRA and assignee != jsmith複数のプロジェクトにおいて、複数のバージョン番号で構成される特定のリリースに対するすべての課題を検索:
project in (JRA,CONF) and fixVersion = "3.14"報告者と担当者が Jack、Jill、John のいずれでもないすべての課題を検索:
reporter not in (Jack,Jill,John) and assignee not in (Jack,Jill,John)
^top of keywords | ^^top of topic
または
複数の句を組み合わせて検索範囲を広げるために使用します。
Note that you can use parentheses to control the order in which clauses are executed.
(Note: also see IN, which can be a more convenient way to search for multiple values of a field.)
例
jsmith または jbrown のいずれかが作成したすべての課題を検索:
reporter = jsmith or reporter = jbrown期限切れまたは期限が設定されていないすべての課題を検索:
duedate < now() or duedate is empty
^top of keywords | ^^top of topic
NOT
Used to negate individual clauses or a complex JQL query (a query made up of more than one clause) using parentheses, allowing you to refine your search.
(Note: also see NOT EQUALS ("!="), DOES NOT CONTAIN ("!~"), NOT IN and IS NOT.)
例
jsmith 以外のすべてのユーザーに割り当てられたすべての課題を検索:
not assignee = jsmithjsmith または jbrown が作成していないすべての課題を検索:
not (reporter = jsmith or reporter = jbrown)
^top of keywords | ^^top of topic
EMPTY
Used to search for issues where a given field does not have a value. See also NULL.
Note that EMPTY can only be used with fields that support the IS and IS NOT operators. To see a field's supported operators, check the individual field reference.
例
Find all issues without a DueDate:
duedate = emptyまたは
duedate is empty
^top of keywords | ^^top of topic
NULL
Used to search for issues where a given field does not have a value. See also EMPTY.
Note that NULL can only be used with fields that support the IS and IS NOT operators. To see a field's supported operators, check the individual field reference.
例
Find all issues without a DueDate:
duedate = nullまたは
duedate is null
^top of keywords | ^^top of topic
ORDER BY
検索結果の並び順の基準として使用する値を持つフィールドを指定するために使用します。
既定では、フィールド独自の並び順が使用されます。昇順 (asc) または降順 (desc) を指定することで、この順序を上書きできます。
例
Find all issues without a DueDate, sorted by CreationDate:
duedate = empty order by createdFind all issues without a DueDate, sorted by CreationDate, then by Priority (highest to lowest):
duedate = empty order by created, priority descFind all issues without a DueDate, sorted by CreationDate, then by Priority (lowest to highest):
duedate = empty order by created, priority asc
Ordering by Components or Versions will list the returned issues first by Project and only then by the field's natural order (see JRA-31113).