• 使用を開始する
  • 関連ドキュメント

Jira Service Management の新しいナビゲーション

We’re in the process of rolling out these changes and the documentation may not match your experience. Bear with us while we update it to reflect the new changes. More about navigating the new Jira

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 関数を利用できる場合があります。

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 サブスクリプションがあるサイトにのみ適用されます。

直近の SLA でサービス目標を達成できなかった作業項目を返します。

構文

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()

"カスケード選択" カスタム フィールドの値が選択したものと一致する作業項目を検索します。

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

例

  • 「Location」カスタム フィールドの 1 層目の値が「USA」、2 層目の値が「New York」である作業項目を検索:
    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.

少なくとも 1 つの引数が必要です。引数が複数ある場合は、それぞれの ID を返します。引数は有効なオプション値でなければなりません。引数が ID でもあり、オプション値でもある場合は、オプション値が一致する作業項目を返します。

構文

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

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

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

サポートされる演算子

IN,NOT IN

サポートされない演算子

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

例

  • カスタム フィールド ("製品バージョン") の値が
    "123" である作業項目を検索:
    "Product Version[Select List (multiple choices)]" in choiceOption(123)

closedSprints()

完了したスプリントに割り当てられている作業項目を検索します。

完了したスプリントと未完了のスプリントの両方に 1 つの作業項目が属している場合もあります。openSprints() もご確認ください。

構文

closedSprints()

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

Sprint

サポートされる演算子

IN,NOT IN

サポートされない演算子

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

例

  • 完了済みのスプリントに割り当てられているすべての作業項目を検索:
    sprint in closedSprints()

completed()

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

SLA サイクルが完了した作業項目、つまり、停止イベントのいずれかに到達した作業項目を返します。

構文

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 the cycle:
    "Time to First Response" = completed()

componentsLeadByUser()

特定のユーザーが主導しているコンポーネント内の作業項目を検索します。必要に応じてユーザーを指定できます。ユーザーを指定しない場合、現在のユーザー (自身) が使用されます。 

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()

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

To use this JQL function, turn on Customer service management on the Features page in Space settings.

この関数は、最大 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()

Perform searches based on the earliest unreleased version in a space. See also unreleasedVersions().

Version order is determined by the order versions are placed in on the Releases page in the space. The version at the bottom of the list is considered the "earliest." To change the order of versions, drag and drop them to a new place in the list.

構文

earliestUnreleasedVersion(space)

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

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

サポートされる演算子

=,!=

サポートされない演算子

~、!~、>、>=、<、<=、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” space:
    fixVersion = earliestUnreleasedVersion(ABC)

  • Find work items that relate to the earliest unreleased version of the “ABC” space:
    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()

  • 期限が明日中である作業項目を検索:
    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")

  • 期限が来月の 15 日までである作業項目を検索:
    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 サブスクリプションがあるサイトにのみ適用されます。

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

To use this JQL function, turn on Customer service management and Products and entitlements on the Features page in Space settings.

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

構文

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

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

エンタイトルメント

サポートされる演算子

IN,NOT IN

サポートされない演算子

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

例

  • 「サポート レベル」が「ゴールド」であるエンタイトルメントに関連する作業項目をすべて検索:
    entitlement in entitlementDetail("Support Level", "Gold")

entitlementProduct()

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

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

To use this JQL function, turn on Customer service management and Products and entitlements on the Features page in Space settings.

構文

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

例

  • 「初期応答までの時間」の目標値を達成できなかった作業項目を検索:
    "Time to First Response" = everBreached()

futureSprints()

まだ開始されていないスプリントに割り当てられている作業項目を検索します。

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

例

  • 最近閲覧した作業項目のうち、自分に割り当てられている作業項目を検索:
    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

例

  • 前回のセッション中に作成された作業項目を検索:
    created > lastLogin()

latestReleasedVersion()

Perform searches based on the latest released version (i.e. the most recent version that has been released) of a specified space. See also releasedVersions().

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

構文

latestReleasedVersion(space)

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

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

サポートされる演算子

=,!=

サポートされない演算子

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

例

  • 修正バージョンが「ABC」スペースの最新のリリース済みバージョンである作業項目を検索:
    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.

企業管理対象スペースにのみ適用されます。

構文

linkedWorkItem = 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

例

  • 特定の作業項目にリンクされた作業項目を検索:
    work item in linkedWorkItems(ABC-123)

  • 特定のリンク タイプによって特定の作業項目にリンクされている作業項目を検索:
    work item in linkedWorkItems(ABC-123,"is duplicated by")

  • 指定されたタイプのリンクで特定の作業項目にリンクしている作業項目を検索:

    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.

完了したスプリントと未完了のスプリントの両方に 1 つの作業項目が属している場合もあります。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()

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

In Customer Service Management

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

構文

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

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

組織

サポートされる演算子

IN,NOT IN

サポートされない演算子

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

例

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

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

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

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

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

Jira Service Management で必要な権限

この関数は、最大 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 サブスクリプションがあるサイトにのみ適用されます。

特定の条件によって一時停止されている SLA を持つ作業項目を返します。

カレンダー時間外のために一時停止されている作業項目を検索するには、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()

pendingApprovalBy()

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

Search for requests where any specified user is the approver for a pending approval step and is yet to approve or decline the approval. You must specify a username.

構文

pendingApprovalBy(user1, user2)

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

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

サポートされる演算子

=,!=

サポートされない演算子

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

例

  • Find request

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)

spacesLeadByUser()

Find work items in spaces 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 にログインしていない場合は、ユーザーを指定する必要があります。

構文

spacesLeadByUser() spacesLeadByUser(username)

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

スペース

サポートされる演算子

IN,NOT IN

サポートされない演算子

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

例

  • Find open work items in spaces that are led by you:
    space in spacesLeadByUser() AND status = Open

  • Find open work items in spaces that are led by Bill:
    space in pspacesLeadByUser(bill) AND status = Open

spacesWhereUserHasPermission()

ご自身が特定の権限を持つスペース内で作業項目を検索します。この関数はスペース レベルで実行されます。つまり、スペースで権限 ([作業項目を編集] など) が作業項目の報告者に付与されている場合、ご自身が報告者ではない (したがって権限が指定されていない) 作業項目が返される可能性があります。 

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

構文

spacesWhereUserHasPermission(permission)

For the permission parameter, you can specify any of the permissions described on permissions for company-manage spaces.

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

スペース

サポートされる演算子

IN,NOT IN

サポートされない演算子

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

例

  • Find open work items in spaces where you have the "Resolve work items" permission:
    space in spacesWhereUserHasPermission("Resolve work items") AND status = Open

spacesWhereUserHasRole()

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

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

構文

spacesWhereUserHasRole(rolename)

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

スペース

サポートされる演算子

IN,NOT IN

サポートされない演算子

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

例

  • Find open work items in spaces where you have the "Developers" role:
    space in spacesWhereUserHasRole("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 space:
    fixVersion in releasedVersions(ABC)

  • Find work items that relate to released versions of the ABC space:
    (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

例

  • 解決までの所要時間が 2 時間以内に違反する作業項目を検索:
    "Time to Resolution" < remaining("2h")

running()

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

カレンダーにかかわらず、実行中の SLA を持つ作業項目を返します。

カレンダー時間に基づいて実行中の作業項目を検索するには、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 work type, not a subtask work type):
    workType in standardWorkTypes()

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")

  • 過去 3 日間で作成された新しい作業項目を検索:
    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()

  • 先月の 1 日以降に作成された新しい作業項目を検索:
    created > startOfMonth("-1")

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

startOfWeek()

今週作成された新しい作業項目を検索します。この機能は、ルック & フィール設定で日付ピッカーの ISO8601 が無効になっている場合、既定で日曜日を週の最初の日と見なします。週の開始日として別の日 (月曜日など) を使用することもできます。

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

例

  • 今週の初日以降の新しい作業項目を検索 (既定では週の初日は日曜日):
    created > startOfWeek()

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

  • 先週の開始以降の新しい作業項目を検索:
    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()

サブタスクである作業項目に基づいて検索を実行します。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 work type is a subtask work type):
    workType in subtaskWorkTypes()

unreleasedVersions()

Perform searches based on the unreleased versions (i.e. versions that your Jira administrator has not yet released) of a specified space. You can also search on the unreleased versions of all spaces, by omitting the project parameter. See also 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” space:
    fixVersion in unreleasedVersions(ABC)

  • Find work items that relate to unreleased versions of the “ABC” space:
    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 work item’s fields, creating or deleting a comment, or editing a comment (only the last edit). 

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

"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")

  • 2018 年の 6 月から 9 月の間に更新された作業項目を検索:
    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

例

  • ウォッチしている作業項目を検索:
    work item in watchedWorkItems()

withinCalendarHours()

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

SLA カレンダーに基づいて実行中の SLA を持つ作業項目を返します。

For example, say your space 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()In Customer Service ManagementJira Service Management で必要な権限organizationMembers()parentEpicpaused()pending()pendingApprovalBy()pendingBy()spacesLeadByUser()spacesWhereUserHasPermission()spacesWhereUserHasRole()releasedVersions()remaining()running()standardWorkTypes()startOfDay()startOfMonth()startOfWeek()startOfYear()subtaskWorkTypes()unreleasedVersions()updatedBy()votedWorkItems()watchedWorkItems()withinCalendarHours()
コミュニティ質問、ディスカッション、記事