JQL フィールド
We're updating terminology in Jira, moving from "issue" to "work item", and "project" to "space".
As we roll out these changes, some JQL entries using the new terms may not work yet. If you come across this, try using the old term instead.
There are no changes to existing JQL queries.
JQL では、特定のフィールドの値を検索できます。Jira の各フィールドには、対応する JQL 名があります。カスタム フィールドを作成した場合は、そのフィールドに名前を付けるように求められます。
句では、フィールドの後に演算子、その後に 1 つ以上の値 (または関数) が続きます。演算子はフィールドの値を右側の 1 つ以上の値または関数と比較して、true となる結果のみが句によって取得されます。JQLでは 2 つのフィールドを比較できません。
対象バージョン
特定の影響を受けたバージョンに割り当てられた作業項目を検索します。検索条件にはバージョン名またはバージョン ID (Jira でバージョンに自動的に割り当てられる番号) を使用できます。バージョン名よりもバージョン ID で検索するほうが適しています。これは、異なるスペースに同じ名前のバージョンが存在する可能性があるためです。
構文 | affectedVersion |
|---|---|
フィールド タイプ | VERSION |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | = および != 演算子と共に使用する場合、このフィールドは以下をサポートします。
IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
承認
ビジネス スペースと Jira Service Management でのみ使用します。
承認済みまたは承認待ちのリクエストを検索します。この検索はユーザーによってさらに細かく設定できます。
構文 | approvals |
|---|---|
フィールド タイプ | USER |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 |
|
例 |
|
担当者
Search for work items that are assigned to a particular user. You can search by the user's full name, ID, or email address.
構文 | assignee |
|---|---|
フィールド タイプ | USER |
オートコンプリート | はい |
サポートされる演算子 |
比較演算子 (例: ">") は、数値やアルファベット順ではなくスペース管理者が設定したバージョン順を使用します。 |
サポートされない演算子 |
|
サポートされる関数 | IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:
EQUALS または NOT EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
添付ファイル
Search for work items that have or do not have attachments.
構文 | attachments |
|---|---|
フィールド タイプ | ATTACHMENT |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 |
|
カテゴリー
Search for work items that belong to spaces in a particular category.
構文 | category |
|---|---|
フィールド タイプ | CATEGORY |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 |
|
ゲーティング タイプを変更する
ビジネス スペースでのみ使用します。
変更リクエストに使用されている変更ゲーティングのタイプを検索します。「Tracked-only」のリクエストは、変更管理プロセスとは別に設けられている統合によって生成されます。これらのツールでは、承認や変更のゲーティング戦略は考慮されません。「Tracked-only」の変更リクエストは、記録保持の目的にのみ使用されます。
構文 | change-gating-type |
|---|---|
フィールド タイプ | TEXT |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 |
|
コメント
Search for work items that have a comment that contains particular text using Jira text-search syntax. More about searching syntax for text fields.
構文 | comment |
|---|---|
フィールド タイプ | TEXT |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 |
|
Component
スペースの特定のコンポーネントに割り当てられた作業項目を検索します。検索条件にはコンポーネント名またはコンポーネント ID (例: Jira がコンポーネントに自動的に割り当てる番号) を使用できます。
構文 | component |
|---|---|
フィールド タイプ | COMPONENT |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | IN および NOT IN 演算子と共に使用する場合、コンポーネントは以下をサポートします:
|
例 |
|
created
Search for work items that were created on, before, or after a particular date (or date range). Note that if a time-component is not specified, midnight will be assumed. Please note that the search results will be relative to your configured time zone (which is by default the Jira server's time zone).
以下の形式のいずれかを使用:
"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 |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | EQUALS、NOT EQUALS、GREATER THAN、GREATER THAN EQUALS、LESS THAN、 LESS THAN EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
作成者
Search for work items that were created by a particular user. You can search by the user's full name, ID, or email address. Note that a work item's creator does not change, so you cannot search for past creators (e.g. WAS).
構文 | creator |
|---|---|
フィールド タイプ | USER |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:
EQUALS または NOT EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
カスタム フィールド
Jira 管理者が 1 つ以上のカスタム フィールドを作成している場合にのみ使用できます。
Search for work items where a particular custom field has a particular value. You can search by custom field name or custom field ID (i.e. the number that Jira automatically allocates to a custom field).
多肢選択式とドロップダウン式のカスタム フィールドでは、オプション値とオプション ID の両方で検索できます。ただし、パフォーマンス上の理由から、closedSprints()、futureSprints()、openSprints() を使用する場合は、オプション値でのみ検索できます。たとえば、closedSprints() が 16 を返す場合、次のクエリは、
"customField1[Dropdown]" in (12, closedSprints())オプション値 12 と 16 と ID 12 を検索します。
構文 | CustomFieldName |
|---|---|
エイリアス | cf[CustomFieldID] |
フィールド タイプ | カスタム フィールドの設定によって異なる "Text" タイプのカスタム フィールドでは、Jira テキスト検索構文を使用できます。 |
オートコンプリート | タイプ ピッカー、グループ ピッカー、選択、チェックボックス、ラジオ ボタン フィールドのカスタム フィールドで利用できます。 |
サポートされる演算子 | カスタム フィールドの種類に応じて、サポートされる演算子も異なります。 |
サポートされる演算子: |
|
サポートされない演算子: |
|
サポートされる演算子: |
|
サポートされない演算子: |
|
サポートされる演算子: |
|
サポートされない演算子: |
|
サポートされる演算子: |
|
サポートされない演算子: |
|
サポートされる関数 | カスタム フィールドの種類に応じて、サポートされる関数も異なります。 |
サポートされる関数: | EQUALS、NOT EQUALS、GREATER THAN、GREATER THAN EQUALS、LESS THAN または LESS THAN EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
サポートされる関数: | バージョン ピッカー フィールド: IN と NOT IN の各演算子を併用する際に、このフィールドは次をサポートします。
|
例 |
|
説明
Jira テキスト検索構文によって、説明に特定のテキストが含まれている作業項目を検索します。テキスト フィールドの検索構文の詳細をご確認ください。
構文 | description |
|---|---|
フィールド タイプ | TEXT |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 |
|
期限
Search for work items that were due on, before, or after a particular date (or date range). Note that the due date relates to the date only (not to the time).
以下の形式のいずれかを使用:
"yyyy/MM/dd""yyyy-MM-dd"
"w" (週) または "d" (日) を使用して現在の時刻に対する相対的な日付を指定することもできます。引用符 (") を使用する必要があることにご注意ください。
構文 | due |
|---|---|
エイリアス | dueDate |
フィールド タイプ | DATE |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | EQUALS、NOT EQUALS、GREATER THAN、GREATER THAN EQUALS、LESS THAN または LESS THAN EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
環境
Jira テキスト検索構文によって、環境に特定のテキストが含まれている作業項目を検索します。テキスト フィールドの検索構文の詳細をご確認ください。
構文 | environment |
|---|---|
フィールド タイプ | TEXT |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 |
|
エピック リンク
2024 年 2 月の時点で、親を優先するためにエピック リンク機能は廃止されています。エピック リンク機能を使用する既存のフィルターは引き続き機能しますが、新しいフィルターを作成するときは親を使用する必要があります。
フィルター
保存済みフィルターを使用して検索を絞り込むことができます。検索条件にはフィルター名またはフィルター ID (Jira で保存済みフィルターに自動的に割り当てられる番号) を使用できます。
注意:
フィルター名ではなくフィルター ID で検索することをおすすめします。フィルター名が変更された場合に保存済みフィルターが壊れ、名前を使用して別のフィルタが呼び出されてしまう可能性があります。一方、フィルター ID は一意であり、変更されることはありません。
入力したクエリでリンクの記述に名前を設定していない場合、保存済みフィルターの ORDER BY ステートメントが上書きされます。
無限ループを発生させるフィルターを実行または保存することはできません (つまり、いずれは現在のフィルターを参照する保存済みフィルターを参照することはできません)。
構文 | filter |
|---|---|
エイリアス | request , savedFilter , searchRequest |
フィールド タイプ | フィルター |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 |
|
修正バージョン
Search for work items that are assigned to a particular fix version. You can search by version name or version ID (i.e. the number that Jira automatically allocates to a version).
構文 | fixVersion |
|---|---|
フィールド タイプ | VERSION |
オートコンプリート | はい |
サポートされる演算子 |
Note that the comparison operators (e.g. ">") use the version order that has been set up by your space admin, not a numeric or alphabetic order. |
サポートされない演算子 |
|
サポートされる関数 | = および != 演算子と共に使用する場合、このフィールドは以下をサポートします。
IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
階層レベル
Filter work items according to their hierarchy level using a JQL filter. This field uses numbers that correlate to hierarchy levels. Use:
1 を使用すると、エピックなどの親レベルのタスクでフィルタリングされます。このレベルは Jira 管理者によって定義されます。
0 to filter by standard level work items, such as stories or tasks
-1 を使用すると、サブタスクでフィルタリングされます。
現在、このフィールドは Advanced Roadmaps で作成されたカスタム階層レベルをサポートしていません。
構文 | hierarchyLevel |
|---|---|
フィールド タイプ | 数値 |
オートコンプリート | はい |
サポートされる演算子 | = , != , > , >= , < , <= , IN , NOT IN |
サポートされない演算子 |
|
サポートされる関数 |
|
例 |
|
Journey
特定のジャーニーの実行中に作成された作業項目を検索します。
構文 | journeyID |
|---|---|
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 | ジャーニー ID「123」の作業項目を検索: |
ジャーニーの親
Search for journey parent work items that were created using a specific journey type.
構文 | journeyParentOfTypeId |
|---|---|
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 | ジャーニーの親 ID「123」の作業項目を検索: |
ジャーニー タイプ
特定のジャーニー タイプを使用して作成された作業項目を検索します。
構文 | journeyTypeId |
|---|---|
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 | ジャーニー タイプ ID "123" を持つ作業項目を検索: |
ジャーニー タイプ バージョン
特定のバージョンのジャーニー タイプを使用して作成された作業項目を検索します。
構文 | journeyTypeVersion |
|---|---|
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 | ジャーニー タイプのバージョンが「1」である作業項目を検索: |
ジャーニー作業項目
特定のジャーニー タイプを使用して作成された特定の作業項目を検索します。
構文 | journeyWorkItemId |
|---|---|
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 | ジャーニーの作業項目 ID「123」の作業項目を検索: |
ラベル
ラベルまたはラベルの一覧でタグ付けされた作業項目を検索します。ラベルがない作業項目も検索できます。これにより、関連するスプリント、キュー、レポートに表示するにはどの作業項目にタグを追加する必要があるかを簡単に確認できます。
構文 | labels |
|---|---|
フィールド タイプ | LABEL |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 |
|
最終閲覧日
最後に閲覧されたのが特定の日付 (または日付範囲)、それよりも前、またはそれよりも後の作業項目を検索します。時間コンポーネントが指定されていない場合、深夜 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) のミリ秒後と解釈されます。
構文 | lastViewed |
|---|---|
フィールド タイプ | DATE |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | EQUALS、NOT EQUALS、GREATER THAN、GREATER THAN EQUALS、LESS THAN または LESS THAN EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
レベル
Jira 管理者が作業レベルのセキュリティを有効にしている場合にのみ使用できます。
特定のセキュリティ レベルが設定されている作業項目を検索します。検索条件には、作業レベル セキュリティ名、または作業項目レベル セキュリティ ID (Jira で作業レベル セキュリティに自動的に割り当てられる番号) を使用できます。
構文 | level |
|---|---|
フィールド タイプ | SECURITY LEVEL |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 |
|
組織
ビジネス スペースでのみ使用します。
組織で共有されているすべてのリクエストを検索します。共有されていないリクエストは返されません。
構文 | organizations |
|---|---|
フィールド タイプ | USER |
オートコンプリート | はい |
サポートされる演算子 |
|
例 | 組織「Atlassian」で共有されているすべてのリクエストを検索します。 organizations = "Atlassian" |
初期見積
Jira 管理者が時間管理を有効にしている場合にのみ使用できます。
初期見積もりが特定の値 (日付や日付範囲ではなく数字) に設定されている作業項目を検索します。"w"、"d"、"h"、"m" を使用して、週、日付、時間、分を指定します。
構文 | originalEstimate |
|---|---|
エイリアス | timeOriginalEstimate |
フィールド タイプ | DURATION |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 |
|
親
Search for all child work items of a parent. For example, you can view all stories under an epic. This function works for both team-managed and company-managed spaces.
作業項目キーまたは ID で検索できます。
構文 | parent |
|---|---|
フィールド タイプ | WorkItem |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 |
|
Parent space
特定のスペースに属する親作業項目を持つすべての子作業項目を検索します。検索条件には、スペースの名前またはスペース ID (Jira がスペースに自動的に割り当てる番号) を使用できます。
構文 | parentProject |
|---|---|
フィールド タイプ | PROJECT |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | IN および NOT IN 演算子とともに使用する場合、
|
例 |
|
優先度
特定の優先度が設定されている作業項目を検索します。検索条件には優先度名または優先度 ID (Jira で優先度に自動的に割り当てられる番号) を使用できます。
構文 | priority |
|---|---|
フィールド タイプ | PRIORITY |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 |
|
Project
特定のスペースに割り当てられた作業項目を検索します。検索条件には、スペース名、スペース キー、または スペース ID (Jira が スペースに自動的に割り当てる番号) を使用できます。スペースのキーが別のスペースの名前と同じである稀なケースでは、スペース キーが優先され、2 番目のスペースからの結果が非表示になります。
構文 | project |
|---|---|
フィールド タイプ | PROJECT |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | IN および NOT IN 演算子とともに使用する場合、
|
例 |
|
プロジェクト タイプ
スペースの特定のタイプ (次のいずれか) に所属する作業項目を検索:
“business” which finds work items created in business spaces
"software": Jira で作成された作業項目を検索
"service_desk": サービス スペースで作成された作業項目を検索
結果は権限レベルに応じて異なります。ご自身がアクセス権を持っているアプリの結果のみを表示できます。アプリによるアクセスの詳細をご確認ください。
構文 |
|
|---|---|
オートコンプリート | はい |
サポートされる演算子 | =、!= IN、NOT IN |
サポートされない演算子 | >、>=、<、<=、~、!~ IS、IS NOT、WAS、WAS NOT、WAS NOT IN、CHANGED |
サポートされる関数 | なし |
例 | ソフトウェア スペース 内のすべての作業項目を検索:
ソフトウェア スペースまたはサービス スペースのすべての作業項目を検索:
ソフトウェア スペース に含まれていないすべての作業項目を検索:
|
残余見積
Jira 管理者が時間管理を有効にしている場合にのみ使用できます。
残余見積が特定の値 (日付や日付範囲ではなく数字) に設定されている作業項目を検索します。"w"、"d"、"h"、"m" を使用して、週、日付、時間、分を指定します。
構文 | remainingEstimate |
|---|---|
エイリアス | timeEstimate |
フィールド タイプ | DURATION |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 |
|
報告者
特定のユーザーが報告した作業項目を検索します。このユーザーは作成者と同じである場合もあります。検索条件にはユーザーのフルネーム、ID またはメール アドレスを使用できます。
構文 | reporter |
|---|---|
フィールド タイプ | USER |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:
EQUALS または NOT EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
リクエストのチャンネル タイプ
ビジネス スペースでのみ使用します。
リクエストが作成されたチャンネルに基づいてリクエストを検索します。たとえば、サービス スペースにメールで送信された全リクエストや、カスタマー ポータルから送信された全リクエストを検索できます。
構文 | request-channel-type |
|---|---|
フィールド タイプ | TEXT |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
リクエストの最終アクティビティ時刻
ビジネス スペースでのみ使用します。
特定の日付 (または日付範囲)、それよりも前、またはそれよりも後に作成されたリクエストを検索します。時間コンポーネントが指定されていない場合、深夜 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) のミリ秒後と解釈されます。
構文 | request-last-activity-time |
|---|---|
フィールド タイプ | DATE |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | EQUALS、NOT EQUALS、GREATER THAN、GREATER THAN EQUALS、LESS THAN または LESS THAN EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
リクエスト タイプ
Used in service spaces only.
特定のリクエスト タイプのリクエストを検索します。リクエスト タイプの設定画面で設定したリクエスト タイプの名前または説明で検索できます。
構文 | "Request Type" |
|---|---|
フィールド タイプ | カスタム フィールド |
オートコンプリート | はい |
サポートされる演算子 | = , !=
|
サポートされない演算子 |
リクエスト タイプの Lucene 値は |
サポートされる関数 | なし |
例 |
|
ソリューション
The resolution field doesn't exist in service team-managed spaces. This means you can't search for work items in service team-managed spaces with the resolution field. Instead, you can use the statusCategory field (a work item is resolved when statusCategory = Done).
特定の解決状況がある作業項目を検索します。検索条件には解決状況の名前または解決状況 ID (Jira で解決状況に自動的に割り当てられる番号) を使用できます。
構文 | resolution |
|---|---|
フィールド タイプ | RESOLUTION |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 |
|
解決済
最後に解決したのが特定の日付 (または日付範囲)、それよりも前、またはそれよりも後の作業項目を検索します。時間コンポーネントが指定されていない場合は、深夜 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) のミリ秒後と解釈されます。
構文 | resolved |
|---|---|
エイリアス | resolutionDate |
フィールド タイプ | DATE |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | EQUALS、NOT EQUALS、GREATER THAN、GREATER THAN EQUALS、LESS THAN、LESS THAN EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
SLA
サービス スペースでのみ使用されます。
リクエストを検索および整理し、SLA 目標を達成するのに役立ててください。SLA が完了状態にあるリクエストや、SLA クロックに一定の時間存在しているリクエストを検索できます。
構文 | Time to resolution
< |
|---|---|
フィールド タイプ | SLA |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 |
|
例 |
|
Sprint
Search for work items that are assigned to a particular sprint. This works for active sprints and future sprints. The search is based on either the sprint name or the sprint ID (i.e. the number that Jira automatically allocates to a sprint).
似た名前、あるいは同じ名前の複数のスプリントがある場合、スプリント名またはスプリント名の一部を使用して検索できます。一致候補はオートコンプリート ドロップダウンに表示され、表示されるスプリントの日付でスプリントを見分けることができます (括弧内にスプリント ID も表示されます)。
構文 | sprint |
|---|---|
フィールド タイプ | NUMBER |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 |
|
例 |
|
ステータス
特定のステータスを持つ作業項目を検索します。検索条件にはステータス名またはステータス ID (Jira でステータスに自動的に割り当てられる番号) を使用できます。
WAS、WAS NOT、WAS IN、WAS NOT IN 演算子は、名前でのみ使用できます (ID では不可)。
構文 | status |
|---|---|
フィールド タイプ | STATUS |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 |
|
要約
Jira テキスト検索構文によって、要約に特定のテキストが含まれている作業項目を検索します。テキスト フィールドの検索構文の詳細をご確認ください。
構文 | summary |
|---|---|
フィールド タイプ | TEXT |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 |
|
テキスト
これは、作業項目に対して次のようなすべてのテキスト フィールドを検索できるマスター フィールドです。
要約
説明
環境
コメント
"Free Text Searcher" を使用するカスタム フィールド。これには以下の組み込みカスタム フィールド タイプが含まれます。
フリー テキスト フィールド (無制限のテキスト)
テキスト フィールド (255 文字まで)
読み取り専用のテキスト フィールド
Search for work items that have certain text present using Jira text-search syntax. More about searching syntax for text fields.
text マスター フィールドは、CONTAINS 演算子 ("~") と一緒にのみ使用できます。
一部の文字や単語は予約されているため、作業項目を検索することはできません。予約文字の詳細をご確認ください。
構文 | text |
|---|---|
フィールド タイプ | TEXT |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 |
|
テキスト フィールド
text と同様に、これはほとんどのテキスト フィールド (コメント、作業ログを除く) で作業項目に関して次のような情報を検索できるマスター フィールドです。
要約
説明
環境
"Free Text Searcher" を使用するカスタム フィールド。これには以下の組み込みカスタム フィールド タイプが含まれます。
フリー テキスト フィールド (無制限のテキスト)
テキスト フィールド (255 文字まで)
読み取り専用のテキスト フィールド
textfields マスター フィールドは、CONTAINS 演算子 ("~") と一緒にのみ使用できます。
一部の文字や単語は予約されているため、作業項目を検索することはできません。予約文字の詳細をご確認ください。
構文 | textfields |
|---|---|
フィールド タイプ | TEXT |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 |
|
消費時間
Jira 管理者が時間管理を有効にしている場合にのみ使用できます。
所要時間が特定の値 (日付や日付範囲ではなく数字) に設定されている作業項目を検索します。"w"、"d"、"h"、"m" を使用して、週、日付、時間、分を指定します。
構文 | timeSpent |
|---|---|
フィールド タイプ | DURATION |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 | 所要時間が 5 日より多い作業項目を検索: |
タイプ
特定の作業タイプの作業項目を検索します。検索条件には、作業タイプ名または作業タイプ ID (Jira で作業タイプに自動的に割り当てられる番号) を使用できます。
構文 | type |
|---|---|
エイリアス | workType |
フィールド タイプ | WORK_TYPE |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 |
|
更新日
最後に更新されたのが特定の日付 (または日付範囲)、それよりも前、またはそれよりも後の作業項目を検索します。時間コンポーネントが指定されていない場合、深夜 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) のミリ秒後と解釈されます。
構文 | updated |
|---|---|
エイリアス | updatedDate |
フィールド タイプ | DATE |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | EQUALS、NOT EQUALS、GREATER THAN、GREATER THAN EQUALS、LESS THAN または LESS THAN EQUALS 演算子と併用する場合、このフィールドは次をサポートします。
|
例 |
|
投票者
Search for work items for which a particular user has voted. You can search by the user's full name, ID, or email address. Note that you can only find work items for which you have the "View Voters and Watchers" permission, unless you are searching for your own votes.
構文 | voter |
|---|---|
フィールド タイプ | USER |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:
EQUALS および NOT EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
投票数
Search for work items with a specified number of votes.
構文 | votes |
|---|---|
フィールド タイプ | NUMBER |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 | Find all work items that have 12 or more votes: |
ウォッチャー
特定のユーザーがウォッチしている作業項目を検索します。ユーザーの氏名、ID、またはメール アドレスで検索できます。自分がウォッチャーである作業項目を検索する場合を除いて、「投票者とウォッチャーの表示」権限を持つ作業項目のみを検索できることにご留意ください。
構文 | watcher |
|---|---|
フィールド タイプ | USER |
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:
EQUALS および NOT EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
ウォッチャー
指定した数のウォッチャーを持つ作業項目を検索します。
構文 | watchers |
|---|---|
フィールド タイプ | NUMBER |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 | 3 人以上にウォッチされているすべての作業項目を検索: |
作業ログへのコメント
このフィールドは Jira 管理者によって時間管理が有効にされている場合にのみ使用できます。また、CONTAINS 演算子 ("~") のみに対応しています。
Jira テキスト検索構文によって、作業ログへのコメントに特定のテキストが存在する作業項目を検索します。テキスト フィールドの検索構文の詳細をご確認ください。
構文 | worklogComment |
|---|---|
フィールド タイプ | TEXT |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 |
|
作業ログの日付
Jira 管理者が時間管理を有効にしている場合にのみ使用できます。
Search for work items with work logged on a specific date
構文 | worklogDate |
|---|---|
フィールド タイプ | DATE |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | EQUALS、NOT EQUALS、GREATER THAN、GREATER THAN EQUALS、LESS THAN または LESS THAN EQUALS 演算子と併用する場合、このフィールドは次をサポートします。
|
例 |
|
作業項目キー
Search for work items with a particular key or ID (i.e. the number that Jira automatically allocates to a work item).
構文 | workItemKey |
|---|---|
エイリアス | id , workItem , key |
フィールド タイプ | WorkItem |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | IN または NOT IN 演算子とともに使用する場合、
|
例 |
|
Work item link
Searches for work items linked or not linked to a work item. You can restrict the search to links of a particular type.
構文 |
|
|---|---|
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 | 作業項目を検索する:
|
Work item link type
[ブロックしている] または [重複している] などの特定のリンク タイプを持つ作業項目を検索します。検索している Jira インスタンスからのみ作業項目を探せます。他の Jira インスタンスの作業項目へのリモート リンクは含まれません。
この JQL クエリを使用して作業項目カードに色を追加できます。たとえば、ブロッカーを持つ作業項目に赤のストライプを追加して、他のすべての作業項目を緑のままにします。これによって、チームで注意が必要な情報を一目で確認できるようになります。詳細については、カードのカスタマイズをご確認ください。
構文 | workItemLinkType |
|---|---|
オートコンプリート | はい |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 | 作業項目を検索する:
|
Jira 作業項目リンク タイプには、次のようなプロパティがあります。
名前: リンク タイプのタイトル
外向きリンクの説明: ある作業項目が他の作業項目に与える影響の説明
Inward description: The description of how a work item is affected by other work items
例えば、あるリンク タイプでは次のようなプロパティを持つ場合があります。
名前: 問題 / インシデント
外向きリンクの説明: causes
内向きリンクの説明: is caused by
workItemLinkType を検索すると、Jira では 3 つのプロパティすべてが検索されます。これは、リンク タイプの名前と説明のいずれかが同じ場合に、特定の内向きまたは外向きの説明を持つ作業項目を分離できないことを意味します。これは、既定の「ブロック」リンク タイプの場合で、名前と外向きの説明が「ブロック」になっています。
たとえば、「blocks」の外向きリンクの説明を使用して作業項目を具体的に検索する必要がある場合、Jira 管理者はリンク タイプの名前を別のものに変更する必要があります。Jira 管理者の場合、詳細については、作業項目リンクの設定をご覧ください。
作業率
Jira 管理者が時間管理を有効にしている場合にのみ使用できます。
作業率が特定の値である作業項目を検索します。作業率の計算方法は次のとおりです: workRatio = timeSpent / originalEstimate) x 100
構文 | workRatio |
|---|---|
フィールド タイプ | NUMBER |
オートコンプリート | いいえ |
サポートされる演算子 |
|
サポートされない演算子 |
|
サポートされる関数 | なし |
例 | Find work items on which more than 75% of the original estimate has been spent: |
この内容はお役に立ちましたか?