詳細検索 - 演算子リファレンス

Created by Magdalena Michalak on Sep 09, 2019

このページでは、詳細検索で使用される演算子の情報について説明します。

JQL の演算子は 1 つ以上の記号または単語から構成されており、その左のフィールドの値と右側の 1 つ以上の値 (または関数) を比較し、条件によって TRUE の結果のみを取得します。一部の演算子では NOT キーワードを使用する場合があります。

EQUALS: =

The "=" operator is used to search for issues where the value of the specified field exactly matches the specified value. (Note: cannot be used with text fields; see the CONTAINS operator instead.)

To find issues where the value of a specified field exactly matches multiple values, use multiple "=" statements with the AND operator.

例

jsmith が作成したすべての課題を検索:
```
reporter = jsmith
```
John Smith が作成したすべての課題を検索:
```
reporter = "John Smith"
```

^{^ ページのトップへ}

On this page:

NOT EQUALS: !=

The "!=" operator is used to search for issues where the value of the specified field does not match the specified value. (Note: cannot be used with text fields; see the DOES NOT MATCH ("!~") operator instead.)

field != value と NOT field = value は同じであることにご注意ください。また、field != EMPTY と field IS_NOT EMPTY も同じです。

"!=" 演算子は、値を持たないフィールド (空のフィールド) は照合しません。例えば、component != fred は、コンポーネントを持ち、かつ、コンポーネントが "fred" ではない課題のみを照合します。"fred" 以外のコンポーネントを持つ課題とコンポーネントを持たない課題を検索するには、component != fred or component is empty と入力する必要があります。

例

jsmith 以外のすべてのユーザーに割り当てられたすべての課題を検索:
```
not assignee = jsmith
```
または
```
assignee != jsmith
```
jsmith に割り当てられていないすべての課題を検索:
```
assignee != jsmith or assignee is empty
```
自分以外が報告した、自分に割り当てられていないすべての課題を検索:
```
reporter = currentUser() and assignee != currentUser()
```
報告社または担当者が John Smith 以外のすべてのユーザーであるすべての課題を検索:
```
assignee != "John Smith" or reporter != "John Smith"
```
未割り当てのすべての課題を検索:
```
assignee is not empty
```
または
```
assignee != null
```

^{^ ページのトップへ}

GREATER THAN: >

">" 演算子は、指定したフィールドの値が指定した値よりも大きい課題の検索に使用します。

">" 演算子は順序をサポートしているフィールド (日付フィールド、バージョンフィールドなど) でのみ使用でき、テキストフィールドでは使用できないことにご注意ください。フィールドでサポートされる演算子については、個々のフィールドのリファレンスを確認してください。

例

投票数が 4 票より多いすべての課題を検索:
```
votes > 4
```
期限切れのすべての課題を検索:
```
duedate < now() and resolution is empty
```
優先度が "Normal" より高いすべての課題を検索:
```
priority > normal
```

^{^ ページのトップへ}

GREATER THAN EQUALS: >=

">=" 演算子は、指定したフィールドの値が指定した値以上である課題の検索に使用します。

">=" 演算子は順序をサポートしているフィールド (日付フィールド、バージョンフィールドなど) でのみ使用でき、テキストフィールドでは使用できないことにご注意ください。フィールドでサポートされる演算子については、個々のフィールドのリファレンスを確認してください。

例

投票数が 4 票以上のすべての課題を検索:
```
votes >= 4
```
期限が 2008 年 12 月 31 日以降のすべての課題を検索:
```
duedate >= "2008/12/31"
```
過去 5 日間に作成されたすべての課題を検索:
```
created >= "-5d"
```

^{^ ページのトップへ}

LESS THAN: <

"<" 演算子は、指定したフィールドの値が指定した値よりも小さい課題の検索に使用します。

"<" 演算子は順序をサポートしているフィールド (日付フィールド、バージョンフィールドなど) でのみ使用でき、テキストフィールドで使用できないことにご注意ください。フィールドでサポートされる演算子については、個々のフィールドのリファレンスを確認してください。

例

投票数が 4 票より少ないすべての課題を検索:
```
votes < 4
```

^{^ ページのトップへ}

LESS THAN EQUALS: <=

"<=" 演算子は、指定したフィールドの値が指定した値以下である課題の検索に使用します。

"<=" 演算子は順序をサポートしているフィールド (日付フィールド、バージョンフィールドなど) でのみ使用でき、テキストフィールドで使用できないことにご注意ください。フィールドでサポートされる演算子については、個々のフィールドのリファレンスを確認してください。

例

投票数が 4 票以下のすべての課題を検索:
```
votes <= 4
```
過去 1 ヶ月間 (30 日間) 更新されなかったすべての課題を検索:
```
updated <= "-4w 2d"
```

^{^ ページのトップへ}

IN

"IN" 演算子は、指定したフィールドの値が対象となる複数の値のいずれかである課題を検索するために使用します。値は、括弧で囲んだカンマ区切りのリスト形式で指定します。

"IN" は、複数の EQUALS (=) ステートメントを使用した場合と同じ結果を返しますが、より短く、便利です。つまり、reporter IN (tom, jane, harry) と reporter = "tom" OR reporter = "jane" OR reporter = "harry" は同じです。

例

jsmith、jbrown、jjones のいずれかが作成したすべての課題を検索:
```
reporter in (jsmith,jbrown,jjones)
```
報告者または担当者が Jack または Jill であるすべての課題を検索:
```
reporter in (Jack,Jill) or assignee in (Jack,Jill)
```
バージョン 3.14 またはバージョン 4.2 のすべての課題を検索:
```
affectedVersion in ("3.14","4.2")
```

^{^ ページのトップへ}

NOT IN

"NOT IN" 演算子は、指定したフィールドの値が対象となる複数の値に含まれない課題を検索するために使用します。

"NOT IN" は、複数の NOT_EQUALS (!=) ステートメントを使用した場合と同じ結果を返しますが、より短く、便利です。つまり、reporter NOT IN (tom, jane, harry) と reporter != "tom" AND reporter != "jane" AND reporter != "harry" は同じです。

"NOT IN" 演算子は、値を持たないフィールド (空のフィールド) は照合しません。例えば、assignee not in (jack,jill) は、担当者を持ち、かつ、担当者が "jack" または "jill" ではない課題を照合します。"jack" または "jill" 以外に割り当てられた課題や未割り当ての課題を検索するには、assignee not in (jack,jill) or assignee is empty と入力する必要があります。

例

Jack、Jill、または John 以外の担当者を持つすべての課題を検索:
```
assignee not in (Jack,Jill,John)
```
担当者が Jack、Jill、または John でははないすべての課題を検索:
```
assignee not in (Jack,Jill,John) or assignee is empty
```
"A"、"B"、"C"、または "D" 以外の修正バージョンを持つすべての課題を検索:
```
FixVersion not in (A, B, C, D)
```
修正バージョンが "A"、"B"、"C"、または "D" ではない、または修正バージョンが指定されていないすべての課題を検索:
```
FixVersion not in (A, B, C, D) or FixVersion is empty
```

^{^ ページのトップへ}

CONTAINS: ~

"~" 演算子は、指定したフィールドの値が指定した値と一致する課題の検索に使用します (完全一致またはあいまい一致。以降の例を参照)。次のように、バージョンおよびテキストフィールドでのみ使用できます。

テキストフィールド:

要約
説明
環境
コメント
"フリーテキスト検索" を使用するカスタムフィールド。これには、次の組み込みカスタムフィールドタイプのカスタムフィールドが含まれます。
- フリーテキストフィールド (無制限のテキスト)
- テキストフィールド (255 文字までのテキスト)
- 読み取り専用テキストフィールド

バージョンフィールド:

対象バージョン
修正バージョン
"バージョンピッカー" を使用するカスタムフィールド

JQL フィールド "text" (例: text ~ "some words") は、課題の要約、説明、環境、コメントを検索します。また、すべてのテキストカスタムフィールドも検索します。テキストカスタムフィールドが多数ある場合は、特定のフィールドを検索することで、クエリのパフォーマンスを改善できます。例:
Summary ~ "some words" OR Description ~ "some words"

Note: when using the "~" operator, the value on the right-hand side of the operator can be specified using Jira text-search syntax.

例

要約に "win" の単語 (または "wins" などの指定した語を含む単語) を含むすべての課題を検索:
```
summary ~ win
```
バージョンフィールドの場合、~ 演算子は完全一致を返すことにご注意ください。たとえば、バージョン "9.0" を検索するには、以下のクエリを使用します。
```
fixVersion ~ "9.0"
```
要約に "win" の単語のワイルドカード一致を含むすべての課題を検索:
```
summary ~ "win*"
```
要約に ”issue" および "collector" の単語を含むすべての課題を検索:
```
summary ~ "issue collector"
```
概要に、"full screen" の語句の完全一致が含まれる課題をすべて検索する（引用符とその他の特殊文字のエスケープ方法についての詳細は、「テキストフィールドの構文を検索する」を参照してください）。
```
summary ~ "\"full screen\""
```
修正バージョンフィールドにバージョン "9" のワイルドカード一致を含むすべての課題 (9.1 や 9.0.1 など) を検索:
```
fixVersion ~ "9*"
```
修正バージョンフィールドに "9" を含むすべての課題 (0.9.1 や 9.1 など) を検索:
```
fixVersion ~ "*9*"
```

^{^ ページのトップへ}

DOES NOT CONTAIN: !~

"!~" 演算子は、指定したフィールドの値が指定した値と一致する課題の検索に使用します。次のように、バージョンおよびテキストフィールドでのみ使用できます。

テキストフィールド:

要約
説明
環境
コメント
"フリーテキスト検索" を使用するカスタムフィールド。これには、次の組み込みカスタムフィールドタイプのカスタムフィールドが含まれます。
- フリーテキストフィールド (無制限のテキスト)
- テキストフィールド (255 文字までのテキスト)
- 読み取り専用テキストフィールド

バージョンフィールド:

対象バージョン
修正バージョン
"バージョンピッカー" を使用するカスタムフィールド

JQL フィールド "text" (例: text ~ "some words") は、課題の要約、説明、環境、コメントを検索します。また、すべてのテキストカスタムフィールドも検索します。テキストカスタムフィールドが多数ある場合は、特定のフィールドを検索することで、クエリのパフォーマンスを改善できます。例:
Summary ~ "some words" OR Description ~ "some words"

Note: when using the "!~" operator, the value on the right-hand side of the operator can be specified using Jira text-search syntax.

例

要約に "run" の単語 (または "running" などの指定した語を含む単語) を含まないすべての課題を検索:
```
summary !~ run
```
バージョンフィールドの場合、~ 演算子は完全一致を返すことにご注意ください。たとえば、修正バージョンが "9.0" ではない課題を検索するには、以下のクエリを使用します。
```
fixVersion !~ "9.0"
```
修正バージョンフィールドに 9.x 系のバージョンを含まないすべての課題を検索:
```
fixVersion !~ "9.*"
```

^{^ ページのトップへ}

IS

The "IS" operator can only be used with EMPTY or NULL. That is, it is used to search for issues where the specified field has no value.

この演算子との互換性を持たないフィールドがあることにご注意ください。詳細については個々のフィールドリファレンスをご参照ください。

例

修正バージョンを持たないすべての課題を検索:
```
fixVersion is empty
```
または
```
fixVersion is null
```

^{^ ページのトップへ}

IS NOT

The "IS NOT" operator can only be used with EMPTY or NULL. That is, it is used to search for issues where the specified field has a value.

この演算子との互換性を持たないフィールドがあることにご注意ください。詳細については個々のフィールドリファレンスをご参照ください。

例

投票数が 1 票以上のすべての課題を検索:
```
votes is not empty
```
または
```
votes is not null
```

^{^ ページのトップへ}

WAS

"WAS" 演算子は、指定したフィールドに指定した値が存在するか、過去に存在した課題の検索に使用します。

この演算子では次の述部を使用できます:

AFTER "date"
BEFORE "date"
BY "username"
DURING ("date1","date2")
ON "date"

この演算子はフィールドの変更時にシステムで構成された値の名前 ("解決済み" など) を照合します。このオプションは値の名前に関連付けられた値 ID も照合します。つまり、"解決済み" と同時に "4" を照合します。

(注意: この演算子は、担当者、修正バージョン、優先度、報告者、解決状況、ステータスの各フィールドでのみ使用できます)

例

現在または過去のステータスが "進行中" である課題を検索:
```
status WAS "In Progress"
```
Joe Smith が 2 月 2 日より前に解決した課題を検索:
```
status WAS "Resolved" BY jsmith BEFORE "2011/02/02"
```

Joe Smith が 2010 年に解決した課題を検索:

status WAS "Resolved" BY jsmith DURING ("2010/01/01","2011/01/01")

^{^ ページのトップへ}

WAS IN

"WAS IN" 演算子は、指定したフィールドに指定した複数の値のいずれかが存在するか、過去に存在した課題を検索するために使用します。値は、括弧で囲んだカンマ区切りのリスト形式で指定します。

"WAS IN" は、複数の WAS ステートメントを使用した場合と同じ結果を返しますが、より短く、便利です。つまり、status WAS IN ('Resolved', 'Closed') と status WAS "Resolved" OR status WAS "Closed" は同じです。

この演算子では次の述部を使用できます:

AFTER "date"
BEFORE "date"
BY "username"
DURING ("date1","date2")
ON "date"

この演算子はフィールドの変更時にシステムで構成された値の名前 ("解決済み" など) を照合します。このオプションは値の名前に関連付けられた値 ID も照合します。つまり、"解決済み" と同時に "4" を照合します。

(注意: この演算子は、担当者、修正バージョン、優先度、報告者、解決状況、ステータスの各フィールドでのみ使用できます)

例

現在または過去のステータスが "Resolved" または "In Progress" であるすべての課題を検索:
```
status WAS IN ("Resolved","In Progress")
```

^{^ ページのトップへ}

WAS NOT IN

"WAS NOT IN" 演算子は、指定したフィールドの値が対象の複数の値のいずれかを持ったことがない課題を検索するために使用します。

"WAS NOT IN" は、複数の WAS_NOT ステートメントを使用した場合と同じ結果を返しますが、より短く、便利です。つまり、status WAS NOT IN ("Resolved","In Progress") と status WAS NOT "Resolved" AND status WAS NOT "In Progress" は同じです。

この演算子では次の述部を使用できます:

AFTER "date"
BEFORE "date"
BY "username"
DURING ("date1","date2")
ON "date"

この演算子は、フィールドの変更時にシステムで構成された値の名前 ("解決済み" など) を照合します。この演算子は値の名前に関連付けられた値 ID も照合します。つまり、"解決済み" と同時に "4" を照合します。

(注意: この演算子は、担当者、修正バージョン、優先度、報告者、解決状況、ステータスの各フィールドでのみ使用できます)

例

"Resolved" または "In Progress" のステータスを持ったことがないすべての課題を検索:
```
status WAS NOT IN ("Resolved","In Progress")
```
2 月 2 日より前に "Resolved" または "In Progress" のステータスを持たなかったすべての課題を検索:
```
status WAS NOT IN ("Resolved","In Progress") BEFORE "2011/02/02"
```

^{^ ページのトップへ}

WAS NOT

"WAS NOT" 演算子は、指定したフィールドが対象の値を持ったことがない課題の検索に使用します。

この演算子では次の述部を使用できます:

AFTER "date"
BEFORE "date"
BY "username"
DURING ("date1","date2")
ON "date"

この演算子はフィールドの変更時にシステムで構成された値の名前 ("解決済み" など) を照合します。このオプションは値の名前に関連付けられた値 ID も照合します。つまり、"解決済み" と同時に "4" を照合します。

(注意: この演算子は、担当者、修正バージョン、優先度、報告者、解決状況、ステータスの各フィールドでのみ使用できます)

例

ステータスが "In Progress" ではなく、過去に持ったこともない課題を検索:
```
status WAS NOT "In Progress"
```
2 月 2 日より前に "In Progress" ステータスを持たなかった課題を検索:
```
status WAS NOT "In Progress" BEFORE "2011/02/02"
```

^{^ ページのトップへ}

CHANGED

"CHANGED" 演算子は、指定したフィールドの値が変更された課題を検索するために使用します。

この演算子では次の述部を使用できます:

```
AFTER "日付"
```
```
BEFORE "日付"
```
```
BY "ユーザー名"
```
```
DURING ("日付1","日付2")
```
```
ON "日付"
```
```
FROM "古い値"
```
```
TO "新しい値"
```

(注意: この演算子は、担当者、修正バージョン、優先度、報告者、解決状況、ステータスの各フィールドでのみ使用できます)

例

担当者が変更された課題を検索:
```
assignee CHANGED
```
ステータスが "In Progress" から "Open " に変更された課題を検索:
```
status CHANGED FROM "In Progress" TO "Open"
```
現在の週の間にユーザー "freddo" が Priority を変更した課題を検索:
```
priority CHANGED BY freddo BEFORE endOfWeek() AFTER startOfWeek()
```

^{^ ページのトップへ}

ラベルなし