JQL フィールド

JQL では、特定のフィールドの値を検索できます。Jira の各フィールドには、対応する JQL 名があります。カスタム フィールドを作成した場合は、そのフィールドに名前を付けるように求められます。

句では、フィールドの後に演算子、その後に 1 つ以上の値 (または関数) が続きます。演算子はフィールドの値を右側の 1 つ以上の値または関数と比較して、true となる結果のみが句によって取得されます。JQLでは 2 つのフィールドを比較できません。

対象バージョン

特定の影響を受けたバージョンに割り当てられた課題を検索します。検索条件にはバージョン名またはバージョン ID (例: Jira がバージョンに自動的に割り当てる番号) を使用できます。バージョン名で検索するよりも、バージョン ID で検索することをおすすめします。これは、異なるプロジェクトで同じ名前を使用している可能性があるためです。Jira 管理者もバージョン名を変更できますが、その名前に依存している保存済みのフィルターが使用できなくなる可能性があります。バージョン ID は一意であり、変更されることはありません。

構文

1 affectedVersion

フィールド タイプ

VERSION

オートコンプリート

はい

サポートされる演算子

= , != , > , >= , < , <=
IS, IS NOT, IN, NOT IN 比較演算子 (例: ">") は、数値やアルファベット順ではなくプロジェクト管理者が設定したバージョン順を使用することにご注意ください。

サポートされない演算子

~ , !~
WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED

サポートされる関数

= および != 演算子と共に使用する場合、このフィールドは以下をサポートします。

  • latestReleasedVersion()

  • earliestUnreleasedVersion()

IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:

  • releasedVersions()

  • unreleasedVersions()

  • AffectedVersion が 3.14 である課題を検索
    affectedVersion = "3.14"
    終止符は予約文字のため、引用符で囲む必要がある点にご注意ください。

  • AffectedVersion が "Big Ted" である課題を検索:
    affectedVersion = "Big Ted"

  • AffectedVersion ID が 10350 である課題を検索:
    affectedVersion = 10350

承認

ビジネス プロジェクトの Jira Service Management でのみ使用します。

承認済みまたは承認待ちのリクエストを検索します。この検索はユーザーによってさらに細かく設定できます。

構文

1 approvals

フィールド タイプ

USER

オートコンプリート

いいえ

サポートされる演算子

=

サポートされない演算子

~ , != , !~ , > , >= , < , <=
IS , IS NOT , IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされる関数

  • approved()

  • approver()

  • myApproval()

  • myPending()

  • myPendingApproval()

  • pending()

  • pendingBy()

  • John Smith による承認が必要または必要だったリクエストを検索:
    approval = approver(jsmith)

  • John Smith による承認が必要なリクエストを検索:
    approval = pendingBy(jsmith)

  • 現在のユーザーによる承認が必要な (または必要だった) リクエストを検索する
    approval = myPending()

  • 承認が必要なすべてのリクエストを検索:
    approval = pending()

担当者

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

構文

1 assignee

フィールド タイプ

USER

オートコンプリート

はい

サポートされる演算子

= , !=
IS, IS NOT, IN, NOT IN, WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED

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

サポートされない演算子

~ , !~ , > , >= , < , <=

サポートされる関数

IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:

  • membersOf()

EQUALS または NOT EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:

  • currentUser()

  • John Smith に割り当てられた課題を検索:
    assignee = "John Smith" または
    assignee = jsmith

  • John Smith に現在割り当てられている、または割り当てられていた課題を検索:
    assignee WAS jsmith

  • メール アドレスが bob@mycompany.com: であるユーザーによって割り当てられた課題を検索:

    • assignee = "bob@mycompany.com"

      終止符と @ 記号は予約語のため、引用符で囲む必要があります。

添付ファイル

添付ファイルがある、または添付ファイルがない課題を検索します。 

構文

1 attachments

フィールド タイプ

ATTACHMENT

オートコンプリート

はい

サポートされる演算子

IS, IS NOT

サポートされない演算子

=, != , ~ , !~ , > , >= , < , <= IN, NOT IN, WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED

サポートされる関数

なし

  • 添付ファイルを持つ課題を検索:
    attachments IS NOT EMPTY  

  • 添付ファイルを持たない課題を検索:
    attachments IS EMPTY 

カテゴリー

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

構文

1 category

フィールド タイプ

CATEGORY

オートコンプリート

はい

サポートされる演算子

=, !=
IS, IS NOT, IN, NOT IN

サポートされない演算子

~ , !~ , > , >= , < , <= WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED

サポートされる関数

なし

  • "Alphabet Projects" カテゴリのプロジェクトに含まれる課題を検索:
    category = "Alphabet Projects"

ゲーティング タイプを変更する

ビジネス プロジェクトでのみ使用します。

変更リクエストに使用されている変更ゲーティングのタイプを検索します。「Tracked-only」のリクエストは、変更管理プロセスとは別に設けられている統合によって生成されます。これらのツールでは、承認や変更のゲーティング戦略は考慮されません。「Tracked-only」の変更リクエストは、記録保持の目的にのみ使用されます。

構文

1 change-gating-type

フィールド タイプ

TEXT

オートコンプリート

はい

サポートされる演算子

= , !=

IS, IS NOT, IN, NOT IN

サポートされない演算子 

~ , !~ , > , >= , < , <= WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED

サポートされる関数

なし

  • ゲーティング タイプが空のリクエストを検索:
    change-gating-type is EMPTY

  • ゲーティング タイプが「Tracked-only (追跡のみ)」のリクエストを検索する
    change-gating-type = "tracked-only"

コメント

Jira テキスト検索構文によって、コメントに特定のテキストが含まれている課題を検索します。テキスト フィールドの検索構文の詳細をご確認ください。

構文

1 comment

フィールド タイプ

TEXT

オートコンプリート

いいえ

サポートされる演算子

~ , !~

サポートされない演算子

= , != , > , >= , < , <=
IS, IS NOT, IN, NOT IN, WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED

サポートされる関数

なし

  • コメントに「My PC is quite old」という語が含まれている課題を検索します (「語句検索」一致)。
    comment ~ "My PC is quite old"

  • コメントに「使っているPCが古い」との完全一致を含む課題を検索:
    comment ~ "\"My PC is quite old\""

  • コメントに「My PC is quite old」と「My Mac is quite new」の両方のフレーズがそのまま含まれている課題を検索します。
    comment ~ "\"My PC is quite old\"" AND comment ~ "\"My Mac is quite new\""

Component

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

注意: コンポーネント名ではなくコンポーネント ID で検索することをおすすめします。異なるプロジェクトに同じ名前のコンポーネントがある場合、コンポーネント名で検索すると、複数のプロジェクトから課題が返される可能性があります。また、Jira 管理者がコンポーネント名を変更すると、その名前に依存している保存済みのフィルターが使用できなくなる可能性がありますが、コンポーネント ID は一意であり、変更されることはありません。

構文

1 component

フィールド タイプ

COMPONENT

オートコンプリート

はい

サポートされる演算子

= , !=
IS , IS NOT , IN , NOT IN

サポートされない演算子

~ , !~ , > , >= , < , <= WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED

サポートされる関数

IN および NOT IN 演算子と共に使用する場合、コンポーネントは以下をサポートします:

  • componentsLeadByUser()

  • "Comp1" または "Comp2" コンポーネントを持つ課題を検索:
    component in (Comp1, Comp2)

  • "Comp1" および"Comp2" コンポーネントを持つ課題を検索:
    component in (Comp1) and component in (Comp2)
    or
    component = Comp1 and component = Comp2 

  • ID が 20500 のコンポーネントを持つ課題を検索:
    component = 20500 

created

特定の日付 (または日付範囲)、それよりも前、またはそれよりも後に作成された課題を検索します。時間コンポーネントが指定されていない場合、深夜 0 時と想定されます。検索結果は設定した タイム ゾーン (既定では Jira Server のタイム ゾーン) に対して相対的なものとなります。

以下の形式のいずれかを使用:

"yyyy/MM/dd HH:mm"
"yyyy-MM-dd HH:mm"
"yyyy/MM/dd"
"yyyy-MM-dd"

"w" (週)、"d" (日)、"h" (時間) または "m" (分) を使用して、現在の時刻に対する相対的な日付を指定することもできます。既定は "m" (分) です。引用符 (") を使用する必要があることにご注意ください。引用符を省略した場合、入力した数字はエポック (1970-1-1) のミリ秒後と解釈されます。

構文

1 created

エイリアス

1 createdDate

フィールド タイプ

DATE

オートコンプリート

いいえ

サポートされる演算子

= , != , > , >= , < , <= IS , IS NOT , IN , NOT IN

サポートされない演算子

~ , !~ WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED

サポートされる関数

EQUALSNOT EQUALSGREATER THANGREATER THAN EQUALSLESS THANLESS THAN EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:

  • currentLogin()

  • lastLogin()

  • now()

  • startOfDay()

  • startOfWeek()

  • startOfMonth()

  • startOfYear()

  • endOfDay()

  • endOfWeek()

  • endOfMonth()

  • endOfYear()

  • 2010 年 12 月 12 日より前に作成されたすべての課題を検索:
    created < "2010/12/12"

  • 2010 年 12 月 12 日以前に作成されたすべての課題を検索:
    created <= "2010/12/13"

  • 2010 年 12 月 12 日の午後 2:00 より前に作成されたすべての課題を検索:
    created > "2010/12/12" and created < "2010/12/12 14:00" 

  • 1 日以内に作成された課題を検索:
    created > "-1d"

  • 2011 年 1 月に作成された課題を検索:
    created > "2011/01/01" and created < "2011/02/01"

  • Find issues created on 15 January 2011:created > "2011/01/15" and created < "2011/01/16"

作成者

特定のユーザーが作成した課題を検索します。ユーザーの氏名、ID、またはメール アドレスで検索できます。課題の作成者は変更されないため、過去の作成者は検索できないことにご注意ください (例: WAS)。その他のオプションについては「報告者」をご参照ください。 

構文

1 creator

フィールド タイプ

USER

オートコンプリート

はい

サポートされる演算子

= , !=
IS , IS NOT , IN , NOT IN

サポートされない演算子

~ , !~ , > , >= , < , <= CHANGED, WAS, WAS IN, WAS NOT, WAS NOT IN

サポートされる関数

IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:

  • membersOf()

EQUALS または NOT EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:

  • currentUser()

  • Jill Jones が作成した課題を検索:
    creator = "Jill Jones"
    or
    creator = "jjones"

  • creator = "bob@mycompany.com"
    のメールアドレスを持つユーザーが作成した課題を検索
    (Note that full-stops and "@" symbols are reserved characters, so the email address needs to be surrounded by quote-marks.) 

カスタム フィールド

Jira 管理者が 1 つ以上のカスタム フィールドを作成している場合にのみ使用できます。

特定のカスタム フィールドに特定の値が入力されている課題を検索します。検索にはカスタム フィールド名またはカスタム フィールド ID (Jira でカスタム フィールドに自動的に割り当てられる番号) を使用できます。

注意: カスタム フィールド名ではなくカスタム フィールド ID で検索することをおすすめします。カスタム フィールドの名前が 組み込み Jira システム フィールドと同じ場合、Jira ではシステム フィールド (カスタム フィールドではなく) が検索されます。この場合、Jira 管理者がカスタム フィールド名を変更してしまうと、その名前に依存している保存済みのフィルターが使用できなくなる可能性がありますが、カスタム フィールド ID は一意であり、変更されることはありません。

多肢選択式とドロップダウン式のカスタム フィールドでは、オプション値とオプション ID の両方で検索できます。ただし、パフォーマンス上の理由から、closedSprints()futureSprints()openSprints() を使用する場合は、オプション値でのみ検索できます。たとえば、closedSprints()16 を返す場合、次のクエリは、

1 "customField1[Dropdown]" in (12, closedSprints())

オプション値 1216 と ID 12 を検索します。

構文

1 CustomFieldName

エイリアス

1 cf[CustomFieldID]

フィールド タイプ

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

"Text" タイプのカスタム フィールドでは、Jira テキスト検索構文を使用できます。

オートコンプリート

タイプ ピッカー、グループ ピッカー、選択、チェックボックス、ラジオ ボタン フィールドのカスタム フィールドで利用できます。

サポートされる演算子

カスタム フィールドの種類に応じて、サポートされる演算子も異なります。

サポートされる演算子:
数値と日付フィールドの場合 

= , != , > , >= , < , <=
IS , IS NOT , IN , NOT IN

サポートされない演算子:
数値と日付フィールドの場合

~ , !~ WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED

サポートされる演算子:
ピッカー、選択、チェックボックス、ラジオ ボタン フィールドの場合

= , !=
IS , IS NOT , IN , NOT IN

サポートされない演算子:
ピッカー、選択、チェックボックス、ラジオ ボタン フィールドの場合

~ , !~ , > , >= , < , <= WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED

サポートされる演算子:
テキスト フィールドの場合 

~ , !~
IS , IS NOT

サポートされない演算子:
テキスト フィールドの場合 

= , != , > , >= , < , <= IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED

サポートされる演算子:
URL フィールドの場合 

= , !=
IS , IS NOT , IN , NOT IN

サポートされない演算子:
URL フィールドの場合

~ , !~ , > , >= , < , <= WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED

サポートされる関数

カスタム フィールドの種類に応じて、サポートされる関数も異なります。

サポートされる関数:
日付/時間フィールドの場合 

EQUALSNOT EQUALSGREATER THANGREATER THAN EQUALSLESS THAN または LESS THAN EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:

  • currentLogin()

  • lastLogin()

  • now()

  • startOfDay()

  • startOfWeek()

  • startOfMonth()

  • startOfYear()

  • endOfDay()

  • endOfWeek()

  • endOfMonth()

  • endOfYear()

サポートされる関数:
バージョン ピッカー フィールドの場合 

 バージョン ピッカー フィールド: INNOT IN の各演算子を併用する際に、このフィールドは次をサポートします。

  • releasedVersions()

  • latestReleasedVersion()

  • unreleasedVersions()

  • earliestUnreleasedVersion()

  • "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

説明

Jira テキスト検索構文によって、説明に特定のテキストが含まれている課題を検索します。テキスト フィールドの検索構文の詳細をご確認ください。

構文

1 description

フィールド タイプ

TEXT

オートコンプリート

いいえ

サポートされる演算子

~ , !~
IS , IS NOT

サポートされない演算子

= , != , > , >= , < , <= IN , NOT IN, WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされる関数

なし

  • 説明に「Please see screenshot」という語が含まれている課題を検索します (「語句検索」一致)。
    description ~ "Please see screenshot"

  • 説明に「スクリーンショットを参照」との完全一致を含む課題を検索:
    description ~ "\"Please see screenshot\""

  • 説明に「Please see screenshot」と「What is needed」の両方のフレーズがそのまま含まれている課題を検索します。
    description ~ "\"Please see screenshot\"" AND description ~ "\"What is needed\"" "

期限

特定の日付 (または日付範囲) またはその前後に期限を持つ課題を検索します。期日は、時間ではなく日付のみを対象とすることにご注意ください。

以下の形式のいずれかを使用:

"yyyy/MM/dd"
"yyyy-MM-dd"

"w" (週) または "d" (日) を使用して現在の時刻に対する相対的な日付を指定することもできます。引用符 (") を使用する必要があることにご注意ください。

構文

1 due

エイリアス

1 dueDate

フィールド タイプ

DATE

オートコンプリート

いいえ

サポートされる演算子

= , != , > , >= , < , <=
IS , IS NOT , IN , NOT IN

サポートされない演算子

~ , !~ WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされる関数

EQUALS、NOT EQUALS、GREATER THAN、GREATER THAN EQUALSLESS THAN または LESS THAN EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:

  • currentLogin()

  • lastLogin()

  • now()

  • startOfDay()

  • startOfWeek()

  • startOfMonth()

  • startOfYear()

  • endOfDay()

  • endOfWeek()

  • endOfMonth()

  • endOfYear()

  • 期日が 2010 年 12 月 31 日より前のすべての課題を検索:
    due < "2010/12/31"

  • 期日が 2010 年 12 月 31 日以前のすべての課題を検索:
    due <= "2011/01/01"

  • 期限が明日であるすべての課題を検索:
    due = "1d"

  • 期日が 2011 年 1 月のすべての課題を検索:
    due >= "2011/01/01" and due <= "2011/01/31"

  • 期日が 2011 年 1 月 15 日のすべての課題を検索:
    due = "2011/01/15"

環境

Jira テキスト検索構文によって、環境に特定のテキストが含まれている課題を検索します。テキスト フィールドの検索構文の詳細をご確認ください。

構文

1 environment

フィールド タイプ

TEXT

オートコンプリート

いいえ

サポートされる演算子

~ , !~
IS , IS NOT

サポートされない演算子

= , != , > , >= , < , <= IN , NOT IN, WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされる関数

なし

  • 環境に「Third floor」と「Fire escape」の両方のフレーズがそのまま含まれている課題を検索します。
    environment ~ "\"Third floor\"" AND environment ~ "\"Fire escape\""

  • 環境に「Third floor」と「Fire escape」の両方のフレーズがそのまま含まれている課題を検索します。
    environment ~ "\"Third floor\"" AND environment ~ "\"Fire escape\""

2024 年 2 月の時点で、を優先するためにエピック リンク機能は廃止されています。エピック リンク機能を使用する既存のフィルターは引き続き機能しますが、新しいフィルターを作成するときは親を使用する必要があります。

このページの「親」セクションに移動してください。

フィルター

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

注意:

  • フィルター名ではなくフィルター ID で検索することをおすすめします。フィルター名が変更された場合に保存済みフィルターが壊れ、名前を使用して別のフィルタが呼び出されてしまう可能性があります。一方、フィルター ID は一意であり、変更されることはありません。

  • 入力したクエリでリンクの記述に名前を設定していない場合、保存済みフィルターの ORDER BY ステートメントが上書きされます。

  • 無限ループを発生させるフィルターを実行または保存することはできません (つまり、いずれは現在のフィルターを参照する保存済みフィルターを参照することはできません)。

構文

1 filter

エイリアス

1 request , savedFilter , searchRequest

フィールド タイプ

フィルター

オートコンプリート

はい

サポートされる演算子

= , !=
IN , NOT IN

サポートされない演算子

~ , !~ , > , >= , < , <= IS , IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされる関数

なし

  • フィルター "My Saved Filter" (ID: 12000) の結果で、ユーザー jsmith に割り当てられた課題を検索:
    filter = "My Saved Filter" and assignee = jsmith
    or
    filter = 12000 and assignee = jsmith

修正バージョン

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

バージョン名で検索するよりも、バージョン ID で検索する方が安全です。異なるプロジェクトに同名のバージョンが存在する場合があるため、バージョン名で検索すると複数のプロジェクトから課題が返される場合があります。Jira 管理者もバージョン名を変更できますが、その名前に依存している保存済みフィルターが使用できなくなる可能性があります。ただし、バージョン ID は一意であり、変更されることはありません。

構文

1 fixVersion

フィールド タイプ

VERSION

オートコンプリート

はい

サポートされる演算子

= , != , > , >= , < , <=
IS , IS NOT, IN , NOT IN, WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED 

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

サポートされない演算子

~ , !~

サポートされる関数

= および != 演算子と共に使用する場合、このフィールドは以下をサポートします。

  • latestReleasedVersion()

  • earliestUnreleasedVersion()

IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:

  • releasedVersions()

  • unreleasedVersions()

  • 修正バージョンが 3.14 または 4.2 の課題を検索:
    fixVersion in ("3.14", "4.2")
    (Note that full-stops are reserved characters, so they need to be surrounded by quote-marks.)

  • Fix Version が "Little Ted" の課題を検索:
    fixVersion = "Little Ted"

  • 修正バージョン ID が 10001 の課題を検索:
    fixVersion = 10001

階層レベル

JQL フィルターによって、階層レベルに応じて課題をフィルタリングします。このフィールドには、階層レベルに関連する番号が使用されます。番号は次のように使用します。

  • 1 を使用すると、エピックなどの親レベルのタスクでフィルタリングされます。このレベルは Jira 管理者によって定義されます。

  • 0 を使用すると、ストーリーやタスクなど、標準レベルの課題でフィルタリングされます。

  • -1 を使用すると、サブタスクでフィルタリングされます。

現在、このフィールドは Advanced Roadmaps で作成されたカスタム階層レベルをサポートしていません。

構文

1 hierarchyLevel

フィールド タイプ

数値

オートコンプリート

はい

サポートされる演算子

1 = , != , > , >= , < , <= , IN , NOT IN

サポートされない演算子

~ , !~ , IS, IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされる関数

  • なし

  • ストーリー レベルで課題を検索:hierarchyLevel = "0"

  • サブタスク レベルより高い課題を検索: hierarchyLevel > -1

課題キー

特定の課題キーまたは課題 ID (Jira で課題に自動的に割り当てられる番号) に基づいて課題を検索します。

構文

1 issueKey

エイリアス

1 id , issue , key

フィールド タイプ

ISSUE

オートコンプリート

いいえ

サポートされる演算子

= , != , > , >= , < , <=
IN, NOT IN

サポートされない演算子

~ , !~
IS, IS NOT, WAS NOT, WAS NOT IN, CHANGED 

サポートされる関数

IN および NOT IN 演算子とともに使用する場合、issueKey は以下をサポートします。 

  • issueHistory()

  • linkedIssues()

  • votedIssues()

  • watchedIssues()

  • キーが "ABC-123" の課題を検索:
    issueKey = ABC-123

課題にリンクされている、またはリンクされていない課題を検索します。検索を特定のタイプのリンクに制限できます。

構文

issueLinkissueLink["link type"]、または issueLinkType。ここで link type または LinkType は、課題リンク タイプで置き換える変数です (例: blocksduplicates、または is blocked)。

オートコンプリート

はい

サポートされる演算子

= , !=

IN , NOT IN

サポートされない演算子

~ , !~ , > , >= , < , <=

WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED , IS , IS NOT

サポートされる関数

なし

次の課題を検索します。

  • 課題 ABC-123 への任意のタイプのリンクを持つ課題: issueLink = ABC-123

  • リンクされた課題を持つが、特定の課題にはリンクされていない課題:issueLink != ABC-123

  • 課題の一覧のうち 1 つ以上にリンクされている: issueLink in (ABC-123, ABC-456)

  • リンクされた課題があるが、指定した任意の課題にはリンクされていない課題を検索: issueLink not in (ABC-123, ABC-456)

  • 課題 ABC-123 をブロックしている (リンク タイプが "blocks") 課題: issueBlocks = ABC-123 or issueLink["blocks"] = ABC-123

  • 課題 ABC-123 によってブロックされている (リンク タイプが "is blocked by") 課題: issueIsBlockedBy = ABC-123 or issueLink["is blocked by"] = ABC-123

blocks または is duplicated by などの特定のリンク タイプを持つ課題を検索します。検索している Jira インスタンスからのみ課題を探せます。他の Jira インスタンスの課題へのリモート リンクは含まれません。

この JQL クエリによって課題カードに色を追加できます。たとえば、ブロッカーを持つ課題に赤のストライプを追加して、他のすべての課題を緑のままにするとします。これによって、チームの注意が必要な情報を一目で確認できるようになります。詳細については「カードのカスタマイズ」をご参照ください。

構文

1 issueLinkType

オートコンプリート

はい

サポートされる演算子

= , !=
IN , NOT IN

サポートされない演算子

~ , !~ , > , >= , < , <=

WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED , IS , IS NOT

サポートされる関数

なし

次の課題を検索します。

  • "causes" リンク タイプを持つ課題を検索: issueLinkType = causes

  • "duplicates" または "clones" リンク タイプを持つ課題を検索: issueLinkType in (duplicates,clones)

  • “clones” 以外のリンク タイプを持つ: issueLinkType != clones

  • 他の課題によってブロックされている、またはブロッカーを持たない:

    • issueLinkType = "is blocked by"

    • issueLinkType != "is blocked by"

Jira 課題のリンク タイプには次のプロパティがあります。

  • 名前: リンク タイプのタイトル

  • 外向きリンクの説明: ある課題が他の課題に与える影響の説明

  • 内向きリンクの説明: ある課題が他の課題から受ける影響の説明

例えば、あるリンク タイプでは次のようなプロパティを持つ場合があります。

  • 名前: 問題 / インシデント

  • 外向きリンクの説明: causes

  • 内向きリンクの説明: is caused by

issueLinkType を検索すると、Jira では 3 つのプロパティすべてが検索されます。つまり、リンク タイプの名前やいずれかの説明が同じ場合は、特定の内向きまたは外向きリンクの説明を持つ課題を区別できません。一例として、名前と外向きリンクの説明が「blocks」となる、既定の「Blocks」リンク タイプがあります。

たとえば、「blocks」の外向きリンクの説明を使用して課題を具体的に検索する必要がある場合、Jira 管理者はリンク タイプの名前を別のものに変更する必要があります。Jira 管理者の場合、詳細については「課題リンクの設定」をご覧ください。

ラベル

ラベルまたはラベルの一覧でタグ付けされた問題を検索します。ラベルが付いていない課題を検索することもできます。これにより、関連するスプリント、キュー、レポートに表示するためにはどの課題にタグを追加する必要があるかを簡単に確認できます。 

構文

1 labels

フィールド タイプ

LABEL

オートコンプリート

はい

サポートされる演算子

= , !=, IS, IS NOT, IN, NOT IN

サポートされない演算子

~ , !~ , , > , >= , < , <=
WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED

サポートされる関数

なし

  • 既存のラベルを持つ課題を検索:
    labels = "x"

  • 特定のラベルを持たない課題と、ラベルを持たない課題を検索:
    labels not in ("x") or labels is EMPTY

最終閲覧日

最後に閲覧されたのが特定の日付 (または日付範囲)、それよりも前、またはそれよりも後の課題を検索します。時間コンポーネントが指定されていない場合、深夜 0 時と想定されます。検索結果は設定したタイム ゾーン (既定では Jira Server のタイム ゾーン) に対して相対的なものとなります。

以下の形式のいずれかを使用:

"yyyy/MM/dd HH:mm"
"yyyy-MM-dd HH:mm"
"yyyy/MM/dd"
"yyyy-MM-dd"

"w" (週)、"d" (日)、"h" (時間) または "m" (分) を使用して、現在の時刻に対する相対的な日付を指定することもできます。既定は "m" (分) です。引用符 (") を使用する必要があることにご注意ください。引用符を省略した場合、入力した数字はエポック (1970-1-1) のミリ秒後と解釈されます。

構文

1 lastViewed

フィールド タイプ

DATE

オートコンプリート

いいえ

サポートされる演算子

= , != , > , >= , < , <=
IS , IS NOT, IN , NOT IN

サポートされない演算子

~ , !~
WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED 

サポートされる関数

EQUALSNOT EQUALSGREATER THANGREATER THAN EQUALSLESS THAN または LESS THAN EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:

  • currentLogin()

  • lastLogin()

  • now()

  • startOfDay()

  • startOfWeek()

  • startOfMonth()

  • startOfYear()

  • endOfDay()

  • endOfWeek()

  • endOfMonth()

  • endOfYear()

  • 最後に閲覧されたのが 2010 年 12 月 12 日より前のすべての課題を検索:
    lastViewed < "2010/12/12"

  • 最後に閲覧されたのが 2010 年 12 月 12 日以前のすべての課題を検索:
    lastViewed <= "2010/12/13"

  • 最後に閲覧されたのが 2010 年 12 月 12 日の午後 2:00 より前のすべての課題を検索:
    lastViewed > "2010/12/12" and created < "2010/12/12 14:00"

  • 最終閲覧日から 1 日以内の課題を検索:
    lastViewed > "-1d"

  • 最後に閲覧されたのが 2011 年 1 月の課題を検索:
    lastViewed > "2011/01/01" and created < "2011/02/01"

  • 最後に閲覧されたのが 2011 年 1 月 15 日の課題を検索:
    lastViewed > "2011/01/15" and created < "2011/01/16"

レベル

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

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

注意: セキュリティ レベル名ではなくセキュリティ レベル ID で検索することをおすすめします。また、Jira 管理者がセキュリティ レベル名を変更してしまうと、その名前に依存している保存済みフィルターが使用できなくなる可能性がありますが、セキュリティ レベル ID は一意であり、変更されることはありません。

構文

1 level

フィールド タイプ

SECURITY LEVEL

オートコンプリート

はい

サポートされる演算子

= , !=
IS , IS NOT, IN , NOT IN

サポートされない演算子

> , >= , < , <= , ~ , !~
WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED 

サポートされる関数

なし

  • セキュリティ レベルが "Really High" または "level1" の課題を検索:
    level in ("Really High", level1)

  • セキュリティ レベル ID が 123 の課題を検索:
    level = 123

組織

ビジネス プロジェクトでのみ使用します。

組織で共有されているすべてのリクエストを検索します。共有されていないリクエストは返されません。

構文

1 organizations

フィールド タイプ

USER

オートコンプリート

はい

サポートされる演算子

= , !=
IN, NOT IN

組織「Atlassian」で共有されているすべてのリクエストを検索します。

1 organizations = "Atlassian"

初期見積

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

初期見積が特定の値 (日付や日付範囲ではなく数字) に設定されている課題を検索します。"w"、"d"、"h"、"m" を使用して、週、日付、時間、分を指定します。

構文

1 originalEstimate

エイリアス

1 timeOriginalEstimate

フィールド タイプ

DURATION

オートコンプリート

いいえ

サポートされる演算子

= , != , > , >= , < , <=
IS , IS NOT, IN , NOT IN

サポートされない演算子

~ , !~
WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED 

サポートされる関数

なし

  • 初期見積もりが 1 時間である課題を検索:
    originalEstimate = 1h

  • 初期見積もりが 2 日よりも多い課題を検索:
    originalEstimate > 2d

親のすべての子課題を検索します。たとえば、エピックの下にあるすべてのストーリーを表示できます。チーム管理対象プロジェクトと企業管理対象プロジェクトの両方でこの機能を使用できます。

課題キーまたは課題 ID で検索できます。

構文

1 parent

フィールド タイプ

ISSUE

オートコンプリート

いいえ

サポートされる演算子

= , !=
IN , NOT IN

サポートされない演算子

> , >= , < , <= , ~ , !~
IS , IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED 

サポートされる関数

なし

  • 課題 TEST-1234 の子課題である課題を検索:
    parent = TEST-1234

親プロジェクト

特定のプロジェクトに属する親課題を持つすべての子課題を検索します。検索条件にはプロジェクト名またはプロジェクト ID (例: Jira がプロジェクトに自動的に割り当てる番号) を使用できます。

構文

1 parentProject

フィールド タイプ

PROJECT

オートコンプリート

いいえ

サポートされる演算子

=, !=, IN, NOT IN

サポートされない演算子

~, !~

WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED

サポートされる関数

IN および NOT IN 演算子とともに使用する場合、project は以下をサポートします。

  • projectsLeadByUser()

  • projectsWhereUserHasPermission()

  • projectsWhereUserHasRole()

  • 親プロジェクトが ABC である課題を検索:
    parentProject = "ABC"

  • 親プロジェクト ID が 12345 である課題を検索:
    parentProject = 12345

優先度

特定の優先度が設定されている課題を検索します。検索条件には優先度名または優先度 ID (Jira で優先度に自動的に割り当てられる番号 を使用できます。

優先度名ではなく優先度 ID で検索することをおすすめします。Jira 管理者が優先度の名前を変更すると、その名前に依存している保存済みフィルターが使用できなくなる可能性があります。ただし、優先度 ID は一意であり、変更されることはありません。

構文

1 priority

フィールド タイプ

PRIORITY

オートコンプリート

はい

サポートされる演算子

= , != , > , >= , < , <= IS , IS NOT, IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED 

サポートされない演算子

~ , !~

サポートされる関数

なし

  • 優先度が "High" である課題を検索:
    priority = High

  • 優先度 ID が 10000 の課題を検索:
    priority = 10000

Project

特定のプロジェクトに属する課題を検索します。検索条件にはプロジェクト名、プロジェクト キーまたはプロジェクト ID (Jira で優先度に自動的に割り当てられる番号) を使用できます。稀に、同じプロジェクト キーを持つプロジェクトがほかにも存在する場合があります。この場合、プロジェクト キーが優先され、検索結果では 2 つ目のプロジェクトが非表示になります。

構文

1 project

フィールド タイプ

PROJECT

オートコンプリート

はい

サポートされる演算子

= , !=
IS , IS NOT, IN , NOT IN

サポートされない演算子

> , >= , < , <= , ~ , !~
WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED 

サポートされる関数

IN および NOT IN 演算子とともに使用する場合、project は以下をサポートします。

  • projectsLeadByUser()

  • projectsWhereUserHasPermission()

  • projectsWhereUserHasRole()

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

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

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

プロジェクト タイプ

プロジェクトの特定のタイプ (次のいずれか) に所属する課題を検索:

  • business: ビジネス プロジェクトで作成された課題を検索

  • software: Jira で作成された課題を検索

  • service_desk: サービス プロジェクトで作成された課題を検索

結果は権限レベルに応じて異なります。自身がアクセス権を持っている製品の結果のみを表示できます。製品アクセス権の詳細をご確認ください。

構文

projectType

オートコンプリート

はい

サポートされる演算子

=、!=

IN、NOT IN

サポートされない演算子

>、>=、<、<=、~、!~

IS、IS NOT、WAS、WAS NOT、WAS NOT IN、CHANGED

サポートされる関数

なし

ソフトウェア プロジェクトのすべての課題を検索:

projectType = ”software”

ソフトウェア プロジェクトまたはサービス プロジェクトのいずれかに所属するすべての課題を検索:

projectType = ”software” OR projectType = ”service_desk”

ソフトウェア プロジェクトに所属しないすべての課題を検索:

projectType != ”software”

残余見積

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

残余見積が特定の値 (日付や日付範囲ではなく数字) に設定されている課題を検索します。"w"、"d"、"h"、"m" を使用して、週、日付、時間、分を指定します。

構文

1 remainingEstimate

エイリアス

1 timeEstimate

フィールド タイプ

DURATION

オートコンプリート

いいえ

サポートされる演算子

= , != , > , >= , < , <=
IS , IS NOT, IN , NOT IN

サポートされない演算子

~ , !~
WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED 

サポートされる関数

なし

  • 残余見積が 4 時間より多い課題を検索:
    remainingEstimate > 4h

報告者

特定のユーザーが報告した課題を検索します。このユーザーは作成者と同じである場合もあります。検索条件にはユーザーのフルネーム、ID またはメール アドレスを使用できます。

構文

1 reporter

フィールド タイプ

USER

オートコンプリート

はい

サポートされる演算子

= , !=
IS , IS NOT, IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされない演算子

~ , !~ , > , >= , < , <=

サポートされる関数

IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:

  • membersOf()

EQUALS または NOT EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:

  • currentUser()

  • Jill Jones が報告した課題を検索:
    reporter = "Jill Jones"orreporter = jjones

  • bob@mycompany.com
    のメールアドレスを持つユーザーが報告した課題を検索:

    • reporter = "bob@mycompany.com"
      (ピリオドと "@" 記号は予約済みの文字であるため、メール アドレスは引用符で囲う必要があることにご注意ください)

リクエストのチャンネル タイプ

ビジネス プロジェクトでのみ使用します。

課題が作成されたチャンネルに基づいてリクエストを検索します。たとえば、サービス プロジェクトにメールで送信された全リクエストや、カスタマー ポータルから送信された全リクエストを検索できます。

構文

1 request-channel-type

フィールド タイプ

TEXT

オートコンプリート

はい

サポートされる演算子

= , !=

IS, IS NOT, IN, NOT IN

サポートされない演算子 

~ , !~ , > , >= , < , <= WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED

サポートされる関数

IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:

  • email: メールで送信されたリクエスト

  • jira: (青色の [作成] ボタンをクリックして) Jira で作成された課題

  • portal: サービス プロジェクト ポータルから送信されたリクエスト

  • anonymous portal: ログインしていないカスタマーによってカスタマー ポータルから送信されたリクエスト

  • api: REST API によって送信されたリクエスト

  • リクエスト チャンネルがメールである課題を検索:
    request-channel-type = email

  • リクエスト チャンネルがサービス プロジェクト ポータル以外であるリクエストを検索する
    request-channel-type != portal

  • リクエスト チャンネルが CI/CD デプロイ ツールによって送信されたリクエストを検索:
    request-channel-type = deployment

リクエストの最終アクティビティ時刻

ビジネス プロジェクトでのみ使用します。

特定の日付 (または日付範囲)、それよりも前、またはそれよりも後に作成されたリクエストを検索します。時間コンポーネントが指定されていない場合、深夜 0 時と想定されます。検索結果は設定したタイム ゾーン (既定では Jira Server のタイム ゾーン) に対して相対的なものとなります。

以下の形式のいずれかを使用:

"yyyy/MM/dd HH:mm"
"yyyy-MM-dd HH:mm"
"yyyy/MM/dd"
"yyyy-MM-dd"

"w" (週)、"d" (日)、"h" (時間) または "m" (分) を使用して、現在の時刻に対する相対的な日付を指定することもできます。既定は "m" (分) です。引用符 (") を使用する必要があることにご注意ください。引用符を省略した場合、入力した数字はエポック (1970-1-1) のミリ秒後と解釈されます。

構文

1 request-last-activity-time

フィールド タイプ

DATE

オートコンプリート

はい

サポートされる演算子

= , != , > , >= , < , <=

IS, IS NOT, IN, NOT IN

サポートされない演算子 

~ , !~WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED

サポートされる関数

EQUALS、NOT EQUALS、GREATER THAN、GREATER THAN EQUALSLESS THAN または LESS THAN EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:

  • currentLogin()

  • lastLogin()

  • now()

  • startOfDay()

  • startOfWeek()

  • startOfMonth()

  • startOfYear()

  • endOfDay()

  • endOfWeek()

  • endOfMonth()

  • endOfYear()

  • 最終更新日が 2016 年 5 月 23 日より前のすべての課題を検索:
    request-last-activity-time < "2016/05/23"

    • 最終更新日が 2016 年 5 月 23 日以前のすべての課題を検索:
      request-last-activity-time <= "2016/05/23"

    • 2016 年 5 月 23 日に作成され、最終更新日がその日の午後 2:00 より前のすべての課題を検索:
      created > "2016/05/23" AND request-last-activity-time < "2016/05/23 14:00" 

    • 最終更新日から 1 日以内の課題を検索:
      request-last-activity-time > "-1d"

    • 最終更新日が 2016 年 1 月の課題を検索:
      request-last-activity-time > "2016/01/01" and request-last-activity-time < "2016/02/01"

リクエスト タイプ

サービス プロジェクトでのみ使用されます。

特定のリクエスト タイプのリクエストを検索します。リクエスト タイプの設定画面で設定したリクエスト タイプの名前または説明で検索できます。 

構文

1 "Request Type"

フィールド タイプ

カスタム フィールド

オートコンプリート

はい

サポートされる演算子

1 = , !=

IN , NOT IN

サポートされない演算子

~ , !~ , > , >= , < , <= IS , IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

リクエスト タイプの Lucene 値は portal-key/request-type-key であることにご注意ください。サービス プロジェクト ポータルの作成後にポータル キーを変更することはできませんが、プロジェクト キーは変更できます。リクエスト タイプの作成後にリクエスト タイプ キーを変更することはできません。

サポートされる関数

なし

  • ユーザーがアクセス権を持つプロジェクトで、リクエスト タイプが Request a new account である課題を検索:
    "Request Type" = "Request a new account"

  • SimpleDesk プロジェクトで、リクエスト タイプが Request a new account であり、右側のオペランドがオート コンプリート候補リストから選択した Lucene 値である課題を検索:
    "Request Type" = "sd/system-access"

  • リクエスト タイプが Request a new account または Get IT Help である課題を検索:
    "Request Type" IN ("Request a new account", "Get IT Help")

ソリューション

サービスのチーム管理対象プロジェクトには、解決状況フィールドは存在しません。つまり、解決状況フィールドを使用して Jira Service Management のチーム管理対象プロジェクトにある課題は検索できません。代わりに、statusCategory フィールド (statusCategory = Done となっている場合、課題は解決済み) を使用できます。

特定の解決策がある課題を検索します。検索条件には解決策名または解決策 ID (Jira で解決策に自動的に割り当てられる番号) を使用できます。

解決策の名前ではなく ID で検索することをおすすめします。Jira 管理者が解決策の名前を変更すると、その名前に依存している保存済みフィルターが使用できなくなる可能性があります。ただし、解決策の ID は一意であり、変更されることはありません。

構文

1 resolution

フィールド タイプ

RESOLUTION

オートコンプリート

はい

サポートされる演算子

= , != , > , >= , < , <=
IS , IS NOT, IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされない演算子

~ , !~

サポートされる関数

なし

  • 解決状況が「Can't Reproduce」または「Won't Fix」になっている課題を検索します。
    resolution in ("Can't Reproduce", "Won't Fix")

  • 解決状況 ID が 5 の課題を検索:
    resolution = 5

  • 解決状況がない課題を検索します。
    resolution = unresolved

解決済

特定の日付 (または日付範囲)、それよりも前、またはそれよりも後に解決された課題を検索します。時間コンポーネントが指定されていない場合、深夜 0 時と想定されます。検索結果は設定したタイム ゾーン (既定では Jira Server のタイム ゾーン) に対して相対的なものとなります。

以下の形式のいずれかを使用:

"yyyy/MM/dd HH:mm"
"yyyy-MM-dd HH:mm"
"yyyy/MM/dd"
"yyyy-MM-dd"

"w" (週)、"d" (日)、"h" (時間) または "m" (分) を使用して、現在の時刻に対する相対的な日付を指定することもできます。既定は "m" (分) です。引用符 (") を使用する必要があることにご注意ください。引用符を省略した場合、入力した数字はエポック (1970-1-1) のミリ秒後と解釈されます。

構文

1 resolved

エイリアス

1 resolutionDate

フィールド タイプ

DATE

オートコンプリート

いいえ

サポートされる演算子

= , != , > , >= , < , <=
IS , IS NOT, IN , NOT IN

サポートされない演算子

~ , !~ WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされる関数

EQUALS、NOT EQUALS、GREATER THAN、GREATER THAN EQUALS、LESS THAN、LESS THAN EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:

  • currentLogin()

  • lastLogin()

  • now()

  • startOfDay()

  • startOfWeek()

  • startOfMonth()

  • startOfYear()

  • endOfDay()

  • endOfWeek()

  • endOfMonth()

  • endOfYear()

  • 2010 年 12 月 31 日よりも前に解決されたすべての課題を検索:
    resolved < "2010/12/31"

  • 2010 年 12 月 31 日午後 2:00 よりも前に解決されたすべての課題を検索:
    resolved < "2010/12/31 14:00"

  • 2010 年 12 月 31 日以前に解決されたすべての課題を検索:
    resolved <= "2011/01/01"

  • 2011 年 1 月に解決された課題を検索:
    resolved > "2011/01/01" and resolved < "2011/02/01"

  • 2011 年 1 月 15 日に解決された課題を検索:
    resolved > "2011/01/15" and resolved < "2011/01/16"

  • 過去 1 時間以内に解決された課題を検索:
    resolved > -1h

SLA

サービス プロジェクトでのみ使用されます。

リクエストを検索および整理し、SLA 目標を達成するのに役立ててください。SLA が完了状態にあるリクエストや、SLA クロックに一定の時間存在しているリクエストを検索できます。 

構文

1 Time to resolution

Time to first response

<your custom SLA name>

フィールド タイプ

SLA

オートコンプリート

いいえ

サポートされる演算子

= , !=, > , >= , < , <=

サポートされない演算子

~ , !~
IS , IS NOT , IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされる関数

  • breached()

  • completed()

  • elapsed()

  • everBreached()

  • paused()

  • remaining()

  • running()

  • withinCalendarHours()

  • 初回応答時間に違反した課題を検索:
    "Time to First Response" = everBreached()

  • SLA カレンダーによって解決時間の SLA が一時停止している課題を検索:
    "Time to Resolution" = paused()

  • SLA カレンダーによって解決時間の SLA が一時停止している課題を検索:
    "Time to Resolution" = withinCalendarHours()

  • 応答を 1 時間より長く待機している課題を検索:
    "Time to First Response" > elapsed("1h")

  • Find issues that that will breach Time to First Response in the next two hours:
    "Time to First Response" < remaining("2h")

Sprint

特定のスプリントに割り当てられている課題を検索します。アクティブなスプリントと将来のスプリントが対象となります。検索はスプリント名、またはスプリント ID (Jira でスプリントに自動的に割り当てられる番号) のいずれかに基づいて行われます。

似た名前、あるいは同じ名前の複数のスプリントがある場合、スプリント名またはスプリント名の一部を使用して検索できます。一致候補はオートコンプリート ドロップダウンに表示され、表示されるスプリントの日付でスプリントを見分けることができます (括弧内にスプリント ID も表示されます)。

構文

1 sprint

フィールド タイプ

NUMBER

オートコンプリート

はい

サポートされる演算子

= , !=
IS , IS NOT, IN , NOT IN

サポートされない演算子

~ , !~ , > , >= , < , <= WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされる関数

  • openSprints()

  • closedSprints()

  • スプリント 999 に所属する課題を検索:
    sprint = 999

  • スプリント "February 1" に所属する課題を検索:
    sprint = "February 1"

  • "February 1"、"February 2" または "February 3" のいずれかに所属する課題を検索:
    sprint in ("February 1","February 2","February 3")

  • スプリントに割り当てられた課題を検索する
    sprint is not empty

ステータス

特定のステータスを持つ課題を検索します。検索条件にはステータス名またはステータス ID (Jira でステータスに自動的に割り当てられる番号) を使用できます。

Jira 管理者がステータスの名前を変更すると、その名前に依存する保存済みフィルターが使用できなくなる可能性があるため、ステータス名よりもステータス ID で検索する方が安全です。ただし、ステータス ID は一意であり、変更されることはありません。

WAS、WAS NOT、WAS IN、WAS NOT IN 演算子は、名前でのみ使用できます (ID では不可)。

構文

1 status

フィールド タイプ

STATUS

オートコンプリート

はい

サポートされる演算子

= , !=
IS , IS NOT, IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされない演算子

~ , !~ , > , >= , < , <=

サポートされる関数

なし

  • ステータス が「Open (未処理)」の課題を検索する
    status = Open

  • ステータス ID が 1 の課題を検索:
    status = 1

  • 現在または過去のステータスが「Open (未処理)」である (であった) 課題を検索する
    status WAS Open

要約

Jira テキスト検索構文によって、要約に特定のテキストが含まれている課題を検索します。テキスト フィールドの検索構文の詳細をご確認ください。

構文

1 summary

フィールド タイプ

TEXT

オートコンプリート

いいえ

サポートされる演算子

~ , !~
IS , IS NOT

サポートされない演算子

= , != , > , >= , < , <=
IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされる関数

なし

  • 要約に「Error saving file」という語が含まれている課題を検索します (「語句検索」一致)。
    summary ~ "Error saving file"

  • 要約に「Error saving file」と完全一致するフレーズが含まれている課題を検索します。
    summary ~  "\"Error saving file\""

  • 要約に「Error saving file」と「Create new version」の両方のフレーズがそのまま含まれている課題を検索します。
    summary ~ "\"Error saving file\"" AND summary ~ "\"Create new version\""

テキスト

これは、課題に対して次のようなすべてのテキスト フィールドを検索できるマスター フィールドです。

  • 要約

  • 説明

  • 環境

  • コメント

  • "Free Text Searcher" を使用するカスタム フィールド。これには以下の組み込みカスタム フィールド タイプが含まれます。

    • フリー テキスト フィールド (無制限のテキスト)

    • テキスト フィールド (255 文字まで)

    • 読み取り専用のテキスト フィールド

Jira テキスト検索構文によって、特定のテキストが存在する課題を検索します。テキスト フィールドの検索構文の詳細をご確認ください。

text マスター フィールドは、CONTAINS 演算子 ("~") と一緒にのみ使用できます。

一部の文字や単語は予約されているため、課題の検索には使用できません。予約文字の詳細をご確認ください。

構文

1 text

フィールド タイプ

TEXT

オートコンプリート

いいえ

サポートされる演算子

~

サポートされない演算子

!~, = , != , > , >= , < , <=
IS , IS NOT , IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされる関数

なし

  • 「Fred」という語を含むテキスト フィールドがある課題を検索します。
    text ~ "Fred" または text ~ Fred

  • "full screen" という単語を含むテキスト フィールドを持つすべての課題を検索:
    text ~ "full screen"

  • テキスト フィールドに「フルスクリーン」と完全一致するフレーズが含まれているすべての課題を検索します。
    text ~ "\"full screen\""

  • テキスト フィールドに「full screen」と「minimize screen」というフレーズがそのまま含まれている課題をすべて検索します。
    text ~ "\"full screen\"" AND text ~ "\"minimize screen\""

テキスト フィールド

Similar to text, this is a master-field that allows you to search in most text fields (except Comments, Worklog) for issues, such as:

  • 要約

  • 説明

  • 環境

  • "Free Text Searcher" を使用するカスタム フィールド。これには以下の組み込みカスタム フィールド タイプが含まれます。

    • フリー テキスト フィールド (無制限のテキスト)

    • テキスト フィールド (255 文字まで)

    • 読み取り専用のテキスト フィールド

textfields マスター フィールドは、CONTAINS 演算子 ("~") と一緒にのみ使用できます。

一部の文字や単語は予約されているため、課題の検索には使用できません。予約文字の詳細をご確認ください。

構文

1 textfields

フィールド タイプ

TEXT

オートコンプリート

いいえ

サポートされる演算子

~

サポートされない演算子

!~, = , != , > , >= , < , <=
IS , IS NOT , IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされる関数

なし

  • 「Fred」という語を含むテキスト フィールドがある課題を検索します。
    textfields ~ "Fred" または textfields ~ Fred

  • "full screen" という単語を含むテキスト フィールドを持つすべての課題を検索:
    textfields ~ "full screen"

  • テキスト フィールドに「フルスクリーン」と完全一致するフレーズが含まれているすべての課題を検索します。
    textfields ~ "\"full screen\""

  • テキスト フィールドに「full screen」と「minimize screen」というフレーズがそのまま含まれている課題をすべて検索します。
    textfields ~ "\"full screen\"" AND textfields ~ "\"minimize screen\""

消費時間

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

消費時間が特定の値 (日付や日付範囲ではなく数字) に設定されている課題を検索します。"w"、"d"、"h"、"m" を使用して、週、日付、時間、分を指定します。

構文

1 timeSpent

フィールド タイプ

DURATION

オートコンプリート

いいえ

サポートされる演算子

= , != , > , >= , < , <=
IS , IS NOT , IN , NOT IN

サポートされない演算子

~ , !~ 
WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされる関数

なし

  • 消費時間が 5 日より多い課題を検索:
    timeSpent > 5d

タイプ

特定の課題タイプの課題を検索します。検索条件には課題タイプ名または課題タイプ ID (Jira で課題タイプに自動的に割り当てられる番号) を使用できます。

タイプ名ではなくタイプ ID で検索することをおすすめします。Jira 管理者がタイプ名を変更してしまうと、その名前に依存している保存済みフィルターが使用できなくなる可能性がありますが、タイプ ID は一意であり、変更されることはありません。

構文

1 type

エイリアス

1 issueType

フィールド タイプ

ISSUE_TYPE

オートコンプリート

はい

サポートされる演算子

= , !=
IS , IS NOT , IN , NOT IN

サポートされない演算子

~ , !~  , > , >= , < , <=
WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされる関数

なし

  • 課題タイプが "Bug" の課題を検索:
    type = Bug

  • 課題タイプが "Bug" または "Improvement" の課題を検索:
    issueType in (Bug,Improvement)

  • 課題タイプ ID が 2 の課題を検索:
    issueType = 2

更新日

最後に更新されたのが特定の日付 (または日付範囲)、それよりも前、またはそれよりも後の課題を検索します。時間コンポーネントが指定されていない場合、深夜 0 時と想定されます。検索結果は設定したタイム ゾーン (既定では Jira Server のタイム ゾーン) に対して相対的なものとなります。

以下の形式のいずれかを使用:

"yyyy/MM/dd HH:mm"
"yyyy-MM-dd HH:mm"
"yyyy/MM/dd"
"yyyy-MM-dd"

"w" (週)、"d" (日)、"h" (時間) または "m" (分) を使用して、現在の時刻に対する相対的な日付を指定することもできます。既定は "m" (分) です。引用符 (") を使用する必要があることにご注意ください。引用符を省略した場合、入力した数字はエポック (1970-1-1) のミリ秒後と解釈されます。

構文

1 updated

エイリアス

1 updatedDate

フィールド タイプ

DATE

オートコンプリート

いいえ

サポートされる演算子

= , != , > , >= , < , <=
IS , IS NOT , IN , NOT IN

サポートされない演算子

~ , !~ 
WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされる関数

EQUALSNOT EQUALS、GREATER THAN、GREATER THAN EQUALS、LESS THAN または LESS THAN EQUALS 演算子と併用する場合、このフィールドは次をサポートします。

  • currentLogin()

  • lastLogin()

  • now()

  • startOfDay()

  • startOfWeek()

  • startOfMonth()

  • startOfYear()

  • endOfDay()

  • endOfWeek()

  • endOfMonth()

  • endOfYear()

  • 最終更新日が 2010 年 12 月 12 日より前の課題を検索:
    updated < "2010/12/12"

  • 最終更新日が 2010 年 12 月 12 日以前の課題を検索:
    updated < "2010/12/13"

  • 2010 年 12 月 31 日午後 2:00 よりも前に更新されたすべての課題を検索:
    updated < "2010/12/31 14:00"

  • 最終更新日が 2 週間より前である課題を検索:
    updated < "-2w"

  • 最終更新日が 2011 年 1 月 15 日である課題を検索:
    updated > "2011/01/15" and updated < "2011/01/16"

  • 最終更新日が
    updated > "2011/01/01" and updated < "2011/02/01" 2011 年 1 月である課題を検索:

投票者

特定のユーザーが投票した課題を検索します。検索条件にはユーザーのフルネーム、ID またはメールアドレスを使用できます。自分の投票を検索する場合を除き、 "View Voters and Watchers"(投票者とウォッチャーの表示)権限を持つ課題のみを検索できます。 

構文

1 voter

フィールド タイプ

USER

オートコンプリート

はい

サポートされる演算子

= , !=
IS , IS NOT , IN , NOT IN

サポートされない演算子

~ , !~ , > , >= , < , <=
WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされる関数

IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:

  • membersOf()

EQUALS および NOT EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:

  • currentUser()

  • 自身が投票した課題を検索:
    voter = currentUser()

  • ユーザー "jsmith" が投票した課題を検索:
    voter = "jsmith"

  • グループ "jira-administrators" のメンバーが投票した課題を検索:
    voter in membersOf("jira-administrators")

投票数

指定した数の投票数を持つ課題を検索します。

構文

1 votes

フィールド タイプ

NUMBER

オートコンプリート

いいえ

サポートされる演算子

= , != , > , >= , < , <=
IN , NOT IN

サポートされない演算子

~ , !~ 
IS , IS NOT , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされる関数

なし

  • 12 票以上の投票数を持つすべての課題を検索:
    votes >= 12

ウォッチャー

特定のユーザーがウォッチしている課題を検索します。ユーザーの氏名、ID、またはメール アドレスで検索できます。自分がウォッチャーである課題を検索する場合を除いて、「投票者とウォッチャーの表示」権限を持つ課題のみを検索できることにご留意ください。watchedIssues もご参照ください。

構文

1 watcher

フィールド タイプ

USER

オートコンプリート

はい

サポートされる演算子

= , !=
IS , IS NOT , IN , NOT IN

サポートされない演算子

~ , !~ , > , >= , < , <=
WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされる関数

IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:

  • membersOf()

EQUALS および NOT EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:

  • currentUser()

  • 自身がウォッチしている課題を検索:
    watcher = currentUser()

  • ユーザー "jsmith" がウォッチしている課題を検索:
    watcher = "jsmith"

  • グループ "jira-administrators" がウォッチしている課題を検索:
    watcher in membersOf("jira-administrators")

ウォッチャー

指定した数のウォッチャーを持つ課題を検索します。

構文

1 watchers

フィールド タイプ

NUMBER

オートコンプリート

いいえ

サポートされる演算子

= , != , > , >= , < , <=
IN , NOT IN

サポートされない演算子

~ , !~ 
IS , IS NOT , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされる関数

なし

  • 4 人以上のユーザーにウォッチされているすべての課題を検索:
    watchers > 3

作業ログへのコメント

このフィールドは Jira 管理者によって時間管理が有効にされている場合にのみ使用できます。また、CONTAINS 演算子 ("~") のみに対応しています。

Jira テキスト検索構文によって、作業ログのコメントに特定のテキストが存在する課題を検索します。テキスト フィールドの検索構文の詳細をご確認ください。

構文

1 worklogComment

フィールド タイプ

TEXT

オートコンプリート

いいえ

サポートされる演算子

~

サポートされない演算子

!~, = , != , > , >= , < , <=
IS , IS NOT , IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされる関数

なし

  • ワークログ コメントに「Fred」という単語が含まれている課題を検索:
    worklogComment ~ "Fred"

  • ワークログ コメントに「full screen」という単語が含まれているすべての課題を検索:
    worklogComment ~ "full screen"

  • ワークログ コメントに「full screen」というフレーズがそのまま含まれている課題をすべて検索します。
    worklogComment ~ "\"full screen\""

  • ワークログ コメントに「full screen」と「minimize screen」の両方のフレーズがそのまま含まれている課題をすべて検索します。
    worklogComment ~ "\"full screen\"" AND worklogComment ~ "\"minimize screen\""

作業ログの日付

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

特定の日付でワークログに記録された課題を検索する

構文

1 worklogDate

フィールド タイプ

DATE

オートコンプリート

いいえ

サポートされる演算子

= , != , > , >= , < , <=
IS , IS NOT , IN , NOT IN

サポートされない演算子

~ , !~ 
WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされる関数

EQUALSNOT EQUALS、GREATER THAN、GREATER THAN EQUALS、LESS THAN または LESS THAN EQUALS 演算子と併用する場合、このフィールドは次をサポートします。

  • currentLogin()

  • lastLogin()

  • now()

  • startOfDay()

  • startOfWeek()

  • startOfMonth()

  • startOfYear()

  • endOfDay()

  • endOfWeek()

  • endOfMonth()

  • endOfYear()

  • 2010 年 12 月 12 日に誰かが作業を記録した課題を検索
    worklogDate = "2010/12/12":

  • 過去 1 週間に誰かが作業を記録した課題を検索:
    worklogDate > startOfWeek()

作業率

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

作業率が特定の値である課題を検索します。作業率の計算方法は次のとおりです: workRatio = timeSpent / originalEstimate) x 100

構文

1 workRatio

フィールド タイプ

NUMBER

オートコンプリート

いいえ

サポートされる演算子

= , != , > , >= , < , <=
IS , IS NOT , IN , NOT IN

サポートされない演算子

~ , !~ 
WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED

サポートされる関数

なし

  • 消費時間が初期見積もりの 75 % よりも多い課題を検索:
    workRatio > 75

 

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。