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 |
例 |
|
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 |
例 |
|
breached()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
直近の SLA で目標を達成できなかった課題を返します。
構文 | 1
breached() |
---|---|
サポートされるフィールド | SLA |
サポートされる演算子 | =,!= |
サポートされない演算子 | ~、!~、>、>=、<、<=、IS、IS NOT、IN、NOT IN、WAS、WAS IN、WAS NOT、WAS NOT IN、CHANGED |
例 |
|
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 |
例 |
|
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 , |
例 |
|
closedSprints()
完了したスプリントに割り当てられている課題を検索します。
完了したスプリントと未完了のスプリントの両方に 1 つの課題が属している場合もあります。openSprints() もご確認ください。
構文 | 1
closedSprints() |
---|---|
サポートされるフィールド | Sprint |
サポートされる演算子 | IN,NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= , IS , IS NOT, WAS , WAS IN , |
例 |
|
completed()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
1 つ以上のサイクルを完了した SLA を持つ課題を返します。
構文 | 1
completed() |
---|---|
サポートされるフィールド | SLA |
サポートされる演算子 | =,!= |
サポートされない演算子 | ~ , !~ , >, >= , < , <= , IS , IS NOT , IN , NOT IN , WAS , |
例 |
|
componentsLeadByUser()
特定のユーザーが主導しているコンポーネント内の課題を検索します。必要に応じてユーザーを指定できます。ユーザーを指定しない場合、現在のユーザー (自身) が使用されます。
Jira にログインしていない場合は、ユーザーを指定する必要があります。
構文 | 1
2
componentsLeadByUser()
componentsLeadByUser(username) |
---|---|
サポートされるフィールド | Component |
サポートされる演算子 | IN,NOT IN |
サポートされない演算子 | =、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、WAS NOT、WAS NOT IN、CHANGED |
例 |
|
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 |
例 |
|
currentUser()
現在のログイン ユーザーに基づいて検索を実行します。
この関数は、ログイン済みのユーザーのみが使用できます。したがって、匿名ユーザーが利用することを想定したフィルターを作成する場合、この関数を使うことはできません。
構文 | 1
currentUser() |
---|---|
サポートされるフィールド | Assignee, Reporter, Voter, Watcher, Creator, custom fields of type User |
サポートされる演算子 | =,!= |
サポートされない演算子 | ~ , !~ , > , >= , < , <= , IS , IS NOT , IN , NOT IN , WAS , |
例 |
|
customerDetail()
顧客の詳細に基づいて検索を実行します。
この JQL 関数を使用するには、[プロジェクト設定] の "機能" ページで [カスタマー サービス管理] をオンにします。
この関数は、最大 32000 のカスタマーを返します。
構文 | 1
customerDetail() |
---|---|
サポートされるフィールド | Assignee, Reporter, Voter, Watcher, custom fields of type User |
サポートされる演算子 | IN,NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= , IS , IS NOT , WAS , WAS IN , |
例 |
|
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 , |
例 |
|
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 |
例 |
|
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 |
例 |
|
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 |
例 |
|
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 |
例 |
|
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 , |
例 |
|
entitlementProduct()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
製品に基づいて検索を行います。
この JQL 関数を使用するには、[プロジェクト設定] の [機能] ページで [カスタマー サービス管理] と [製品とエンタイトルメント] を有効にします。
構文 | 1
entitlementProduct("Product Name") |
---|---|
サポートされるフィールド | エンタイトルメント |
サポートされる演算子 | IN,NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= , IS , IS NOT, WAS , WAS IN , |
例 |
|
everBreached()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
SLA 目標の 1 つを達成できなかった課題を返します。
構文 | 1
everBreached() |
---|---|
サポートされるフィールド | SLA |
サポートされる演算子 | =,!= |
サポートされない演算子 | ~ , > , >= , < , <= , IS , IS NOT , WAS , WAS IN , WAS NOT , |
例 |
|
futureSprints()
まだ開始されていないスプリントに割り当てられている課題を検索します。
完了したスプリントと未完了のスプリントの両方に 1 つの課題が属している場合もあります。
構文 | 1
futureSprints() |
---|---|
サポートされるフィールド | Sprint |
サポートされる演算子 | IN,NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= , IS , IS NOT, WAS , WAS IN , |
例 |
|
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 , |
例 |
|
issuesWithRemoteLinksByGlobalId()
指定されたグローバル ID のいずれかを持つリモート リンクに関連付けられている課題に基づいて検索を実行します。
この関数では 1 から 100 の globalId を指定できます。0、または 100 よりも大きい globalId を指定するとエラーになります。
構文 | 1
issuesWithRemoteLinksByGlobalId(globalId) |
---|---|
サポートされるフィールド | Issue |
サポートされる演算子 | IN,NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= , IS , IS NOT, WAS , WAS IN , |
例 |
|
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 |
例 |
|
latestReleasedVersion()
特定のプロジェクトのリリース済みバージョンの中で一番最後にリリースされたバージョンに基づいて検索を実行します。「releasedVersions()」も参照してください。
「最新」かどうかは、実際のバージョン期限ではなく、バージョンに割り当てられた序数に基づいて判断されます。
構文 | 1
latestReleasedVersion(project) |
---|---|
サポートされるフィールド | AffectedVersion, FixVersion, custom fields of type Version |
サポートされる演算子 | =,!= |
サポートされない演算子 | ~ , !~ , > , >= , < , <= , IS , IS NOT , IN , NOT IN , WAS , |
例 |
|
linkedissue
エピックとサブタスクを検索します。課題がエピックではない場合、検索結果はその課題のすべてのサブタスクを返します。
企業管理対象プロジェクトにのみ適用されます。
構文 | 1
linkedIssue = issueKey |
---|---|
サポートされるフィールド | Issue |
サポートされる演算子 | = , != , IN , NOT IN |
サポートされない演算子 | ~ , !~ , > , >= , < , <= , IS , IS NOT , WAS , WAS IN, WAS NOT , WAS NOT IN , CHANGED |
例 |
|
linkedIssues()
課題にリンクされている課題を検索します。特定のタイプのリンクに検索を制限できます。
構文 | 1
2
3
linkedIssues(issueKey)
linkedIssues(issueKey,CaseSensitiveLinkType)
linkedIssues(issueKey,CaseSensitiveLinkType, CaseSensitiveLinkType) |
---|---|
サポートされるフィールド | Issue |
サポートされる演算子 | IN,NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= , IS , IS NOT, WAS , WAS IN , |
例 |
|
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 |
例 |
|
myApproval()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
現在のユーザーが保留中または完了した承認ステップの承認者であり、そのリクエストをまだ承認または却下していない場合があるリクエストを検索します。
構文 | 1
myApproval() |
---|---|
サポートされるフィールド | Custom fields of type Approval |
サポートされる演算子 | = |
サポートされない演算子 | != , ~ , !~ , > , >= , < , <= , IS , IS NOT , IN , NOT IN , WAS , |
例 |
|
myPendingApproval()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
現在のユーザーが保留中の承認ステップの承認者で、まだ承認または却下していないリクエストを検索します。
構文 | 1
myPendingApproval() |
---|---|
サポートされるフィールド | Custom fields of type Approval |
サポートされる演算子 | = |
サポートされない演算子 | != , ~ , !~ , > , >= , < , <= , IS , IS NOT , IN , NOT IN , WAS , |
例 |
|
myPending()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
現在のユーザーが保留中の承認ステップの承認者であり、承認をまだ承認または却下していない場合があるリクエストを検索します。
構文 | 1
myPending() |
---|---|
サポートされるフィールド | Custom fields of type Approval |
サポートされる演算子 | = |
サポートされない演算子 | != , ~ , !~ , > , >= , < , <= , IS , IS NOT , IN , NOT IN , WAS , |
例 |
|
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 |
例 |
|
openSprints()
開始済みかつ未完了のスプリントに割り当てられている課題を検索します。
完了したスプリントと未完了のスプリントの両方に 1 つの課題が属している場合もあります。closedSprints() もご確認ください。
構文 | 1
openSprints() |
---|---|
サポートされるフィールド | Sprint |
サポートされる演算子 | IN,NOT IN |
サポートされない演算子 | =、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、WAS NOT、WAS NOT IN、CHANGED |
例 |
|
organizationDetail()
組織の詳細に基づいて検索を実行します。
この JQL 関数を使用するには、[プロジェクト設定] の "機能" ページで [カスタマー サービス管理] をオンにします。
This function will return up to 32,000 organizations.
構文 | 1
organizationDetail("Field Name", "Field Value") |
---|---|
サポートされるフィールド | 組織 |
サポートされる演算子 | IN,NOT IN |
サポートされない演算子 | =、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、WAS NOT、WAS NOT IN、CHANGED |
例 |
|
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 |
例 |
|
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 |
例 |
|
paused()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
特定の条件によって一時停止されている SLA を持つ課題を返します。
カレンダー時間外のために一時停止されている課題を検索するには、withincalendarhours() を使用します。
構文 | 1
paused() |
---|---|
サポートされるフィールド | SLA |
サポートされる演算子 | =,!= |
サポートされない演算子 | ~ , > , >= , < , <= , IS , IS NOT , WAS , WAS IN , WAS NOT , |
例 |
|
pending()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
承認ステップが保留中のリクエストを検索します。
構文 | 1
pending() |
---|---|
サポートされるフィールド | Custom fields of type Approval |
サポートされる演算子 | =,!= |
サポートされない演算子 | ~ , > , >= , < , <= , IS , IS NOT , WAS , WAS IN , WAS NOT , |
例 |
|
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 , |
例 |
|
projectsLeadByUser()
特定のユーザーが主導するプロジェクト内の課題を検索します。必要に応じてユーザーを指定できます。ユーザーを指定しない場合、現在のユーザーが使用されます。
注意事項として、JIRA にログインしていない場合は、ユーザーを指定する必要があります。
構文 | 1
2
projectsLeadByUser()
projectsLeadByUser(username) |
---|---|
サポートされるフィールド | Project |
サポートされる演算子 | IN,NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= , IS , IS NOT, WAS , WAS IN , |
例 |
|
projectsWhereUserHasPermission()
自身が特定の権限を持つプロジェクト内で課題を検索します。この関数はプロジェクト レベルで実行されます。つまり、プロジェクトで権限 ([課題を編集] など) が課題の報告者に付与されている場合、自身が報告者ではない (したがって権限が指定されていない) 課題が返される可能性があります。
Jira にログインしているユーザーのみがこの関数を利用できます。
構文 | 1
projectsWhereUserHasPermission(permission) permission パラメータには、企業管理対象プロジェクトの権限で説明されている任意の権限を指定できます。 |
---|---|
サポートされるフィールド | Project |
サポートされる演算子 | IN,NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= , IS , IS NOT, WAS , WAS IN , |
例 |
|
projectsWhereUserHasRole()
自身が特定のロールを持っているプロジェクト内で課題を検索します。
Jira にログインしているユーザーのみがこの関数を利用できます。
構文 | 1
projectsWhereUserHasRole(rolename) |
---|---|
サポートされるフィールド | Project |
サポートされる演算子 | IN,NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= , IS , IS NOT, WAS , WAS IN , |
例 |
|
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 , |
例 |
|
remaining()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
SLA サイクルの終了に対し、SLA クロックが特定の相対的なタイミングにある課題を返します。
構文 | 1
remaining() |
---|---|
サポートされるフィールド | SLA |
サポートされる演算子 | = , != , > , >= , < , <= |
サポートされない演算子 | ~ , !~ , IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED |
例 |
|
running()
Jira Service Management サブスクリプションがあるサイトにのみ適用されます。
カレンダーにかかわらず、実行中の SLA を持つ課題を返します。
カレンダー時間に基づいて実行中の課題を検索するには、withincalendarhours() を使用します。
構文 | 1
running() |
---|---|
サポートされるフィールド | SLA |
サポートされる演算子 | =,!= |
サポートされない演算子 | ~ , > , >= , < , <= , IS , IS NOT , WAS , WAS IN , WAS NOT , |
例 |
|
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 |
サポートされない演算子 | =、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、WAS NOT、WAS NOT IN、CHANGED |
例 |
|
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 |
例 |
|
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 |
例 |
|
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 |
例 |
|
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 |
例 |
|
subtaskIssueTypes()
サブタスクである課題に基づいて検索を実行します。standardIssueTypes() もご確認ください。
構文 | 1
subtaskIssueTypes() |
---|---|
サポートされるフィールド | タイプ |
サポートされる演算子 | IN,NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= , IS , |
例 |
|
unreleasedVersions()
特定のプロジェクトの未リリース バージョン (つまり、Jira 管理者がまだリリースしていないバージョン) に基づいて検索を実行します。project パラメーターを省略することで、すべてのプロジェクトの未リリース バージョンを対象に検索を実行することもできます。「earliestUnreleasedVersion()」も参照してください。
構文 | 1
2
unreleasedVersions()
unreleasedVersions(project) |
---|---|
サポートされるフィールド | AffectedVersion, FixVersion, custom fields of type Version |
サポートされる演算子 | IN,NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= , IS , |
例 |
|
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 |
サポートされない演算子 | =、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、WAS NOT IN、WAS NOT、CHANGED |
例 |
|
votedIssues()
自身が投票した課題に基づいて検索を実行します。Voter フィールドもご確認ください。この関数は、ログイン済みのユーザーのみが使用できます。
This function will return up to 32,000 issue IDs.
構文 | 1
votedIssues() |
---|---|
サポートされるフィールド | Issue |
サポートされる演算子 | IN,NOT IN |
サポートされない演算子 | =、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、WAS NOT IN、WAS NOT、CHANGED |
例 |
|
watchedIssues()
自身がウォッチしている課題に基づいて検索を実行します。Watcher フィールドもご確認ください。この関数は、ログイン済みのユーザーのみが使用できます。
This function will return up to 32,000 issue IDs.
構文 | 1
watchedIssues() |
---|---|
サポートされるフィールド | Issue |
サポートされる演算子 | IN,NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= , IS , |
例 |
|
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 , |
例 |
|
この内容はお役に立ちましたか?