高度な検索リファレンス - JQL 関数

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

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

検索クエリで指定されていないかぎり、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()

^ ページのトップへ



approver()

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

ユーザーによる承認が必要または必要だったリクエストを検索します。これは 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)

  • Find requests that require or required approval by John Smith or Sarah Khan: approvals = 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")

  • Find issues where a custom field ("Location") has the value "USA" for the first tier and any value (or no value) for the second tier:
    location in cascadeOption( "USA" )

  • Find issues where a custom field ("Location") has the value "USA" for the first tier and no value for the second tier:
    location in cascadeOption( "USA" ,none)

  • "Location" カスタム フィールドの 1 階層と 2 階層の両方に値を持たない課題を検索:
    location in cascadeOption(none)

  • Find issues where a custom field ("Referrer") has the value "none" for the first tier and "none" for the second tier:
    referrer in cascadeOption( "\"none\"" , "\"none\"" )

  • Find issues where a custom field ("Referrer") has the value "none" for the first tier and no value for the second tier:
    referrer in cascadeOption( "\"none\"" ,none)

^ ページのトップへ

closedSprints()

Search for issues that are assigned to a completed Sprint. Note, it is 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()

特定のユーザーがリードになっているコンポーネント内の課題を検索します。必要に応じてユーザーを指定できます。ユーザーを指定しない場合、現在のユーザー (操作者) が設定されます。Jira にログインしていない場合はユーザーを指定する必要があることにご注意ください。

構文

componentsLeadByUser() componentsLeadByUser(username)

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

Component

サポートされる演算子

IN , NOT IN

サポートされない演算子

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

例

  • 自身がリードであるコンポーネントのオープンな課題を検索:
    component in componentsLeadByUser() AND status = Open

  • Bill がリードであるコンポーネントのオープンな課題を検索:
    component in componentsLeadByUser(bill) AND status = Open

^ ページのトップへ

currentLogin()

現在のユーザーによるセッションの開始時間に基づいて検索を実行します。 lastLogin もご確認ください。

構文

currentLogin()

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

作成日、期限、解決日、更新日、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()

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

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

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

検索実行日の最終時刻に基づいて検索を実行します。endOfWeek、endOfMonth、endOfYear、startOfDay、startOfWeek、startOfMonth、および startOfYear もご確認ください。

構文

endOfDay() endOfDay("inc")

where inc is an optional increment of (+/-)nn(y|M|w|d|h|m). If the time unit qualifier is omitted, it defaults to the natural period of the function, e.g. endOfDay("+1") is the same as endOfDay("+1d"). If the plus/minus (+/-) sign is omitted, plus is assumed.

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

作成日、期限、解決日、更新日、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")

where inc is an optional increment of (+/-)nn(y|M|w|d|h|m). If the time unit qualifier is omitted, it defaults to the natural period of the function, e.g. endOfMonth("+1") is the same as endOfMonth("+1M"). If the plus/minus (+/-) sign is omitted, plus is assumed.

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

作成日、期限、解決日、更新日、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")

where inc is an optional increment of (+/-)nn(y|M|w|d|h|m). If the time unit qualifier is omitted, it defaults to the natural period of the function, e.g. endOfWeek("+1") is the same as endOfWeek("+1w"). If the plus/minus (+/-) sign is omitted, plus is assumed.

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

作成日、期限、解決日、更新日、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()

Perform searches based on the end of the current year. See also startOfDay, startOfWeek, and startOfMonth; and endOfDay, endOfWeek, endOfMonth, and endOfYear.

構文

endOfYear() endOfYear("inc")

where inc is an optional increment of (+/-)nn(y|M|w|d|h|m). If the time unit qualifier is omitted, it defaults to the natural period of the function, e.g. endOfYear("+1") is the same as endOfYear("+1y"). If the plus/minus (+/-) sign is omitted, plus is assumed.

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

作成日、期限、解決日、更新日、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 つを達成できなかった課題を返します。  

構文

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

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

注意:

  • [最近の課題] ドロップダウンでは課題が 5 件だけ返されるのに対して、issueHistory() では最大 50 件の課題が返されます。

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

構文

issueHistory()

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

Issue

サポートされる演算子

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

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

Issue

サポートされる演算子

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() という関数があります。"latest" はそのバージョンが利用する序数によって決定されます。バージョンの 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)

^ ページのトップへ

linkedissue

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

構文

linkedissue = issueKey

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

Issue

サポートされる演算子

=、!=

例

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

    linkedissue = epicKey-123

^ ページのトップへ

linkedIssues()

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

構文

linkedIssues(issueKey) linkedIssues(issueKey,CaseSensitiveLinkType)

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

Issue

サポートされる演算子

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

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

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

サポートされる演算子

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

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

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

構文

myApproval()

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

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

サポートされる演算子

=

サポートされない演算子

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

例

自身による承認が必要なすべてのリクエストを検索
approval = myApproval()

^ ページのトップへ



myPendingApproval()

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

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

構文

myPendingApproval()

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

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

サポートされる演算子

=

サポートされない演算子

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

例

現在、自身による承認が必要なすべてのリクエストを検索する
approvals = myPendingApproval()

^ ページのトップへ

myPending()

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

現在またはこれまでに、現在のユーザーによる承認を必要とするリクエストを検索します。

構文

myPending()

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

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

サポートされる演算子

=

サポートされない演算子

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

例

現在、または以前に自身による承認が必要だったすべてのリクエストを検索する
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()

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

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

構文

organizationMembers()

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

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

サポートされる演算子

IN , NOT IN , WAS IN , WAS NOT IN

サポートされない演算子

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

例

  • 組織 "Atlassian" のメンバーが送信したすべてのリクエストを検索:
    reporter in organizationMembers("Atlassian")

  • 組織 "Atlassian" または "ACME" のメンバー以外が送信したリクエストを検索:
    reporter not in organizationMembers("Atlassian","ACME")

^ ページのトップへ



parentEpic()

企業管理対象プロジェクトにのみ適用されます。

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

構文

parentEpic()

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

Issue

サポートされる演算子

= , != , IN , NOT IN

サポートされない演算子

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

例

  • エピック DEMO-123 の課題とサブタスクを検索:
    parentEpic = DEMO 123

  • エピック DEMO-1 または SAMPLE-4 の課題およびサブタスクを検索:
    parentEpic in (DEMO-1, SAMPLE-4)

^ ページのトップへ

paused()

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

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

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

構文

paused()

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

SLA

サポートされる演算子

= , !=

サポートされない演算子

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

例

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

pending()

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

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

構文

pending()

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

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

サポートされる演算子

=

サポートされない演算子

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

例

  • 承認が必要なすべてのリクエストを検索:
    approvals = pending()

^ ページのトップへ

pendingBy()

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

特定のユーザーによる承認が必要なリクエストを検索します。これは 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()

特定のユーザーが主導するプロジェクト内の課題を検索します。オプションでアカウント ID を指定できます。アカウント ID を指定しない場合は、現在のユーザー アカウントが使用されます。Jira にログインしていない場合は、アカウント ID を指定する必要があることにご注意ください。

構文

projectsLeadByUser() projectsLeadByUser(accountID)

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

Project

サポートされる演算子

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.

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

Project

サポートされる演算子

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)

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

Project

サポートされる演算子

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

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

カレンダー時間に基づいて実行中の課題を検索するには、withincalendarhours() を使用します。

構文

running()

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

SLA

サポートされる演算子

= , !=

サポートされない演算子

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

例

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

standardIssueTypes()

Perform searches based on "standard" Issue Types, that is, search for issues that are not sub-tasks. See also 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")

where inc is an optional increment of (+/-)nn(y|M|w|d|h|m). If the time unit qualifier is omitted, it defaults to the natural period of the function, e.g. startOfDay("+1") is the same as startOfDay("+1d"). If the plus/minus (+/-) sign is omitted, plus is assumed.

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

作成日、期限、解決日、更新日、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")

where inc is an optional increment of (+/-)nn(y|M|w|d|h|m). If the time unit qualifier is omitted, it defaults to the natural period of the function, e.g. startOfMonth("+1") is the same as startOfMonth("+1M"). If the plus/minus (+/-) sign is omitted, plus is assumed.

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

作成日、期限、解決日、更新日、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")

where inc is an optional increment of (+/-)nn(y|M|w|d|h|m). If the time unit qualifier is omitted, it defaults to the natural period of the function, e.g. startOfWeek("+1") is the same as startOfWeek("+1w"). If the plus/minus (+/-) sign is omitted, plus is assumed.

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

作成日、期限、解決日、更新日、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")

where inc is an optional increment of (+/-)nn(y|M|w|d|h|m). If the time unit qualifier is omitted, it defaults to the natural period of the function, e.g. endOfYear("+1") is the same as endOfYear("+1y"). If the plus/minus (+/-) sign is omitted, plus is assumed.

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

作成日、期限、解決日、更新日、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)

  • Find issues that were updated by John Smith within the last 8 days:
    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 日に切り上げられます。
    issuekey IN updatedBy(jsmith, "-1h")

^ ページのトップへ

votedIssues()

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

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

構文

votedIssues()

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

Issue

サポートされる演算子

IN , NOT IN

サポートされない演算子

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

例

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

^ ページのトップへ

watchedIssues()

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

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

構文

watchedIssues()

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

Issue

サポートされる演算子

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

^ ページのトップへ

さらにヘルプが必要ですか?

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