詳細検索 - 関数リファレンス

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

このページでは、詳細検索で使用する関数の情報について説明します。

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

一部の Jira アプリでは、高度な課題検索に関数を追加できます。たとえば、ScriptRunner for JIRA アプリでは、myProjects() and projectmatch() のような関数で JQL を拡張します

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

approved()

Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。

承認を必要としていた課題で、承認の最終決定が完了しているものを検索します。

構文
approved()
サポートされるフィールドApproval タイプのカスタム フィールド
サポートされる演算子 =
サポートされない演算子 , != , !~ , > , >= , < , <= 
IS , IS NOT , IN , NOT IN , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • 承認済みのすべての課題を検索:
    Approvals = approved()
  • 自分が承認した、または自分の承認待ちの課題をすべて検索:
    Approvals = myApproval() OR Approvals = myPending()

^ ページのトップへ

On this page:

approver()

Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。

リスト内の 1 人以上のユーザーによる承認が必要な課題または必要だった課題を検索します。OR 演算子を使用し、ユーザー名を指定する必要があります。

構文
approver(user,user)
サポートされるフィールドApproval タイプのカスタム フィールド
サポートされる演算子 =
サポートされない演算子, != , !~ , > , >= , < , <= 
IS , IS NOT , IN , NOT IN , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • John Smith による承認が必要または必要だった課題を検索:
    approval = approver(jsmith)
  • John Smith または Sarah Khan による承認が必要または必要だった課題を検索:
    approval = approver(jsmith,skhan)

^ ページのトップへ

breached()

Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。

直近で目標を達成できなかった課題を返します。

構文
breached()
サポートされるフィールド
サポートされる演算子 = , !=
サポートされない演算子 ~ , !~ , > , >= , < , <= , IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • 初回応答時間に違反した課題を検索:
    "Time to First Response" = breached()

^ ページのトップへ

cascadeOption()

"cascading select" カスタム フィールドで選択された値と一致する課題を検索します。

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

"none" キーワードは、片方もしくは両方に値を持たない課題を検索するときに使用します。

構文
cascadeOption(parentOption)
cascadeOption(parentOption,childOption)
サポートされるフィールド"Cascading Select" タイプのカスタム フィールド
サポートされる演算子 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)

^ ページのトップへ

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 がインストールされていてライセンスが付与されている場合にのみ適用可能です。

1 つ以上のサイクルが完了した課題を返します。  

構文
completed()
サポートされるフィールド
サポートされる演算子 = , !=
サポートされない演算子 = , ~ , !~ , > , >= , < , <= , IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • 初回応答時間を 1 回以上達成した課題を検索:
    "Time to First Response" = completed()

^ ページのトップへ

componentsLeadByUser()

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

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

構文
componentsLeadByUser()
componentsLeadByUser(username)
サポートされるフィールドコンポーネント
サポートされる演算子 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()
サポートされるフィールド作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド
サポートされる演算子= , != , > , >= , < , <=
WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED*
* Only in predicate 
サポートされない演算子~ , !~ , IS , IS NOT , IN , NOT IN
  • 現在のセッション中に作成された課題を検索:
    created > currentLogin()

^ ページのトップへ

currentUser()

Perform searches based on the currently logged-in user.

この関数は、ログイン済みのユーザーのみが使用できます。匿名ユーザーが利用することを想定した保存済みフィルターを作成する場合は、この関数を使用しないでください。

構文
currentUser()
サポートされるフィールド担当者、報告者、投票者、ウォッチャー、User タイプのカスタム フィールド
サポートされる演算子= , !=
サポートされない演算子~ , !~ , > , >= , < , <= , IS , IS NOT , IN , NOT IN , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • 自身に割り当てられた課題を検索:
    assignee = currentUser()

  • 自分が報告したが自分に割り当てられていない課題を検索:

    reporter = currentUser() AND (assignee != currentUser() OR assignee is EMPTY)

^ ページのトップへ

earliestUnreleasedVersion()

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

"一番古い" かどうかは、実際のバージョン期限ではなく、バージョンに割り当てられた序数に基づいて判断されることに留意してください。

構文
earliestUnreleasedVersion(project)
サポートされるフィールド影響バージョン、修正バージョン、Version タイプのカスタム フィールド
サポートされる演算子

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

サポートされない演算子IN , NOT IN
  • FixVersion が ABC プロジェクトの一番古い未リリースのバージョンである課題を検索:
    fixVersion = earliestUnreleasedVersion(ABC)

  • ABC プロジェクトの一番古い未リリースのバージョンに関連する課題を検索:
    affectedVersion = earliestUnreleasedVersion(ABC) or fixVersion = earliestUnreleasedVersion(ABC)

^ ページのトップへ

elapsed()

Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。

サイクルの開始イベントに対し、クロックが特定の相対的なタイミングにある課題を返します。  

構文
elapsed()
サポートされるフィールド
サポートされる演算子 = , != , > , >= , < , <=
サポートされない演算子~ , IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • 初回応答を 1 時間より長く待機している課題を検索:
    "Time to First Response" > elapsed("1h")

^ ページのトップへ

endOfDay()

検索実行日の最終時刻に基づいて検索を実行します。「endOfWeek()」、「endOfMonth()」、「endOfYear()」、「startOfDay()」、「startOfWeek()」、「startOfMonth()」、および「startOfYear()」も参照してください。

構文
endOfDay()
endOfDay("inc")

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

サポートされるフィールド作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド
サポートされる演算子= , != , > , >= , < , <=
WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED*
Only in predicate 
サポートされない演算子~ , !~ , IS , IS NOT , IN , NOT IN
  • 期限が今日中である課題を検索:
    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") と同じと解釈されます。プラス / マイナス (+/-) 記号が省略された場合、プラスと見なされます。

サポートされるフィールド作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド
サポートされる演算子= , != , > , >= , < , <=
WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED*
Only in predicate 
サポートされない演算子~ , !~ , 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()
endOfWeek("inc")

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

サポートされるフィールド作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド
サポートされる演算子= , != , > , >= , < , <=
WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED*
Only in predicate 
サポートされない演算子~ , !~ , IS , IS NOT , IN , NOT IN
  • 期限が今週中である課題を検索:
    due < endOfWeek()

  • 期限が来週中である課題を検索:
    due < endOfWeek("+1")

^ ページのトップへ

endOfYear()

検索実行日の年末に基づいて検索を実行します。「startOfDay()」、「startOfWeek()」、「startOfMonth()」、「endOfDay()」、「endOfWeek()」、「endOfMonth()」、および「endOfYear()」も参照してください。

構文
endOfYear()
endOfYear("inc")

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

サポートされるフィールド作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド
サポートされる演算子= , != , > , >= , < , <=
WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED*
Only in predicate 
サポートされない演算子~ , !~ , IS , IS NOT , IN , NOT IN
  • 期限が今年中である課題を検索:
    due < endOfYear()

  • 期限が来年の 3 月中である課題を検索:
    due < endOfYear("+3M")

^ ページのトップへ

everBreached()

Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。

目標の 1 つを達成できなかった課題を返します。  

構文
elapsed()
サポートされるフィールド
サポートされる演算子 = , !=
サポートされない演算子~ , > , >= , < , <= , IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • 初回応答時間の目標を達成できなかった課題を検索:
    "Time to First Response" = everbreached()

^ ページのトップへ

futureSprints()

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

1 つの課題が完了したスプリントと未完了のスプリントの両方に属する可能性もあります。 

構文
futureSprints()
サポートされるフィールドSprint
サポートされる演算子IN , NOT IN
サポートされない演算子= , != , ~ , !~ , > , >= , < , <=
IS , IS NOT, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • 未開始のスプリントに割り当てられているすべての課題を検索:
    sprint in futureSprints()

^ ページのトップへ

issueHistory()

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

注意:  

  • issueHistory() は最大 60 件の課題を返すのに対し、[最近の課題] ドロップダウンは 5 件のみを返します。
  • Jira にログインしていない場合、現在のブラウザ セッションから取得した課題のみが含まれます。
  • 90 日よりも古い課題は、スケジュールされたジョブによって毎日削除されます。

構文
issueHistory()
サポートされるフィールド課題
サポートされる演算子IN , NOT IN
サポートされない演算子= , != , ~ , !~ , > , >= , < , <= , IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • 最近閲覧した課題の中で自身が担当している課題を検索:
    issue in issueHistory() AND assignee = currentUser()

^ ページのトップへ

issuesWithRemoteLinksByGlobalId()

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

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

構文
issuesWithRemoteLinksByGlobalId()
サポートされるフィールド課題
サポートされる演算子IN , NOT IN
サポートされない演算子= , != , ~ , !~ , > , >= , < , <= , IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • "abc" の globalId を持つリモート リンクにリンクしている課題を検索:
    issue in issuesWithRemoteLinksByGlobalId(abc)

  • "abc" または "def" の globalId を持つリモート リンクにリンクしている課題を検索:
    issue in issuesWithRemoteLinksByGlobalId(abc, def)

^ ページのトップへ

lastLogin()

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

構文
lastLogin()
サポートされるフィールド作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド
サポートされる演算子= , != , > , >= , < , <=
WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED*
Only in predicate 
サポートされない演算子~ , !~ , IS , IS NOT , IN , NOT IN
  • 前回のセッション中に作成された課題を検索:
    created > lastLogin()

^ ページのトップへ

latestReleasedVersion()

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

"一番最後" かどうかは、実際のバージョン期限ではなく、バージョンに割り当てられた序数に基づいて判断されることに留意してください。

構文
latestReleasedVersion(project)
サポートされるフィールド影響バージョン、修正バージョン、Version タイプのカスタム フィールド
サポートされる演算子= , !=
サポートされない演算子

~ , !~ , > , >= , < , <= 

IS , IS NOT , IN , NOT IN , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED

  • FixVersion が ABC プロジェクトの最新のリリース済みバージョンである課題を検索:
    fixVersion = latestReleasedVersion(ABC)

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

^ ページのトップへ

linkedIssues()

特定の課題にリンクされている課題に基づいて検索を実行します。検索を特定のタイプのリンクに制限することもできます。

LinkType では大文字と小文字が区別されることに注意してください。

構文
linkedIssues(issueKey)
linkedIssues(issueKey,linkType)
サポートされるフィールド課題
サポートされる演算子IN , NOT IN
サポートされない演算子= , != , ~ , !~ , > , >= , < , <= , IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • 特定の課題にリンクしている課題を検索:
    issue in linkedIssues(ABC-123)

  • 特定の課題から特定のリンク タイプでリンクしている課題を検索:
    issue in linkedIssues(ABC-123,"is duplicated by")

^ ページのトップへ

membersOf()

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

構文
membersOf(グループ)
サポートされるフィールド担当者、報告者、投票者、ウォッチャー、User タイプのカスタム フィールド
サポートされる演算子IN , NOT IN
サポートされない演算子= , != , ~ , !~ , > , >= , < , <= , IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • 担当者が "jira-administrators" グループのメンバーである課題を検索:
    assignee in membersOf("Jira-administrators")

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

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

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

^ ページのトップへ

myApproval()

Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。

現在のユーザーによる承認が必要または必要だった課題を検索します。

構文
myApproval()
サポートされるフィールドApproval タイプのカスタム フィールド
サポートされる演算子 =
サポートされない演算子 , != , !~ , > , >= , < , <= 
IS , IS NOT , IN , NOT IN , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • 自身による承認が必要または必要だったすべての課題を検索:
    approval = myApproval()

^ ページのトップへ

myPending()

Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。

現在のユーザーによる承認が必要な課題を検索します。

構文
myPending()
サポートされるフィールドApproval タイプのカスタム フィールド
サポートされる演算子 =
サポートされない演算子 , != , !~ , > , >= , < , <= 
IS , IS NOT , IN , NOT IN , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • 自身による承認が必要なすべての課題を検索:
    approval = myPending()

^ ページのトップへ

now()

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

構文
now()
サポートされるフィールド作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド
サポートされる演算子= , != , > , >= , < , <=
WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED*
Only in predicate 
サポートされない演算子~ , !~ , 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()

^ ページのトップへ

outdated()

Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。

設定で SLA が変更されたために SLA が古くなっている課題を返します。サイトが SLA をインデックス再作成して再計算した後は、この関数で返される課題はありません。インデックス再作成に時間がかかっている場合や、変更が多いためにインデックス再作成が延期された場合は、この関数を使用してください。

構文
outdated()
サポートされるフィールド
サポートされる演算子 = , !=
サポートされない演算子 ~ , !~ , > , >= , < , <= , IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • SLA が最新ではない課題を検索:
    "Time to First Response" = outdated()

^ ページのトップへ

paused()

Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。

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

カレンダー時間外のために一時停止されている課題を検索するには、withincalendarhours() を使用します。

構文
paused()
サポートされるフィールド
サポートされる演算子 = , !=
サポートされない演算子 ~ , !~ , > , >= , < , <= , IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • 初回応答時間が一時停止している課題を検索:
    "Time to First Response" = paused()

^ ページのトップへ

pending()

Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。

承認が必要な課題を検索します。

構文
pending()
サポートされるフィールドApproval タイプのカスタム フィールド
サポートされる演算子 =
サポートされない演算子 , != , !~ , > , >= , < , <= 
IS , IS NOT , IN , NOT IN , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • 承認が必要なすべての課題を検索:
    approval = pending()

^ ページのトップへ

pendingBy()

Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。

リスト内の 1 人以上のユーザーによる承認が必要な課題を検索します。OR 演算子を使用し、ユーザー名を指定する必要があります

構文
pendingBy(user1,user2)
サポートされるフィールドApproval タイプのカスタム フィールド
サポートされる演算子 =
サポートされない演算子 , != , !~ , > , >= , < , <= 
IS , IS NOT , IN , NOT IN , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • John Smith による承認が必要な課題を検索:
    approval = pendingBy(jsmith)
  • John Smith または Sarah Khan による承認が必要な課題を検索:
    approval = pendingBy(jsmith,skhan)

^ ページのトップへ

projectsLeadByUser() 

特定のユーザーが主導するプロジェクト内の課題を検索します。必要に応じてユーザーを指定できます。ユーザーを指定しない場合、現在のユーザーが使用されます。 

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

構文
projectsLeadByUser()
projectsLeadByUser(username) 
サポートされるフィールドプロジェクト
サポートされる演算子IN , NOT IN
サポートされない演算子= , != , ~ , !~ , > , >= , < , <=
IS , IS NOT, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • 自身がリードであるプロジェクトのオープンな課題を検索:
    project in projectsLeadByUser() AND status = Open

  • Bill がリードであるプロジェクトのオープンな課題を検索:
    project in projectsLeadByUser(bill) AND status = Open

^ ページのトップへ

projectsWhereUserHasPermission()

自身が特定の権限を持つプロジェクト内で課題を検索します。この関数は、プロジェクト レベルで実行されます。たとえば、プロジェクトで課題の報告者に特定の権限 ("課題の編集" など) が付与されている場合、自身が報告者ではない (したがって権限を持たない) 課題が返される可能性があります。この関数は、Jira にログインしている場合にのみ利用できます。

構文
projectsWhereUserHasPermission(permission)

permission パラメータには、記載されている任意の権限を指定できます。

サポートされるフィールドプロジェクト
サポートされる演算子IN , NOT IN
サポートされない演算子= , != , ~ , !~ , > , >= , < , <=
IS , IS NOT, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • 自身が "Resolve Issues" 権限を持つプロジェクトのオープンな課題を検索:
    project in projectsWhereUserHasPermission("Resolve Issues") AND status = Open

^ ページのトップへ

projectsWhereUserHasRole()

自身が特定のロールを持っているプロジェクトの課題を検索します。この関数は、Jira にログインしている場合にのみ利用できます。

構文
projectsWhereUserHasRole(rolename)
サポートされるフィールドプロジェクト
サポートされる演算子IN , NOT IN
サポートされない演算子= , != , ~ , !~ , > , >= , < , <=
IS , IS NOT, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • 自身が "Developer" ロールを持つプロジェクトのオープンな課題を検索:
    project in projectsWhereUserHasRole("Developers") AND status = Open

^ ページのトップへ

releasedVersions()

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

構文
releasedVersions()
releasedVersions(project)
サポートされるフィールド影響バージョン、修正バージョン、Version タイプのカスタム フィールド
サポートされる演算子IN , NOT IN
サポートされない演算子= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • FixVersion が ABC プロジェクトのリリース済みバージョンである課題を検索:
    fixVersion in releasedVersions(ABC)

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

^ ページのトップへ

remaining()

Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。

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

構文
remaining()
サポートされるフィールド
サポートされる演算子 = , !=, > , >= , < , <=
サポートされない演算子 ~ , 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()
サポートされるフィールド
サポートされる演算子 = , !=
サポートされない演算子 ~ , !~ , > , >= , < , <= , IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • 初回応答時間の計測が実行中の課題を検索:
    "Time to First Response" = running()

^ ページのトップへ

standardIssueTypes()

"標準" 課題タイプに基づいて検索を実行します。つまり、サブタスク以外の課題を検索します。subtaskIssueTypes() もご確認ください。

構文
standardIssueTypes()
サポートされるフィールドタイプ
サポートされる演算子IN , NOT IN
サポートされない演算子= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • サブタスクではない課題 (サブタスク意外の通常の課題タイプを持つ課題) を検索:
    issuetype in standardIssueTypes()

^ ページのトップへ

startOfDay()

検索実行日の開始時刻に基づいて検索を実行します。「startOfWeek()」、「startOfMonth()」、「startOfYear()」、「endOfDay()」、「endOfWeek()」、「endOfMonth()」、および「endOfYear()」も参照してください。

構文
startOfDay()
startOfDay("inc")

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

サポートされるフィールド作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド
サポートされる演算子= , != , > , >= , < , <=
WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED*
Only in predicate 
サポートされない演算子~ , !~ , 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") と同じと解釈されます。プラス / マイナス (+/-) 記号が省略された場合、プラスと見なされます。

サポートされるフィールド作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド
サポートされる演算子= , != , > , >= , < , <=
WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED*
Only in predicate 
サポートされない演算子~ , !~ , IS , IS NOT , IN , NOT IN
  • 今月作成された課題を検索:
    created > startOfMonth()

  • 先月の 1 日以降に作成された課題を検索:
    created > startOfMonth("-1")

  • 今月の 15 日以降に作成された課題を検索:
    created > startOfMonth("+14d")

^ ページのトップへ

startOfWeek()

検索実行日の週初めに基づいて検索を実行します。「startOfDay()」、「startOfMonth()」、「startOfYear()」、「endOfDay()」、「endOfWeek()」、「endOfMonth()」、および「endOfYear()」も参照してください。

startOfWeek() 関数の場合、結果はロケールにより異なります。たとえば、ヨーロッパでは、週の初日は一般的に月曜日ですが、米国では日曜日とみなされます。

構文
startOfWeek()
startOfWeek("inc")

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

サポートされるフィールド作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド
サポートされる演算子= , != , > , >= , < , <=
WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED*
Only in predicate 
サポートされない演算子~ , !~ , IS , IS NOT , IN , NOT IN
  • 今週作成された課題を検索:
    created > startOfWeek()

  • 先週以降に作成された課題を検索:
    created > startOfWeek("-1")

^ ページのトップへ

startOfYear()

検索実行日の年始に基づいて検索を実行します。「startOfDay()」、「startOfWeek()」、「startOfMonth()」、「endOfDay()」、「endOfWeek()」、「endOfMonth()」、および「endOfYear」も参照してください。

構文
startOfYear()
startOfYear("inc")

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

サポートされるフィールド作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド
サポートされる演算子= , != , > , >= , < , <=
WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED*
*
 Only in predicate 
サポートされない演算子~ , !~ , IS , IS NOT , IN , NOT IN
  • 今年作成された課題を検索:
    created > startOfYear()

  • 昨年以降に作成された課題を検索:
    created > startOfYear("-1")

^ ページのトップへ

subtaskIssueTypes()

サブタスクである課題に基づいて検索を実行します。standardIssueTypes() もご確認ください。

構文
subtaskIssueTypes()
サポートされるフィールドタイプ
サポートされる演算子IN , NOT IN
サポートされない演算子= , != , ~ , !~ , > , >= , < , <= , IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • サブタスクである課題 (課題タイプがサブタスク課題タイプである課題) を検索:
    issuetype in subtaskIssueTypes()

^ ページのトップへ

unreleasedVersions()

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

構文
unreleasedVersions()
unreleasedVersions(project)
サポートされるフィールド影響バージョン、修正バージョン、Version タイプのカスタム フィールド
サポートされる演算子IN , NOT IN
サポートされない演算子= , != , ~ , !~ , > , >= , < , <= , IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • FixVersion が 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)
サポートされるフィールドIssuekey、およびそのエイリアス (idissuekey)
サポートされる演算子 IN , NOT IN
サポートされない演算子=, ~ , != , !~ , > , >= , < , <= 
IS , IS NOTWAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • John Smith が更新した課題を検索:
    issuekey IN updatedBy(jsmith)
  • John Smith が最近 8 日間以内に更新した課題を検索:
    issuekey IN updatedBy(jsmith, "-8d")
  • 2018 年の 6 月から 9 月の間に更新された課題を検索:
    issuekey IN updatedBy(jsmith, "2018/06/01", "2018/08/31")
  • 以下の例のように過去 1 時間以内に更新された検索をする場合、これはサポートされない小さな値であるため、1 日に切り上げられます:
    issuekey IN updatedBy(jsmith, "-1h")

^ ページのトップへ

votedIssues()

自身が投票した課題に基づいて検索を実行します。[Voter (投票者)] フィールドも参照してください。

この関数は、ログイン済みのユーザーのみが使用できます。

構文
votedIssues()
サポートされるフィールド課題
サポートされる演算子IN , NOT IN
サポートされない演算子= , != , ~ , !~ , > , >= , < , <= , IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • 自身が投票した課題を検索:
    issue in votedIssues()

^ ページのトップへ

watchedIssues()

自身がウォッチしている課題に基づいて検索を実行します。[Watcher (ウォッチャー)] フィールドも参照してください。 

この関数は、ログイン済みのユーザーのみが使用できます。

構文
watchedIssues()
サポートされるフィールド課題
サポートされる演算子IN , NOT IN
サポートされない演算子= , != , ~ , !~ , > , >= , < , <= , IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • 自身がウォッチしている課題を検索:
    issue in watchedIssues()

^ ページのトップへ

withinCalendarHours()

Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。

カレンダーに従って実行中の SLA がある課題を返します。

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

構文
withinCalendarHours()
サポートされるフィールド
サポートされる演算子 = , !=
サポートされない演算子 ~ , !~ , > , >= , < , <= , IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
  • 初回応答時間がカレンダー時間内の課題を検索:
    "Time to First Response" = withinCalendarHours()

^ ページのトップへ

最終更新日: 2023 年 10 月 12 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.