クラウド
Data Center 8.15
バージョン

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

詳細検索

このページの内容

関連コンテンツ

  • 関連コンテンツがありません

お困りですか?

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

コミュニティに質問

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

A function in JQL appears as a word followed by parentheses, which may contain one or more explicit values or Jira system fields. In a clause, a function is preceded by an operator, which in turn is preceded by a field. A function performs a calculation on either specific Jira data or the function's content in parentheses, such that only true results are retrieved by the function, and then again by the clause in which the function is used.

Note that some Jira apps can add additional functions to the advanced issue search. For example, the ScriptRunner for JIRA app extends JQL with such functions as myProjects() and projectmatch().

検索クエリで指定されていないかぎり、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
例
  • 承認済みのすべての課題を検索:
    approval = approved()

^ ページのトップへ

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

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

構文
breached()
サポートされるフィールドSLA
サポートされる演算子 = , !=
サポートされない演算子 ~ , !~ , > , >= , < , <= , 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()

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

It's possible for an issue to belong to both a completed Sprint(s) and an incomplete Sprint(s). See also openSprints().

構文
closedSprints()
サポートされるフィールドSprint
サポートされる演算子IN , NOT IN
サポートされない演算子= , != , ~ , !~ , > , >= , < , <=
IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
例

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

^ ページのトップへ

completed()

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

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

構文
completed()
サポートされるフィールドSLA
サポートされる演算子 = , !=
サポートされない演算子 = , ~ , !~ , > , >= , < , <= , IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
例

  • 初回応答時間を 1 回以上達成した課題を検索:
    "Time to First Response" = completed()

^ ページのトップへ

componentsLeadByUser()

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

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

構文
componentsLeadByUser()
componentsLeadByUser(username)
サポートされるフィールドコンポーネント
サポートされる演算子 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()

Perform searches based on the earliest unreleased version (i.e. next version that is due to be released) of a specified project. See also 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 がインストールされていてライセンスが付与されている場合にのみ適用可能です。

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

構文
elapsed()
サポートされるフィールドSLA
サポートされる演算子 = , != , > , >= , < , <=
サポートされない演算子~ , IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
例

  • 初回応答を 1 時間より長く待機している課題を検索:
    "Time to First Response" > elapsed("1h")

^ ページのトップへ

endOfDay()

Perform searches based on the end of the current day. See also endOfWeek(), endOfMonth(), and endOfYear(), startOfDay(), startOfWeek(), startOfMonth(), and 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 がインストールされていてライセンスが付与されている場合にのみ適用可能です。

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

構文
elapsed()
サポートされるフィールドSLA
サポートされる演算子 = , !=
サポートされない演算子~ , > , >= , < , <= , 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() returns up to 50 issues, whereas the Recent Issues dropdown returns only 5.
  • Jira にログインしていない場合、現在のブラウザ セッションから取得した課題のみが含まれます。
構文
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 , WAS NOT IN , WAS 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(QA) and assignee not in ("John Smith","Jill Jones")

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

^ ページのトップへ

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

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

Returns issues that have an SLA that is paused due to a condition. To find issues that are paused because they are outside calendar hours, use withincalendarhours().

構文
paused()
サポートされるフィールドSLA
サポートされる演算子 = , !=
サポートされない演算子 ~ , !~ , > , >= , < , <= , IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
例

  • 初回応答時間が一時停止している課題を検索:
    "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 がインストールされていてライセンスが付与されている場合にのみ適用可能です。

Search for issues that require approval by the listed users. This uses an OR operator, and you must specify the usernames.

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

Find issues in projects where you have a specific permission.

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

This function is only available if you are logged in to Jira.

構文
projectsWhereUserHasPermission(permission)

For the permission parameter, you can specify any of the permissions described in Managing project permissions.

サポートされるフィールドプロジェクト
サポートされる演算子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()

Find issues in projects where you have a specific role. 

This function is only available if you are logged in to 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()

Perform searches based on the released versions (i.e. versions that your Jira administrator has released) of a specified project. You can also search on the released versions of all projects, by omitting the project parameter. See also latestReleasedVersion().

構文
releasedVersions()
releasedVersions(project)
サポートされるフィールド影響バージョン、修正バージョン、Version タイプのカスタム フィールド
サポートされる演算子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 がインストールされていてライセンスが付与されている場合にのみ適用可能です。

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

Returns issues that have an SLA that is running, regardless of the calendar. To find issues that are running based on calendar hours, use withincalendarhours().

構文
running()
サポートされるフィールドSLA
サポートされる演算子 = , !=
サポートされない演算子 ~ , !~ , > , >= , < , <= , 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()

Perform searches based on the start of the current year. See also startOfDay(), startOfWeek(), startOfMonth(), endOfDay(), endOfWeek(), endOfMonth(), and 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、およびそのエイリアス (id、issue、key)
サポートされる演算子 IN , NOT IN
サポートされない演算子=, ~ , != , !~ , > , >= , < , <= 
IS , IS NOT , WAS , 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 カレンダーに基づいて実行中の 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
例

  • 初回応答時間がカレンダー時間内の課題を検索:
    "Time to First Response" = withinCalendarHours()

^ ページのトップへ

最終更新日: 2023 年 1 月 31 日

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

はい
いいえ
この記事についてのフィードバックを送信する

関連コンテンツ

  • 関連コンテンツがありません
Powered by Confluence and Scroll Viewport.