• 使用を開始する
  • 関連ドキュメント

JQL 関数

This page describes information about functions that are used for advanced searching. Additional JQL functions may also be available through installed apps.

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

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

approved()

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

Search for all requests that have an approval with a final decision of approved.

構文

1 approved()

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

Custom fields of type Approval

サポートされる演算子

=

サポートされない演算子

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

  • 承認済みのすべてのリクエストを検索:
    approvals = approved()

approver()

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

Search for requests where any specified user is an approver for a pending or completed approval step, and may or may not have already approved or declined the approval. You must specify a username.

構文

1 approver(user1, user2)

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

Custom fields of type 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 で目標を達成できなかった課題を返します。

構文

1 breached()

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

SLA

サポートされる演算子

=,!=

サポートされない演算子

~!~>>=<<=ISIS NOTINNOT INWASWAS INWAS NOTWAS NOT INCHANGED

  • Find issues where an SLA (“Time to First Response) was breached:
    "Time to First Response" = breached()

cascadeOption()

Search for issues that match the selected values of a Cascading Select custom field.

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

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

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

構文

1 2 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")

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

choiceOption()

Search for issues that match the selected IDs of a Multiple Choice or Dropdown custom field.

Requires at least one argument. For multiple arguments, returns the ID of each one. Arguments must be valid option values. In cases where the argument could be both an ID and the option value, returns issues where the option value matches.

構文

1 2 choiceOption(ValueOption) choiceOption(ValueOption1,ValueOption2,ValueOption3)

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

Custom fields of types Multiple Choice and Dropdown

サポートされる演算子

IN,NOT IN

サポートされない演算子

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

  • Find issues where a custom field ("Product Version") has the value
    ”123”:
    "Product Version[Select List (multiple choices)]" in choiceOption(123)

closedSprints()

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

完了したスプリントと未完了のスプリントの両方に 1 つの課題が属している場合もあります。openSprints() もご確認ください。

構文

1 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 を持つ課題を返します。 

構文

1 completed()

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

SLA

サポートされる演算子

=,!=

サポートされない演算子

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

  • Find issues where an SLA (“Time to First Response”) has completed at least one cycle:
    "Time to First Response" = completed()

componentsLeadByUser()

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

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

構文

1 2 componentsLeadByUser() componentsLeadByUser(username)

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

Component

サポートされる演算子

IN,NOT IN

サポートされない演算子

=!=~!~>>=<<=ISIS NOTWASWAS INWAS NOTWAS NOT INCHANGED

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

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

currentLogin()

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

構文

1 currentLogin()

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

Created, Due, Resolved, Updated, custom fields of type Date/Time

サポートされる演算子

= , != , > , >= , < , <= , WAS* , WAS IN* , WAS NOT* , WAS NOT IN*, CHANGED*

* Only in predicate 

サポートされない演算子

~ , !~ , IS , IS NOT , IN , NOT IN

  • Find issues that have been created during your current session:
    created > currentLogin()

currentUser()

現在のログイン ユーザーに基づいて検索を実行します。 

この関数は、ログイン済みのユーザーのみが使用できます。したがって、匿名ユーザーが利用することを想定したフィルターを作成する場合、この関数を使うことはできません。

構文

1 currentUser()

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

Assignee, Reporter, Voter, Watcher, Creator, custom fields of type User

サポートされる演算子

=,!=

サポートされない演算子

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

  • Find issues that are assigned to you:
    assignee = currentUser()

  • Find issues that were reported by you but are not assigned to you:
    reporter = currentUser() AND assignee != currentUser()

customerDetail()

顧客の詳細に基づいて検索を実行します。

この JQL 関数を使用するには、[プロジェクト設定] の "機能" ページで [カスタマー サービス管理] をオンにします。

この関数は、最大 32000 のカスタマーを返します。

構文

1 customerDetail()

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

Assignee, Reporter, Voter, Watcher, custom fields of type User

サポートされる演算子

IN,NOT IN

サポートされない演算子

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

  • Find all requests reported by customers in the APAC region:
    reporter in customerDetail("Region", "APAC")

  • Find all requests reported by customers who are not technical contacts:
    reporter not in customerDetail("Role", "Technical Contact")

earliestUnreleasedVersion()

Perform searches based on the earliest unreleased version in a project. See also unreleasedVersions().

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

構文

1 earliestUnreleasedVersion(project)

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

AffectedVersion, FixVersion, custom fields of type Version

サポートされる演算子

=,!=

サポートされない演算子

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

  • Find issues whose fix version is the earliest unreleased version of the “ABC” project:
    fixVersion = earliestUnreleasedVersion(ABC)

  • Find issues that relate to the earliest unreleased version of the “ABC” project:
    affectedVersion = earliestUnreleasedVersion(ABC) or fixVersion = earliestUnreleasedVersion(ABC)

endOfDay()

検索実行日の最終時刻に基づいて検索を実行します。

See also endOfWeek(), endOfMonth(), endOfYear(), startOfDay(), startOfWeek(), startOfMonth(), and startOfYear().

構文

1 2 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.

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

Created, Due, Resolved, Updated, custom fields of type Date/Time

サポートされる演算子

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

サポートされない演算子

~ , !~ , IS , IS NOT , IN , NOT IN

  • 期限が今日中である課題を検索:
    due < endOfDay()

  • 期限が明日中である課題を検索:
    due < endOfDay("+1")

endOfMonth()

検索実行日の月末に基づいて検索を実行します。

See also endOfDay(), endOfWeek(), endOfYear(), startOfDay(), startOfWeek(), startOfMonth(), and startOfYear().

構文

1 2 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.

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

Created, Due, Resolved, Updated, custom fields of type Date/Time

サポートされる演算子

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

サポートされない演算子

~ , !~ , IS , IS NOT , IN , NOT IN

  • 期限が今月中である課題を検索:
    due < endOfMonth()

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

  • 期限が来月の 15 日である課題を検索
    due < endOfMonth("+15d")

endOfWeek()

期日が今週中である課題を検索します。既定では、この関数は週の最終日を土曜日とみなします。週の最終日として別の日 (日曜日など) を使用することもできます。以下の例の構文を参照してください。 

See also endOfDay(), endOfMonth(), endOfYear(), startOfDay(), startOfWeek(), startOfMonth(), and startOfYear().

構文

1 2 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.

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

Created, Due, Resolved, Updated, custom fields of type Date/Time

サポートされる演算子

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

サポートされない演算子

~ , !~ , IS , IS NOT , IN , NOT IN

  • 期日が今週中である課題 (初期設定では最終日は土曜日) を検索:
    due < endOfWeek()

  • 期日が今週中である課題を検索 (最終日は日曜日):
    due < endOfWeek("+1d")

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

endOfYear()

検索実行日の年末に基づいて検索を実行します。

See also endOfDay(), endOfWeek(), endOfMonth(), startOfDay(), startOfWeek(), startOfMonth(), and startOfYear().

構文

1 2 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.

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

Created, Due, Resolved, Updated, custom fields of type Date/Time

サポートされる演算子

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

サポートされない演算子

~ , !~ , IS , IS NOT , IN , NOT IN

  • 期限が今年中である課題を検索:
    due < endOfYear()

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

entitlementDetail()

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

エンタイトルメントの詳細に基づいて検索を実行します。

この JQL 関数を使用するには、[プロジェクト設定] の [機能] ページで [カスタマー サービス管理] と [製品とエンタイトルメント] を有効にします。

This function will return up to 32,000 entitlements.

構文

1 entitlementDetail("Field Name", "Field Value")

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

エンタイトルメント

サポートされる演算子

IN,NOT IN

サポートされない演算子

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

  • Find all issues related to an entitlement where the “Support Level” is “Gold”:
    entitlement in entitlementDetail("Support Level", "Gold")

entitlementProduct()

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

製品に基づいて検索を行います。

この JQL 関数を使用するには、[プロジェクト設定] の [機能] ページで [カスタマー サービス管理] と [製品とエンタイトルメント] を有効にします。

構文

1 entitlementProduct("Product Name")

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

エンタイトルメント

サポートされる演算子

IN,NOT IN

サポートされない演算子

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

  • Find all issues related to entitlements for the product “Acme Widget”:
    entitlement in entitlementProduct("Acme Widget")

everBreached()

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

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

構文

1 everBreached()

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

SLA

サポートされる演算子

=,!=

サポートされない演算子

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

  • 初回応答時間の目標を達成できなかった課題を検索:
    "Time to First Response" = everBreached()

futureSprints()

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

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

構文

1 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 50 issues, whereas the 'Recent Issues' dropdown returns only 5.

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

構文

1 issueHistory()

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

Issue

サポートされる演算子

IN,NOT IN

サポートされない演算子

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

  • Find issues which you have recently viewed, that are assigned to you:
    issue in issueHistory() AND assignee = currentUser()

issuesWithRemoteLinksByGlobalId()

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

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

構文

1 issuesWithRemoteLinksByGlobalId(globalId)

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

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

構文

1 lastLogin()

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

Created, Due, Resolved, Updated, custom fields of type Date/Time

サポートされる演算子

= , != , > , >= , < , <= , WAS* , WAS IN* , WAS NOT* , WAS NOT IN*, CHANGED*

* Only in predicate 

サポートされない演算子

~ , !~ , IS , IS NOT , IN , NOT IN

  • Find issues that have been created during your last session:
    created > lastLogin()

latestReleasedVersion()

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

「最新」かどうかは、実際のバージョン期限ではなく、バージョンに割り当てられた序数に基づいて判断されます。

構文

1 latestReleasedVersion(project)

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

AffectedVersion, FixVersion, custom fields of type Version

サポートされる演算子

=,!=

サポートされない演算子

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

  • Find issues whose fix version is the latest released version of the “ABC” project:
    fixVersion = latestReleasedVersion(ABC)

  • Find issues that relate to the latest released version of the “ABC” project:
    affectedVersion = latestReleasedVersion(ABC) or fixVersion = latestReleasedVersion(ABC)

linkedissue

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

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

構文

1 linkedIssue = issueKey

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

Issue

サポートされる演算子

= , != , IN , NOT IN

サポートされない演算子

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

  • Find subtasks that are linked to a particular epic:
    linkedIssue = epicKey-123

linkedIssues()

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

構文

1 2 3 linkedIssues(issueKey) linkedIssues(issueKey,CaseSensitiveLinkType) linkedIssues(issueKey,CaseSensitiveLinkType, 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")

  • 指定されたタイプのリンクで特定の課題にリンクしている課題を検索:

    issue in linkedIssues(ABC-123, "is duplicated by", "is blocked by")

membersOf()

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

構文

1 membersOf(Group)

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

Assignee, Reporter, Voter, Watcher, Creator, custom fields of type User

サポートされる演算子

IN , NOT IN , WAS IN , WAS NOT IN

サポートされない演算子

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

  • Find issues where the assignee is a member of the group
    "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 サブスクリプションがあるサイトにのみ適用されます。

現在のユーザーが保留中または完了した承認ステップの承認者であり、そのリクエストをまだ承認または却下していない場合があるリクエストを検索します。

構文

1 myApproval()

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

Custom fields of type Approval

サポートされる演算子

=

サポートされない演算子

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

  • Find all requests that require your approval:
    approval = myApproval()

myPendingApproval()

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

現在のユーザーが保留中の承認ステップの承認者で、まだ承認または却下していないリクエストを検索します。

構文

1 myPendingApproval()

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

Custom fields of type Approval

サポートされる演算子

=

サポートされない演算子

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

  • Find all requests that currently require your approval:
    approvals = myPendingApproval()

myPending()

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

現在のユーザーが保留中の承認ステップの承認者であり、承認をまだ承認または却下していない場合があるリクエストを検索します。

構文

1 myPending()

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

Custom fields of type Approval

サポートされる演算子

=

サポートされない演算子

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

  • Find all requests that currently or previously required your approval
    approvals = myPending()

now()

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

構文

1 now()

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

Created, Due, Resolved, Updated, custom fields of type 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() もご確認ください。

構文

1 openSprints()

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

Sprint

サポートされる演算子

IN,NOT IN

サポートされない演算子

=!=~!~>>=<<=ISIS NOTWASWAS INWAS NOTWAS NOT INCHANGED

  • 未完了のスプリントに割り当てられた課題を検索:
    sprint in openSprints()

organizationDetail()

組織の詳細に基づいて検索を実行します。

この JQL 関数を使用するには、[プロジェクト設定] の "機能" ページで [カスタマー サービス管理] をオンにします。

This function will return up to 32,000 organizations.

構文

1 organizationDetail("Field Name", "Field Value")

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

組織

サポートされる演算子

IN,NOT IN

サポートされない演算子

=!=~!~>>=<<=ISIS NOTWASWAS INWAS NOTWAS NOT INCHANGED

  • Find all requests shared with organizations in the APAC region:
    organizations in organizationDetail("Region", "APAC")

  • Find all requests shared with organizations that are not in a platinum support level
    organizations not in organizationDetail("Support level", "Platinum")

  • Find all unresolved requests shared with organizations that joined on 2023-08-24 where the date is in YYYY-MM-DD format: resolution = Unresolved AND Organizations in organizationDetail("Joined on", "2023-08-24")

  • Consider a multi-select dropdown that can contain up to two values (option1 and option2). To create a query for all the organizations where both values are present:

    resolution = Unresolved AND Organizations in organizationDetail("Options", "option1") AND Organizations in organizationDetail("Options", "option2")

organizationMembers()

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

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

構文

1 organizationMembers()

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

Assignee, Reporter, Voter, Watcher, custom fields of type User

サポートされる演算子

IN , NOT IN , WAS IN , WAS NOT IN

サポートされない演算子

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

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

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

parentEpic

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

Search for issues and subtasks that are linked to an epic. 

構文

1 parentEpic = issuekey

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

Issue

サポートされる演算子

= , != , IN , NOT IN

サポートされない演算子

~ , !~ , > , >= , < , <= , IS , IS NOT , 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() を使用します。

構文

1 paused()

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

SLA

サポートされる演算子

=,!=

サポートされない演算子

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

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

pending()

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

承認ステップが保留中のリクエストを検索します。

構文

1 pending()

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

Custom fields of type Approval

サポートされる演算子

=,!=

サポートされない演算子

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

  • Find all requests that are awaiting approval:
    approvals = pending()

pendingBy()

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

Search for requests where any specified user is an approver for a pending approval step, and may or may not have already approved or declined the request. You must specify a username.

構文

1 pendingBy(user1, user2)

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

Custom fields of type Approval

サポートされる演算子

=,!=

サポートされない演算子

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

  • John Smith による承認が必要なリクエストを検索:
    approvals = pendingBy(jsmith)

  • Find requests that require approval by John Smith or Sarah Khan:
    approvals = pendingBy(jsmith, skhan)

projectsLeadByUser()

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

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

構文

1 2 projectsLeadByUser() projectsLeadByUser(username)

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

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 にログインしているユーザーのみがこの関数を利用できます。

構文

1 projectsWhereUserHasPermission(permission)

permission パラメータには、企業管理対象プロジェクトの権限で説明されている任意の権限を指定できます。

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

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 にログインしているユーザーのみがこの関数を利用できます。

構文

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

構文

1 2 releasedVersions() releasedVersions(project)

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

AffectedVersion, FixVersion, custom fields of type 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 クロックが特定の相対的なタイミングにある課題を返します。  

構文

1 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() を使用します。

構文

1 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 subtasks. See also subtaskIssueTypes().

構文

1 standardIssueTypes()

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

タイプ

サポートされる演算子

IN,NOT IN

サポートされない演算子

=!=~!~>>=<<=ISIS NOTWASWAS INWAS NOTWAS NOT INCHANGED

  • サブタスクではない課題 (サブタスク意外の通常の課題タイプを持つ課題) を検索:
    issuetype in standardIssueTypes()

startOfDay()

検索実行日の開始時刻に基づいて検索を実行します。

See also startOfWeek(), startOfMonth(), startOfYear(), endOfDay(), endOfWeek(), endOfMonth() and endOfYear().

構文

1 2 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.

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

Created, Due, Resolved, Updated, custom fields of type Date/Time

サポートされる演算子

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

サポートされない演算子

~ , !~ , IS , IS NOT , IN , NOT IN

  • 今日作成された課題を検索:
    created > startOfDay()

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

  • 過去 3 日間で作成された課題を検索:
    created > startOfDay("-3d")

startOfMonth()

検索実行日の月初に基づいて検索を実行します。

See also startOfDay(), startOfWeek() startOfYear(), endOfDay(), endOfWeek(), endOfMonth() and endOfYear().

構文

1 2 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.

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

Created, Due, Resolved, Updated, custom fields of type Date/Time

サポートされる演算子

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

サポートされない演算子

~ , !~ , IS , IS NOT , IN , NOT IN

  • 今月作成された課題を検索:
    created > startOfMonth()

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

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

startOfWeek()

今週作成された新しい課題を検索します。既定では、この関数は週の開始日を日曜日とみなします。週の開始日として別の日 (月曜日など) を使用することもできます。以下の例の構文を参照してください。 

See also startOfDay(), startOfMonth(), startOfYear(), endOfDay(), endOfWeek(), endOfMonth() and endOfYear().

構文

1 2 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.

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

Created, Due, Resolved, Updated, custom fields of type Date/Time

サポートされる演算子

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

サポートされない演算子

~ , !~ , IS , IS NOT , IN , NOT IN

  • 今週作成された新しい課題を検索 (既定では週の初めは日曜日)
    created > startOfWeek()

  • 今週作成された新しい課題を検索 (週の初めは月曜日):
    created > startOfWeek("+1d")

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

startOfYear()

検索実行日の年始に基づいて検索を実行します。

See also startOfDay(), startOfWeek(), startOfMonth(), endOfDay(), endOfWeek(), endOfMonth() and endOfYear().

構文

1 2 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. startOfYear("+1") is the same as startOfYear("+1y"). If the plus/minus (+/-) sign is omitted, plus (+) is assumed.

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

Created, Due, Resolved, Updated, custom fields of type Date/Time

サポートされる演算子

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

サポートされない演算子

~ , !~ , IS , IS NOT , IN , NOT IN

  • 今年作成された課題を検索:
    created > startOfYear()

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

subtaskIssueTypes()

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

構文

1 subtaskIssueTypes()

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

タイプ

サポートされる演算子

IN,NOT IN

サポートされない演算子

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

  • サブタスクである課題 (課題タイプがサブタスク課題タイプである課題) を検索:
    issuetype in subtaskIssueTypes()

unreleasedVersions()

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

構文

1 2 unreleasedVersions() unreleasedVersions(project)

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

AffectedVersion, FixVersion, custom fields of type Version

サポートされる演算子

IN,NOT IN

サポートされない演算子

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

  • Find issues whose fix version is an unreleased version of the “ABC” project:
    fixVersion in unreleasedVersions(ABC)

  • Find issues that relate to unreleased versions of the “ABC” project:
    affectedVersion in unreleasedVersions(ABC)

updatedBy()

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

This function will return up to 32,000 issue IDs.

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

"yyyy/MM/dd"
"yyyy-MM-dd"

"w" (週) または "d" (日) を使用して現在の時刻に対する相対的な日付を指定することもできます。他の関数とは異なり、updatedBy では 1 日よりも小さい値はサポートされず、常に 1 日に切り上げられます。

構文

1 2 3 updatedBy(user) updatedBy(user, dateFrom) updatedBy(user, dateFrom, dateTo)

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

Issue

サポートされる演算子

IN,NOT IN

サポートされない演算子

=!=~!~>>=<<=ISIS NOTWASWAS INWAS NOT INWAS NOTCHANGED

  • 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 フィールドもご確認ください。この関数は、ログイン済みのユーザーのみが使用できます。

This function will return up to 32,000 issue IDs.

構文

1 votedIssues()

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

Issue

サポートされる演算子

IN,NOT IN

サポートされない演算子

=!=~!~>>=<<=ISIS NOTWASWAS INWAS NOT INWAS NOTCHANGED

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

watchedIssues()

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

This function will return up to 32,000 issue IDs.

構文

1 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 を持つ課題を返します。

For example, say your project has two SLAs that count Time to First Response. Some issues with this SLA 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.

構文

1 withinCalendarHours()

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

SLA

サポートされる演算子

= , !=

サポートされない演算子

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

  • Find issues where an SLA (“Time to First Response”) is within calendar hours:
    "Time to First Response" = withinCalendarHours()

 

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

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