Jira Service Management の管理者向けの利用開始ガイド
最初に、Jira Service Management の使用を開始する方法を確認します。
このページでは、高度な検索で使用する関数の情報について説明します。
JQL における関数は単語のあとに括弧が続くもので、1 つ以上の値や Jira フィールドを含むことがあります。句では、関数の前に演算子があり、その前にフィールドがあります。関数は特定の Jira データまたは関数内のコンテンツの計算を実行し、関数または関数を利用する句では真となる結果のみを取得します。
検索クエリで指定されていないかぎり、JQL 検索の結果で空のフィールドが返されることはありません。現在のユーザーに割り当てられていない課題を検索するときに空のフィールド (未割り当ての課題) を含めるには、(assignee != currentUser() OR assignee is EMPTY) と入力して、未割り当ての課題を検索結果に含めます。
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
承認が必要だったリクエストや、承認が最終決定済みのリクエストを検索します。
構文 | 1
approved() |
---|---|
サポートされるフィールド | Approval タイプのカスタム フィールド |
サポートされる演算子 | = |
サポートされない演算子 | ~ , != , !~ , > , >= , < , <= IS , IS NOT , IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED |
例 |
|
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
ユーザーによる承認が必要または必要だったリクエストを検索します。これは OR 演算子を使用し、ユーザー名を指定する必要があります。
構文 | 1
approver(user,user) |
---|---|
サポートされるフィールド | Approval タイプのカスタム フィールド |
サポートされる演算子 | = |
サポートされない演算子 | ~ , != , !~ , >、>=、<、<= |
例 |
|
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
直近の SLA で目標を達成できなかった課題を返します。
構文 | 1
breached() |
---|---|
サポートされるフィールド | SLA |
サポートされる演算子 | = , != |
サポートされない演算子 | ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED |
例 |
|
"cascading select" カスタム フィールドの値が選択したものと一致する課題を検索します。
parentOption パラメーターは、cascading select フィールドの第 1 階層のオプションに対応します。childOption() パラメーターは、cascading select フィールドの第 2 階層のオプションに対応します。
"none" キーワードは、片方もしくは両方にのオプションに値を持たない課題を検索するときに使用します。
構文 | 1
2
cascadeOption(parentOption)
cascadeOption(parentOption,childOption) |
---|---|
サポートされるフィールド | "Cascading Select" タイプのカスタム フィールド |
サポートされる演算子 | IN , NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= IS , IS NOT, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED |
例 |
|
完了したスプリントに割り当てられている課題を検索します。
完了したスプリントと未完了のスプリントの両方に 1 つの課題が属している場合もあります。openSprints() もご確認ください。
構文 | 1
closedSprints() |
---|---|
サポートされるフィールド | Sprint |
サポートされる演算子 | IN , NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= |
例 |
|
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
1 つ以上のサイクルを完了した SLA を持つ課題を返します。
構文 | 1
completed() |
---|---|
サポートされるフィールド | SLA |
サポートされる演算子 | = , != |
サポートされない演算子 | ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED |
例 |
|
特定のユーザーが主導しているコンポーネント内の課題を検索します。必要に応じてユーザーを指定できます。ユーザーを指定しない場合、現在のユーザー (自身) が使用されます。
Jira にログインしていない場合は、ユーザーを指定する必要があります。
構文 | 1
2
componentsLeadByUser()
componentsLeadByUser(username) |
---|---|
サポートされるフィールド | Component |
サポートされる演算子 | IN , NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= IS , IS NOT, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED |
例 |
|
現在のユーザーによるセッションの開始時間に基づいて検索を実行します。lastLogin もご確認ください。
構文 | 1
currentLogin() |
---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 | = , != , > , >= , < , <= WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED* * Only in predicate |
サポートされない演算子 | ~ , !~ IS , IS NOT , IN , NOT IN |
例 |
|
現在のログイン ユーザーに基づいて検索を実行します。
この関数は、ログイン済みのユーザーのみが使用できます。したがって、匿名ユーザーが利用することを想定したフィルターを作成する場合、この関数を使うことはできません。
構文 | 1
currentUser() |
---|---|
サポートされるフィールド | 担当者、報告者、投票者、ウォッチャー、作成者、ユーザー タイプのカスタム フィールド |
サポートされる演算子 | = , != |
サポートされない演算子 | ~ , !~ , > , >= , < , <= IS , IS NOT , IN , NOT IN , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED |
例 |
|
顧客の詳細に基づいて検索を実行します。
Jira Service Management の Premium プランと Enterprise プランでのみ利用できます。この JQL 関数を使用するには、[プロジェクト設定] の "機能" ページで [カスタマー サービス管理] をオンにします。
構文 | 1
customerDetail( ) |
---|---|
サポートされるフィールド | 担当者、報告者、投票者、ウォッチャー、User タイプのカスタム フィールド |
サポートされる演算子 | IN , NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT IN, WAS NOT , CHANGED |
例 |
|
プロジェクトの未リリースのバージョンの中で一番古いバージョンに基づいて検索を実行します。「unreleasedVersions」も参照してください。
バージョンの順序は、プロジェクトの [リリース] ページにバージョンが表示される順序によって決まります。一覧の一番下のバージョンが "一番古い" ものとなります。バージョンの順序を変更するには、一覧でバージョンをドラッグ アンド ドロップして新しい場所に配置します。
構文 | 1
earliestUnreleasedVersion(project) |
---|---|
サポートされるフィールド | 影響バージョン、修正バージョン、Version タイプのカスタム フィールド |
サポートされる演算子 | = , != , ~ , !~ , > , >= , < , <= IS, IS NOT, WAS, WAS NOT |
サポートされない演算子 | IN, NOT IN、WAS IN、WAS NOT IN、CHANGED |
例 |
|
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
SLA サイクルの開始イベントに対し、SLA クロックが特定の相対的なタイミングにある課題を返します。
構文 | 1
elapsed() |
---|---|
サポートされるフィールド | SLA |
サポートされる演算子 | = , !=, > , >= , < , <= |
サポートされない演算子 | ~ IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED |
例 |
|
検索実行日の最終時刻に基づいて検索を実行します。
endOfWeek、endOfMonth、endOfYear、startOfDay、startOfWeek、startOfMonth、および startOfYear もご確認ください。
構文 | 1
2
endOfDay()
endOfDay("inc") inc は、(+/-)nn(y|M|w|d|h|m). のオプションのインクリメントです。時間単位の修飾子が省略された場合、既定ではその関数の自然周期が設定されます。endOfDay("+1") は endOfDay("+1d") と同じと解釈されます。プラス/マイナス (+/-) 記号が省略された場合、プラスと見なされます。 |
---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 | = , != , > , >= , < , <= WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED** Only in predicate |
サポートされない演算子 | ~ , !~ IS , IS NOT , IN , NOT IN |
例 |
|
検索実行日の月末に基づいて検索を実行します。
endOfDay、endOfWeek、endOfYear、startOfDay、startOfWeek、startOfMonth、および startOfYear もご確認ください。
構文 | 1
2
endOfMonth()
endOfMonth("inc") inc は、(+/-)nn(y|M|w|d|h|m). のオプションのインクリメントです。時間単位の修飾子が省略された場合、既定ではその関数の自然周期が設定されます。endOfMonth("+1") は endOfMonth("+1M") と同じと解釈されます。プラス/マイナス (+/-) 記号が省略された場合、プラスと見なされます。 |
---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 | = , != , > , >= , < , <= WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED** Only in predicate |
サポートされない演算子 | ~ , !~ IS , IS NOT , IN , NOT IN |
例 |
|
期日が今週中である課題を検索します。既定では、この関数は週の最終日を土曜日とみなします。週の最終日として別の日 (日曜日など) を使用することもできます。以下の例の構文を参照してください。
endOfDay、endOfMonth、endOfYear、startOfDay、startOfWeek、startOfMonth、 および startOfYear もご確認ください。
構文 | 1
2
endOfWeek()
endOfWeek("inc") inc は、(+/-)nn(y|M|w|d|h|m). のオプションのインクリメントです。時間単位の修飾子が省略された場合、既定ではその関数の自然周期が設定されます。endOfWeek("+1") は endOfWeek("+1w") と同じと解釈されます。プラス/マイナス (+/-) 記号が省略された場合、プラスと見なされます。 |
---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 | = , != , > , >= , < , <= WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED** Only in predicate |
サポートされない演算子 | ~ , !~ IS , IS NOT , IN , NOT IN |
例 |
|
検索実行日の年末に基づいて検索を実行します。
startOfDay、startOfWeek、startOfMonth、endOfDay、endOfWeek、endOfMonth、およびendOfYear もご確認ください。
構文 | 1
2
endOfYear()
endOfYear("inc") inc は、(+/-)nn(y|M|w|d|h|m). のオプションのインクリメントです。時間単位の修飾子が省略された場合、既定ではその関数の自然周期が設定されます。endOfYear("+1") は endOfYear("+1y") と同じと解釈されます。プラス/マイナス (+/-) 記号が省略された場合、プラスと見なされます。 |
---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 | = , != , > , >= , < , <= WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED** Only in predicate |
サポートされない演算子 | ~ , !~ IS , IS NOT , IN , NOT IN |
例 |
|
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
SLA 目標の 1 つを達成できなかった課題を返します。
構文 | 1
elapsed() |
---|---|
サポートされるフィールド | SLA |
サポートされる演算子 | = , != |
サポートされない演算子 | ~, > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED |
例 |
|
まだ開始されていないスプリントに割り当てられている課題を検索します。
完了したスプリントと未完了のスプリントの両方に 1 つの課題が属している場合もあります。
構文 | 1
futureSprints() |
---|---|
サポートされるフィールド | Sprint |
サポートされる演算子 | IN , NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= |
例 |
|
最近閲覧した課題、つまり [課題] ドロップダウン メニューの [最近表示した課題] セクションにある課題を検索します。
注意:
[最近の課題] ドロップダウンでは課題が 5 件だけ返されるのに対して、issueHistory() では最大 50 件の課題が返されます。
Jira にログインしていない場合、現在のブラウザ セッションから取得した課題のみが含まれます。
構文 | 1
issueHistory() |
---|---|
サポートされるフィールド | Issue |
サポートされる演算子 | IN , NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED |
例 |
|
指定されたグローバル ID のいずれかを持つリモート リンクに関連付けられている課題に基づいて検索を実行します。
この関数では 1 から 100 の globalId を指定できます。0、または 100 よりも大きい globalId を指定するとエラーになります。
構文 | 1
issuesWithRemoteLinksByGlobalId() |
---|---|
サポートされるフィールド | Issue |
サポートされる演算子 | IN , NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED |
例 |
|
現在のユーザーの前回のセッション開始時間に基づいて検索を行います。currentLogin もご確認ください。
構文 | 1
lastLogin() |
---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 | = , != , > , >= , < , <= WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED** Only in predicate |
サポートされない演算子 | ~ , !~ IS , IS NOT , IN , NOT IN |
例 |
|
特定のプロジェクトのリリース済みバージョンの中で一番最後にリリースされたバージョンに基づいて検索を実行します。「releasedVersions()」も参照してください。
「最新」かどうかは、実際のバージョン期限ではなく、バージョンに割り当てられた序数に基づいて判断されます。
構文 | 1
latestReleasedVersion(project) |
---|---|
サポートされるフィールド | 影響バージョン、修正バージョン、Version タイプのカスタム フィールド |
サポートされる演算子 | = , != |
サポートされない演算子 | ~ , !~ , > , >= , < , <= IS、IS NOT、IN、NOT IN、WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED |
例 |
|
エピックとサブタスクを検索します。課題がエピックではない場合、検索結果はその課題のすべてのサブタスクを返します。
構文 | 1
linkedissue = issueKey |
---|---|
サポートされるフィールド | Issue |
サポートされる演算子 | =、!= |
例 |
|
課題にリンクされている課題を検索します。特定のタイプのリンクに検索を制限できます。
構文 | 1
2
linkedIssues(issueKey)
linkedIssues(issueKey,CaseSensitiveLinkType) |
---|---|
サポートされるフィールド | Issue |
サポートされる演算子 | IN , NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED |
例 |
|
特定のグループのメンバーに基づく検索を実施します。
構文 | 1
|
---|