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

お困りですか?

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

コミュニティに質問

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

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.

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

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

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

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

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

Returns issues that whose most recent has missed its goal.

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

^ ページのトップへ

cascadeOption()

Search for issues that match the selected values of a "cascading select" custom field.

The parentOption parameter matches against the first tier of options in the cascading select field. The childOption parameter matches against the second tier of options in the cascading select field, and is optional. 

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

構文
cascadeOption(parentOption)
cascadeOption(parentOption,childOption)
サポートされるフィールドCustom fields of type "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 がインストールされていてライセンスが付与されている場合にのみ適用可能です。

Returns issues that have an that has completed at least one cycle.  

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

If you are not logged in to Jira, a user must be specified.

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

Perform searches based on the time at which the current user's session began. See also 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.

This function can only be used by logged-in users. If you are creating a saved filter that you expect to be used by anonymous users, don't use this function.

構文
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」も参照してください。 

Consider that the "earliest" is determined by the ordering assigned to the versions, not by actual Version Due Dates.

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

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

^ ページのトップへ

elapsed()

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

Returns issues whose clock is at a certain point relative to a cycle's start event.  

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

Perform searches based on the end of the current month. See also endOfDay()endOfWeek(), endOfYear(), startOfDay()startOfWeek()startOfMonth(), and 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()

Perform searches based on the end of the current week. See also endOfDay()endOfMonth(), endOfYear()startOfDay()startOfWeek()startOfMonth(), and startOfYear.

For the endOfWeek() function, the result depends upon your locale. For example, in Europe, the first day of the week is generally considered to be Monday, while in the USA, it is considered to be Sunday.

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

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

Returns issues that have missed one of their goals.  

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

^ ページのトップへ

futureSprints()

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

It is possible for an issue to belong to both completed and incomplete sprints. 

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

^ ページのトップへ

issueHistory()

Find issues that you have recently viewed, i.e. issues that are in the Recent Issues section of the Issues dropdown menu.

注意:  

  • issueHistory() returns up to 60 issues, whereas the Recent Issues drop-down returns only 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()

Perform searches based on the time at which the current user's previous session began. See also 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()

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

Consider that the "latest" is determined by the ordering assigned to the versions, not by actual Version Due Dates.

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

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

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

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

^ ページのトップへ

paused()

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

Returns issues that have an that is paused due to a condition.

カレンダー時間外のために一時停止されている課題を検索するには、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 がインストールされていてライセンスが付与されている場合にのみ適用可能です。

Search for issues that require approval by one or more of 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() 

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

If you are not logged in to Jira, a user must be specified.

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

Returns issues whose clock is at a certain point relative to the goal.  

構文
remaining()
サポートされるフィールド
サポートされる演算子 = , !=, > , >= , < , <=
サポートされない演算子 ~ , 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 haxve an that is running, regardless of the calendar.

カレンダー時間に基づいて実行中の課題を検索するには、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()

Perform searches based on the start of the current day. See also startOfWeek()startOfMonth(), startOfYear()endOfDay()endOfWeek()endOfMonth(), and 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()

Perform searches based on the start of the current month. See also startOfDay()startOfWeek(), startOfYear(),  endOfDay()endOfWeek()endOfMonth(), and 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()

Perform searches based on the start of the current week. See also startOfDay()startOfMonth(), startOfYear()endOfDay()endOfWeek()endOfMonth(), and 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()

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

Perform searches based on issues for which you have voted. Also, see the Voter field.

This function can only be used by logged-in users.

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

^ ページのトップへ

watchedIssues()

Perform searches based on issues that you are watching. Also, see the Watcher field. 

This function can only be used by logged-in users.

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

^ ページのトップへ

withinCalendarHours()

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

Returns issues that have an that is running according to the calendar.

For example, say your project has two SLAs that count Time to First Response. Some issues with this 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 issues from the 9am-5pm agreement first. They can use withincalendarhours() to find all the issues where Time to First Response is running at 3pm.

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

^ ページのトップへ

最終更新日 2022 年 9 月 2 日

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

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