詳細検索 - フィールド リファレンス
このページでは、詳細検索で使用されるフィールドについて説明します。JQL のフィールドとは、Jira フィールド (または Jira アプリケーションで定義済みのカスタム フィールド) に対応する単語です。句では、フィールドの後に演算子、その後に 1 つ以上の値 (または関数) が続きます。演算子はフィールドの値を右側の 1 つ以上の値または関数と比較して、true となる結果のみが句によって取得されます。注: JQLでは 2 つのフィールドを比較できません。
対象バージョン
特定の対象バージョンに割り当てられた課題を検索します。検索条件にはバージョン名またはバージョン ID (Jira がバージョンに自動的に割り当てる番号) を使用できます。バージョン名で検索するよりも、バージョン ID で検索することをおすすめします。これは、異なるプロジェクトで同じ名前を使用している可能性があるためです。また、Jira 管理者がバージョン名を変更した場合、その名前に依存している保存済みのフィルターが使用できなくなる可能性がありますが、バージョン ID は一意であり、変更されることはありません。
構文 | affectedVersion |
---|---|
フィールド タイプ | VERSION |
オートコンプリート | はい |
サポートされる演算子 | = , != , > , >= , < , <= IS, IS NOT, IN, NOT IN 比較演算子 (例: ">") は、数値やアルファベット順ではなくプロジェクト管理者が設定したバージョン順を使用することにご注意ください。 |
サポートされない演算子 | ~ , !~ WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED |
サポートされる関数 | = と != 演算子と併用する際に、このフィールドは次をサポートします。
IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
承認
Used in Jira Service Management only.
承認済みまたは承認待ちのリクエストを検索します。この検索はユーザーによってさらに細かく設定できます。
構文 | 承認 |
---|---|
フィールド タイプ | USER |
オートコンプリート | いいえ |
サポートされる演算子 | |
サポートされない演算子 |
|
サポートされる関数 |
|
例 |
|
担当者
特定のユーザーに割り当てられた課題を検索します。検索条件にはユーザーのフルネーム、ID またはメール アドレスを使用できます。
構文 | 担当者 |
---|---|
フィールド タイプ | USER |
オートコンプリート | はい |
サポートされる演算子 | 注意: 比較演算子 (例: ">") は、数値やアルファベット順ではなくプロジェクト管理者が設定したバージョン順を使用します。 |
サポートされない演算子 | ~ , !~ |
サポートされる関数 | IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:
EQUALS または NOT EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
添付ファイル
添付ファイルがある、または添付ファイルがない課題を検索します。
構文 | attachments |
---|---|
フィールド タイプ | ATTACHMENT |
オートコンプリート | はい |
サポートされる演算子 | IS, IS NOT |
サポートされない演算子 | =, != , ~ , !~ IN, NOT IN, |
サポートされる関数 | なし |
例 |
|
カテゴリ
特定のカテゴリー内のプロジェクトに所属する課題を検索します。
構文 | category |
---|---|
フィールド タイプ | CATEGORY |
オートコンプリート | はい |
サポートされる演算子 | =, != IS, IS NOT, IN, NOT IN |
サポートされない演算子 | ~ , !~
|
サポートされる関数 | なし |
例 |
|
ゲーティング タイプを変更する
Used in Jira Service Management only.
変更リクエストに使用されている変更ゲーティングのタイプを検索します。「Tracked-only」のリクエストは、変更管理プロセスとは別に設けられている統合によって生成されます。これらのツールでは、承認や変更のゲーティング戦略は考慮されません。「Tracked-only」の変更リクエストは、記録保持の目的にのみ使用されます。
構文 | change-gating-type |
---|---|
フィールド タイプ | TEXT |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED |
サポートされる関数 | なし |
例 |
|
コメント
コメントに特定のテキストを含む課題を検索します。Jira テキスト検索構文を使用できます。
構文 | comment |
---|---|
フィールド タイプ | TEXT |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED |
サポートされる関数 | なし |
例 |
|
コンポーネント
プロジェクトの特定のコンポーネントに割り当てられた課題を検索します。検索条件にはコンポーネント名またはコンポーネント ID (Jira がバージョンに自動的に割り当てる番号) を使用できます。
注意: コンポーネント名ではなくコンポーネント ID で検索することをおすすめします。異なるプロジェクトに同じ名前のコンポーネントがある場合、コンポーネント名で検索すると、複数のプロジェクトから課題が返される可能性があります。また、Jira 管理者がコンポーネント名を変更すると、その名前に依存している保存済みのフィルターが使用できなくなる可能性がありますが、コンポーネント ID は一意であり、変更されることはありません。
構文 | component |
---|---|
フィールド タイプ | COMPONENT |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED |
サポートされる関数 | IN および NOT IN 演算子と共に使用する場合、コンポーネントは以下をサポートします:
|
例 |
|
作成日
特定の日付 (または日付範囲)、またはその前後に作成された課題を検索します。時間コンポーネントが指定されていない場合、深夜 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) のミリ秒後と解釈されます。
構文 | created |
---|---|
エイリアス | createdDate |
フィールド タイプ | DATE |
オートコンプリート | いいえ |
サポートされる演算子 | = , != , When you use the |
サポートされない演算子 |
WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED |
サポートされる関数 | EQUALS、NOT EQUALS、GREATER THAN、GREATER THAN EQUALS、LESS THAN、 LESS THAN EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
作成者
特定のユーザーが作成した課題を検索します。検索条件にはユーザーのフルネーム、ID またはメール アドレスを使用できます。課題の作成者は変更されないため、過去の作成者を検索することはできません (例: WAS)。その他のオプションについては、「Reporter」を参照してください。
構文 | creator |
---|---|
フィールド タイプ | USER |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
CHANGED, |
サポートされる関数 | IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:
EQUALS または NOT EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
カスタム フィールド
Jira 管理者が 1 つ以上のカスタム フィールドを作成している場合にのみ使用できます。
特定のカスタム フィールドに特定の値を持つ課題を検索します。検索条件にはカスタム フィールド名またはカスタム フィールド ID (Jira がカスタム フィールドに自動的に割り当てた番号) を使用できます。
注意: カスタム フィールド名ではなくカスタム フィールド ID で検索することをおすすめします。カスタム フィールドの名前が Jira の組み込みのシステム フィールドと同じ場合、Jira はカスタム フィールドではなくシステム フィールドで検索を実行します。また、Jira 管理者がカスタム フィールド名を変更すると、その名前に依存している保存済みのフィルターが使用できなくなる可能性がありますが、カスタムフィールド ID は一意であり、変更されることはありません。
構文 | CustomFieldName |
---|---|
エイリアス | cf[CustomFieldID] |
フィールド タイプ | カスタム フィールドの設定によって異なる 注意: "Text" タイプのカスタム フィールドでは Jira テキスト検索構文を使用できます。 |
オートコンプリート | タイプ ピッカー、グループ ピッカー、選択、チェックボックス、ラジオ ボタン フィールドのカスタム フィールドで利用できます。 |
サポートされる演算子 | カスタム フィールドの種類に応じて、サポートされる演算子も異なります。 |
サポートされる演算子: 数値と日付フィールドの場合 |
When you use the |
サポートされない演算子: 数値と日付フィールドの場合 |
WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED |
サポートされる演算子: ピッカー、選択、チェックボックス、ラジオ ボタン フィールドの場合 | = , != |
サポートされない演算子: ピッカー、選択、チェックボックス、ラジオ ボタン フィールドの場合 |
WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED |
サポートされる演算子: テキスト フィールドの場合 |
|
サポートされない演算子: テキスト フィールドの場合 | = , != ,
|
サポートされる演算子: URL フィールドの場合 |
|
サポートされない演算子: URL フィールドの場合 |
WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED |
サポートされる関数 | カスタム フィールドの種類に応じて、サポートされる関数も異なります。 |
サポートされる関数: 日付/時間フィールドの場合 | EQUALS、NOT EQUALS、GREATER THAN、GREATER THAN EQUALS、LESS THAN または LESS THAN EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
サポートされる関数: バージョン ピッカー フィールドの場合 | バージョン ピッカー フィールド: IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
顧客リクエスト タイプ
Used in Jira Service Management only.
特定のリクエスト タイプのリクエストを検索します。リクエスト タイプの設定画面で設定したリクエスト タイプの名前または説明で検索できます。
構文 | "Customer Request Type" |
---|---|
フィールド タイプ | カスタム フィールド |
オートコンプリート | はい |
サポートされる演算子 | =、!=
|
サポートされない演算子 |
顧客リクエスト タイプの Lucene 値は |
サポートされる関数 | なし |
例 |
|
説明
説明に特定のテキストを含む課題を検索します。Jira テキスト検索構文を使用できます。
構文 | description |
---|---|
フィールド タイプ | TEXT |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 |
|
期限
特定の日付 (または日付範囲) またはその前後に期限を持つ課題を検索します。期日は、時間ではなく日付のみを対象とすることにご注意ください。
以下の形式のいずれかを使用:
"yyyy/MM/dd"
"yyyy-MM-dd"
"w"
(週) または "d"
(日) を使用して現在の時刻に対する相対的な日付を指定することもできます。引用符 ("
) を使用する必要があることにご注意ください。
構文 | due |
---|---|
エイリアス | dueDate |
フィールド タイプ | DATE |
オートコンプリート | いいえ |
サポートされる演算子 |
When you use the |
サポートされない演算子 |
|
サポートされる関数 | EQUALS、NOT EQUALS、GREATER THAN、GREATER THAN EQUALS、LESS THAN または LESS THAN EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
環境
環境に特定のテキストを含むすべての課題を検索します。Jira テキスト検索構文を使用できます。
構文 | environment |
---|---|
フィールド タイプ | TEXT |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 |
|
エピック リンク
企業管理対象プロジェクトで、特定のエピックに所属する課題を検索します。検索はエピックの名前、課題キー、課題 ID (Jira が課題に自動で割り当てる番号) のいずれかに基づいて実行されます。
チーム管理対象プロジェクトで特定のエピックに割り当てられた課題を検索するには、parent を使用します。
構文 | "epic link" |
---|---|
フィールド タイプ | Epic Link Relationship |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | IN および NOT IN 演算子とともに使用する場合、
|
例 |
|
フィルター
保存済みフィルターを使用して検索を絞り込むことができます。フィルター名またはフィルター ID (Jira が保存済みのフィルターに自動的に割り当てる番号) を使用して検索できます。
注意:
- フィルター名ではなくフィルター ID で検索することをおすすめします。フィルター名が変更された場合に保存済みフィルターが壊れ、名前を使用して別のフィルタが呼び出されてしまう可能性があります。一方、フィルター ID は一意であり、変更されることはありません。
- 入力したクエリでリンクの記述に名前を設定していない場合、保存済みフィルターの ORDER BY ステートメントが上書きされます。
- 無限ループを発生させるフィルターを実行または保存することはできません (現在のフィルターを参照する保存済みフィルターを参照することはできません)。
構文 | filter |
---|---|
エイリアス | request、savedFilter、searchRequest |
フィールド タイプ | フィルター |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 |
|
修正バージョン
特定の修正バージョンに割り当てられた課題を検索します。バージョン名またはバージョン ID (Jira がバージョンに自動的に割り当てる番号) を使用して検索できます。
バージョン名ではなくバージョン ID で検索することをおすすめします。異なるプロジェクトに同じ名前のバージョンがある場合があるため、バージョン名で検索すると、複数のプロジェクトから課題が返される可能性があります。また、Jira 管理者がバージョン名を変更した場合、その名前に依存している保存済みのフィルターが使用できなくなる可能性がありますが、バージョン ID は一意であり、変更されることはありません。
構文 | fixVersion |
---|---|
フィールド タイプ | VERSION |
オートコンプリート | はい |
サポートされる演算子 |
比較演算子 (例: ">") は、 数値やアルファベット順ではなく、プロジェクト管理者が設定した バージョン順 を使用します。 |
サポートされない演算子 |
|
サポートされる関数 | = および != 演算子と共に使用する場合、このフィールドは以下をサポートします。
IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
課題キー
特定の課題キーまたは課題 ID (Jira が課題に自動的に割り当てる番号) に基づいて課題を検索します。
構文 | issueKey |
---|---|
エイリアス | id、issue、key |
フィールド タイプ | ISSUE |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | IN および NOT IN 演算子とともに使用する場合、
|
例 |
|
課題リンク
課題にリンクされている、またはリンクされていない課題を検索します。検索を特定のタイプのリンクに制限できます。
構文 |
|
---|---|
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 | 次の課題を検索します。
|
課題リンク タイプ
blocks または is duplicated by などの特定のリンク タイプを持つ課題を検索します。検索している Jira インスタンスからのみ課題を検索できます。他の Jira インスタンスの課題へのリモート リンクは含まれません。
この JQL クエリを使用して課題カードに色を追加できます。たとえば、ブロッカーを持つ課題に赤色のストライプを追加し、他のすべての課題を緑色のままにするとします。これによって、チームで注意が必要な情報を一目で確認できるようになります。詳細については、「カードのカスタマイズ」を参照してください。
構文 | issueLinkType |
---|---|
オートコンプリート | はい |
サポートされる演算子 | |
サポートされない演算子 |
|
サポートされる関数 | なし |
例 | 次の課題を検索します。
|
Jira 課題のリンク タイプには次のプロパティがあります。
- 名前: リンク タイプのタイトル
- 外向きリンクの説明: ある課題が他の課題に与える影響の説明
- 内向きリンクの説明: ある課題が他の課題から受ける影響の説明
例えば、あるリンク タイプでは次のようなプロパティを持つ場合があります。
- 名前: 問題 / インシデント
- 外向きリンクの説明: causes
- 内向きリンクの説明: is caused by
issueLinkType
を検索すると、Jira は 3 つのプロパティすべてを検索します。つまり、リンク タイプの名前やいずれかの説明が同じ場合、特定の内向きリンクおよび外向きリンクの説明を持つ課題を区別することはできません。例として、名前と外向き リンクの説明が "blocks" となる、既定の "Blocks" リンク タイプがあります。
"blocks" の外向きリンクの説明を使用して課題を具体的に検索する必要がある場合、Jira 管理者はリンク タイプの名前を別のものに変更する必要があります。Jira 管理者の場合、詳細について「課題リンクの設定」をご覧ください。
ラベル
ラベルまたはラベルの一覧でタグ付けされた問題を検索します。ラベルが付いていない課題を検索することもできます。これにより、関連するスプリント、キュー、レポートに表示するためにはどの課題にタグを追加する必要があるかを簡単に確認できます。
構文 | labels |
---|---|
フィールド タイプ | LABEL |
オートコンプリート | はい |
サポートされる演算子 | 1 つのラベルを検索するには IS または IS NOT を、ラベルの一覧について検索するには IN または NOT IN を使用することをお勧めします。 |
サポートされない演算子 | ~ , !~ , WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED |
サポートされる関数 | なし |
例 |
|
最終閲覧日
最後に閲覧されたのが特定の日付 (または日付範囲)、またはその前後である課題を検索します。時間コンポーネントが指定されていない場合、深夜 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) のミリ秒後と解釈されます。
構文 | lastViewed |
---|---|
フィールド タイプ | DATE |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | EQUALS、NOT EQUALS、GREATER THAN、GREATER THAN EQUALS、LESS THAN または LESS THAN EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
レベル
Jira 管理者が課題レベルのセキュリティを有効にしている場合にのみ使用できます。
特定のセキュリティ レベルに割り当てられた課題を検索します。課題レベル セキュリティ名または課題レベル セキュリティ ID (Jira が課題レベル セキュリティに自動的に割り当てる番号) を使用して検索できます。
注意: セキュリティ レベル名ではなくセキュリティ レベル ID で検索することをおすすめします。Jira 管理者がセキュリティ レベル名を変更した場合に、その名前に依存している保存済みのフィルターを使用できなくなる可能性があります。セキュリティ レベル ID は一意であり、変更されることはありません。
構文 | レベル |
---|---|
フィールド タイプ | SECURITY LEVEL |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 |
|
組織
Used in Jira Service Management only.
組織で共有されているすべてのリクエストを検索します。共有されていないリクエストは返されません。
構文 | 組織 |
---|---|
フィールド タイプ | USER |
オートコンプリート | はい |
サポートされる演算子 |
|