Jira Automation のドキュメントが移動しました。

以前「Jira のプロセスとワークフローを自動化する」セクションにあった Jira Cloud Automation に関連するすべてのコンテンツ、新しい Cloud Automation のドキュメントに移動しました。

Cloud の自動化のドキュメントに移動する | これを行った理由

高度な検索リファレンス - 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()

  • 影響バージョンが 3.14 である課題を検索:
    affectedVersion = "3.14"
    終止符は予約語のため、引用符で囲む必要があります。

  • 影響バージョンが "Big Ted" である課題を検索:
    affectedVersion = "Big Ted"

  • 影響バージョンの 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"

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

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

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

構文

1 change-gating-type

フィールド タイプ

TEXT

オートコンプリート

はい

サポートされる演算子

=、!=

IS、IS NOT、IN、NOT IN

サポートされない演算子 

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

サポートされる関数

なし

  • ゲーティング タイプが空であるリクエストを検索:
    hange-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"

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)
    または
    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) のミリ秒後と解釈されます。

構文

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"

  • 2011 年 1 月 15 日に作成されたすべての課題を検索: 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"
    または
    creator = "jjones"

  • メール アドレスを持つユーザーが作成した課題を検索:
    creator = "bob@mycompany.com"
    (終止符と "@" 記号は予約済みの文字であるため、メール アドレスを引用符で囲む必要があります) 

カスタム フィールド

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

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

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

構文

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

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

構文

1 "Customer 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 (新規アカウントをリクエスト) である課題を検索:
    "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 テキスト検索構文を使用した特定のテキストを含む課題を検索します。テキスト フィールドの検索構文に関する詳細についてご確認ください

構文

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"

期限

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

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

"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" を含む課題を検索:
    environment ~ "Third floor"

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

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

構文

1 "epic link"

フィールド タイプ

Epic Link Relationship

オートコンプリート

いいえ

サポートされる演算子

=、!=
IS、IS NOT、IN、NOT IN

サポートされない演算子

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

サポートされる関数

IN または NOT IN の各演算子と併用する場合、エピック リンクは次をサポートします:

  • issueHistory()

  • linkedIssues()

  • votedIssues()

  • watchedIssues()

  • Jupiter の課題キーが ANERDS-31 である場合に、"Jupiter" エピックに所属する課題を検索:
    "epic link" = ANERDS-31
    or
    "epic link" = Jupiter

フィルター

保存済みフィルターを使用して検索を絞り込むことができます。フィルター名またはフィルター 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
    または
    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")
    (注: ピリオドは予約済みの文字であるため、引用符で囲う必要があります)

  • 修正バージョンが "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 の値を課題リンク タイプ (blocksduplicatesis blocked by など) に置き換えます。

オートコンプリート

はい

サポートされる演算子

=、!=

IN、NOT IN

サポートされない演算子

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

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

サポートされる関数

なし

次の課題を検索します。

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

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

  • 一連の課題のいずれかにリンクされている課題を検索: 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

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) のミリ秒後と解釈されます。

構文

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

組織

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

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

構文

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 (Jira が課題に自動で割り当てる番号) に基づいて検索できます。

構文

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 が優先度に自動的に割り当てる番号) を使用して検索できます。

優先度名ではなく優先度 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 

サポートされる関数

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

構文

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

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

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

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

構文

1 request-channel-type

フィールド タイプ

TEXT

オートコンプリート

はい

サポートされる演算子

=、!=

IS、IS NOT、IN、NOT IN

サポートされない演算子 

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

サポートされる関数

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

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

  • 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) のミリ秒後と解釈されます。

構文

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 時より前であるすべての課題を検索:
      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 は一意であり、変更されることはありません。

構文

1 resolution

フィールド タイプ

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) のミリ秒後と解釈されます。

構文

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

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

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

構文

1 Time to resolution

Time to first response

<カスタムの SLA 名>

フィールド タイプ

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 が一時停止している課題を検索:
    "Time to Resolution" = paused()

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

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

  • 最初のレスポンスまでの時間を 2 時間以内に違反する課題を検索:
    "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"、または過去に "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"

テキスト

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

  • 要約

  • 説明

  • 環境

  • コメント

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

消費時間

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

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

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

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

投票者

特定のユーザーが投票した課題を検索します。検索条件にはユーザーのフルネーム、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

サポートされる関数

なし

  • 3 人を超えるユーザーにウォッチされているすべての課題を検索:
    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"

作業ログの日付

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

 

その他のヘルプ