高度な検索リファレンス - JQL フィールド

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

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

対象バージョン

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

構文

フィールド タイプ

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 でのみ使用します。

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

構文

フィールド タイプ

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 またはメール アドレスを使用できます。

構文

フィールド タイプ

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"

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

添付ファイル

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

構文

フィールド タイプ

ATTACHMENT

オートコンプリート

はい

サポートされる演算子

IS, IS NOT

サポートされない演算子

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

サポートされる関数

なし

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

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

カテゴリー

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

構文

フィールド タイプ

CATEGORY

オートコンプリート

はい

サポートされる演算子

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

サポートされない演算子

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

サポートされる関数

なし

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

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

Jira Service Management でのみ使用します。

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

構文

フィールド タイプ

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 テキスト検索構文によって、コメントに特定のテキストを含む課題を検索します。テキスト フィールドの検索構文に関する詳細についてご確認ください

構文

フィールド タイプ

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"

Component

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

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

構文

フィールド タイプ

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 サーバーのタイムゾーン) に対して相対的なものとなります。

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

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

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

構文

エイリアス

フィールド タイプ

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)。その他のオプションについては「報告者」をご参照ください。 

構文

フィールド タイプ

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 は一意であり、変更されることはありません。

構文

エイリアス

フィールド タイプ

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

"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 Service Management でのみ使用します。

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

構文

フィールド タイプ

カスタム フィールド

オートコンプリート

はい

サポートされる演算子

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" である課題を検索:
    "Customer Request Type" = "Request a new account"

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

  • カスタマー リクエスト タイプが "Request a new account (新規アカウントをリクエスト)" または "Get IT Help (IT ヘルプを依頼)" である課題を検索:
    "Customer Request Type" IN ("Request a new account", "Get IT Help")

説明

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

構文

フィールド タイプ

TEXT

オートコンプリート

いいえ

サポートされる演算子

~ , !~
IS , IS NOT

サポートされない演算子

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

サポートされる関数

なし

  • 説明に "Please see screenshot" という単語を含む課題を検索:
    description ~ "Please see screenshot"

期限

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

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

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

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

構文

エイリアス

フィールド タイプ

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 テキスト検索構文を使用した特定のテキストを含む課題を検索します。テキスト フィールドの検索構文に関する詳細についてご確認ください

構文

フィールド タイプ

TEXT

オートコンプリート

いいえ

サポートされる演算子

~ , !~
IS , IS NOT

サポートされない演算子

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

サポートされる関数

なし

  • 環境に "Third floor" という単語を含む課題を検索:
    environment ~ "Third floor"

企業管理対象プロジェクトで、特定のエピックに所属する課題を検索します。検索はエピックの名前、課題キー、課題 ID (Jira が課題に自動で割り当てる番号) のいずれかに基づいて実行されます。

チーム管理対象プロジェクトで特定のエピックに割り当てられた課題を検索するには、parent を使用します。

構文

フィールド タイプ

Epic Link Relationship

オートコンプリート

いいえ

サポートされる演算子

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

サポートされない演算子

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

サポートされる関数

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

  • issueHistory()

  • linkedIssues()

  • votedIssues()

  • watchedIssues()

  • エピック "Jupiter" (課題キー ANERDS-31) に所属する課題を検索:
    "epic link" = ANERDS-31
    or
    "epic link" = Jupiter

フィルター

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

注意:

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

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

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

構文

エイリアス

フィールド タイプ

フィルター

オートコンプリート

はい

サポートされる演算子

= , !=
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 は一意で変更できません。

構文

フィールド タイプ

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 で作成されたカスタム階層レベルをサポートしていません。

構文

フィールド タイプ

数値

オートコンプリート

はい

サポートされる演算子

サポートされない演算子

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

サポートされる関数

  • なし

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

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

課題キー

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

構文

エイリアス

フィールド タイプ

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

構文

オートコンプリート

はい

サポートされる演算子

= , !=
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 管理者の場合、詳細については「課題リンクの設定」をご参照ください。

ラベル

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

構文

フィールド タイプ

LABEL

オートコンプリート

はい

サポートされる演算子

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

1 つのラベルを検索するには 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 サーバーのタイムゾーン) に対して相対的なものとなります。

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

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

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

構文

フィールド タイプ

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 は一意であり、変更されることはありません。

構文

フィールド タイプ

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

組織

Jira Service Management でのみ使用します。

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

構文

フィールド タイプ

USER

オートコンプリート

はい

サポートされる演算子

= , !=
IN, NOT IN

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

初期見積

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

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

構文

エイリアス

フィールド タイプ

DURATION

オートコンプリート

いいえ

サポートされる演算子

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

サポートされない演算子

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

サポートされる関数

なし

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

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

企業管理対象プロジェクトにある特定の課題のすべてのサブタスク、またはチーム管理対象プロジェクトにある特定のエピックのサブタスクを検索します。課題キーまたは課題 ID (Jira が課題に自動で割り当てる番号) に基づいて検索できます。

構文

フィールド タイプ

ISSUE

オートコンプリート

はい

サポートされる演算子

= , !=
IN , NOT IN

サポートされない演算子

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

サポートされる関数

なし

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

優先度

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

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

構文

フィールド タイプ

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 つ目のプロジェクトが非表示になります。

構文

フィールド タイプ

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: Jira Work Management プロジェクトで作成された課題を検索

  • “software”: Jira Software プロジェクトで作成された課題を検索

  • “service_desk”: Jira Service Management プロジェクトで作成された課題を検索

結果は権限レベルに応じて異なります。自身がアクセス権を持っている製品の結果のみを表示できます。製品アクセスについてはこちらをお読みください

構文

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" を使用して、週、日付、時間、分を指定します。

構文

エイリアス

フィールド タイプ

DURATION

オートコンプリート

いいえ

サポートされる演算子

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

サポートされない演算子

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

サポートされる関数

なし

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

報告者

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

構文

フィールド タイプ

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"
      (ピリオドと "@" 記号は予約済みの文字であるため、メール アドレスは引用符で囲う必要があることにご注意ください)

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

Jira Service Management でのみ使用します。

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

構文

フィールド タイプ

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

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

Jira Service Management でのみ使用します。

特定の日付 (または日付範囲)、それよりも前、またはそれよりも後に作成されたリクエストを検索します。時間コンポーネントが指定されていない場合、深夜 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) のミリ秒後と解釈されます。

構文

フィールド タイプ

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"

ソリューション

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

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

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

構文

フィールド タイプ

RESOLUTION

オートコンプリート

はい

サポートされる演算子

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

サポートされない演算子

~ , !~

サポートされる関数

なし

  • 解決状況が "Cannot Reproduce" または "Won't Fix" の課題を検索:
    resolution in ("Cannot Reproduce", "Won't Fix")

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

  • 解決状況がない課題を検索:
    resolution = unresolved

解決済

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

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

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

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

構文

エイリアス

フィールド タイプ

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

Jira Service Management でのみ使用します。

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

構文

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 も表示されます)。

構文

フィールド タイプ

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 では不可)。

構文

フィールド タイプ

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 テキスト検索構文を使用した特定のテキストを含む課題を検索します。テキスト フィールドの検索構文に関する詳細についてご確認ください

構文

フィールド タイプ

TEXT

オートコンプリート

いいえ

サポートされる演算子

~ , !~
IS , IS NOT

サポートされない演算子

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

サポートされる関数

なし

  • 概要に "Error saving file" という単語を含む課題を検索:
    summary ~ "Error saving file"

テキスト

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

  • 要約

  • 説明

  • 環境

  • コメント

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

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

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

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

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

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

構文

フィールド タイプ

TEXT

オートコンプリート

いいえ

サポートされる演算子

~

サポートされない演算子

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

サポートされる関数

なし

  • "Fred" という語を含むテキスト フィールドを持つ課題を検索:
    text ~ "Fred"
    or
    text ~ Fred

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

消費時間

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

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

構文

フィールド タイプ

DURATION

オートコンプリート

いいえ

サポートされる演算子

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

サポートされない演算子

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

サポートされる関数

なし

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

タイプ

特定の課題タイプの課題を検索します。課題タイプ名または課題タイプ ID (Jira が課題タイプに自動的に割り当てる番号) に基づいて検索できます。

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

構文

エイリアス

フィールド タイプ

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 サーバーのタイムゾーン) に対して相対的なものとなります。

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

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

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

構文

エイリアス

フィールド タイプ

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 > "20011/01/01" and updated < "2011/02/01" 2011 年 1 月である課題を検索:

投票者

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

構文

フィールド タイプ

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

投票数

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

構文

フィールド タイプ

NUMBER

オートコンプリート

いいえ

サポートされる演算子

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

サポートされない演算子

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

サポートされる関数

なし

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

ウォッチャー

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

構文

フィールド タイプ

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

ウォッチャー

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

構文

フィールド タイプ

NUMBER

オートコンプリート

いいえ

サポートされる演算子

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

サポートされない演算子

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

サポートされる関数

なし

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

作業ログへのコメント

このフィールドは Jira 管理者によってタイム トラッキングが有効にされている場合にのみ使用できます。また、CONTAINS 演算子 ("~") のみサポートします。

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

構文

フィールド タイプ

TEXT

オートコンプリート

いいえ

サポートされる演算子

~

サポートされない演算子

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

サポートされる関数

なし

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

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

作業ログの日付

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

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

構文

フィールド タイプ

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

構文

フィールド タイプ

NUMBER

オートコンプリート

いいえ

サポートされる演算子

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

サポートされない演算子

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

サポートされる関数

なし

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

 

その他のヘルプ