AND

Used to combine multiple statements, allowing you to refine your search.

Note that you can use parentheses to control the order in which statements are executed.

例

• "New office" プロジェクト内のすべてのオープンな課題を検索:

  project = "New office" and status = "open"

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

  status = open and priority = urgent and assignee = jsmith

• jsmith に割り当てられていない、特定のプロジェクト内のすべての課題を検索:

  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)

または

Used to combine multiple statements, allowing you to expand your search.

Note that you can use parentheses to control the order in which statements are executed.

(注意： INについても参照してください。フィールドの複数の値を検索するのに便利です。)

例

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

  reporter = jsmith or reporter = jbrown

• 期限切れまたは期限が設定されていないすべての課題を検索:

  duedate < now() or duedate is empty

NOT

Used to negate individual operators or entire statements of a query, allowing you to refine your search.

Note that you can use parentheses to control the order in which statements are executed.

(Note: also see NOT_EQUALS ("!="), DOES_NOT_CONTAIN ("!~"), NOT_IN and IS_NOT.)

例

• jsmith 以外のすべてのユーザーに割り当てられたすべての課題を検索:

  not assignee = jsmith

• jsmith または jbrown が作成していないすべての課題を検索:

  not (reporter = jsmith or reporter = jbrown)

EMPTY

指定されたフィールドに値が入力されていない課題を検索します。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.

例

• DueDate (期日)が設定されていない課題をすべて検索する:

  duedate = empty

  または

  duedate is empty

NULL

指定されたフィールドに値が入っていない課題を検索します。 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.

例

• DueDate (期日)が設定されていない課題をすべて検索する:

  duedate = null

  または

  duedate is null

ORDER BY

検索結果の並び順の基準として使用する値を持つフィールドを指定するために使用します。

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

例

• DueDate (期日) が設定されていないすべての課題を検索し、CreationDate (作成日) 順に並べ替える:

  duedate = empty order by created 

• DueDate (期日) が設定されていないすべての課題を検索し、CreationDate (作成日)、Priority (優先順位) (最高から最低の順)の順に並べ替える:

  duedate = empty order by created, priority desc

• DueDate (期日) が設定されていないすべての課題を検索し、CreationDate (作成日) 、 Priority (優先順位)(最低から最高) の順に並べ替える:

  duedate = empty order by created, priority asc

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.)

例

• jsmith が作成したすべての課題を検索:

  reporter = jsmith

• John Smith が作成したすべての課題を検索:

  reporter = "John Smith"

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.)

Note that typing field != value is the same as typing NOT field = value, and that field != EMPTY is the same as field IS_NOT EMPTY.

例

• jsmith 以外のすべてのユーザーに割り当てられたすべての課題を検索:

  not assignee = jsmith

  または

  assignee != jsmith

• Find all issues that were not reported by jsmith:

  reporter !=jsmith

• 自分以外が報告した、自分に割り当てられていないすべての課題を検索:

  reporter = currentUser() and assignee != currentUser()

• 報告社または担当者が John Smith 以外のすべてのユーザーであるすべての課題を検索:

  assignee != "John Smith" or reporter != "John Smith"

• 未割り当てのすべての課題を検索:

  assignee is not empty

  または

  assignee != null

GREATER THAN: >

The ">" operator is used to search for issues where the value of the specified field is greater than the specified value. Cannot be used with text fields.

Note that the ">" operator can only be used with fields which support ordering (e.g. date fields and version fields). To see a field's supported operators, check the individual field reference.

例

• 投票数が 4 票より多いすべての課題を検索:

  votes > 4

• 期限切れのすべての課題を検索:

  duedate < now() and resolution is empty

• 優先度が "Normal" より高いすべての課題を検索:

  priority > normal

GREATER THAN EQUALS: >=

The ">=" operator is used to search for issues where the value of the specified field is greater than or equal to the specified value. Cannot be used with text fields.

Note that the ">=" operator can only be used with fields which support ordering (e.g. date fields and version fields). To see a field's supported operators, check the individual field reference.

例

• 投票数が 4 票以上のすべての課題を検索:

  votes >= 4

• 期限が 2008 年 12 月 31 日以降のすべての課題を検索:

  duedate >= "2008/12/31"

• 過去 5 日間に作成されたすべての課題を検索:

  created >= "-5d"

LESS THAN: <

The "<" operator is used to search for issues where the value of the specified field is less than the specified value. Cannot be used with text fields.

Note that the "<" operator can only be used with fields which support ordering (e.g. date fields and version fields). To see a field's supported operators, check the individual field reference.

例

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

  votes < 4

LESS THAN EQUALS: <=

The "<=" operator is used to search for issues where the value of the specified field is less than or equal to than the specified value. Cannot be used with text fields.

Note that the "<=" operator can only be used with fields which support ordering (e.g. date fields and version fields). To see a field's supported operators, check the individual field reference.

例

• 投票数が 4 票以下のすべての課題を検索:

  votes <= 4

• 過去 1 ヶ月間 (30 日間) 更新されなかったすべての課題を検索:

  updated <= "-4w 2d"

IN

The "IN" operator is used to search for issues where the value of the specified field is one of multiple specified values.

Using "IN" is equivalent to using multiple EQUALS (=) statements, but is shorter and more convenient. That is, typing reporter IN (tom, jane, harry) is the same as typing 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" 演算子は、指定したフィールドの値が対象となる複数の値に含まれない課題を検索するために使用します。

Using "NOT IN" is equivalent to using multiple NOT_EQUALS (!=) statements, but is shorter and more convenient. That is, typing reporter NOT IN (tom, jane, harry) is the same as typing reporter != "tom" AND reporter != "jane" AND reporter != "harry".

例

• Find all issues where the Reporter is not Jack, Jill or John:

  reporter not in (Jack,Jill,John)

CONTAINS: ~

The "~" operator is used to search for issues where the value of the specified field contains a "fuzzy" match for the specified value. For use with text fields only, i.e.:

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

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

例

• Find all issues where the Summary contains the word "win" (or derivatives of that word, such as "windows" or "winning"):

  summary ~ win

DOES NOT CONTAIN: !~

"!~" 演算子は、指定したフィールドの値が指定した値のあいまい一致に該当しない課題の検索に使用します。次のようなテキスト フィールドでのみ使用できます。

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

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

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

対象バージョン

特定の Affects Version (対象バージョン) に割り当てられた課題を検索します。検索条件にはバージョン名またはバージョン ID (例: JIRA がバージョンに自動的に割り当てる番号) を使用できます。

注意： このフィールドはオートコンプリートをサポートしています。

構文

affectedVersion

フィールド タイプ

VERSION

サポートされる演算子

比較演算子 (例: ">") は、数値やアルファベット順ではなく、プロジェクト管理者が設定したバージョン順を使用します。

サポートされる関数

When used with the IN and NOT_IN operators, affectedVersion supports:

• releasedVersions()
• unreleasedVersions()

例

• AffectedVersion (対象バージョン) が 3.14 の課題を検索する:

  affectedVersion = "3.14"

  (注意： ピリオドは予約文字のため、クオテーションマークで囲う必要があります。)
• AffectedVersion (対象バージョン) が "Big Ted" の課題を検索する:

  affectedVersion = "Big Ted"

• AffectedVersion ID (対象バージョン ID) が 10350 の課題を検索する:

  affectedVersion = 10350

担当者

特定のユーザーに割り当てられた課題を検索します。検索条件にはユーザーのフルネーム、ID またはメールアドレスを使用できます。

注意： このフィールドはオートコンプリートをサポートしています。

構文

担当者

フィールド タイプ

USER

サポートされる演算子

サポートされる関数

When used with the IN and NOT_IN operators, assignee supports:

• membersOf()

When used with the EQUALS and NOT_EQUALS operators, assignee supports:

• currentUser()

例

• Search for issues that are assigned to John Smith:

  assignee = "John Smith"

  または

  assignee = jsmith

• Search for issues that are assigned by the user with email address "bob@mycompany.com":

  assignee = "bob@mycompany.com"

  (注意： ピリオドおよび「@」記号は予約文字のため、メールアドレスはクオテーションマークで囲う必要があります。)

カテゴリ

特定のカテゴリー内のプロジェクトに所属する課題を検索します。

注意： このフィールドはオートコンプリートをサポートしています。

構文

category

フィールド タイプ

CATEGORY

サポートされる演算子

サポートされる関数

n/a

例

• "Alphabet Projects" カテゴリーのプロジェクトに所属する課題を検索する:

   category = "Alphabet Projects"

コメント

Comment (コメント) に特定のテキストが含まれる課題を検索します。

JIRA テキスト検索構文を使用できます。

注意：このフィールドは、オートコンプリートをサポートしていません。

構文

comment

フィールド タイプ

TEXT

サポートされる演算子

サポートされる関数

n/a

例

• Find issues where a Comment contains text that matches "My PC is quite old":

  comment ~ "My PC is quite old"

コンポーネント

プロジェクトの特定のコンポーネントに割り当てられた課題を検索します。検索条件にはコンポーネント名またはコンポーネント ID (例: JIRA がバージョンに自動的に割り当てる番号) を使用できます。

注意： このフィールドはオートコンプリートをサポートしています。

構文

component

フィールド タイプ

COMPONENT

サポートされる演算子

サポートされる関数

n/a

例

• "Comp1" または "Comp2" コンポーネント内の課題を検索する:

   component in (Comp1, Comp2)

• Find issues in the "Comp1" and "Comp2" components:

   component in (Comp1) and component in (Comp2)

• ID が 20500 のコンポーネント内で課題を検索する:

  component = 20500

作成日

Search for issues that were created on, before or after a particular date (or date range).

注意：このフィールドは、オートコンプリートをサポートしていません。

構文

created

Alias (エイリアス):

createdDate

フィールド タイプ

DATE

サポートされる演算子

サポートされる関数

When used with the EQUALS, NOT_EQUALS, GREATER_THAN, GREATER_THAN_EQUALS, LESS_THAN or LESS_THAN_EQUALS operators, createdDate supports:

• now()

例

• Find all issues created on or before 12th December 2008 00:00:

  created <= "2008/12/12"

• 1 日以内に作成された課題を検索する:

  created > "-1d"

• 2009 年 1 月に作成された課題を検索する:

  created > "2008/12/31" and created < "2009/02/01"

• 2009 年 1 月 15 日に作成された課題を検索する:

  created > "2009/01/14" and created < "2009/01/16"

カスタム フィールド

JIRA 管理者が 1 つ以上のカスタム フィールドを作成した場合にのみ適用されます。

特定のカスタム フィールドに特定の値が入力された課題を検索します。

検索条件にはカスタム フィールド名またはカスタム フィールド ID (例: JIRA がカスタム フィールドに自動的に割り当てた番号) を使用できます。

注意:

• JIRA テキスト検索構文をタイプ "Text (テキスト)" のカスタム フィールドに使用できます。
• auto-complete is supported for Custom Fields of type picker, group picker, select (except 'Cascading Select'), check-box and radio button fields.

構文

CustomFieldName

Alias (エイリアス):

cf[CustomFieldID]

フィールド タイプ

カスタム フィールドの設定によって異なる

サポートされる演算子

カスタム フィールドの種類が異なると、サポートしている演算子も異なります。既定のカスタム フィールド タイプでは、次の演算子をサポートしています:

• 数字および日付/ 時刻フィールド:

  =	!=	~	!~	>	>=	<	<=	IS	IS NOT	IN	NOT IN

• ピッカー、選択、チェックボックス、ラジオ ボタン フィールド:

  =	!=	~	!~	>	>=	<	<=	IS	IS NOT	IN	NOT IN

• テキスト フィールド:

  =	!=	~	!~	>	>=	<	<=	IS	IS NOT	IN	NOT IN

サポートされる関数

カスタム フィールドの種類が異なると、サポートしている関数も異なります。既定のカスタム フィールド タイプでは、次の関数をサポートしています:

• Date/time fields: now() (when used with any operator except IS or Advanced Searching)
• Version picker fields: releasedVersions() and unreleasedVersions() (when used with the IN and NOT_IN operators)

例

• "Location (場所)" カスタム フィールドの値が "New York" の課題を検索する:

  location = "New York"

• ID が 10003 で、カスタム フィールドの値が "New York" の課題を検索する:

  cf[10003] = "New York"

• "Location (場所)" カスタム フィールドの値が "London"、"Milan" または "Paris" の課題を検索する:

  cf[10003] in ("London", "Milan", "Paris")

• "Location (場所)" カスタム フィールドの値がない課題を検索する:

  location != empty

説明

Description (説明) に特定のテキストが含まれる課題を検索します。

JIRA テキスト検索構文を使用できます。

注意：このフィールドは、オートコンプリートをサポートしていません。

構文

description

フィールド タイプ

TEXT

サポートされる演算子

サポートされる関数

n/a

例

• Find issues where the Description contains text that matches "Please see screenshot for details.":

  description ~ "Please see screenshot for details."

期限

Search for issues that were due on, before or after a particular date (or date range).

Note that Due Date relates to the date only (not to the time).

注意：このフィールドは、オートコンプリートをサポートしていません。

構文

due

Alias (エイリアス):

dueDate

フィールド タイプ

DATE

サポートされる演算子

サポートされる関数

When used with the EQUALS, NOT_EQUALS, GREATER_THAN, GREATER_THAN_EQUALS, LESS_THAN or LESS_THAN_EQUALS operators, dueDate supports:

• now()

例

• 2008 年 12 月 31 日以前に期限切れとなった課題をすべて検索する:

  due <= "2008/12/31"

• Find issues that are due tomorrow:

  due = "1d"

• Find issues that were due in January 2009:

  due > "2008/12/31" and due < "2009/02/01"

• Find issues that were due on 15 January 2009:

  due > "2009/01/14" and due < "2009/01/16"

環境

Environment (環境) に特定のテキストが含まれる課題をすべて検索します。

JIRA テキスト検索構文を使用できます。

注意：このフィールドは、オートコンプリートをサポートしていません。

構文

environment

フィールド タイプ

TEXT

サポートされる演算子

サポートされる関数

n/a

例

• Find issues where the description contains text that matches "Third floor":

  environment ~ "Third floor"

フィルター

フィルターを使用して検索を絞り込むことができます。検索条件にはフィルター名またはフィルター ID (例: JIRA が保存済みのフィルターに自動的に割り当てる番号) を使用できます。

注意:

• An Advanced Searching statement in your typed query will override an ORDER BY statement in the saved filter.
• 無限ループを発生させるフィルターを実行または保存することはできません (現在のフィルターを参照する保存済みフィルターを参照することはできません)。
• このフィールドは、オートコンプリートをサポートしています。

  構文

  filter

  エイリアス:

  リクエスト

  savedFilter

  searchRequest

フィールド タイプ

フィルター

サポートされる演算子

サポートされる関数

n/a

例

• ユーザー jsmith に割り当てられた課題のフィルター "My Saved Filter (マイ保存済みフィルター)" (ID は 12000) の結果を検索する:

  filter = "My Saved Filter" and assignee = jsmith

  または

  filter = 12000 and assignee = jsmith

修正対象バージョン

特定の Fix Version (修正バージョン) に割り当てられた課題を検索します。検索条件にはバージョン名またはバージョン ID (例: JIRA がバージョンに自動的に割り当てる番号) を使用できます。

注意： このフィールドはオートコンプリートをサポートしています。

構文

fixVersion

フィールド タイプ

VERSION

サポートされる演算子

比較演算子 (例: ">") は、数値やアルファベット順ではなく、プロジェクト管理者が設定したバージョン順を使用します。

サポートされる関数

When used with the IN and NOT_IN operators, fixVersion supports:

• releasedVersions()
• unreleasedVersions()

例

• Fix Version (修正バージョン) が 3.14 または 4.2 の課題を検索する:

   fixVersion in ("3.14", "4.2")

  (注意： ピリオドは予約文字のため、クオテーションマークで囲う必要があります。)
• Fix Version (修正バージョン) が "Little Ted" の課題を検索する:

  fixVersion = "Little Ted"

• Fix Version ID (修正バージョン ID) が 10001 の課題を検索する:

  fixVersion = 10001

課題キー

検索は特定の課題キーまたは課題 ID (例: JIRA が課題に自動的に割り当てる番号) のいずれかに基づいて実行されます。

注意：このフィールドは、オートコンプリートをサポートしていません。

構文

issueKey

エイリアス:

ID

課題

鍵 (キー)

フィールド タイプ

ISSUE

サポートされる演算子

サポートされる関数

When used with the IN or NOT_IN operators, issueKey supports:

• issueHistory()
• linkedIssues()
• votedIssues()
• watchedIssues()

例

• キーが "ABC-123" の課題を検索する:

  issueKey = ABC-123 

レベル

JIRA 管理者が Issue Level Security (課題レベル セキュリティ) を有効にしている場合にのみ使用できます。

特定の Security Level (セキュリティ レベル) に割り当てられた課題を検索します。検索条件にはセキュリティ レベル名または課題セキュリティ レベル ID (例: JIRA が課題セキュリティ レベルに自動的に割り当てる番号) を使用できます。

注意： このフィールドはオートコンプリートをサポートしています。

構文

レベル

フィールド タイプ

SECURITY LEVEL

サポートされる演算子

サポートされる関数

n/a

例

• Security Level (セキュリティ レベル) が "Really High (非常に高い)" または "レベル1" の課題を検索する:

  level in ("Really High", level1)

• Security Level ID (セキュリティ レベル ID) が 123 の課題を検索する:

  level = 123

初期見積り

JIRA 管理者が時間管理を有効にしている場合にのみ使用できます。

Original Estimate (最初の予測) が特定の値 (例: 数字、日付や日付範囲ではない) に設定されている課題を検索します。

"w"、"d"、"h"、"m" を使用して、週、日付、時間、分を指定します。

注意：このフィールドは、オートコンプリートをサポートしていません。

構文

originalEstimate

Alias (エイリアス):

timeOriginalEstimate

フィールド タイプ

DURATION

サポートされる演算子

サポートされる関数

n/a

例

• Original Estimate (最初の予測) が 1 時間の課題を検索する:

  originalEstimate = 1h

• Original Estimate (最初の予測) が 2 日より多い課題を検索する:

  originalEstimate > 2d

親

JIRA 管理者がサブタスクを有効にしている場合にのみ使用できます。

特定の課題のサブタスクをすべて検索します。検索は課題キーまたは課題 ID (例: JIRA が課題に自動的に割り当てる番号) のいずれかに基づいて行われます。

注意：このフィールドは、オートコンプリートをサポートしていません。

構文

parent

フィールド タイプ

ISSUE

サポートされる演算子

サポートされる関数

n/a

例

• "TEST-1234" を親に持つサブタスクを検索する:

  parent = TEST-1234

Priority

特定の Priority (優先度) に割り当てられた課題を検索します。検索条件には優先度または優先度 ID (例: JIRA が優先度に自動的に割り当てる番号) を使用できます。

注意： このフィールドはオートコンプリートをサポートしています。

構文

優先度

フィールド タイプ

PRIORITY

サポートされる演算子

サポートされる関数

n/a

例

• Priority (優先度) が "High (高)" の課題を検索する:

   priority = High

• Priority ID (優先度 ID) が 10000 の課題を検索する:

  priority = 10000

プロジェクト

Search for issues that belong to a particular Project

You can search by Project Name, by Project Key or by Project ID (i.e. the number that JIRA automatically allocates to a project).

注意： このフィールドはオートコンプリートをサポートしています。

構文

プロジェクト

フィールド タイプ

PROJECT

サポートされる演算子

サポートされる関数

n/a

例

• "ABC Project" という名前のプロジェクトに所属する課題を検索する:

   project = "ABC Project" 

• キーが "ABC" のプロジェクトに所属する課題を検索する:

  project = "ABC"

• ID が "1234" のプロジェクトに所属する課題を検索する:

  project = 1234

残余見積り

JIRA 管理者が時間管理を有効にしている場合にのみ使用できます。

Remaining Estimate (残余予測) が特定の値 (例: 数字、日付や日付範囲ではない) に設定されている課題を検索します。

"w"、"d"、"h"、"m" を使用して、週、日付、時間、分を指定します。

注意：このフィールドは、オートコンプリートをサポートしていません。

構文

remainingEstimate

Alias (エイリアス):

timeEstimate

フィールド タイプ

DURATION

サポートされる演算子

サポートされる関数

n/a

例

• Remaining Estimate (残余予測) が 4 日より多い課題を検索する:

   remainingEstimate > 4h 

報告者

Search for issues that were reported by (i.e. created by) a particular user.

検索条件にはユーザーのフルネーム、ID またはメールアドレスを使用できます。

注意： このフィールドはオートコンプリートをサポートしています。

構文

reporter

フィールド タイプ

USER

サポートされる演算子

サポートされる関数

When used with the IN and NOT_IN operators, reporter supports:

• membersOf()

When used with the EQUALS and NOT_EQUALS operators, reporter supports:

• currentUser()

例

• Jill Jones が作成した課題を検索する:

  reporter = "Jill Jones"

  または

  reporter = jjones

• Search for issues that were created by the user with email address "bob@mycompany.com":

  assignee = "bob@mycompany.com"

  (注意： ピリオドおよび「@」記号は予約文字のため、メールアドレスはクオテーションマークで囲う必要があります。)

ソリューション

特定の Resolution (解決策) に割り当てられた課題を検索します。

検索条件には解決策名または解決策 ID (例: JIRA が解決策に自動的に割り当てる番号) を使用できます。

注意： このフィールドはオートコンプリートをサポートしています。

構文

resolution

フィールド タイプ

RESOLUTION

サポートされる演算子

サポートされる関数

n/a

例

• Resolution (解決策) が "Cannot Reproduce (再現不可)" または "Won't Fix (修正しない)" の課題を検索する:

   resolution in ("Cannot Reproduce", "Won't Fix")

• Resolution ID (解決策 ID) が 5 の課題を検索する:

  resolution = 5

• 解決策がない課題を検索する:

  resolution = unresolved

解決済み

Search for issues that were resolved on, before or after a particular date (or date range).

注意：このフィールドは、オートコンプリートをサポートしていません。

構文

resolved

Alias (エイリアス):

resolutionDate

フィールド タイプ

DATE

サポートされる演算子

サポートされる関数

When used with the EQUALS, NOT_EQUALS, GREATER_THAN, GREATER_THAN_EQUALS, LESS_THAN or LESS_THAN_EQUALS operators, resolved supports:

• now()

例

• Find all issues that were resolved on or before 31st December 2008 00:00:

  resolved <= "2008/12/31"

• 2009 年 1 月に解決された課題を検索する:

  resolved > "2008/12/31" and resolved < "2009/02/01"

• 2009 年 1 月 15 日に解決された課題を検索する:

  resolved > "2009/01/14" and resolved < "2009/01/16"

• 過去 1 時間以内に解決された課題を検索する:

  resolved > -1h

ステータス

特定の Status (ステータス) を持つ課題を検索します。

検索条件にはステータス名またはステータス ID (例: JIRA がステータスに自動的に割り当てる番号) を使用できます。

注意： このフィールドはオートコンプリートをサポートしています。

構文

ステータス

フィールド タイプ

STATUS

サポートされる演算子

サポートされる関数

n/a

例

• Status (ステータス) が " Open (未処理)" の課題を検索する:

   status = Open

• Status ID (ステータス ID) が 1 の課題を検索する:

  status = 1

要約

Summary (概要) に特定のテキストが含まれる 課題を検索します。

JIRA テキスト検索構文を使用できます。

注意：このフィールドは、オートコンプリートをサポートしていません。

構文

要約

フィールド タイプ

TEXT

サポートされる演算子

サポートされる関数

n/a

例

• Find issues where the Summary contains text that matches "Error saving file":

  summary ~ "Error saving file"

Text

これは、次のすべてのテキスト フィールドを検索できる "マスター フィールド" です。

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

Note: The text master-field can only be used with the CONTAINS operator ("~" and "!~").

構文

text

フィールド タイプ

TEXT

サポートされる演算子

サポートされる関数

n/a

例

• テキスト フィールドが、"Fred" の単語と一致する課題を検索する:

  text ~ "Fred"

タイプ

特定の Issue Type (課題タイプ) の課題を検索します。

検索は課題タイプ名または課題タイプ ID (例: JIRA が課題タイプに自動的に割り当てる番号) のいずれかに基づいて行われます。

注意： このフィールドはオートコンプリートをサポートしています。

構文

type

Alias (エイリアス):

issueType

フィールド タイプ

ISSUE_TYPE

サポートされる演算子

サポートされる関数

n/a

例

• Issue Type (課題タイプ) が "Bug (バグ)" の課題を検索する:

  type = Bug

• Issue Type (課題タイプ) が "Bug (バグ)" または "Improvement (改善)" の課題を検索する:

   issueType in (Bug,Improvement)

• Issue Type ID (課題タイプ ID) が 2 の課題を検索する:

  issueType = 2

消費時間

JIRA 管理者が時間管理を有効にしている場合にのみ使用できます。

Time Spent (所要時間) が特定の値 (例: 数字、日付や日付範囲ではない) に設定されている課題を検索します。

"w"、"d"、"h"、"m" を使用して、週、日付、時間、分を指定します。

注意：このフィールドは、オートコンプリートをサポートしていません。

構文

timeSpent

フィールド タイプ

DURATION

サポートされる演算子

サポートされる関数

n/a

例

• Time Spent (所要時間) が 5 日より多い課題を検索する:

  timeSpent > 5d

更新日

Search for issues that were last updated on, before or after a particular date (or date range).

注意：このフィールドは、オートコンプリートをサポートしていません。

構文

updated

Alias (エイリアス):

updatedDate

フィールド タイプ

DATE

サポートされる演算子

サポートされる関数

When used with the EQUALS, NOT_EQUALS, GREATER_THAN, GREATER_THAN_EQUALS, LESS_THAN or LESS_THAN_EQUALS operators, updated supports:

• now()

例

• Find issues that were updated on or before 12th December 2008 00:00:

  updated <= "2008/12/12"

• Find issues that were updated more than two weeks ago:

  updated < "-2w"

• Find issues that were updated on 15 January 2009:

  updated > "2009/01/14" and updated < "2009/01/16"

• Find issues that were updated in January 2009:

  updated > "2008/12/31" and updated < "2009/02/01"

投票数

指定した数の投票数の課題を検索します:

注意：このフィールドは、オートコンプリートをサポートしていません。

構文

votes

フィールド タイプ

NUMBER

サポートされる演算子

サポートされる関数

n/a

例

• 12 票以上の課題をすべて検索する:

  votes >= 12

Work Ratio (作業率)

JIRA 管理者が時間管理を有効にしている場合にのみ使用できます。

Work Ratio (作業率) が特定の値の課題を検索します。

Work Ratio (作業率) の計算方法:workRatio = timeSpent / originalEstimate) x 100

注意：このフィールドは、オートコンプリートをサポートしていません。

構文

workRatio

フィールド タイプ

NUMBER

サポートされる演算子

サポートされる関数

n/a

例

• 所要時間が Original Estimate (最初の予測) の 75 % より多い課題を検索する:

   workRatio > 75

cascadeOption()

Search for issues that match the selected values of a 'cascading select' custom field.

The parentOption parameter matches against the first tier of options in the cascading select field. The childOption parameter matches against the second tier of options in the cascading select field, and is optional.

The keyword "none" can be used to search for issues where either or both of the options have no value.

構文

cascadeOption(parentOption)

または

cascadeOption(parentOption,childOption)

Supported Field Types

CASCADING_OPTION

サポートされる演算子

例

• Find issues where a custom field ("Location") has the value "USA" for the first tier and "New York" for the second tier:

  location in cascadeOption("USA","New York")

• Find issues where a custom field ("Location") has the value "USA" for the first tier and any value (or no value) for the second tier:

  location in cascadeOption("USA")

• Find issues where a custom field ("Location") has the value "USA" for the first tier and no value for the second tier:

  location in cascadeOption("USA",none)

• Find issues where a custom field ("Location") has no value for the first tier and no value for the second tier:

  location in cascadeOption(none)

• Find issues where a custom field ("Referrer") has the value "none" for the first tier and "none" for the second tier:

  referrer in cascadeOption("\"none"\","\"none"\")

• Find issues where a custom field ("Referrer") has the value "none" for the first tier and no value for the second tier:

  referrer in cascadeOption("\"none"\",none)

currentUser()

Perform searches based on the currently logged-in user.

Note that this function can only be used by logged-in users. So if you are creating a saved filter that you expect to be used by anonymous users, do not use this function.

構文

currentUser()

Supported Field Types

USER

サポートされる演算子

例

• Find issues that are assigned to me:

  assignee = currentUser()

• 自分が報告したが自分に割り当てられていない課題を検索:

  reporter = currentUser() and assignee != currentUser()

issueHistory()

最近閲覧した課題、つまり [課題] ドロップダウン メニューの [最近表示した課題] セクションにある課題を検索します。

注意:

• issueHistory() returns up to 50 issues, whereas the 'Recent Issues' drop-down returns only 5.
• JIRA にログインしていない場合、現在利用しているブラウザのセッションから取得した課題だけが含まれます。

構文

issueHistory()

Supported Field Types

ISSUE

サポートされる演算子

例

• Find issues which I have recently viewed, that are assigned to me:

  issue in issueHistory() AND assignee = currentUser()

linkedIssues()

Perform searches based on issues which are linked to a specified issue.

You can optionally restrict the search to links of a particular type. Note that LinkType is case-sensitive.

構文

linkedIssues(issueKey)

または

linkedIssues(issueKey,linkType)

Supported Field Types

ISSUE

サポートされる演算子

例

• Find issues that are linked to a particular issue:

  issue in linkedIssues(ABC-123)

• Find issues that are linked to a particular issue via a particular type of link:

  issue in linkedIssues(ABC-123,"is duplicated by")

membersOf()

特定のグループのメンバーに基づく検索を実施します。

構文

membersOf（グループ）

Supported Field Types

USER

サポートされる演算子

例

• Find issues where the Assignee is a member of the group "jira-developers":

  assignee in membersOf("jira-developers")

• Search through multiple groups and a specific user, e.g:

  reporter in membersOf("jira-developers") or reporter in membersOf("jira-administrators") or reporter=jsmith

• Search for a particular group, but exclude a particular member or members, e.g.:

  assignee in membersOf(QA) and assignee not in ("John Smith","Jill Jones")

• Exclude members of a particular group:

  assignee not in membersOf(QA)

now()

現在の時刻に基づいた検索を行います。

構文

now()

Supported Field Types

DATE

サポートされる演算子

例

• Find issues that are overdue:

  duedate < now() and status not in (closed, resolved) 

releasedVersions()

Perform searches based on the released versions (i.e. versions that your JIRA administrator has released) of a specified project.

You can also search on the released versions of all projects, by omitting the project parameter.

構文

releasedVersions()

または

releasedVersions(project)

Supported Field Types

VERSION

サポートされる演算子

例

• Find issues whose FixVersion is a released version of the ABC project:

  fixVersion in releasedVersions(ABC)

• Find issues that relate to released versions of the ABC project:

  affectedVersion in releasedVersions(ABC)

  または

  fixVersion in releasedVersions(ABC)

standardIssueTypes()

Perform searches based on "standard" Issue Types, that is, search for issues which are not sub-tasks.

構文

standardIssueTypes()

Supported Field Types

ISSUE_TYPE

サポートされる演算子

例

• Find issues that are not subtasks (i.e. issues whose Issue Type is a standard issue type, not a subtask issue type):

  issuetype in standardIssueTypes()

subtaskIssueTypes()

Perform searches based on issues which are sub-tasks.

構文

subtaskIssueTypes()

Supported Field Types

ISSUE_TYPE

サポートされる演算子

例

• Find issues that are subtasks (i.e. issues whose Issue Type is a subtask issue type):

  issuetype in subtaskIssueTypes()

unreleasedVersions()

Perform searches based on the unreleased versions (i.e. versions that your JIRA administrator has not yet released) of a specified project.

You can also search on the unreleased versions of all projects, by omitting the project parameter.

構文

unreleasedVersions()

または

unreleasedVersions(project)

Supported Field Types

VERSION

サポートされる演算子

例

• Find issues whose FixVersion is an unreleased version of the ABC project:

  fixVersion in unreleasedVersions(ABC)

• Find issues that relate to unreleased versions of the ABC project:

  affectedVersion in unreleasedVersions(ABC)

  または

  fixVersion in unreleasedVersions(ABC)

votedIssues()

Perform searches based on issues for which you have voted.

Note that this function can only be used by logged-in users.

構文

votedIssues()

Supported Field Types

ISSUE

サポートされる演算子

例

• Find issues that you have voted for:

  issue in votedIssues()

watchedIssues()

Perform searches based on issues which you are watching.

Note that this function can only be used by logged-in users.

構文

watchedIssues()

Supported Field Types

ISSUE

サポートされる演算子

例

• Find issues that you are watching:

  issue in watchedIssues()

Supported Field Types

ISSUE

サポートされる演算子

例

• Find issues that you have recently viewed:

  issue in issueHistory()

オートコンプリート候補のリストは、アルファベット順に最初の 15 件の一致が表示されます。注意: オートコンプリート候補は関数パラメーターでは表示されません。

オートコンプリート候補はすべてのフィールドで表示される訳ではありません。オートコンプリートをサポートしているフィールドを確認するには、フィールド参照を確認してください。

If you type a space at the start of your query...

...JIRA will offer a list of all available fields, e.g.:

If you type one or more characters...

...JIRA will offer a list of matching fields, e.g.:

If you type a field then a space...

...JIRA will offer a list of valid operators, e.g.:

If you type a field, then an operator, then a space...

...JIRA will offer a list of valid values, e.g.:

If you type a field, then an operator, then one or more characters...

...JIRA will offer a list of valid values (if your field supports this) and valid functions for the field/operator combination, e.g.: