高度な検索リファレンス - JQL 関数
このページでは、高度な検索で使用する関数の情報について説明します。
JQL における関数とは、言葉に丸括弧が続くもので、1 つ以上の値や Jira フィールドを含むことがあります。 句では、関数の前に演算子があり、その前にフィールドが先行します。関数は特定の Jira データまたは関数内のコンテンツの計算を実行し、関数または関数を利用する句では真となる結果のみを取得します。
検索クエリで指定されていないかぎり、JQL 検索の結果で空のフィールドが返されることはありません。現在のユーザーに割り当てられていない課題を検索するときに空のフィールド (未割り当ての課題) を含めるには、(assignee != currentUser() OR assignee is EMPTY) と入力して、未割り当ての課題を検索結果に含めます。
approved()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
承認が必要だったリクエストや、承認が最終決定済みのリクエストを検索します。
構文 | approved() |
|---|---|
サポートされるフィールド | Approval タイプのカスタム フィールド |
サポートされる演算子 | = |
サポートされない演算子 |
|
例 |
|
approver()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
ユーザーによる承認が必要または必要だったリクエストを検索します。これは OR 演算子を使用し、ユーザー名を指定する必要があります。
構文 | approver(user,user) |
|---|---|
サポートされるフィールド | Approval タイプのカスタム フィールド |
サポートされる演算子 | = |
サポートされない演算子 |
|
例 |
|
breached()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
直近の SLA でサービス目標を達成できなかった課題を返します。
構文 | breached() |
|---|---|
サポートされるフィールド | SLA |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
cascadeOption()
"cascading select" カスタム フィールドの値が選択したものと一致する課題を検索します。
parentOption パラメーターは、cascading select フィールドの第 1 階層のオプションに対応します。childOption() パラメーターは、cascading select フィールドの第 2 階層のオプションに対応します。
"none" キーワードは、片方もしくは両方にのオプションに値を持たない課題を検索するときに使用します。
構文 | cascadeOption(parentOption)
cascadeOption(parentOption,childOption) |
|---|---|
サポートされるフィールド | "Cascading Select" タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
closedSprints()
Search for issues that are assigned to a completed Sprint. Note, it is possible for an issue to belong to both a completed Sprint(s) and an incomplete Sprint(s). See also openSprints().
構文 | closedSprints() |
|---|---|
サポートされるフィールド | Sprint |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
completed()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
1 つ以上のサイクルを完了した SLA を持つ課題を返します。
構文 | completed() |
|---|---|
サポートされるフィールド | SLA |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
componentsLeadByUser()
特定のユーザーがリードになっているコンポーネント内の課題を検索します。必要に応じてユーザーを指定できます。ユーザーを指定しない場合、現在のユーザー (操作者) が設定されます。Jira にログインしていない場合はユーザーを指定する必要があることにご注意ください。
構文 | componentsLeadByUser()
componentsLeadByUser(username) |
|---|---|
サポートされるフィールド | Component |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
currentLogin()
現在のユーザーによるセッションの開始時間に基づいて検索を実行します。 lastLogin もご確認ください。
構文 | currentLogin() |
|---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
currentUser()
現在のログインユーザーに基づいて検索を実行します。ログインしたユーザーに対してのみ実行できることにご注意ください。したがって、匿名ユーザーが利用することを想定したフィルターを作成する場合、この関数を使うことはできません。
構文 | currentUser() |
|---|---|
サポートされるフィールド | 担当者、報告者、投票者、ウォッチャー、作成者、ユーザー タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
earliestUnreleasedVersion()
プロジェクトの未リリース バージョンの中で一番古いバージョンに基づいて検索を実行します。「unreleasedVersions」も参照してください。
バージョンの順序は、プロジェクトの [リリース] ページにバージョンが表示される順序によって決まります。一覧の一番下のバージョンが "一番古い" ものとなります。バージョンの順序を変更するには、一覧でバージョンをドラッグ アンド ドロップして新しい場所に配置します。
構文 | earliestUnreleasedVersion(project) |
|---|---|
サポートされるフィールド | 影響バージョン、修正バージョン、Version タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
elapsed()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
SLA サイクルの開始イベントに対し、SLA クロックが特定の相対的なタイミングにある課題を返します。
構文 | elapsed() |
|---|---|
サポートされるフィールド | SLA |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
endOfDay()
検索実行日の最終時刻に基づいて検索を実行します。endOfWeek、endOfMonth、endOfYear、startOfDay、startOfWeek、startOfMonth、および startOfYear もご確認ください。
構文 | endOfDay()
endOfDay("inc")where |
|---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
endOfMonth()
検索実行日の月末に基づいて検索を実行します。endOfDay、endOfWeek、endOfYear、startOfDay、startOfWeek、startOfMonth、および startOfYear もご確認ください。
構文 | endOfMonth()
endOfMonth("inc")where |
|---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
endOfWeek()
期日が今週中である課題を検索します。既定では、この関数は週の最終日を土曜日とみなします。週の最終日として別の日 (日曜日など) を使用することもできます。以下の例の構文を参照してください。
endOfDay、endOfMonth、endOfYear、startOfDay、startOfWeek、startOfMonth、 および startOfYear もご確認ください。
構文 | endOfWeek()
endOfWeek("inc")where |
|---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
endOfYear()
Perform searches based on the end of the current year. See also startOfDay, startOfWeek, and startOfMonth; and endOfDay, endOfWeek, endOfMonth, and endOfYear.
構文 | endOfYear()
endOfYear("inc")where |
|---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
everBreached()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
SLA 目標の 1 つを達成できなかった課題を返します。
構文 | everbreached() |
|---|---|
サポートされるフィールド | SLA |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
futureSprints()
まだ開始されていないスプリントに割り当てられている課題を検索します。注: 1 つの課題が完了したスプリントと未完了のスプリントの両方に割り当てられている場合があります。
構文 | futureSprints() |
|---|---|
サポートされるフィールド | Sprint |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
issueHistory()
最近閲覧した課題、つまり [課題] ドロップダウン メニューの [最近表示した課題] セクションにある課題を検索します。
注意:
[最近の課題] ドロップダウンでは課題が 5 件だけ返されるのに対して、
issueHistory()では最大 50 件の課題が返されます。Jira にログインしていない場合、現在のブラウザ セッションから取得した課題のみが含まれます。
構文 | issueHistory() |
|---|---|
サポートされるフィールド | Issue |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
issuesWithRemoteLinksByGlobalId()
指定されたグローバル ID のいずれかを持つリモート リンクに関連付けられている課題に基づいて検索を実行します。
注意:
この関数では 1 から 100 の globalId を指定できます。0、または 100 よりも大きい globalId を指定するとエラーになります。
構文 | issuesWithRemoteLinksByGlobalId() |
|---|---|
サポートされるフィールド | Issue |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
lastLogin()
現在のユーザーによる前回のセッションの開始時間に基づいて検索を実行します。同様に currentLogin という関数があります。
構文 | lastLogin() |
|---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
latestReleasedVersion()
特定のプロジェクトのリリース済みバージョンの中で一番最後にリリースされたバージョンに基づいて検索を実行します。同様に releasedVersions() という関数があります。"latest" はそのバージョンが利用する序数によって決定されます。バージョンの Due Dates によるものではないので注意してください。
構文 | latestReleasedVersion(project) |
|---|---|
サポートされるフィールド | 影響バージョン、修正バージョン、Version タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
linkedissue
エピックとサブタスクを検索します。課題がエピックではない場合、検索結果はその課題のすべてのサブタスクを返します。
構文 | linkedissue = issueKey |
|---|---|
サポートされるフィールド | Issue |
サポートされる演算子 | =、!= |
例 |
|
linkedIssues()
課題にリンクされている課題を検索します。特定のタイプのリンクに検索を制限できます。
構文 | linkedIssues(issueKey)
linkedIssues(issueKey,CaseSensitiveLinkType) |
|---|---|
サポートされるフィールド | Issue |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
membersOf()
特定のグループのメンバーに基づく検索を実施します。
構文 | membersOf(Group) |
|---|---|
サポートされるフィールド | 担当者、報告者、投票者、ウォッチャー、作成者、ユーザー タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
myApproval()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
ログイン ユーザーによる承認が必要または必要だったリクエストを検索します。
構文 | myApproval() |
|---|---|
サポートされるフィールド | Approval タイプのカスタム フィールド |
サポートされる演算子 | = |
サポートされない演算子 | ~ , != , !~ , > , >= , < , <=
IS , IS NOT , IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED |
例 | 自身による承認が必要なすべてのリクエストを検索 |
myPendingApproval()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
現在、ログイン ユーザーによる承認が必要なリクエストを検索します。
構文 | myPendingApproval() |
|---|---|
サポートされるフィールド | Approval タイプのカスタム フィールド |
サポートされる演算子 | = |
サポートされない演算子 |
|
例 | 現在、自身による承認が必要なすべてのリクエストを検索する |
myPending()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
現在またはこれまでに、現在のユーザーによる承認を必要とするリクエストを検索します。
構文 | myPending() |
|---|---|
サポートされるフィールド | Approval タイプのカスタム フィールド |
サポートされる演算子 | = |
サポートされない演算子 |
|
例 | 現在、または以前に自身による承認が必要だったすべてのリクエストを検索する |
now()
現在の時刻に基づいた検索を行います。
構文 | now() |
|---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
openSprints()
開始済みかつ未完了のスプリントに割り当てられている課題を検索します。注: 1 つの課題が完了したスプリントと未完了のスプリントの両方に割り当てられている場合があります。closedSprints() もご確認ください。
構文 | openSprints() |
|---|---|
サポートされるフィールド | Sprint |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
organizationMembers()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
ある組織のメンバーが送信したすべてのリクエストを検索します。メンバーが組織と共有したリクエスト、未共有のリクエスト、および所属しているほかの組織に共有したリクエストが返されます。
構文 | organizationMembers() |
|---|---|
サポートされるフィールド | 担当者、報告者、投票者、ウォッチャー、User タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
parentEpic()
企業管理対象プロジェクトにのみ適用されます。
エピックにリンクされている課題とサブタスクを検索します。
構文 | parentEpic() |
|---|---|
サポートされるフィールド | Issue |
サポートされる演算子 | = , != , IN , NOT IN |
サポートされない演算子 |
|
例 |
|
paused()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
特定の条件によって一時停止されている SLA を持つ課題を返します。
カレンダー時間外のために一時停止されている課題を検索するには、withincalendarhours() を使用します。
構文 | paused() |
|---|---|
サポートされるフィールド | SLA |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
pending()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
承認が必要なリクエストを検索します。
構文 | pending() |
|---|---|
サポートされるフィールド | Approval タイプのカスタム フィールド |
サポートされる演算子 | = |
サポートされない演算子 |
|
例 |
|
pendingBy()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
特定のユーザーによる承認が必要なリクエストを検索します。これは OR 演算子を使用し、ユーザー名を指定する必要があります。
構文 | pendingBy(user1,user2) |
|---|---|
サポートされるフィールド | Approval タイプのカスタム フィールド |
サポートされる演算子 | = |
サポートされない演算子 |
|
例 |
|
projectsLeadByUser()
特定のユーザーが主導するプロジェクト内の課題を検索します。オプションでアカウント ID を指定できます。アカウント ID を指定しない場合は、現在のユーザー アカウントが使用されます。Jira にログインしていない場合は、アカウント ID を指定する必要があることにご注意ください。
構文 | projectsLeadByUser()
projectsLeadByUser(accountID) |
|---|---|
サポートされるフィールド | Project |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
projectsWhereUserHasPermission()
自身が特定の権限を持つプロジェクト内で課題を検索します。この関数は、プロジェクト レベルで実行されます。たとえば、プロジェクトで課題の報告者に特定の権限 ("課題の編集" など) が付与されている場合、自身が報告者ではない (したがって権限を持たない) 課題が返される可能性があります。この関数は、Jira にログインしている場合にのみ利用できます。
構文 | projectsWhereUserHasPermission(permission)For the |
|---|---|
サポートされるフィールド | Project |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
projectsWhereUserHasRole()
自身が特定のロールを持っているプロジェクトの課題を検索します。この関数は、Jira にログインしている場合にのみ利用できます。
構文 | projectsWhereUserHasRole(rolename) |
|---|---|
サポートされるフィールド | Project |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
releasedVersions()
Perform searches based on the released versions (i.e. versions that your Jira administrator has released) of a specified project. You can also search on the released versions of all projects, by omitting the project parameter. See also latestReleasedVersion().
構文 | releasedVersions()
releasedVersions(project) |
|---|---|
サポートされるフィールド | 影響バージョン、修正バージョン、Version タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
remaining()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
SLA サイクルの終了に対し、SLA クロックが特定の相対的なタイミングにある課題を返します。
構文 | remaining() |
|---|---|
サポートされるフィールド | SLA |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
running()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
カレンダーにかかわらず、実行中の SLA を持つ課題を返します。
カレンダー時間に基づいて実行中の課題を検索するには、withincalendarhours() を使用します。
構文 | running() |
|---|---|
サポートされるフィールド | SLA |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
standardIssueTypes()
Perform searches based on "standard" Issue Types, that is, search for issues that are not sub-tasks. See also subtaskIssueTypes().
構文 | standardIssueTypes() |
|---|---|
サポートされるフィールド | タイプ |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
startOfDay()
検索実行日の開始時刻に基づいて検索を実行します。startOfWeek、startOfMonth、startOfYear、endOfDay、endOfWeek、endOfMonth、および endOfYear もご確認ください。
構文 | startOfDay()
startOfDay("inc")where |
|---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
startOfMonth()
検索実行日の月初に基づいて検索を実行します。startOfDay、startOfWeek、startOfMonth、endOfDay、endOfWeek、endOfMonth、および endOfYear もご確認ください。
構文 | startOfMonth()
startOfMonth("inc")where |
|---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
startOfWeek()
今週作成された新しい課題を検索します。既定では、この関数は週の開始日を日曜日とみなします。週の開始日として別の日 (月曜日など) を使用することもできます。以下の例の構文を参照してください。
startOfDay、startOfMonth、startOfYear、endOfDay、endOfWeek、endOfMonth、および endOfYear も参照してください。
構文 | startOfWeek()
startOfWeek("inc")where |
|---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
startOfYear()
検索実行日の年始に基づいて検索を実行します。同様の関数に startOfDay, startOfWeek, startOfMonth, endOfDay, endOfWeek, endOfMonth, endOfYearといった関数もあります。
構文 | startOfYear()
startOfYear("inc")where |
|---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
subtaskIssueTypes()
サブタスクである課題に基づいて検索を実行します。standardIssueTypes() もご確認ください。
構文 | subtaskIssueTypes() |
|---|---|
サポートされるフィールド | タイプ |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
unreleasedVersions()
特定のスペースの未リリース バージョン (つまり、Jira 管理者がまだリリースしていないバージョン) に基づいて検索を実行します。projectパラメーターを省略することで、すべてのプロジェクトの未リリースバージョンの課題を検索することも出来ます。「earliestUnreleasedVersion()」も参照してください。
構文 | unreleasedVersions()
unreleasedVersions(project) |
|---|---|
サポートされるフィールド | 影響バージョン、修正バージョン、Version タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
updatedBy()
特定のユーザーが更新した課題を検索できます。オプションで期間も指定できます。ここの更新とは、課題の作成、課題の任意のフィールドの更新、コメントの作成または削除、またはコメントの編集 (直前の編集のみ) を含みます。
この関数は、最大 32000 の課題 ID を返します。
時間範囲については、以下の形式のいずれかを使用します。
"yyyy/MM/dd""yyyy-MM-dd"
"w" (週) または "d" (日) を使用して現在の時刻に対する相対的な日付を指定することもできます。他の関数とは異なり、updatedBy では 1 日よりも小さい値はサポートされず、常に 1 日に切り上げられます。
構文 | updatedBy(user)
updatedBy(user, dateFrom)
updatedBy(user, dateFrom, dateTo) |
|---|---|
サポートされるフィールド |
|
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
votedIssues()
自身が投票した課題に基づいて検索を実行します。Voter フィールドもご確認ください。この関数は、ログイン済みのユーザーのみが使用できます。
この関数は、最大 32000 の課題 ID を返します。
構文 | votedIssues() |
|---|---|
サポートされるフィールド | Issue |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
watchedIssues()
自身がウォッチしている課題に基づいて検索を実行します。Watcher フィールドもご確認ください。この関数は、ログイン済みのユーザーのみが使用できます。
この関数は、最大 32000 の課題 ID を返します。
構文 | watchedIssues() |
|---|---|
サポートされるフィールド | Issue |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
withinCalendarHours()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
SLA カレンダーに基づいて実行中の SLA を持つ課題を返します。
たとえば、プロジェクトに、初回応答時間をカウントする 2 つの SLA があるとします。この SLA を使用する一部の課題は午前 9 時 - 午後 1 時のカレンダーを、他の課題は午前 9 時 - 午後 5 時のカレンダーを使用します。エージェントが午後 3 時に作業を開始した場合、おそらく午前 9 時 - 午後 5 時の SLA にある課題から作業を行います。withincalendarhours() を使用して、午後 3 時時点で初回応答時間が実行中のすべての課題を検索できます。
構文 | withinCalendarHours() |
|---|---|
サポートされるフィールド | SLA |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
この内容はお役に立ちましたか?