クラウド
Data Center
バージョン

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

詳細検索

このページの内容

関連コンテンツ

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

お困りですか?

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

コミュニティに質問

robotsnoindex


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

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

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

approved()

Only applicable for sites with Jira Service Management subscriptions.

承認が必要だったリクエストや、承認が最終決定済みのリクエストを検索します。

構文
approved()
サポートされるフィールドApproval タイプのカスタム フィールド
サポートされる演算子 =
サポートされない演算子

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

例
  • Find all requests that have been approved:
    approvals = approved()

^ ページのトップへ


approver()

Only applicable for sites with Jira Service Management subscriptions.

ユーザーによる承認が必要または必要だったリクエストを検索します。これは OR 演算子を使用し、ユーザー名を指定する必要があります。

構文
approver(user,user)
サポートされるフィールドApproval タイプのカスタム フィールド
サポートされる演算子 =
サポートされない演算子 ~ , != , !~ , > , >= , < , <= 
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()

Only applicable for sites with Jira Service Management subscriptions.

直近の 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()

完了したスプリントに割り当てられている課題を検索します。1 つの課題が完了したスプリントと未完了のスプリントの両方に所属することができる点にご注意ください。openSprints() もご確認ください。

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

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

^ ページのトップへ

completed()

Only applicable for sites with Jira Service Management subscriptions.

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

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

現在のログインユーザーに基づいて検索を実行します。ログインしたユーザーに対してのみ実行できることにご注意ください。したがって、匿名ユーザーが利用することを想定したフィルターを作成する場合、この関数を使うことはできません。

構文
currentUser()
サポートされるフィールド担当者、報告者、投票者、ウォッチャー、作成者、ユーザー タイプのカスタム フィールド
サポートされる演算子 = , !=
サポートされない演算子 ~ , !~ , > , >= , < , <= IS , IS NOT , IN , NOT IN , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
例

  • 自身に割り当てられた課題を検索:
    assignee = currentUser()

  • Find issues that were reported by me but are not assigned to me:

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

^ ページのトップへ

earliestUnreleasedVersion()

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

バージョンの順序は、プロジェクトの [リリース] ページにバージョンが表示される順序によって決まります。一覧の一番下のバージョンが "一番古い" ものとなります。バージョンの順序を変更するには、一覧でバージョンをドラッグ アンド ドロップして新しい場所に配置します。

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

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

IS, IS NOT, WAS, WAS NOT

サポートされない演算子IN, NOT IN, WAS IN, WAS NOT IN, CHANGED
例

  • FixVersion が ABC プロジェクトの一番古い未リリースのバージョンである課題を検索:
    fixVersion = earliestUnreleasedVersion(ABC)

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

^ ページのトップへ

elapsed()

Only applicable for sites with Jira Service Management subscriptions.

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

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

  • 期限が来週中である課題を検索:
    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()

Only applicable for sites with Jira Service Management subscriptions.

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

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

  • Find issues that have missed their goal for Time to First Response:
    "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() は最大 50 件の課題を返します。[最近表示した課題] ドロップダウンは 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)

^ ページのトップへ

linkedissue

エピックとサブタスクを検索します。課題がエピックではない場合、検索結果はその課題のすべてのサブタスクを返します。

構文
linkedissue = issueKey
サポートされるフィールド課題
サポートされる演算子=、!=
例
  • 特定のエピックにリンクされているサブタスクを検索:
    linkedissue = epicKey-123

^ ページのトップへ

linkedIssues()

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

構文
linkedIssues(issueKey)
linkedIssues(issueKey,CaseSensitiveLinkType)
サポートされるフィールド課題
サポートされる演算子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（グループ）
サポートされるフィールド担当者、報告者、投票者、ウォッチャー、作成者、ユーザー タイプのカスタム フィールド
サポートされる演算子IN , NOT IN , WAS IN , WAS NOT IN , CHANGED
サポートされない演算子= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS NOT 
例

  • 担当者が "jira-administrators" グループのメンバーである課題を検索:
    assignee in membersOf("jira-administrators")

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

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

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

^ ページのトップへ

myApproval()

Only applicable for sites with Jira Service Management subscriptions.

ログイン ユーザーによる承認が必要または必要だったリクエストを検索します。

構文
myApproval()
サポートされるフィールドApproval タイプのカスタム フィールド
サポートされる演算子 =
サポートされない演算子
~、!=、!~、>、>=、<、<= 
IS , IS NOT , IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED
例

Find all requests that required my approval
approval = myApproval()

^ ページのトップへ


myPendingApproval()

Only applicable for sites with Jira Service Management subscriptions.

現在、ログイン ユーザーによる承認が必要なリクエストを検索します。

構文
myPendingApproval()
サポートされるフィールドApproval タイプのカスタム フィールド
サポートされる演算子 =
サポートされない演算子 ~ , != , !~ , > , >= , < , <= 
IS , IS NOT , IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
例

Find all requests that currently require my approval
approvals = myPendingApproval()

^ ページのトップへ

myPending()

Only applicable for sites with Jira Service Management subscriptions.

Search for requests that currently or previously required approval by the current user.

構文
myPending()
サポートされるフィールドApproval タイプのカスタム フィールド
サポートされる演算子 =
サポートされない演算子 ~ , != , !~ , > , >= , < , <= 
IS , IS NOT , IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED
例

Find all requests that currently or previously required my approval
approvals = 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()

^ ページのトップへ

organizationMembers()

Only applicable for sites with Jira Service Management subscriptions.

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

構文
organizationMembers()
サポートされるフィールド担当者、報告者、投票者、ウォッチャー、User タイプのカスタム フィールド
サポートされる演算子IN , NOT IN , WAS IN , WAS NOT IN
サポートされない演算子= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS NOT , CHANGED
例

  • Find all requests sent by members of the organization Atlassian:
    reporter in organizationMembers("Atlassian")

  • Find requests sent by people who are not in the organizations Atlassian or ACME:
    reporter not in organizationMembers("Atlassian","ACME")

^ ページのトップへ


parentEpic()

Only applicable for company-managed projects.

エピックにリンクされている課題とサブタスクを検索します。 

構文
parentEpic()
サポートされるフィールド課題
サポートされる演算子 = , != , IN , NOT IN
サポートされない演算子 ~ , != , !~ , > , >= , < , <= 
IS , IS NOT , IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED
例
  • エピック DEMO-123 で課題とサブタスクを検索する:
    parentEpic = DEMO 123
  • Find issues and sub-tasks in the epic DEMO-1 or SAMPLE-4:
    parentEpic in (DEMO-1, SAMPLE-4)

^ ページのトップへ

paused()

Only applicable for sites with Jira Service Management subscriptions.

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

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

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

  • 初回応答時間が一時停止している課題を検索:
    "Time to First Response" = paused()

pending()

Only applicable for sites with Jira Service Management subscriptions.

承認が必要なリクエストを検索します。

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

^ ページのトップへ

pendingBy()

Only applicable for sites with Jira Service Management subscriptions.

特定のユーザーによる承認が必要なリクエストを検索します。これは OR 演算子を使用し、ユーザー名を指定する必要があります。

構文
pendingBy(user1,user2)
サポートされるフィールドApproval タイプのカスタム フィールド
サポートされる演算子 =
サポートされない演算子

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

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

例
  • John Smith による承認が必要なリクエストを検索:
     approvals = pendingBy(jsmith)
  • John Smith または Sarah Khan による承認が必要なリクエストを検索: approvals = pendingBy(jsmith,skhan)

^ ページのトップへ

projectsLeadByUser()

Find issues in projects that are led by a specific user. You can optionally specify an account ID, or if an account ID is omitted, the current user account will be used. Note that if you are not logged in to Jira, an account ID must be specified.

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

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

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

Only applicable for sites with Jira Service Management subscriptions.

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

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

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

running()

Only applicable for sites with Jira Service Management subscriptions.

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

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

  • 先週以降に作成された課題を検索:
    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()

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

この関数は最大 32000 の課題 ID を返します。

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

"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")
  • Find issues updated by John Smith between June and September 2021:
    issuekey IN updatedBy(jsmith, "2021/06/01", "2021/09/30")
  • 次の例のように過去 1 時間以内に更新された課題を検索しようとした場合、1 日よりも小さな値はサポートされないため、時間は 1 日に切り上げられます:
    issuekey IN updatedBy(jsmith, "-1h")

^ ページのトップへ

votedIssues()

自身が投票した課題に基づいて検索を実行します。Voter フィールドもご確認ください。この関数は、ログイン済みのユーザーのみが使用できます。

この関数は最大 32000 の課題 ID を返します。

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

  • 自身が投票した課題を検索:
    issue in votedIssues()

^ ページのトップへ

watchedIssues()

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

この関数は最大 32000 の課題 ID を返します。

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

  • 自身がウォッチしている課題を検索:
    issue in watchedIssues()

^ ページのトップへ

withinCalendarHours()

Only applicable for sites with Jira Service Management subscriptions.

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 年 2 月 23 日

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

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

関連コンテンツ

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