• 関連ドキュメント
クラウド

We're updating our terminology in Jira

'Issue' is changing to 'work item'. You might notice some inconsistencies while this big change takes place.

JQL 関数

We're updating terminology in Jira and changing 'issue' to 'work item'. As part of the change, there are no changes to existing JQL queries.

このページでは、高度な検索で使用する関数の情報をご説明します。インストール済みのアプリから追加の JQL 関数を利用できる場合があります。

JQL における関数とは、言葉に丸括弧が続くもので、1 つ以上の値や Jira フィールドを含むことがあります。 句では、関数の前に演算子があり、その前にフィールドが先行します。関数は特定の Jira データまたは関数内のコンテンツの計算を実行し、関数または関数を利用する句では真となる結果のみを取得します。

Unless specified in the search query, note that JQL searches do not return empty fields in results. To include empty fields (e.g. unassigned work items) when searching for work items that are not assigned to the current user, you would enter (assignee != currentUser() OR assignee is EMPTY) to include unassigned work items in the list of results.

approved()

Jira Service Management サブスクリプションがあるサイトにのみ適用されます。

承認が行われており、最終決定が承認済みであるすべてのリクエストを検索します。

構文

approved()

サポートされるフィールド

承認タイプのカスタム フィールド

サポートされる演算子

=

サポートされない演算子

!=、~、!~、>、>=、<、<=、IS、IS NOT、IN、NOT IN、WAS、WAS IN、WAS NOT、WAS NOT IN、CHANGED

例

  • 承認済みのすべてのリクエストを検索:
    approvals = approved()

approver()

Jira Service Management サブスクリプションがあるサイトにのみ適用されます。

特定のユーザーが保留中または完了した承認ステップの承認者であり、承認を実行したか、または却下したか分からないリクエストを検索します。ユーザー名を入力する必要があります。

構文

approver(user1, user2)

サポートされるフィールド

承認タイプのカスタム フィールド

サポートされる演算子

=

サポートされない演算子

!=、~、!~、>、>=、<、<=、IS、IS NOT、IN、NOT IN、WAS、WAS IN、WAS NOT、WAS NOT IN、CHANGED

例

  • John Smith による承認が必要または必要だったリクエストを検索:
    approvals = approver(jsmith)

  • John Smith または Sarah Khan による承認が必要であるリクエスト、または必要であったリクエストを検索:
    approvals = approver(jsmith, skhan)

breached()

Jira Service Management サブスクリプションがあるサイトにのみ適用されます。

Returns work items that whose most recent SLA has missed its goal.

構文

breached()

サポートされるフィールド

SLA

サポートされる演算子

=,!=

サポートされない演算子

~、!~、>、>=、<、<=、IS、IS NOT、IN、NOT IN、WAS、WAS IN、WAS NOT、WAS NOT IN、CHANGED

例

  • Find work items where an SLA (“Time to First Response”) was breached:
    "Time to First Response" = breached()

cascadeOption()

Search for work items that match the selected values of a Cascading Select custom field.

parentOption パラメーターは、cascading select フィールドの第 1 階層のオプションに対応します。

childOption パラメーターは、"カスケード選択" フィールドの第 2 階層のオプションに対応します (任意)。 

The keyword none can be used to search for work items where either or both of the options have no value.

構文

cascadeOption(parentOption) cascadeOption(parentOption,childOption)

サポートされるフィールド

カスケード選択タイプのカスタム フィールド

サポートされる演算子

IN , NOT IN

サポートされない演算子

= , != , ~ , !~ , > , >= , < , <= IS , IS NOT, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED

例

  • Find work items where a custom field ("Location") has the value "USA" for the first tier and "New York" for the second tier:
    location in cascadeOption("USA", "New York")

  • Find work items where a custom field ("Location") has the value "USA" for the first tier and any value (or no value) for the second tier:
    location in cascadeOption("USA")

  • Find work items where a custom field ("Location") has the value "USA" for the first tier and no value for the second tier:
    location in cascadeOption("USA", none)

  • Find work items where a custom field ("Location") has no value for the first tier and no value for the second tier:
    location in cascadeOption(none)

  • Find work items where a custom field ("Referrer") has the value "none" for the first tier and "none" for the second tier:
    referrer in cascadeOption("\"none\"", "\"none\"")

  • Find work items where a custom field ("Referrer") has the value "none" for the first tier and no value for the second tier:
    referrer in cascadeOption("\"none\"", none)

choiceOption()

Search for work items that match the selected IDs of a Multiple Choice or Dropdown custom field.

Requires at least one argument. For multiple arguments, returns the ID of each one. Arguments must be valid option values. In cases where the argument could be both an ID and the option value, returns work items where the option value matches.

構文

choiceOption(ValueOption) choiceOption(ValueOption1,ValueOption2,ValueOption3)

サポートされるフィールド

複数選択タイプのカスタム フィールドとドロップダウン タイプのカスタム フィールド

サポートされる演算子

IN,NOT IN

サポートされない演算子

=、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、
WAS NOT、WAS NOT IN、CHANGED

例

  • Find work items where a custom field ("Product Version") has the value
    ”123”:
    "Product Version[Select List (multiple choices)]" in choiceOption(123)

closedSprints()

Search for work items that are assigned to a completed Sprint.

It is possible for a work item to belong to both a completed Sprint(s) and an incomplete Sprint(s). See also openSprints().

構文

closedSprints()

サポートされるフィールド

Sprint

サポートされる演算子

IN,NOT IN

サポートされない演算子

=、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、
WAS NOT、WAS NOT IN、CHANGED

例

  • Find all work items that are assigned to a completed sprint:
    sprint in closedSprints()

completed()

Jira Service Management サブスクリプションがあるサイトにのみ適用されます。

Returns work items that have an SLA that has completed at least one cycle. 

構文

completed()

サポートされるフィールド

SLA

サポートされる演算子

=,!=

サポートされない演算子

~、!~、>、>=、<、<=、IS、IS NOT、IN、NOT IN、WAS、
WAS IN、WAS NOT、WAS NOT IN、CHANGED

例

  • Find work items where an SLA (“Time to First Response”) has completed at least one cycle:
    "Time to First Response" = completed()

componentsLeadByUser()

Find work items in components that are led by a specific user. You can optionally specify a user, or if the user is omitted, the current user (i.e. you) will be used. 

Jira にログインしていない場合は、ユーザーを指定する必要があります。

構文

componentsLeadByUser() componentsLeadByUser(username)

サポートされるフィールド

Component

サポートされる演算子

IN,NOT IN

サポートされない演算子

=、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、WAS NOT、WAS NOT IN、CHANGED

例

  • Find open work items in components that are led by you:
    component in componentsLeadByUser() AND status = Open

  • Find open work items in components that are led by Bill:
    component in componentsLeadByUser(bill) AND status = Open

currentLogin()

現在のユーザーによるセッションの開始時間に基づいて検索を実行します。「lastLogin()」も参照してください。

構文

currentLogin()

サポートされるフィールド

日付/時間タイプの "作成日時"、"期限日"、"解決日時"、"更新日時" カスタム フィールド

サポートされる演算子

=、!=、>、>=、<、<=、WAS*、WAS IN*、WAS NOT*、WAS NOT IN*、CHANGED*

* 述語のみ 

サポートされない演算子

~、!~、IS、IS NOT、IN、NOT IN

例

  • Find work items that have been created during your current session:
    created > currentLogin()

currentUser()

現在のログイン ユーザーに基づいて検索を実行します。 

この関数は、ログイン済みのユーザーのみが使用できます。したがって、匿名ユーザーが利用することを想定したフィルターを作成する場合、この関数を使うことはできません。

構文

currentUser()

サポートされるフィールド

ユーザー タイプの "担当者"、"報告者"、"投票者"、"ウォッチャー"、"作成者" カスタム フィールド

サポートされる演算子

=,!=

サポートされない演算子

~、!~、>、>=、<、<=、IS、IS NOT、IN、NOT IN、WAS、
WAS IN、WAS NOT、WAS NOT IN、CHANGED

例

  • Find work items that are assigned to you:
    assignee = currentUser()

  • Find work items that were reported by you but are not assigned to you:
    reporter = currentUser() AND assignee != currentUser()

customerDetail()

顧客の詳細に基づいて検索を実行します。

この JQL 関数を使用するには、[プロジェクト設定] の "機能" ページで [カスタマー サービス管理] をオンにします。

この関数は、最大 32000 のカスタマーを返します。

構文

customerDetail()

サポートされるフィールド

ユーザー タイプの "担当者"、"報告者"、"投票者"、"ウォッチャー" カスタム フィールド

サポートされる演算子

IN,NOT IN

サポートされない演算子

=、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、
WAS NOT IN、WAS NOT、CHANGED

例

  • APAC 地域のカスタマーから報告されたリクエストをすべて検索:
    reporter in customerDetail("Region", "APAC")

  • 技術担当者ではないカスタマーから報告されたリクエストをすべて検索:
    reporter not in customerDetail("Role", "Technical Contact")

earliestUnreleasedVersion()

プロジェクトの未リリース バージョンの中で一番古いバージョンに基づいて検索を実行します。unreleasedVersions() もご参照ください。

バージョンの順序は、プロジェクトの [リリース] ページにバージョンが表示される順序によって決まります。一覧の一番下のバージョンが "一番古い" ものとなります。バージョンの順序を変更するには、一覧でバージョンをドラッグ アンド ドロップして新しい場所に配置します。

構文

earliestUnreleasedVersion(project)

サポートされるフィールド

バージョン タイプの "影響を受けるバージョン"、"修正バージョン" カスタム フィールド

サポートされる演算子

=,!=

サポートされない演算子

~、!~、>、>=、<、<=、IS、IS NOT、IN、NOT IN、WAS、
WAS IN、WAS NOT、WAS NOT IN、CHANGED

例

  • Find work items whose fix version is the earliest unreleased version of the “ABC” project:
    fixVersion = earliestUnreleasedVersion(ABC)

  • Find work items that relate to the earliest unreleased version of the “ABC” project:
    affectedVersion = earliestUnreleasedVersion(ABC) or fixVersion = earliestUnreleasedVersion(ABC)

endOfDay()

検索実行日の最終時刻に基づいて検索を実行します。

endOfWeek()、endOfMonth()、endOfYear()、startOfDay()、startOfWeek()、startOfMonth()、startOfYear() もご参照ください。

構文

endOfDay() endOfDay("inc")

ここで、inc は (+/-)nn(y|M|w|d|h|m) の任意のインクリメントです。時間単位の修飾子が省略された場合は、既定で関数の固有周期が設定されます。たとえば、endOfDay("+1") は endOfDay("+1d") と同じです。プラス/マイナス (+/-) 記号が省略された場合、プラス (+) と見なされます。

サポートされるフィールド

日付/時間タイプの "作成日時"、"期限日"、"解決日時"、"更新日時" カスタム フィールド

サポートされる演算子

=、!=、>、>=、<、<=、WAS、WAS IN、WAS NOT、WAS NOT IN、CHANGED

サポートされない演算子

~、!~、IS、IS NOT、IN、NOT IN

例

  • Find work items due by the end of today:
    due < endOfDay()

  • Find work items due by the end of tomorrow:
    due < endOfDay("+1")

endOfMonth()

検索実行日の月末に基づいて検索を実行します。

endOfDay()、endOfWeek()、endOfYear()、startOfDay()、startOfWeek()、startOfMonth()、startOfYear() もご参照ください。

構文

endOfMonth() endOfMonth("inc")

ここで、inc は (+/-)nn(y|M|w|d|h|m) の任意のインクリメントです。時間単位の修飾子が省略された場合は、既定で関数の固有周期が設定されます。たとえば、endOfMonth("+1") は endOfMonth("+1M") と同じです。プラス/マイナス (+/-) 記号が省略された場合、プラス (+) と見なされます。

サポートされるフィールド

日付/時間タイプの "作成日時"、"期限日"、"解決日時"、"更新日時" カスタム フィールド

サポートされる演算子

=、!=、>、>=、<、<=、WAS、WAS IN、WAS NOT、WAS NOT IN、CHANGED

サポートされない演算子

~、!~、IS、IS NOT、IN、NOT IN

例

  • Find work items due by the end of this month:
    due < endOfMonth()

  • Find work items due by the end of next month:
    due < endOfMonth("+1")

  • Find work items due by the 15th of next month:
    due < endOfMonth("+15d")

endOfWeek()

Search for work items that are due by the end of the last day of the current week. By default, this function considers Saturday to be the last day of the week. You can use a different day (for example, Sunday) as the end of the week. See the syntax in the examples mentioned below. 

endOfDay()、endOfMonth()、endOfYear()、startOfDay()、startOfWeek()、startOfMonth()、startOfYear() もご参照ください。

構文

endOfWeek() endOfWeek("inc")

ここで、inc は (+/-)nn(y|M|w|d|h|m) の任意のインクリメントです。時間単位の修飾子が省略された場合は、既定で関数の固有周期が設定されます。たとえば、endOfWeek("+1") は endOfWeek("+1w") と同じです。プラス/マイナス (+/-) 記号が省略された場合、プラス (+) と見なされます。

サポートされるフィールド

日付/時間タイプの "作成日時"、"期限日"、"解決日時"、"更新日時" カスタム フィールド

サポートされる演算子

=、!=、>、>=、<、<=、WAS、WAS IN、WAS NOT、WAS NOT IN、CHANGED

サポートされない演算子

~、!~、IS、IS NOT、IN、NOT IN

例

  • Find work items due by the last day of the end of this week (by default, the last day is Saturday):
    due < endOfWeek()

  • Find work items due by the end of this week (last day as Sunday):
    due < endOfWeek("+1d")

  • Find work items due by the end of next week:
    due < endOfWeek("+1")

endOfYear()

検索実行日の年末に基づいて検索を実行します。

endOfDay()、endOfWeek()、endOfMonth()、startOfDay()、startOfWeek()、startOfMonth()、startOfYear() もご参照ください。

構文

endOfYear() endOfYear("inc")

ここで、inc は (+/-)nn(y|M|w|d|h|m) の任意のインクリメントです。時間単位の修飾子が省略された場合は、既定で関数の固有周期が設定されます。たとえば、endOfYear("+1") は endOfYear("+1y") と同じです。プラス/マイナス (+/-) 記号が省略された場合、プラス (+) と見なされます。

サポートされるフィールド

日付/時間タイプの "作成日時"、"期限日"、"解決日時"、"更新日時" カスタム フィールド

サポートされる演算子

=、!=、>、>=、<、<=、WAS、WAS IN、WAS NOT、WAS NOT IN、CHANGED

サポートされない演算子

~、!~、IS、IS NOT、IN、NOT IN

例

  • Find work items due by the end of this year:
    due < endOfYear()

  • Find work items due by the end of March next year:
    due < endOfYear("+3M")

entitlementDetail()

Jira Service Management サブスクリプションがあるサイトにのみ適用されます。

エンタイトルメントの詳細に基づいて検索を実行します。

この JQL 関数を使用するには、[プロジェクト設定] の [機能] ページで [カスタマー サービス管理] と [製品とエンタイトルメント] を有効にします。

この関数は、最大 32,000 のエンタイトルメントを返します。

構文

entitlementDetail("Field Name", "Field Value")

サポートされるフィールド

エンタイトルメント

サポートされる演算子

IN,NOT IN

サポートされない演算子

=、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、
WAS NOT、WAS NOT IN、CHANGED

例

  • Find all work items related to an entitlement where the “Support Level” is “Gold”:
    entitlement in entitlementDetail("Support Level", "Gold")

entitlementProduct()

Jira Service Management サブスクリプションがあるサイトにのみ適用されます。

製品に基づいて検索を行います。

この JQL 関数を使用するには、[プロジェクト設定] の [機能] ページで [カスタマー サービス管理] と [製品とエンタイトルメント] を有効にします。

構文

entitlementProduct("Product Name")

サポートされるフィールド

エンタイトルメント

サポートされる演算子

IN,NOT IN

サポートされない演算子

=、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、
WAS NOT、WAS NOT IN、CHANGED

例

  • Find all work items related to entitlements for the product “Acme Widget”:
    entitlement in entitlementProduct("Acme Widget")

everBreached()

Jira Service Management サブスクリプションがあるサイトにのみ適用されます。

Returns work items that have missed one of their SLA goals.  

構文

everBreached()

サポートされるフィールド

SLA

サポートされる演算子

=,!=

サポートされない演算子

~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、WAS NOT、
WAS NOT IN、CHANGED

例

  • Find work items have missed their goal for Time to First Response:
    "Time to First Response" = everBreached()

futureSprints()

Search for work items that are assigned to a sprint that hasn't been started yet.

It is possible for work items to belong to both a completed sprint(s) and an incomplete sprint(s). 

構文

futureSprints()

サポートされるフィールド

Sprint

サポートされる演算子

IN,NOT IN

サポートされない演算子

=、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、
WAS NOT、WAS NOT IN、CHANGED

例

  • Find all work items that are assigned to a sprint that hasn't been started yet:
    sprint in futureSprints()

workItemHistory()

Find work items that you have recently viewed, i.e. work items that are in the 'Recent work' section of the 'Work items' dropdown menu.

  • workItemHistory() returns up to 50 work items, whereas the 'Recent work' dropdown returns only 5.

  • If you are not logged in to Jira, only work items from your current browser session will be included.

構文

workItemHistory()

サポートされるフィールド

WorkItem

サポートされる演算子

IN,NOT IN

サポートされない演算子

=、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、
WAS NOT、WAS NOT IN、CHANGED

例

  • Find work items which you have recently viewed, that are assigned to you:
    work item in workItemHistory() AND assignee = currentUser()

workItemsWithRemoteLinksByGlobalId()

Perform searches based on work items that are associated with remote links that have any of the specified global IDs.

この関数では 1 から 100 の globalId を指定できます。0、または 100 よりも大きい globalId を指定するとエラーになります。

構文

workItemsWithRemoteLinksByGlobalId(globalId)

サポートされるフィールド

WorkItem

サポートされる演算子

IN,NOT IN

サポートされない演算子

=、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、
WAS NOT、WAS NOT IN、CHANGED

例

  • Find work items that are linked to remote links that have global ID "abc":
    work item in workItemsWithRemoteLinksByGlobalId(abc)

  • Find work items that are linked to remote links that have either global ID "abc" or "def":
    work item in workItemsWithRemoteLinksByGlobalId(abc, def)

lastLogin()

現在のユーザーによる前回のセッションの開始時間に基づいて検索を実行します。「currentLogin()」も参照してください。

構文

lastLogin()

サポートされるフィールド

日付/時間タイプの "作成日時"、"期限日"、"解決日時"、"更新日時" カスタム フィールド

サポートされる演算子

=、!=、>、>=、<、<=、WAS*、WAS IN*、WAS NOT*、WAS NOT IN*、CHANGED*

* 述語のみ 

サポートされない演算子

~、!~、IS、IS NOT、IN、NOT IN

例

  • Find work items that have been created during your last session:
    created > lastLogin()

latestReleasedVersion()

特定のプロジェクトのリリース済みバージョンの中で一番最後にリリースされたバージョンに基づいて検索を実行します。「releasedVersions()」も参照してください。

「最新」かどうかは、実際のバージョン期限ではなく、バージョンに割り当てられた序数に基づいて判断されます。

構文

latestReleasedVersion(project)

サポートされるフィールド

バージョン タイプの "影響を受けるバージョン"、"修正バージョン" カスタム フィールド

サポートされる演算子

=,!=

サポートされない演算子

~、!~、>、>=、<、<=、IS、IS NOT、IN、NOT IN、WAS、
WAS IN、WAS NOT、WAS NOT IN、CHANGED

例

  • Find work items whose fix version is the latest released version of the “ABC” project:
    fixVersion = latestReleasedVersion(ABC)

  • “ABC” プロジェクトの最新のリリース済みバージョンに関連する課題を検索:
    affectedVersion = latestReleasedVersion(ABC) or fixVersion = latestReleasedVersion(ABC)

linkedWorkItem

Searches for epics and subtasks. If the work item is not an epic, the search returns all subtasks for the work item.

企業管理対象プロジェクトにのみ適用されます。

構文

linkedworkIt = workItemKey

サポートされるフィールド

WorkItem

サポートされる演算子

=、!=、IN、NOT IN

サポートされない演算子

~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、WAS NOT、WAS NOT IN、CHANGED

例

  • 特定のエピックにリンクされているサブタスクを検索:
    linkedWorkItem = epicKey-123

linkedWorkItems()

Searches for work items that are linked to a work item. You can restrict the search to links of a particular type. 

構文

linkedWorkItems(workItemKey) linkedWorkItems(workItemKey,CaseSensitiveLinkType) linkedWorkItems(workItemKey,CaseSensitiveLinkType, CaseSensitiveLinkType)

サポートされるフィールド

WorkItem

サポートされる演算子

IN,NOT IN

サポートされない演算子

=、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、
WAS NOT、WAS NOT IN、CHANGED

例

  • Find work items that are linked to a particular work item:
    work item in linkedWorkItems(ABC-123)

  • Find work items that are linked to a particular issue via a particular type of link:
    work item in linkedWorkItems(ABC-123,"is duplicated by")

  • Find work items that are linked to a particular work item via any type of link specified:

    work item in linkedWorkItems(ABC-123, "is duplicated by", "is blocked by")

membersOf()

特定のグループのメンバーに基づく検索を実施します。

構文

membersOf(Group)

サポートされるフィールド

ユーザー タイプの "担当者"、"報告者"、"投票者"、"ウォッチャー"、"作成者" カスタム フィールド

サポートされる演算子

IN、NOT IN、WAS IN、WAS NOT IN

サポートされない演算子

=、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS NOT、CHANGED

例

  • Find work items where the assignee is a member of the group
    "jira-administrators":
    assignee in membersOf("jira-administrators")

  • 複数のグループおよび特定のユーザーで検索:
    reporter in membersOf("jira-administators") or reporter in membersOf("jira-work-management-users") or reporter=jsmith

  • 特定のグループで検索 (特定のメンバーを除く):
    assignee in membersOf(QA) and assignee not in ("John Smith","Jill Jones")

  • 特定のグループのメンバーを除外:
    assignee not in membersOf(QA)

myApproval()

Jira Service Management サブスクリプションがあるサイトにのみ適用されます。

現在のユーザーが保留中または完了した承認ステップの承認者であり、そのリクエストをまだ承認または却下していない場合があるリクエストを検索します。

構文

myApproval()

サポートされるフィールド

承認タイプのカスタム フィールド

サポートされる演算子

=

サポートされない演算子

!=、~、!~、>、>=、<、<=、IS、IS NOT、IN、NOT IN、WAS、
WAS IN、WAS NOT、WAS NOT IN、CHANGED

例

  • 自分の承認が必要なリクエストをすべて検索:
    approval = myApproval()

myPendingApproval()

Jira Service Management サブスクリプションがあるサイトにのみ適用されます。

現在のユーザーが保留中の承認ステップの承認者で、まだ承認または却下していないリクエストを検索します。

構文

myPendingApproval()

サポートされるフィールド

承認タイプのカスタム フィールド

サポートされる演算子

=

サポートされない演算子

!=、~、!~、>、>=、<、<=、IS、IS NOT、IN、NOT IN、WAS、
WAS IN、WAS NOT、WAS NOT IN、CHANGED

例

  • 現時点で自分の承認が必要なリクエストをすべて検索:
    approvals = myPendingApproval()

myPending()

Jira Service Management サブスクリプションがあるサイトにのみ適用されます。

現在のユーザーが保留中の承認ステップの承認者であり、承認をまだ承認または却下していない場合があるリクエストを検索します。

構文

myPending()

サポートされるフィールド

承認タイプのカスタム フィールド

サポートされる演算子

=

サポートされない演算子

!=、~、!~、>、>=、<、<=、IS、IS NOT、IN、NOT IN、WAS、
WAS IN、WAS NOT、WAS NOT IN、CHANGED

例

  • 現時点で自分の承認が必要なリクエスト、または以前自分の承認が必要だったリクエストをすべて検索:
    approvals = myPending()

now()

現在の時刻に基づいた検索を行います。

構文

now()

サポートされるフィールド

日付/時間タイプの "作成日時"、"期限日"、"解決日時"、"更新日時" カスタム フィールド

サポートされる演算子

=、!=、>、>=、<、<=、WAS*、WAS IN*、WAS NOT*、WAS NOT IN*、CHANGED*

* 述語のみ 

サポートされない演算子

~、!~、IS、IS NOT、IN、NOT IN

例

  • Find work items that are overdue:
    duedate < now() and status not in (closed, resolved)

openSprints()

Search for work items that are assigned to a sprint that was started, but has not yet been completed.

It is possible for a work item to belong to both a completed sprint(s) and an incomplete sprint(s). See also closedSprints().

構文

openSprints()

サポートされるフィールド

Sprint

サポートされる演算子

IN,NOT IN

サポートされない演算子

=、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、WAS NOT、WAS NOT IN、CHANGED

例

  • Find all work items that are assigned to a sprint that has not yet been completed:
    sprint in openSprints()

organizationDetail()

組織の詳細に基づいて検索を実行します。

この JQL 関数を使用するには、[プロジェクト設定] の "機能" ページで [カスタマー サービス管理] をオンにします。

この関数は、最大 32,000 の組織を返します。

構文

organizationDetail("Field Name", "Field Value")

サポートされるフィールド

組織

サポートされる演算子

IN,NOT IN

サポートされない演算子

=、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、WAS NOT、WAS NOT IN、CHANGED

例

  • APAC 地域の組織と共有されているリクエストをすべて検索:
    organizations in organizationDetail("Region", "APAC")

  • プラチナ サポート レベルではない組織と共有されたリクエストをすべて検索:
    organizations not in organizationDetail("Support level", "Platinum")

  • YYYY-MM-DD 形式の日付で 2023 年 8 月 24 日に参加した組織と共有されている未解決のリクエストをすべて検索: resolution = Unresolved AND Organizations in organizationDetail("Joined on", "2023-08-24")

  • 最大 2 つの値 (option1 とoption2) を含むことができる複数選択ドロップダウン。両方の値が存在するすべての組織のクエリの作成方法:

    resolution = Unresolved AND Organizations in organizationDetail("Options", "option1") AND Organizations in organizationDetail("Options", "option2")

organizationMembers()

Jira Service Management サブスクリプションがあるサイトにのみ適用されます。

ある組織のメンバーが送信したすべてのリクエストを検索します。メンバーが組織と共有したリクエスト、未共有のリクエスト、および所属しているほかの組織に共有したリクエストが返されます。

構文

organizationMembers()

サポートされるフィールド

ユーザー タイプの "担当者"、"報告者"、"投票者"、"ウォッチャー" カスタム フィールド

サポートされる演算子

IN、NOT IN、WAS IN、WAS NOT IN

サポートされない演算子

=、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS NOT、CHANGED

例

  • “Atlassian” 組織のメンバーから送られたリクエストをすべて検索:
    reporter in organizationMembers("Atlassian")

  • “Atlassian” 組織や “ACME” 組織に所属していないユーザーから送られたリクエストをすべて検索:
    reporter not in organizationMembers("Atlassian","ACME")

parentEpic

企業管理対象プロジェクトにのみ適用されます。

Search for work items and subtasks that are linked to an epic. 

構文

parentEpic = workItemkey

サポートされるフィールド

WorkItem

サポートされる演算子

=、!=、IN、NOT IN

サポートされない演算子

~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、WAS NOT、WAS NOT IN、CHANGED

例

  • Find work items and sub-tasks in the epic DEMO-123:
    parentEpic = DEMO 123

  • Find work items and sub-tasks the epic DEMO-1 or SAMPLE-4:
    parentEpic in (DEMO-1, SAMPLE-4)

paused()

Jira Service Management サブスクリプションがあるサイトにのみ適用されます。

Returns work items that have an SLA that is paused due to a condition.

To find work items that are paused because they are outside calendar hours, use withinCalendarHours().

構文

paused()

サポートされるフィールド

SLA

サポートされる演算子

=,!=

サポートされない演算子

~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、WAS NOT、
WAS NOT IN、CHANGED

例

  • Find work items where Time to First Response is paused:
    "Time to First Response" = paused()

pending()

Jira Service Management サブスクリプションがあるサイトにのみ適用されます。

承認ステップが保留中のリクエストを検索します。

構文

pending()

サポートされるフィールド

承認タイプのカスタム フィールド

サポートされる演算子

=,!=

サポートされない演算子

~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、WAS NOT、
WAS NOT IN、CHANGED

例

  • 承認待ちのリクエストをすべて検索:
    approvals = pending()

pendingBy()

Jira Service Management サブスクリプションがあるサイトにのみ適用されます。

特定のユーザーが保留中の承認ステップの承認者であり、リクエストをの承認を実行したか、または却下したか分からないリクエストを検索します。ユーザー名を入力する必要があります。

構文

pendingBy(user1, user2)

サポートされるフィールド

承認タイプのカスタム フィールド

サポートされる演算子

=,!=

サポートされない演算子

~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、WAS NOT、
WAS NOT IN、CHANGED

例

  • John Smith による承認が必要なリクエストを検索:
    approvals = pendingBy(jsmith)

  • John Smith または Sarah Khan による承認が必要なリクエストを検索:
    approvals = pendingBy(jsmith, skhan)

projectsLeadByUser()

Find work items in projects that are led by a specific user. You can optionally specify a user, or if the user is omitted, the current user will be used. 

注意事項として、JIRA にログインしていない場合は、ユーザーを指定する必要があります。

構文

projectsLeadByUser() projectsLeadByUser(username)

サポートされるフィールド

Project

サポートされる演算子

IN,NOT IN

サポートされない演算子

=、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、
WAS NOT、WAS NOT IN、CHANGED

例

  • Find open work items in projects that are led by you:
    project in projectsLeadByUser() AND status = Open

  • Find open work items in projects that are led by Bill:
    project in projectsLeadByUser(bill) AND status = Open

projectsWhereUserHasPermission()

Find work items in projects where you have a specific permission. Note, this function operates at the project level. This means that if a permission (e.g. "Edit work items") is granted to the reporter of work items in a project, then you may see some work items returned where you are not the reporter, and therefore don't have the permission specified. 

Jira にログインしているユーザーのみがこの関数を利用できます。

構文

projectsWhereUserHasPermission(permission)

permission パラメータには、企業管理対象プロジェクトの権限で説明されている任意の権限を指定できます。

サポートされるフィールド

Project

サポートされる演算子

IN,NOT IN

サポートされない演算子

=、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、
WAS NOT、WAS NOT IN、CHANGED

例

  • Find open work items in projects where you have the "Resolve work items" permission:
    project in projectsWhereUserHasPermission("Resolve work items") AND status = Open

projectsWhereUserHasRole()

Find work items in projects where you have a specific role. 

Jira にログインしているユーザーのみがこの関数を利用できます。

構文

projectsWhereUserHasRole(rolename)

サポートされるフィールド

Project

サポートされる演算子

IN,NOT IN

サポートされない演算子

=、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、
WAS NOT、WAS NOT IN、CHANGED

例

  • Find open work items in projects where you have the "Developers" role:
    project in projectsWhereUserHasRole("Developers") AND status = Open

releasedVersions()

特定のプロジェクトのリリース済みバージョン (例: Jira 管理者がリリースしたバージョン) に基づいた検索を行います。project パラメーターを省略すると、すべてのプロジェクトのリリース済みバージョンを対象として検索を実行することもできます。latestReleasedVersion() もご参照ください。

構文

releasedVersions() releasedVersions(project)

サポートされるフィールド

バージョン タイプの "影響を受けるバージョン"、"修正バージョン" カスタム フィールド

サポートされる演算子

IN,NOT IN

サポートされない演算子

=、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、
WAS NOT、WAS NOT IN、CHANGED

例

  • Find work items whose fix version is a released version of the ABC project:
    fixVersion in releasedVersions(ABC)

  • Find work items that relate to released versions of the ABC project:
    (affectedVersion in releasedVersions(ABC)) or (fixVersion in releasedVersions(ABC))

remaining()

Jira Service Management サブスクリプションがあるサイトにのみ適用されます。

Returns work items whose SLA clock is at a certain point relative to the goal.  

構文

remaining()

サポートされるフィールド

SLA

サポートされる演算子

=、!=、>、>=、<、<=

サポートされない演算子

~、!~、IS、IS NOT、WAS、WAS IN、WAS NOT、WAS NOT IN、CHANGED

例

  • Find work items that will breach Time to Resolution in the next two hours:
    "Time to Resolution" < remaining("2h")

running()

Jira Service Management サブスクリプションがあるサイトにのみ適用されます。

Returns work items that have an SLA that is running, regardless of the calendar.

To find work items that are running based on calendar hours, use withinCalendarHours().

構文

running()

サポートされるフィールド

SLA

サポートされる演算子

=,!=

サポートされない演算子

~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、WAS NOT、
WAS NOT IN、CHANGED

例

  • Find work items where Time to First Response is running:
    "Time to First Response" = running()

standardWorkTypes()

Perform searches based on "standard" work types, that is, search for work items that are not subtasks. See also subtaskWorkTypes().

構文

standardWorkTypes()

サポートされるフィールド

タイプ

サポートされる演算子

IN,NOT IN

サポートされない演算子

=、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、WAS NOT、WAS NOT IN、CHANGED

例

  • Find work items that are not subtasks (i.e. work items whose work type is a standard issue type, not a subtask issue type):
    workType in standardWorkItemTypes()

startOfDay()

検索実行日の開始時刻に基づいて検索を実行します。

startOfWeek()、startOfMonth()、startOfYear()、endOfDay()、endOfWeek()、endOfMonth()、endOfYear() もご参照ください。

構文

startOfDay() startOfDay("inc")

ここで、inc は (+/-)nn(y|M|w|d|h|m) の任意のインクリメントです。時間単位の修飾子が省略された場合は、既定で関数の固有周期が設定されます。たとえば、startOfDay("+1") は startOfDay("+1d") と同じです。プラス/マイナス (+/-) 記号が省略された場合、プラス (+) と見なされます。

サポートされるフィールド

日付/時間タイプの "作成日時"、"期限日"、"解決日時"、"更新日時" カスタム フィールド

サポートされる演算子

=、!=、>、>=、<、<=、WAS、WAS IN、WAS NOT、WAS NOT IN、CHANGED

サポートされない演算子

~、!~、IS、IS NOT、IN、NOT IN

例

  • Find new work items created since the start of today:
    created > startOfDay()

  • Find new work items created since the start of yesterday:
    created > startOfDay("-1")

  • Find new work items created in the last three days:
    created > startOfDay("-3d")

startOfMonth()

検索実行日の月初に基づいて検索を実行します。

startOfDay()、startOfWeek() startOfYear()、endOfDay()、endOfWeek()、endOfMonth()、endOfYear() もご参照ください。

構文

startOfMonth() startOfMonth("inc")

ここで、inc は (+/-)nn(y|M|w|d|h|m) の任意のインクリメントです。時間単位の修飾子が省略された場合は、既定で関数の固有周期が設定されます。たとえば、startOfMonth("+1") は startOfMonth("+1M") と同じです。プラス/マイナス (+/-) 記号が省略された場合、プラス (+) と見なされます。

サポートされるフィールド

日付/時間タイプの "作成日時"、"期限日"、"解決日時"、"更新日時" カスタム フィールド

サポートされる演算子

=、!=、>、>=、<、<=、WAS、WAS IN、WAS NOT、WAS NOT IN、CHANGED

サポートされない演算子

~、!~、IS、IS NOT、IN、NOT IN

例

  • Find new work items created since the start of this month:
    created > startOfMonth()

  • Find new work items created since the start of last month:
    created > startOfMonth("-1")

  • Find new work items created since the 15th of this month:
    created > startOfMonth("+14d")

startOfWeek()

Search for new work items created since the start of the first day of the current week. By default, this function considers Sunday to be the first day of the week when ISO8601 for the Date Picker is disabled in Look and feel settings. You can use a different day (for example, Monday) as the start of the week.

startOfDay()、startOfMonth()、startOfYear()、endOfDay()、endOfWeek()、endOfMonth()、endOfYear() もご参照ください。

構文

startOfWeek() startOfWeek("inc")

ここで、inc は (+/-)nn(y|M|w|d|h|m) の任意のインクリメントです。時間単位の修飾子が省略された場合は、既定で関数の固有周期が設定されます。たとえば、startOfWeek("+1") は startOfWeek("+1w") と同じです。プラス/マイナス (+/-) 記号が省略された場合、プラス (+) と見なされます。

サポートされるフィールド

日付/時間タイプの "作成日時"、"期限日"、"解決日時"、"更新日時" カスタム フィールド

サポートされる演算子

=、!=、>、>=、<、<=、WAS、WAS IN、WAS NOT、WAS NOT IN、CHANGED

サポートされない演算子

~、!~、IS、IS NOT、IN、NOT IN

例

  • Find new work items since the first day of the start of this week (by default, the first day is Sunday):
    created > startOfWeek()

  • Find new work items since the first day of the start of this week (first day as Monday):
    created > startOfWeek("+1d")

  • Find new work items since the start of last week:
    created > startOfWeek("-1")

startOfYear()

検索実行日の年始に基づいて検索を実行します。

startOfDay()、startOfWeek()、startOfMonth()、endOfDay()、endOfWeek()、endOfMonth()、endOfYear() もご参照ください。

構文

startOfYear() startOfYear("inc")

ここで、inc は (+/-)nn(y|M|w|d|h|m) の任意のインクリメントです。時間単位の修飾子が省略された場合は、既定で関数の固有周期が設定されます。たとえば、startOfYear("+1") は startOfYear("+1y") と同じです。プラス/マイナス (+/-) 記号が省略された場合、プラス (+) と見なされます。

サポートされるフィールド

日付/時間タイプの "作成日時"、"期限日"、"解決日時"、"更新日時" カスタム フィールド

サポートされる演算子

=、!=、>、>=、<、<=、WAS、WAS IN、WAS NOT、WAS NOT IN、CHANGED

サポートされない演算子

~、!~、IS、IS NOT、IN、NOT IN

例

  • Find new work items since the start of this year:
    created > startOfYear()

  • Find new work items since the start of last year:
    created > startOfYear("-1")

subtaskWorkTypes()

Perform searches based on work items that are sub-tasks. See also standardWorkTypes().

構文

subtaskWorkTypes()

サポートされるフィールド

タイプ

サポートされる演算子

IN,NOT IN

サポートされない演算子

=、!=、~、!~、>、>=、<、<=、IS、
IS NOT、WAS、WAS IN、WAS NOT IN、
WAS NOT、CHANGED

例

  • Find work items that are subtasks (i.e. work items whose issue type is a subtask issue type):
    workType in subtaskWorkTypes()

unreleasedVersions()

特定のプロジェクトの未リリース バージョン (つまり、Jira 管理者がまだリリースしていないバージョン) に基づいて検索を実行します。project パラメーターを省略することで、すべてのプロジェクトの未リリース バージョンを対象に検索を実行することもできます。「earliestUnreleasedVersion()」も参照してください。

構文

unreleasedVersions() unreleasedVersions(project)

サポートされるフィールド

バージョン タイプの "影響を受けるバージョン"、"修正バージョン" カスタム フィールド

サポートされる演算子

IN,NOT IN

サポートされない演算子

=、!=、~、!~、>、>=、<、<=、IS、
IS NOT、WAS、WAS IN、WAS NOT IN、
WAS NOT、CHANGED

例

  • Find work items whose fix version is an unreleased version of the “ABC” project:
    fixVersion in unreleasedVersions(ABC)

  • Find work items that relate to unreleased versions of the “ABC” project:
    affectedVersion in unreleasedVersions(ABC)

updatedBy()

Search for work items that were updated by a specific user, optionally within the specified time range. An update, in this case, includes creating a work item, updating any of the issue's fields, creating or deleting a comment, or editing a comment (only the last edit). 

This function will return up to 32,000 work item IDs.

時間範囲については、以下の形式のいずれかを使用します。

"yyyy/MM/dd"
"yyyy-MM-dd"

"w" (週) または "d" (日) を使用して現在の時刻に対する相対的な日付を指定することもできます。他の関数とは異なり、updatedBy では 1 日よりも小さい値はサポートされず、常に 1 日に切り上げられます。

構文

updatedBy(user) updatedBy(user, dateFrom) updatedBy(user, dateFrom, dateTo)

サポートされるフィールド

WorkItem

サポートされる演算子

IN,NOT IN

サポートされない演算子

=、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、WAS NOT IN、WAS NOT、CHANGED

例

  • Find work items that were updated by John Smith:
    workItemKey in updatedBy(jsmith)

  • Find work items that were updated by John Smith within the last 8 days:
    workItemKey in updatedBy(jsmith, "-8d")

  • Find work items updated between June and September 2018:
    workItemkey in updatedBy(jsmith, "2018/06/01", "2018/08/31")

  • If you try to find work items updated in the last hour, like in the following example, the time will be rounded up to 1 day, as smaller values aren't supported:
    workItemkey in updatedBy(jsmith, "-1h")

votedWorkItems()

Perform searches based on work itemss for which you have voted. Also, see the Voter field. Note, this function can only be used by logged-in users.

This function will return up to 32,000 work item IDs.

構文

votedWorkItems()

サポートされるフィールド

WorkItem

サポートされる演算子

IN,NOT IN

サポートされない演算子

=、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、WAS NOT IN、WAS NOT、CHANGED

例

  • Find work items that you have voted for:
    work item in votedWorkItems()

watchedWorkItems()

Perform searches based on work items that you are watching. Also, see the Watcher field. Note that this function can only be used by logged-in users.

This function will return up to 32,000 work item IDs.

構文

watchedWorkItems()

サポートされるフィールド

WorkItem

サポートされる演算子

IN,NOT IN

サポートされない演算子

=、!=、~、!~、>、>=、<、<=、IS、
IS NOT、WAS、WAS IN、WAS NOT、
WAS NOT IN、CHANGED

例

  • Find work items that you are watching:
    work item in watchedWorkItems()

withinCalendarHours()

Jira Service Management サブスクリプションがあるサイトにのみ適用されます。

Returns work items that have an SLA that is running according to the SLA calendar.

For example, say your project has two SLAs that count Time to First Response. Some work items with this SLA use a 9am-1pm calendar, and others use a 9am-5pm calendar. If an agent starts work at 3pm, they probably want to work on work items from the 9am-5pm agreement first. They can use withinCalendarHours() to find all the work items where Time to First Response is running at 3pm.

構文

withinCalendarHours()

サポートされるフィールド

SLA

サポートされる演算子

=、!=

サポートされない演算子

~、!~、>、>=、<、<=、IS、IS NOT、WAS、
WAS IN、WAS NOT、WAS NOT IN、CHANGED

例

  • Find work items where an SLA (“Time to First Response”) is within calendar hours:
    "Time to First Response" = withinCalendarHours()

 

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。
コミュニティに質問
このページの内容approved()approver()breached()cascadeOption()choiceOption()closedSprints()completed()componentsLeadByUser()currentLogin()currentUser()customerDetail()earliestUnreleasedVersion()endOfDay()endOfMonth()endOfWeek()endOfYear()entitlementDetail()entitlementProduct()everBreached()futureSprints()workItemHistory()workItemsWithRemoteLinksByGlobalId()lastLogin()latestReleasedVersion()linkedWorkItemlinkedWorkItems()membersOf()myApproval()myPendingApproval()myPending()now()openSprints()organizationDetail()organizationMembers()parentEpicpaused()pending()pendingBy()projectsLeadByUser()projectsWhereUserHasPermission()projectsWhereUserHasRole()releasedVersions()remaining()running()standardWorkTypes()startOfDay()startOfMonth()startOfWeek()startOfYear()subtaskWorkTypes()unreleasedVersions()updatedBy()votedWorkItems()watchedWorkItems()withinCalendarHours()
コミュニティ質問、ディスカッション、記事