JQL キーワード

ここでは高度な検索に使用するキーワードに関する情報について説明します。JQL のキーワードは、次のうちいずれかに当てはまる単語または語句となります。

• 2 つ以上の句を結合して複雑な JQL クエリを形成する

• 1 つ以上の句のロジックを変更する

• 演算子のロジックを変更する

• JQL クエリ内に明確な定義がある

• JQL クエリの結果を置き換える特定の関数を実行する。

AND

複数の句を組み合わせて検索を絞り込むために使用します。

括弧を使用することで句の実行順序を制御できます。

例

• "New office" スペース内のすべてのオープンな作業項目を検索:

  space = "New office" and status = "open"

• jsmith に割り当てられたオープンかつ緊急のすべての作業項目を検索:

  status = open and priority = urgent and assignee = jsmith

• Find all work items in a particular space that are not assigned to jsmith:

  space = JRA and assignee != jsmith

• 複数のスペースにおいて、複数のバージョン番号で構成される特定のリリースに対するすべての作業項目を検索:

  space in (JRA,CONF) and fixVersion = "3.14"

• 報告者と担当者が Jack、Jill、John のいずれでもないすべての作業項目を検索:

  reporter not in (Jack,Jill,John) and assignee not in (Jack,Jill,John)

または

複数の句を組み合わせて検索範囲を広げるために使用します。

括弧を使用することで句の実行順序を制御できます。

(注: あわせて IN もご確認ください。フィールドで複数の値を検索する場合はこちらのほうが便利である可能性があります)

例

• jsmith または jbrown のいずれかが作成したすべての作業項目を検索:

  reporter = jsmith or reporter = jbrown

• Find all work items that are overdue or where no due date is set:

  duedate < now() or duedate is empty

NOT

個別の句、または括弧を使用した複雑な JQL クエリ (複数の句で構成されたクエリ) の否定に使用して、検索精度を高めることができます。

(注意:  NOT EQUALS ("!="), DOES NOT CONTAIN ("!~")、NOT IN そして IS NOTについても参照してください)

例

• jsmith 以外のすべてのユーザーに割り当てられたすべての作業項目を検索:

  not assignee = jsmith

• jsmith または jbrown のいずれかが作成したすべての作業項目を検索:

  not (reporter = jsmith or reporter = jbrown)

EMPTY

指定されたフィールドに値が入力されていない作業項目を検索します。NULL についてはこちらをご覧ください。

EMPTY は、IS および IS NOT 演算子をサポートしているフィールドでのみ使用できます。フィールドがサポートする演算子については、個々のフィールドリファレンスを確認してください。

例

• 期限が設定されていないすべての作業項目を検索:

  duedate = empty

  または

  duedate is empty

NULL

指定されたフィールドに値が入力されていない作業項目を検索します。EMPTYについてはこちらをご覧ください。

NULL は、IS および IS NOT 演算子をサポートしているフィールドでのみ使用できます。フィールドがサポートする演算子については、個々のフィールドリファレンスを確認してください。

例

• 期限が設定されていないすべての作業項目を検索:

  duedate = null

  または

  duedate is null

ORDER BY

検索結果をその値に基づいて並べ替えるフィールドを指定するために使用します。この要件は JQL クエリの最後に記述する必要があります。そうしないと、JQL は無効になります。

既定では、フィールド独自の並び順が使用されます。昇順 (asc) または降順 (desc) を指定することで、この順序をオーバーライドできます。

例

• Find all work items without a DueDate, sorted by CreationDate:

  duedate = empty order by created

• 期限が設定されていないすべての作業項目を検索し、作成日、および優先度 (最高から最低へ) で並べ替え:

  duedate = empty order by created, priority desc

• DueDate がないすべての作業項目を、CreationDate でソートして、次に優先度 (最低から最高) で検索します。

  duedate = empty order by created, priority asc