Jira の使用を開始する
Jira を使用するのが初めての場合は、新たに管理者やユーザーになった方を対象としたガイドをご覧ください。
ここでは高度な検索に使用するキーワードに関する情報について説明します。JQL のキーワードは、次のうちいずれかに当てはまる単語または語句となります。
2 つ以上の句を結合して複雑な JQL クエリを形成する
1 つ以上の句のロジックを変更する
演算子のロジックを変更する
JQL クエリ内に明確な定義がある
JQL クエリの結果を置き換える特定の関数を実行する。
複数の句を組み合わせて検索を絞り込むために使用します。
括弧を使用することで句の実行順序を制御できます。
例
"New office" プロジェクト内のすべてのオープンな課題を検索:
1
project = "New office" and status = "open"
jsmith に割り当てられたオープンかつ緊急のすべての課題を検索:
1
status = open and priority = urgent and assignee = jsmith
jsmith に割り当てられていない、特定のプロジェクト内のすべての課題を検索:
1
project = JRA and assignee != jsmith
複数のプロジェクトにおいて、複数のバージョン番号で構成される特定のリリースに対するすべての課題を検索:
1
project in (JRA,CONF) and fixVersion = "3.14"
報告者と担当者が Jack、Jill、John のいずれでもないすべての課題を検索:
1
reporter not in (Jack,Jill,John) and assignee not in (Jack,Jill,John)
複数の句を組み合わせて検索範囲を広げるために使用します。
括弧を使用することで句の実行順序を制御できます。
(注: あわせて IN もご確認ください。フィールドで複数の値を検索する場合はこちらのほうが便利である可能性があります)
例
jsmith または jbrown のいずれかが作成したすべての課題を検索:
1
reporter = jsmith or reporter = jbrown
期限切れまたは期限が設定されていないすべての課題を検索:
1
duedate < now() or duedate is empty
個別の句、または括弧を使用した複雑な JQL クエリ (複数の句で構成されたクエリ) の否定に使用して、検索精度を高めることができます。
(注: NOT EQUALS ("!=")、DOES NOT CONTAIN ("!~")、NOT IN、IS NOT についてもご確認ください)
例
jsmith 以外のすべてのユーザーに割り当てられたすべての課題を検索:
1
not assignee = jsmith
jsmith または jbrown が作成していないすべての課題を検索:
1
not (reporter = jsmith or reporter = jbrown)
指定されたフィールドに値が入力されていない課題を検索するために使用します。NULL についてもご確認ください。
EMPTY は、IS および IS NOT 演算子をサポートしているフィールドでのみ使用できます。フィールドがサポートする演算子については、個々のフィールド リファレンスを確認してください。
例
期限が設定されていないすべての課題を検索:
1
duedate = empty
または
1
duedate is empty
指定されたフィールドに値が入力されていない課題を検索するために使用します。EMPTY についてもご確認ください。
NULL は、IS および IS NOT 演算子をサポートしているフィールドでのみ使用できます。フィールドがサポートする演算子については、個々のフィールド リファレンスを確認してください。
例
期限が設定されていないすべての課題を検索:
1
duedate = null
または
1
duedate is null
検索結果をその値に基づいて並べ替えるフィールドを指定するために使用します。この要件は JQL クエリの最後に記述する必要があります。そうしないと、JQL は無効になります。
既定では、フィールド独自の並び順が使用されます。昇順 (asc) または降順 (desc) を指定することで、この順序をオーバーライドできます。
例
期限が設定されていないすべての課題を検索し、 作成日順に並べ替え:
1
duedate = empty order by created
期限が設定されていないすべての課題を検索し、作成日、および優先度 (最高から最低へ) で並べ替え:
1
duedate = empty order by created, priority desc
期限が設定されていないすべての課題を検索し、作成日、および優先度 (最低から最高へ) で並べ替え:
1
duedate = empty order by created, priority asc
コンポーネントまたはバージョン順に並べると、課題はプロジェクト、フィールドの順に並べられます (JRA-31113をご参照ください)。
この内容はお役に立ちましたか?