• 関連ドキュメント

JQL 関数

アトラシアンは Jira 用語の更新を行っており、「課題」から「作業項目」へ、「プロジェクト」から「スペース」へと移行しています。

現在、こうした変更をロールアウトしているため、新しい用語を使用する一部の JQL エントリがまだ機能しない場合があります。この問題が発生した場合は、代わりに古い用語の利用をお試しください。

既存の JQL クエリに変更はありません。

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

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

検索クエリで指定されていないかぎり、JQL 検索の結果で空のフィールドが返されることはありません。現在のユーザーに割り当てられていない作業項目を検索するときに空のフィールド (たとえば、未割り当ての作業項目) を含めるには、(assignee != currentUser() OR assignee is EMPTY) と入力して、未割り当ての作業項目を結果リストに含めます。

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

例

  • SLA ([最初の対応までの時間]) に違反した作業項目を検索:
    "Time to First Response" = breached()

cascadeOption()

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

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

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

none キーワードは、片方もしくは両方にのオプションに値を持たない作業項目を検索するときに使用します。

構文

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

  • 「Location」カスタム フィールドの 1 層目の値が「USA」であるすべての作業項目 (2 層目の値の内容や有無は問わない) を検索:
    location in cascadeOption("USA")

  • 「Location」カスタム フィールドの 1 層目の値が「USA」で 2 層目に値を持たない作業項目を検索:
    location in cascadeOption("USA", none)

  • カスタム フィールド (「Location」) で第 1 階層に値がなく、第 2 階層に値がない作業項目を検索:
    location in cascadeOption(none)

  • 「Referrer」カスタム フィールドの 1 層目の値が「none」で 2 層目の値が「none」である作業項目を検索:
    referrer in cascadeOption("\"none\"", "\"none\"")

  • カスタム フィールド (「Referrer」) の 1 層目の値が「none」で 2 層目に値を持たない作業項目を検索:
    referrer in cascadeOption("\"none\"", none)

choiceOption()

[複数選択] または [ドロップダウン] の各カスタム フィールドで選択した ID と一致する作業項目を検索します。

少なくとも 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

例

  • SLA (「最初の対応までの時間」) のサイクルが完了した作業項目を検索:
    "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

例

  • 自分がリードであるコンポーネントのオープンな作業項目を検索:
    component in componentsLeadByUser() AND status = Open

  • 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

例

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

currentUser()

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

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

構文

currentUser()

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

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

サポートされる演算子

=,!=

サポートされない演算子

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

例

  • 自分に割り当てられた作業項目を検索:
    assignee = currentUser()

  • 自分が報告したが自分に割り当てられていない作業項目を検索:
    reporter = currentUser() AND assignee != currentUser()

customerDetail()

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

この JQL 関数を使用するには、[機能] ページで [カスタマー サービス管理] を有効にします。これを見つけるには、[スペース設定]、[機能] の順に移動します。

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

結果には削除または無効化された顧客が含まれます。これらを除外するには、クエリに次の条件を追加します。AND reporter NOT IN inactiveUsers()

構文

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

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

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

サポートされる演算子

=,!=

サポートされない演算子

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

例

  • 修正バージョンが「ABC」スペースの一番古い未リリースのバージョンである作業項目を検索:
    fixVersion = earliestUnreleasedVersion(ABC)

  • 「ABC」スペースの最も早いリリース予定のバージョンに関連する作業項目を検索:
    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

例

  • 期限が今日の終わりまでである作業項目を検索する:
    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

例

  • 期限が今月末までである作業項目を検索:
    due < endOfMonth()

  • 期限が来月末までである作業項目を検索:
    due < endOfMonth("+1")

  • 期限が来月の 15 日までである作業項目を検索:
    due < endOfMonth("+15d")

endOfWeek()

期限が今週中である作業項目を検索します。既定では、この関数は週の最終日を土曜日とみなします。週の最終日として別の日 (日曜日など) を使用することもできます。以下の例の構文を参照してください。 

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

例

  • 期限が今週末までである作業項目を検索 (既定では最終日は土曜日):
    due < endOfWeek()

  • 期限が今週末までである作業項目を検索 (最終日が日曜日の場合):
    due < endOfWeek("+1d")

  • 期限が来週末までである作業項目を検索:
    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

例

  • 期限が今年末までである作業項目を検索:
    due < endOfYear()

  • 期限が来年の 3 月末までである作業項目を検索:
    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

例

  • 「サポート レベル」が「ゴールド」であるエンタイトルメントに関連する作業項目をすべて検索:
    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

例

  • 製品「Acme Widget」のエンタイトルメントに関連する作業項目をすべて検索:
    entitlement in entitlementProduct("Acme Widget")

everBreached()

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

SLA 目標の 1 つを達成できなかった作業項目を返します。  

構文

everBreached()

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

SLA

サポートされる演算子

=,!=

サポートされない演算子

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

例

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

futureSprints()

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

完了したスプリントと未完了のスプリントの両方に作業項目が属している場合もあります。 

構文

futureSprints()

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

Sprint

サポートされる演算子

IN,NOT IN

サポートされない演算子

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

例

  • 未開始のスプリントに割り当てられているすべての作業項目を検索:
    sprint in futureSprints()

workItemHistory()

最近閲覧した作業項目、つまり [作業項目] ドロップダウン メニューの「最近の作業」セクションにある作業項目を検索します。

  • [最近の作業] ドロップダウンが最近の 5 件のみを返すのに対して、workItemHistory() は最大 50 件の作業項目を返します。

  • Jira にログインしていない場合、現在のブラウザ セッションから取得した作業項目のみが含まれます。

構文

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

指定されたグローバル ID のいずれかを持つリモート リンクに関連付けられている作業項目に基づいて検索を実行します。

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

構文

workItemsWithRemoteLinksByGlobalId(globalId)

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

WorkItem

サポートされる演算子

IN,NOT IN

サポートされない演算子

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

例

  • 「abc」の global ID を持つリモート リンクにリンクしている作業項目を検索:
    work item in workItemsWithRemoteLinksByGlobalId(abc)

  • "abc" または "def" の global ID を持つリモート リンクにリンクしている作業項目を検索:
    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()

特定のスペースのリリース済みバージョンの中で一番最後にリリースされたバージョンに基づいて検索を実行します。「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

親レベルの作業項目 (ソフトウェア スペースでは既定でエピック) とサブタスクを検索します。作業項目がその親レベルにない場合、検索結果はその作業項目のすべてのサブタスクを返します。

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

構文

linkedWorkItem = workItemKey

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

WorkItem

サポートされる演算子

=、!=、IN、NOT IN

サポートされない演算子

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

例

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

linkedWorkItems()

作業項目にリンクされている 作業項目を検索します。検索を特定のタイプのリンクに制限できます。 

構文

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

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

If a membersOf() function in your JQL query returns more than 10,000 users, the search won't run and you'll get an error. To fix this, use smaller groups or split large umbrella groups into smaller ones.

構文

グループの場合:

membersOf(Group)

チーム

membersOf(id:<teamId>)

 

チームは現在、チーム名では動作しません。teamId を使用する必要があります。これは、チーム プロファイル URL から取得できます。

groupID でグループを使用することも可能です (例: membersOf(id:<groupId>))

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

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

サポートされる演算子

IN、NOT IN、WAS IN、WAS NOT IN

サポートされない演算子

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

例

  • 担当者がグループまたはチームのメンバーである作業項目を検索する方法:

    • 担当者が特定のグループ「jira-administrators」に属している場合:

      • assignee in membersOf("jira-administrators")

    • 担当者が特定のチーム「team vitafleet」に所属している場合:

      • assignee in membersOf("id: <team vitafleet teamId>")

  • 複数のグループまたはチームで特定のユーザーを検索する場合:

    • グループ

      • reporter in membersOf("jira-administators") または

      • reporter in membersOf("jira-work-management-users") または

      • reporter=jsmith

    • チーム:

      • reporter in membersOf("id:<team vitafleet-teamId") または

      • reporter in membersOf("id:<another-teamId>") または

      • reporter=jsmith

  • 特定のメンバーを除外して、特定のグループを検索する場合:

    • グループ

      • assignee in membersOf(QA) and assignee not in ("John Smith","Jill Jones")

    • チーム:

      • assignee in membersOf('id:<vitafleet-teamId>') and assignee not in ("John Smith","Jill Jones")

  • 特定のグループのメンバーを除く:

    • assignee not in membersOf(QA)

      • チームと同様です “<id: teamId>”

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

例

  • 期限切れの作業項目を検索:
    duedate < now() and status not in (closed, resolved)

openSprints()

開始済みかつ未完了のスプリントに割り当てられている作業項目を検索します。

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

構文

openSprints()

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

Sprint

サポートされる演算子

IN,NOT IN

サポートされない演算子

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

例

  • 未完了のスプリントに割り当てられたすべての作業項目を検索:
    sprint in openSprints()

organizationDetail()

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

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

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

If an organizationMembers() function in your JQL query returns more than 10,000 users, the search won't run and you'll get an error. To fix this, reduce the organization size in your query or use labels or custom fields to filter instead.

構文

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

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

より大きな作業 (ソフトウェア スペースでは既定でエピック) に使用される親レベルの作業タイプにリンクされている作業項目とサブタスクを検索します。

構文

parentEpic = workItemkey

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

WorkItem

サポートされる演算子

=、!=、IN、NOT IN

サポートされない演算子

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

例

  • エピック DEMO-123 の作業項目とサブタスクを検索:
    parentEpic = DEMO 123

  • エピック DEMO-1 または 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

例

  • 最初の対応までの時間が一時停止している作業項目を検索:
    "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 サブスクリプションがあるサイトにのみ適用されます。

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

構文

pendingApprovalBy(user1, user2)

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

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

サポートされる演算子

=,!=

サポートされない演算子

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

例

  • リクエストを検索

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

特定のユーザーが主導するスペース内の作業項目を検索します。必要に応じてユーザーを指定できます。ユーザーを指定しない場合、現在のユーザーが使用されます。 

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

構文

spacesLeadByUser() spacesLeadByUser(username)

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

スペース

サポートされる演算子

IN,NOT IN

サポートされない演算子

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

例

  • 自分がリードであるスペースのオープンな作業項目を検索:
    space in spacesLeadByUser() AND status = Open

  • Bill がリードであるスペースのオープンな作業項目を検索:
    space in pspacesLeadByUser(bill) AND status = Open

spacesWhereUserHasPermission()

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

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

構文

spacesWhereUserHasPermission(permission)

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

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

スペース

サポートされる演算子

IN,NOT IN

サポートされない演算子

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

例

  • 自身が「Resolve work items」権限を持つスペースのオープンな作業項目を検索:
    space in spacesWhereUserHasPermission("Resolve work items") AND status = Open

spacesWhereUserHasRole()

ご自身が特定のロールを持つスペース内で作業項目を検索します。 

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

構文

spacesWhereUserHasRole(rolename)

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

スペース

サポートされる演算子

IN,NOT IN

サポートされない演算子

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

例

  • 自身が「Developer」ロールを持つスペースのオープンな作業項目を検索:
    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

例

  • 修正バージョンが「ABC」スペースのリリース済みバージョンである作業項目を検索:
    fixVersion in releasedVersions(ABC)

  • ABC スペースのリリース済みバージョンに関連する作業項目を検索:
    (affectedVersion in releasedVersions(ABC)) or (fixVersion in releasedVersions(ABC))

remaining()

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

目標に対し、SLA クロックが特定の相対的なタイミングにある作業項目を返します。  

構文

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

例

  • 初回応答時間の計測が実行中の作業項目を検索:
    "Time to First Response" = running()

standardWorkTypes()

「標準」作業タイプに基づいて検索を実行します。つまり、サブタスク以外の作業項目を検索します。subtaskWorkTypes() も参照してください。

構文

standardWorkTypes()

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

タイプ

サポートされる演算子

IN,NOT IN

サポートされない演算子

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

例

  • サブタスクではない作業項目 (例: 作業タイプがサブタスク作業タイプではなく、標準の作業タイプである作業項目) を検索:
    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

例

  • 今日作成された新しい作業項目を検索:
    created > startOfDay()

  • 昨日以降に作成された新しい作業項目を検索:
    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

例

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

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

  • 今月の 15 日以降に作成された新しい作業項目を検索:
    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()

  • 今週の初日以降の新しい作業項目を検索 (初日が月曜日の場合):
    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

例

  • 今年の開始以降の新しい作業項目を検索:
    created > startOfYear()

  • 昨年始め以降の新しい作業項目を検索:
    created > startOfYear("-1")

subtaskWorkTypes()

サブタスクである作業項目に基づいて検索を実行します。standardWorkTypes() も参照してください。

構文

subtaskWorkTypes()

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

タイプ

サポートされる演算子

IN,NOT IN

サポートされない演算子

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

例

  • サブタスクである作業項目 (つまり、作業タイプがサブタスク作業タイプである作業項目) を検索:
    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

例

  • 修正バージョンが「ABC」スペースの未リリース バージョンである作業項目を検索:
    fixVersion in unreleasedVersions(ABC)

  • "ABC" スペースの未リリース バージョンに関連する作業項目を検索:
    affectedVersion in unreleasedVersions(ABC)

updatedBy()

特定のユーザーが更新した作業項目を検索できます。オプションで期間も指定できます。ここでいう更新には、作業項目の作成、作業項目の任意のフィールドの更新、コメントの作成または削除、またはコメントの編集 (直前の編集のみ) が含まれます。 

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

"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

例

  • John Smith が更新した作業項目を検索:
    workItemKey in updatedBy(jsmith)

  • John Smith が過去 8 日間以内に更新した作業項目を検索:
    workItemKey in updatedBy(jsmith, "-8d")

  • 2018 年の 6 月から 9 月の間に更新された作業項目を検索:
    workItemkey in updatedBy(jsmith, "2018/06/01", "2018/08/31")

  • 以下の例のように過去 1 時間以内に更新された作業項目を検索する場合、1 日よりも小さな値はサポートされないため、1 日に切り上げられます。
    workItemkey in updatedBy(jsmith, "-1h")

votedWorkItems()

自身が投票した作業項目に基づいて検索を実行します。[Voter (投票者)] フィールドも参照してください。この関数は、ログイン済みのユーザーのみが使用できます。

この関数は、最大 32,000 の作業項目 ID を返します。

構文

votedWorkItems()

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

WorkItem

サポートされる演算子

IN,NOT IN

サポートされない演算子

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

例

  • 自身が投票した作業項目を検索:
    work item in votedWorkItems()

watchedworkItems()

自身がウォッチしている作業項目に基づいて検索を実行します。Watcher フィールドもご確認ください。この関数は、ログイン済みのユーザーのみが使用できます。

この関数は、最大 32,000 の作業項目 ID を返します。

構文

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 を持つ作業項目を返します。

たとえば、スペースに、最初の対応までの時間をカウントする 2 つの SLA があるとします。この SLA を使用する一部の作業項目は午前 9 時 - 午後 1 時のカレンダーを、他の作業項目は午前 9 時 - 午後 5 時のカレンダーを使用します。エージェントが午後 3 時に作業を開始した場合は、おそらく午前 9 時 - 午後 5 時の SLA にある作業項目から作業を行います。withinCalendarHours() を使用すると、午後 3 時の時点で最初の対応までの時間が実行中であるすべての作業項目を検索できます。

構文

withinCalendarHours()

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

SLA

サポートされる演算子

=、!=

サポートされない演算子

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

例

  • SLA (「最初の対応までの時間」) がカレンダー時間内である作業項目を検索:
    "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()Customer Service Management でJira Service Management で必要な権限organizationMembers()parentEpicpaused()pending()pendingApprovalBy()pendingBy()spacesLeadByUser()spacesWhereUserHasPermission()spacesWhereUserHasRole()releasedVersions()remaining()running()standardWorkTypes()startOfDay()startOfMonth()startOfWeek()startOfYear()subtaskWorkTypes()unreleasedVersions()updatedBy()votedWorkItems()watchedworkItems()withinCalendarHours()
コミュニティ質問、ディスカッション、記事