Jira の使用を開始する
Jira を使用するのが初めての場合は、新たに管理者やユーザーになった方を対象としたガイドをご覧ください。
JQL では、特定のフィールドの値を検索できます。Jira の各フィールドには、対応する JQL 名があります。カスタム フィールドを作成した場合は、そのフィールドに名前を付けるように求められます。
句では、フィールドの後に演算子、その後に 1 つ以上の値 (または関数) が続きます。演算子はフィールドの値を右側の 1 つ以上の値または関数と比較して、true となる結果のみが句によって取得されます。JQLでは 2 つのフィールドを比較できません。
特定の影響を受けたバージョンに割り当てられた課題を検索します。検索条件にはバージョン名またはバージョン ID (例: Jira がバージョンに自動的に割り当てる番号) を使用できます。バージョン名で検索するよりも、バージョン ID で検索することをおすすめします。これは、異なるプロジェクトで同じ名前を使用している可能性があるためです。Jira 管理者もバージョン名を変更できますが、その名前に依存している保存済みのフィルターが使用できなくなる可能性があります。バージョン ID は一意であり、変更されることはありません。
構文 | 1
affectedVersion |
---|---|
フィールド タイプ | VERSION |
オートコンプリート | はい |
サポートされる演算子 | = , != , > , >= , < , <= |
サポートされない演算子 | ~ , !~ |
サポートされる関数 | = および != 演算子と共に使用する場合、このフィールドは以下をサポートします。
IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
ビジネス プロジェクトの Jira Service Management でのみ使用します。
承認済みまたは承認待ちのリクエストを検索します。この検索はユーザーによってさらに細かく設定できます。
構文 | 1
approvals |
---|---|
フィールド タイプ | USER |
オートコンプリート | いいえ |
サポートされる演算子 | = |
サポートされない演算子 | ~ , != , !~ , > , >= , < , <= |
サポートされる関数 |
|
例 |
|
特定のユーザーに割り当てられた課題を検索します。検索条件にはユーザーのフルネーム、ID またはメール アドレスを使用できます。
構文 | 1
assignee |
---|---|
フィールド タイプ | USER |
オートコンプリート | はい |
サポートされる演算子 | = , != 注意: 比較演算子 (例: ">") は、数値やアルファベット順ではなくプロジェクト管理者が設定したバージョン順を使用します。 |
サポートされない演算子 | ~ , !~ , > , >= , < , <= |
サポートされる関数 | IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:
EQUALS または NOT EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
添付ファイルがある、または添付ファイルがない課題を検索します。
構文 | 1
attachments |
---|---|
フィールド タイプ | ATTACHMENT |
オートコンプリート | はい |
サポートされる演算子 | IS, IS NOT |
サポートされない演算子 | =, != , ~ , !~ , > , >= , < , <= IN, NOT IN, WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED |
サポートされる関数 | なし |
例 |
|
特定のカテゴリー内のプロジェクトに所属する課題を検索します。
構文 | 1
category |
---|---|
フィールド タイプ | CATEGORY |
オートコンプリート | はい |
サポートされる演算子 | =, != |
サポートされない演算子 | ~ , !~ , > , >= , < , <= WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED |
サポートされる関数 | なし |
例 |
|
ビジネス プロジェクトでのみ使用します。
変更リクエストに使用されている変更ゲーティングのタイプを検索します。「Tracked-only」のリクエストは、変更管理プロセスとは別に設けられている統合によって生成されます。これらのツールでは、承認や変更のゲーティング戦略は考慮されません。「Tracked-only」の変更リクエストは、記録保持の目的にのみ使用されます。
構文 | 1
change-gating-type |
---|---|
フィールド タイプ | TEXT |
オートコンプリート | はい |
サポートされる演算子 | = , != IS, IS NOT, IN, NOT IN |
サポートされない演算子 | ~ , !~ , > , >= , < , <= WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED |
サポートされる関数 | なし |
例 |
|
Jira テキスト検索構文によって、コメントに特定のテキストが含まれている課題を検索します。テキスト フィールドの検索構文の詳細をご確認ください。
構文 | 1
comment |
---|---|
フィールド タイプ | TEXT |
オートコンプリート | いいえ |
サポートされる演算子 | ~ , !~ |
サポートされない演算子 | = , != , > , >= , < , <= |
サポートされる関数 | なし |
例 |
|
プロジェクトの特定のコンポーネントに割り当てられた課題を検索します。検索条件にはコンポーネント名またはコンポーネント ID (例: Jira がバージョンに自動的に割り当てる番号) を使用できます。
注意: コンポーネント名ではなくコンポーネント ID で検索することをおすすめします。異なるプロジェクトに同じ名前のコンポーネントがある場合、コンポーネント名で検索すると、複数のプロジェクトから課題が返される可能性があります。また、Jira 管理者がコンポーネント名を変更すると、その名前に依存している保存済みのフィルターが使用できなくなる可能性がありますが、コンポーネント ID は一意であり、変更されることはありません。
構文 | 1
component |
---|---|
フィールド タイプ | COMPONENT |
オートコンプリート | はい |
サポートされる演算子 | = , != |
サポートされない演算子 | ~ , !~ , > , >= , < , <= WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED |
サポートされる関数 | 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) のミリ秒後と解釈されます。
構文 | 1
created |
---|---|
エイリアス | 1
createdDate |
フィールド タイプ | 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 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
特定のユーザーが作成した課題を検索します。ユーザーの氏名、ID、またはメール アドレスで検索できます。課題の作成者は変更されないため、過去の作成者は検索できないことにご注意ください (例: WAS)。その他のオプションについては「報告者」をご参照ください。
構文 | 1
creator |
---|---|
フィールド タイプ | USER |
オートコンプリート | はい |
サポートされる演算子 | = , != |
サポートされない演算子 | ~ , !~ , > , >= , < , <= CHANGED, WAS, WAS IN, WAS NOT, WAS NOT IN |
サポートされる関数 | IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:
EQUALS または NOT EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
Jira 管理者が 1 つ以上のカスタム フィールドを作成している場合にのみ使用できます。
特定のカスタム フィールドに特定の値が入力されている課題を検索します。検索にはカスタム フィールド名またはカスタム フィールド ID (Jira でカスタム フィールドに自動的に割り当てられる番号) を使用できます。
注意: カスタム フィールド名ではなくカスタム フィールド ID で検索することをおすすめします。カスタム フィールドの名前が 組み込み Jira システム フィールドと同じ場合、Jira ではシステム フィールド (カスタム フィールドではなく) が検索されます。この場合、Jira 管理者がカスタム フィールド名を変更してしまうと、その名前に依存している保存済みのフィルターが使用できなくなる可能性がありますが、カスタム フィールド ID は一意であり、変更されることはありません。
多肢選択式とドロップダウン式のカスタム フィールドでは、オプション値とオプション ID の両方で検索できます。ただし、パフォーマンス上の理由から、closedSprints()、futureSprints()、openSprints() を使用する場合は、オプション値でのみ検索できます。たとえば、closedSprints() が 16 を返す場合、次のクエリは、
1
"customField1[Dropdown]" in (12, closedSprints())
オプション値 12 と 16 と ID 12 を検索します。
構文 | 1
CustomFieldName |
---|---|
エイリアス | 1
cf[CustomFieldID] |
フィールド タイプ | カスタム フィールドの設定によって異なる "Text" タイプのカスタム フィールドでは、Jira テキスト検索構文を使用できます。 |
オートコンプリート | タイプ ピッカー、グループ ピッカー、選択、チェックボックス、ラジオ ボタン フィールドのカスタム フィールドで利用できます。 |
サポートされる演算子 | カスタム フィールドの種類に応じて、サポートされる演算子も異なります。 |
サポートされる演算子: | = , != , > , >= , < , <= |
サポートされない演算子: | ~ , !~ WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED |
サポートされる演算子: | = , != |
サポートされない演算子: | ~ , !~ , > , >= , < , <= WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED |
サポートされる演算子: | ~ , !~ |
サポートされない演算子: | = , != , > , >= , < , <= IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED |
サポートされる演算子: | = , != |
サポートされない演算子: | ~ , !~ , > , >= , < , <= 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 の各演算子を併用する際に、このフィールドは次をサポートします。
|
例 |
|
Jira テキスト検索構文によって、説明に特定のテキストが含まれている課題を検索します。テキスト フィールドの検索構文の詳細をご確認ください。
構文 | 1
description |
---|---|
フィールド タイプ | TEXT |
オートコンプリート | いいえ |
サポートされる演算子 | ~ , !~ |
サポートされない演算子 | = , != , > , >= , < , <= IN , NOT IN, WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED |
サポートされる関数 | なし |
例 |
|
特定の日付 (または日付範囲) またはその前後に期限を持つ課題を検索します。期日は、時間ではなく日付のみを対象とすることにご注意ください。
以下の形式のいずれかを使用:
"yyyy/MM/dd"
"yyyy-MM-dd"
"w" (週) または "d" (日) を使用して現在の時刻に対する相対的な日付を指定することもできます。引用符 (") を使用する必要があることにご注意ください。
構文 | 1
due |
---|---|
エイリアス | 1
dueDate |
フィールド タイプ | DATE |
オートコンプリート | いいえ |
サポートされる演算子 | = , != , > , >= , < , <= |
サポートされない演算子 | ~ , !~ WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED |
サポートされる関数 | EQUALS、NOT EQUALS、GREATER THAN、GREATER THAN EQUALS、LESS THAN または LESS THAN EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
Jira テキスト検索構文によって、環境に特定のテキストが含まれている課題を検索します。テキスト フィールドの検索構文の詳細をご確認ください。
構文 | 1
environment |
---|---|
フィールド タイプ | TEXT |
オートコンプリート | いいえ |
サポートされる演算子 | ~ , !~ |
サポートされない演算子 | = , != , > , >= , < , <= IN , NOT IN, WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED |
サポートされる関数 | なし |
例 |
|
2024 年 2 月の時点で、親を優先するためにエピック リンク機能は廃止されています。エピック リンク機能を使用する既存のフィルターは引き続き機能しますが、新しいフィルターを作成するときは親を使用する必要があります。
保存済みフィルターを使用して検索を絞り込むことができます。検索条件にはフィルター名またはフィルター ID (Jira で保存済みフィルターに自動的に割り当てられる番号) を使用できます。
注意:
フィルター名ではなくフィルター ID で検索することをおすすめします。フィルター名が変更された場合に保存済みフィルターが壊れ、名前を使用して別のフィルタが呼び出されてしまう可能性があります。一方、フィルター ID は一意であり、変更されることはありません。
入力したクエリでリンクの記述に名前を設定していない場合、保存済みフィルターの ORDER BY ステートメントが上書きされます。
無限ループを発生させるフィルターを実行または保存することはできません (つまり、いずれは現在のフィルターを参照する保存済みフィルターを参照することはできません)。
構文 | 1
filter |
---|---|
エイリアス | 1
request , savedFilter , searchRequest |
フィールド タイプ | フィルター |
オートコンプリート | はい |
サポートされる演算子 | = , != |
サポートされない演算子 | ~ , !~ , > , >= , < , <= IS , IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED |
サポートされる関数 | なし |
例 |
|
特定の修正バージョンに割り当てられている課題を検索します。検索条件にはバージョン名またはバージョン ID (Jira でバージョンに自動的に割り当てられる番号) を使用できます。
バージョン名で検索するよりも、バージョン ID で検索する方が安全です。異なるプロジェクトに同名のバージョンが存在する場合があるため、バージョン名で検索すると複数のプロジェクトから課題が返される場合があります。Jira 管理者もバージョン名を変更できますが、その名前に依存している保存済みフィルターが使用できなくなる可能性があります。ただし、バージョン ID は一意であり、変更されることはありません。
構文 | 1
fixVersion |
---|---|
フィールド タイプ | VERSION |
オートコンプリート | はい |
サポートされる演算子 | = , != , > , >= , < , <= 比較演算子 (例: ">") は、数値やアルファベット順ではなくプロジェクト管理者が設定したバージョン順を使用することにご注意ください。 |
サポートされない演算子 | ~ , !~ |
サポートされる関数 | = および != 演算子と共に使用する場合、このフィールドは以下をサポートします。
IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
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 |
サポートされる関数 |
|
例 |
|
特定の課題キーまたは課題 ID (Jira で課題に自動的に割り当てられる番号) に基づいて課題を検索します。
構文 | 1
issueKey |
---|---|
エイリアス | 1
id , issue , key |
フィールド タイプ | ISSUE |
オートコンプリート | いいえ |
サポートされる演算子 | = , != , > , >= , < , <= |
サポートされない演算子 | ~ , !~ |
サポートされる関数 | IN および NOT IN 演算子とともに使用する場合、issueKey は以下をサポートします。
|
例 |
|
課題にリンクされている、またはリンクされていない課題を検索します。検索を特定のタイプのリンクに制限できます。
構文 | issueLink、issueLink["link type"]、または issueLinkType。ここで link type または LinkType は、課題リンク タイプで置き換える変数です (例: blocks、duplicates、または is blocked)。 |
---|---|
オートコンプリート | はい |
サポートされる演算子 | = , != IN , NOT IN |
サポートされない演算子 | ~ , !~ , > , >= , < , <= WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED , IS , IS NOT |
サポートされる関数 | なし |
例 | 次の課題を検索します。
|
blocks または is duplicated by などの特定のリンク タイプを持つ課題を検索します。検索している Jira インスタンスからのみ課題を探せます。他の Jira インスタンスの課題へのリモート リンクは含まれません。
この JQL クエリによって課題カードに色を追加できます。たとえば、ブロッカーを持つ課題に赤のストライプを追加して、他のすべての課題を緑のままにするとします。これによって、チームの注意が必要な情報を一目で確認できるようになります。詳細については「カードのカスタマイズ」をご参照ください。
構文 | 1
issueLinkType |
---|---|
オートコンプリート | はい |
サポートされる演算子 | = , != |
サポートされない演算子 | ~ , !~ , > , >= , < , <= WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED , IS , IS NOT |
サポートされる関数 | なし |
例 | 次の課題を検索します。
|
Jira 課題のリンク タイプには次のプロパティがあります。
名前: リンク タイプのタイトル
外向きリンクの説明: ある課題が他の課題に与える影響の説明
内向きリンクの説明: ある課題が他の課題から受ける影響の説明
例えば、あるリンク タイプでは次のようなプロパティを持つ場合があります。
名前: 問題 / インシデント
外向きリンクの説明: causes
内向きリンクの説明: is caused by
issueLinkType を検索すると、Jira では 3 つのプロパティすべてが検索されます。つまり、リンク タイプの名前やいずれかの説明が同じ場合は、特定の内向きまたは外向きリンクの説明を持つ課題を区別できません。一例として、名前と外向きリンクの説明が「blocks」となる、既定の「Blocks」リンク タイプがあります。
たとえば、「blocks」の外向きリンクの説明を使用して課題を具体的に検索する必要がある場合、Jira 管理者はリンク タイプの名前を別のものに変更する必要があります。Jira 管理者の場合、詳細については「課題リンクの設定」をご覧ください。
ラベルまたはラベルの一覧でタグ付けされた問題を検索します。ラベルが付いていない課題を検索することもできます。これにより、関連するスプリント、キュー、レポートに表示するためにはどの課題にタグを追加する必要があるかを簡単に確認できます。
構文 | 1
labels |
---|---|
フィールド タイプ | LABEL |
オートコンプリート | はい |
サポートされる演算子 | = , !=, IS, IS NOT, 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) のミリ秒後と解釈されます。
構文 | 1
lastViewed |
---|---|
フィールド タイプ | DATE |
オートコンプリート | いいえ |
サポートされる演算子 | = , != , > , >= , < , <= |
サポートされない演算子 | ~ , !~ |
サポートされる関数 | EQUALS、NOT EQUALS、GREATER THAN、GREATER THAN EQUALS、LESS THAN または LESS THAN EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
Jira 管理者が課題レベルのセキュリティを有効にしている場合にのみ使用できます。
特定のセキュリティ レベルが設定されている課題を検索します。検索条件には課題レベル セキュリティ名または課題レベル セキュリティ ID (Jira で課題レベル セキュリティに自動的に割り当てられる番号) を使用できます。
注意: セキュリティ レベル名ではなくセキュリティ レベル ID で検索することをおすすめします。また、Jira 管理者がセキュリティ レベル名を変更してしまうと、その名前に依存している保存済みフィルターが使用できなくなる可能性がありますが、セキュリティ レベル ID は一意であり、変更されることはありません。
構文 | 1
level |
---|---|
フィールド タイプ | SECURITY LEVEL |
オートコンプリート | はい |
サポートされる演算子 | = , != |
サポートされない演算子 | > , >= , < , <= , ~ , !~ |
サポートされる関数 | なし |
例 |
|
ビジネス プロジェクトでのみ使用します。
組織で共有されているすべてのリクエストを検索します。共有されていないリクエストは返されません。
構文 | 1
organizations |
---|---|
フィールド タイプ | USER |
オートコンプリート | はい |
サポートされる演算子 | = , != |
例 | 組織「Atlassian」で共有されているすべてのリクエストを検索します。 1
organizations = "Atlassian" |
Jira 管理者が時間管理を有効にしている場合にのみ使用できます。
初期見積が特定の値 (日付や日付範囲ではなく数字) に設定されている課題を検索します。"w"、"d"、"h"、"m" を使用して、週、日付、時間、分を指定します。
構文 | 1
originalEstimate |
---|---|
エイリアス | 1
timeOriginalEstimate |
フィールド タイプ | DURATION |
オートコンプリート | いいえ |
サポートされる演算子 | = , != , > , >= , < , <= |
サポートされない演算子 | ~ , !~ |
サポートされる関数 | なし |
例 |
|
親のすべての子課題を検索します。たとえば、エピックの下にあるすべてのストーリーを表示できます。チーム管理対象プロジェクトと企業管理対象プロジェクトの両方でこの機能を使用できます。
課題キーまたは課題 ID で検索できます。
構文 | 1
parent |
---|---|
フィールド タイプ | ISSUE |
オートコンプリート | いいえ |
サポートされる演算子 | = , != |
サポートされない演算子 | > , >= , < , <= , ~ , !~ |
サポートされる関数 | なし |
例 |
|
特定のプロジェクトに属する親課題を持つすべての子課題を検索します。検索条件にはプロジェクト名またはプロジェクト ID (例: Jira がプロジェクトに自動的に割り当てる番号) を使用できます。
構文 | 1
parentProject |
---|---|
フィールド タイプ | PROJECT |
オートコンプリート | いいえ |
サポートされる演算子 | =, !=, IN, NOT IN |
サポートされない演算子 | ~, !~ WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED |
サポートされる関数 | IN および NOT IN 演算子とともに使用する場合、project は以下をサポートします。
|
例 |
|
特定の優先度が設定されている課題を検索します。検索条件には優先度名または優先度 ID (Jira で優先度に自動的に割り当てられる番号 を使用できます。
優先度名ではなく優先度 ID で検索することをおすすめします。Jira 管理者が優先度の名前を変更すると、その名前に依存している保存済みフィルターが使用できなくなる可能性があります。ただし、優先度 ID は一意であり、変更されることはありません。
構文 | 1
priority |
---|---|
フィールド タイプ | PRIORITY |
オートコンプリート | はい |
サポートされる演算子 | = , != , > , >= , < , <= IS , IS NOT, IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED |
サポートされない演算子 | ~ , !~ |
サポートされる関数 | なし |
例 |
|
特定のプロジェクトに属する課題を検索します。検索条件にはプロジェクト名、プロジェクト キーまたはプロジェクト ID (Jira で優先度に自動的に割り当てられる番号) を使用できます。稀に、同じプロジェクト キーを持つプロジェクトがほかにも存在する場合があります。この場合、プロジェクト キーが優先され、検索結果では 2 つ目のプロジェクトが非表示になります。
構文 | 1
project |
---|---|
フィールド タイプ | PROJECT |
オートコンプリート | はい |
サポートされる演算子 | = , != |
サポートされない演算子 | > , >= , < , <= , ~ , !~ |
サポートされる関数 | IN および NOT IN 演算子とともに使用する場合、project は以下をサポートします。
|
例 |
|
プロジェクトの特定のタイプ (次のいずれか) に所属する課題を検索:
business: ビジネス プロジェクトで作成された課題を検索
software: Jira で作成された課題を検索
service_desk: サービス プロジェクトで作成された課題を検索
結果は権限レベルに応じて異なります。自身がアクセス権を持っている製品の結果のみを表示できます。製品アクセス権の詳細をご確認ください。
構文 | projectType |
---|---|
オートコンプリート | はい |
サポートされる演算子 | =、!= IN、NOT IN |
サポートされない演算子 | >、>=、<、<=、~、!~ IS、IS NOT、WAS、WAS NOT、WAS NOT IN、CHANGED |
サポートされる関数 | なし |
例 | ソフトウェア プロジェクトのすべての課題を検索: projectType = ”software” ソフトウェア プロジェクトまたはサービス プロジェクトのいずれかに所属するすべての課題を検索: projectType = ”software” OR projectType = ”service_desk” ソフトウェア プロジェクトに所属しないすべての課題を検索: projectType != ”software” |
Jira 管理者が時間管理を有効にしている場合にのみ使用できます。
残余見積が特定の値 (日付や日付範囲ではなく数字) に設定されている課題を検索します。"w"、"d"、"h"、"m" を使用して、週、日付、時間、分を指定します。
構文 | 1
remainingEstimate |
---|---|
エイリアス | 1
timeEstimate |
フィールド タイプ | DURATION |
オートコンプリート | いいえ |
サポートされる演算子 | = , != , > , >= , < , <= |
サポートされない演算子 | ~ , !~ |
サポートされる関数 | なし |
例 |
|
特定のユーザーが報告した課題を検索します。このユーザーは作成者と同じである場合もあります。検索条件にはユーザーのフルネーム、ID またはメール アドレスを使用できます。
構文 | 1
reporter |
---|---|
フィールド タイプ | USER |
オートコンプリート | はい |
サポートされる演算子 | = , != |
サポートされない演算子 | ~ , !~ , > , >= , < , <= |
サポートされる関数 | IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:
EQUALS または NOT EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
ビジネス プロジェクトでのみ使用します。
課題が作成されたチャンネルに基づいてリクエストを検索します。たとえば、サービス プロジェクトにメールで送信された全リクエストや、カスタマー ポータルから送信された全リクエストを検索できます。
構文 | 1
request-channel-type |
---|---|
フィールド タイプ | TEXT |
オートコンプリート | はい |
サポートされる演算子 | = , != IS, IS NOT, IN, NOT IN |
サポートされない演算子 | ~ , !~ , > , >= , < , <= WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED |
サポートされる関数 | 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) のミリ秒後と解釈されます。
構文 | 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 EQUALS、LESS THAN または LESS THAN EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
サービス プロジェクトでのみ使用されます。
特定のリクエスト タイプのリクエストを検索します。リクエスト タイプの設定画面で設定したリクエスト タイプの名前または説明で検索できます。
構文 | 1
"Request Type" |
---|---|
フィールド タイプ | カスタム フィールド |
オートコンプリート | はい |
サポートされる演算子 | 1
= , != IN , NOT IN |
サポートされない演算子 | ~ , !~ , > , >= , < , <= IS , IS NOT, WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED リクエスト タイプの Lucene 値は portal-key/request-type-key であることにご注意ください。サービス プロジェクト ポータルの作成後にポータル キーを変更することはできませんが、プロジェクト キーは変更できます。リクエスト タイプの作成後にリクエスト タイプ キーを変更することはできません。 |
サポートされる関数 | なし |
例 |
|
サービスのチーム管理対象プロジェクトには、解決状況フィールドは存在しません。つまり、解決状況フィールドを使用して Jira Service Management のチーム管理対象プロジェクトにある課題は検索できません。代わりに、statusCategory フィールド (statusCategory = Done となっている場合、課題は解決済み) を使用できます。
特定の解決策がある課題を検索します。検索条件には解決策名または解決策 ID (Jira で解決策に自動的に割り当てられる番号) を使用できます。
解決策の名前ではなく ID で検索することをおすすめします。Jira 管理者が解決策の名前を変更すると、その名前に依存している保存済みフィルターが使用できなくなる可能性があります。ただし、解決策の ID は一意であり、変更されることはありません。
構文 | 1
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) のミリ秒後と解釈されます。
構文 | 1
resolved |
---|---|
エイリアス | 1
resolutionDate |
フィールド タイプ | DATE |
オートコンプリート | いいえ |
サポートされる演算子 | = , != , > , >= , < , <= |
サポートされない演算子 | ~ , !~ WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED |
サポートされる関数 | EQUALS、NOT EQUALS、GREATER THAN、GREATER THAN EQUALS、LESS THAN、LESS THAN EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
サービス プロジェクトでのみ使用されます。
リクエストを検索および整理し、SLA 目標を達成するのに役立ててください。SLA が完了状態にあるリクエストや、SLA クロックに一定の時間存在しているリクエストを検索できます。
構文 | 1
Time to resolution Time to first response <your custom SLA name> |
---|---|
フィールド タイプ | SLA |
オートコンプリート | いいえ |
サポートされる演算子 | = , !=, > , >= , < , <= |
サポートされない演算子 | ~ , !~ |
サポートされる関数 |
|
例 |
|
特定のスプリントに割り当てられている課題を検索します。アクティブなスプリントと将来のスプリントが対象となります。検索はスプリント名、またはスプリント ID (Jira でスプリントに自動的に割り当てられる番号) のいずれかに基づいて行われます。
似た名前、あるいは同じ名前の複数のスプリントがある場合、スプリント名またはスプリント名の一部を使用して検索できます。一致候補はオートコンプリート ドロップダウンに表示され、表示されるスプリントの日付でスプリントを見分けることができます (括弧内にスプリント ID も表示されます)。
構文 | 1
sprint |
---|---|
フィールド タイプ | NUMBER |
オートコンプリート | はい |
サポートされる演算子 | = , != |
サポートされない演算子 | ~ , !~ , > , >= , < , <= WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED |
サポートされる関数 |
|
例 |
|
特定のステータスを持つ課題を検索します。検索条件にはステータス名またはステータス ID (Jira でステータスに自動的に割り当てられる番号) を使用できます。
Jira 管理者がステータスの名前を変更すると、その名前に依存する保存済みフィルターが使用できなくなる可能性があるため、ステータス名よりもステータス ID で検索する方が安全です。ただし、ステータス ID は一意であり、変更されることはありません。
WAS、WAS NOT、WAS IN、WAS NOT IN 演算子は、名前でのみ使用できます (ID では不可)。
構文 | 1
status |
---|---|
フィールド タイプ | STATUS |
オートコンプリート | はい |
サポートされる演算子 | = , != |
サポートされない演算子 | ~ , !~ , > , >= , < , <= |
サポートされる関数 | なし |
例 |
|
Jira テキスト検索構文によって、要約に特定のテキストが含まれている課題を検索します。テキスト フィールドの検索構文の詳細をご確認ください。
構文 | 1
summary |
---|---|
フィールド タイプ | TEXT |
オートコンプリート | いいえ |
サポートされる演算子 | ~ , !~ |
サポートされない演算子 | = , != , > , >= , < , <= |
サポートされる関数 | なし |
例 |
|
これは、課題に対して次のようなすべてのテキスト フィールドを検索できるマスター フィールドです。
要約
説明
環境
コメント
"Free Text Searcher" を使用するカスタム フィールド。これには以下の組み込みカスタム フィールド タイプが含まれます。
フリー テキスト フィールド (無制限のテキスト)
テキスト フィールド (255 文字まで)
読み取り専用のテキスト フィールド
Jira テキスト検索構文によって、特定のテキストが存在する課題を検索します。テキスト フィールドの検索構文の詳細をご確認ください。
text マスター フィールドは、CONTAINS 演算子 ("~") と一緒にのみ使用できます。
一部の文字や単語は予約されているため、課題の検索には使用できません。予約文字の詳細をご確認ください。
構文 | 1
text |
---|---|
フィールド タイプ | TEXT |
オートコンプリート | いいえ |
サポートされる演算子 | ~ |
サポートされない演算子 | !~, = , != , > , >= , < , <= |
サポートされる関数 | なし |
例 |
|
Similar to text, this is a master-field that allows you to search in most text fields (except Comments, Worklog) for issues, such as:
要約
説明
環境
"Free Text Searcher" を使用するカスタム フィールド。これには以下の組み込みカスタム フィールド タイプが含まれます。
フリー テキスト フィールド (無制限のテキスト)
テキスト フィールド (255 文字まで)
読み取り専用のテキスト フィールド
textfields マスター フィールドは、CONTAINS 演算子 ("~") と一緒にのみ使用できます。
一部の文字や単語は予約されているため、課題の検索には使用できません。予約文字の詳細をご確認ください。
構文 | 1
textfields |
---|---|
フィールド タイプ | TEXT |
オートコンプリート | いいえ |
サポートされる演算子 | ~ |
サポートされない演算子 | !~, = , != , > , >= , < , <= |
サポートされる関数 | なし |
例 |
|
Jira 管理者が時間管理を有効にしている場合にのみ使用できます。
消費時間が特定の値 (日付や日付範囲ではなく数字) に設定されている課題を検索します。"w"、"d"、"h"、"m" を使用して、週、日付、時間、分を指定します。
構文 | 1
timeSpent |
---|---|
フィールド タイプ | DURATION |
オートコンプリート | いいえ |
サポートされる演算子 | = , != , > , >= , < , <= |
サポートされない演算子 | ~ , !~ |
サポートされる関数 | なし |
例 |
|
特定の課題タイプの課題を検索します。検索条件には課題タイプ名または課題タイプ ID (Jira で課題タイプに自動的に割り当てられる番号) を使用できます。
タイプ名ではなくタイプ ID で検索することをおすすめします。Jira 管理者がタイプ名を変更してしまうと、その名前に依存している保存済みフィルターが使用できなくなる可能性がありますが、タイプ ID は一意であり、変更されることはありません。
構文 | 1
type |
---|---|
エイリアス | 1
issueType |
フィールド タイプ | ISSUE_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) のミリ秒後と解釈されます。
構文 | 1
updated |
---|---|
エイリアス | 1
updatedDate |
フィールド タイプ | DATE |
オートコンプリート | いいえ |
サポートされる演算子 | = , != , > , >= , < , <= |
サポートされない演算子 | ~ , !~ |
サポートされる関数 | EQUALS、NOT EQUALS、GREATER THAN、GREATER THAN EQUALS、LESS THAN または LESS THAN EQUALS 演算子と併用する場合、このフィールドは次をサポートします。
|
例 |
|
特定のユーザーが投票した課題を検索します。検索条件にはユーザーのフルネーム、ID またはメールアドレスを使用できます。自分の投票を検索する場合を除き、 "View Voters and Watchers"(投票者とウォッチャーの表示)権限を持つ課題のみを検索できます。
構文 | 1
voter |
---|---|
フィールド タイプ | USER |
オートコンプリート | はい |
サポートされる演算子 | = , != |
サポートされない演算子 | ~ , !~ , > , >= , < , <= |
サポートされる関数 | IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:
EQUALS および NOT EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
指定した数の投票数を持つ課題を検索します。
構文 | 1
votes |
---|---|
フィールド タイプ | NUMBER |
オートコンプリート | いいえ |
サポートされる演算子 | = , != , > , >= , < , <= |
サポートされない演算子 | ~ , !~ |
サポートされる関数 | なし |
例 |
|
特定のユーザーがウォッチしている課題を検索します。ユーザーの氏名、ID、またはメール アドレスで検索できます。自分がウォッチャーである課題を検索する場合を除いて、「投票者とウォッチャーの表示」権限を持つ課題のみを検索できることにご留意ください。watchedIssues もご参照ください。
構文 | 1
watcher |
---|---|
フィールド タイプ | USER |
オートコンプリート | はい |
サポートされる演算子 | = , != |
サポートされない演算子 | ~ , !~ , > , >= , < , <= |
サポートされる関数 | IN および NOT IN 演算子と共に使用する場合、このフィールドは以下をサポートします:
EQUALS および NOT EQUALS 演算子と共に使用する場合、このフィールドは以下をサポートします:
|
例 |
|
指定した数のウォッチャーを持つ課題を検索します。
構文 | 1
watchers |
---|---|
フィールド タイプ | NUMBER |
オートコンプリート | いいえ |
サポートされる演算子 | = , != , > , >= , < , <= |
サポートされない演算子 | ~ , !~ |
サポートされる関数 | なし |
例 |
|
このフィールドは Jira 管理者によって時間管理が有効にされている場合にのみ使用できます。また、CONTAINS 演算子 ("~") のみに対応しています。
Jira テキスト検索構文によって、作業ログのコメントに特定のテキストが存在する課題を検索します。テキスト フィールドの検索構文の詳細をご確認ください。
構文 | 1
worklogComment |
---|---|
フィールド タイプ | TEXT |
オートコンプリート | いいえ |
サポートされる演算子 | ~ |
サポートされない演算子 | !~, = , != , > , >= , < , <= |
サポートされる関数 | なし |
例 |
|
Jira 管理者が時間管理を有効にしている場合にのみ使用できます。
特定の日付でワークログに記録された課題を検索する
構文 | 1
worklogDate |
---|---|
フィールド タイプ | DATE |
オートコンプリート | いいえ |
サポートされる演算子 | = , != , > , >= , < , <= |
サポートされない演算子 | ~ , !~ |
サポートされる関数 | EQUALS、NOT EQUALS、GREATER THAN、GREATER THAN EQUALS、LESS THAN または LESS THAN EQUALS 演算子と併用する場合、このフィールドは次をサポートします。
|
例 |
|
Jira 管理者が時間管理を有効にしている場合にのみ使用できます。
作業率が特定の値である課題を検索します。作業率の計算方法は次のとおりです: workRatio = timeSpent / originalEstimate) x 100
構文 | 1
workRatio |
---|---|
フィールド タイプ | NUMBER |
オートコンプリート | いいえ |
サポートされる演算子 | = , != , > , >= , < , <= |
サポートされない演算子 | ~ , !~ |
サポートされる関数 | なし |
例 |
|
この内容はお役に立ちましたか?