詳細検索 - 関数リファレンス
approver()
Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。
リスト内の 1 人以上のユーザーによる承認が必要な課題または必要だった課題を検索します。OR
演算子を使用し、ユーザー名を指定する必要があります。
構文 | approver(user,user) |
---|---|
サポートされるフィールド | Approval タイプのカスタム フィールド |
サポートされる演算子 | = |
サポートされない演算子 | |
例 |
|
breached()
Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。
直近で目標を達成できなかった課題を返します。
構文 | breached() |
---|---|
サポートされるフィールド | |
サポートされる演算子 | = , != |
サポートされない演算子 | |
例 |
|
cascadeOption()
"cascading select" カスタム フィールドで選択された値と一致する課題を検索します。
parentOption
パラメーターは、cascading select フィールドの第 1 階層のオプションに対応します。childOption
パラメーターは、cascading select フィールドの第 2 階層のオプションに対応し、省略可能です。
"none"
キーワードは、片方もしくは両方に値を持たない課題を検索するときに使用します。
構文 | cascadeOption(parentOption) cascadeOption(parentOption,childOption) |
---|---|
サポートされるフィールド | "Cascading Select" タイプのカスタム フィールド |
サポートされる演算子 | IN , NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= , |
例 |
|
closedSprints()
完了したスプリントに割り当てられている課題を検索します。
1 つの課題が完了したスプリントと未完了のスプリントの両方に属する可能性もあります。「openSprints()」も参照してください。
構文 | closedSprints() |
---|---|
サポートされるフィールド | Sprint |
サポートされる演算子 | IN , NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= |
例 |
|
completed()
Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。
1 つ以上のサイクルが完了した課題を返します。
構文 | completed() |
---|---|
サポートされるフィールド | |
サポートされる演算子 | = , != |
サポートされない演算子 | = , |
例 |
|
componentsLeadByUser()
特定のユーザーが主導するコンポーネント内の課題を検索します。必要に応じてユーザーを指定できます。ユーザーを指定しない場合、現在のユーザー (自身) が使用されます。
Jira にログインしていない場合は、ユーザーを指定する必要があります。
構文 | componentsLeadByUser() componentsLeadByUser(username) |
---|---|
サポートされるフィールド | コンポーネント |
サポートされる演算子 | IN , NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= , |
例 |
|
currentLogin()
現在のユーザーによるセッションの開始時間に基づいて検索を実行します。「lastLogin()」も参照してください。
構文 | currentLogin() |
---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 | = , != ,
|
サポートされない演算子 | ~ , !~ , |
例 |
|
currentUser()
Perform searches based on the currently logged-in user.
この関数は、ログイン済みのユーザーのみが使用できます。匿名ユーザーが利用することを想定した保存済みフィルターを作成する場合は、この関数を使用しないでください。
構文 | currentUser() |
---|---|
サポートされるフィールド | 担当者、報告者、投票者、ウォッチャー、User タイプのカスタム フィールド |
サポートされる演算子 | = , != |
サポートされない演算子 | ~ , !~ , |
例 |
|
earliestUnreleasedVersion()
特定のプロジェクトの未リリースのバージョンの中で一番古いバージョンに基づいて検索を実行します。「unreleasedVersions」も参照してください。
"一番古い" かどうかは、実際のバージョン期限ではなく、バージョンに割り当てられた序数に基づいて判断されることに留意してください。
構文 | earliestUnreleasedVersion(project) |
---|---|
サポートされるフィールド | 影響バージョン、修正バージョン、Version タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 | IN , NOT IN |
例 |
|
elapsed()
Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。
サイクルの開始イベントに対し、クロックが特定の相対的なタイミングにある課題を返します。
構文 | elapsed() |
---|---|
サポートされるフィールド | |
サポートされる演算子 | = , != , |
サポートされない演算子 | |
例 |
|
endOfDay()
検索実行日の最終時刻に基づいて検索を実行します。「endOfWeek()」、「endOfMonth()」、「endOfYear()」、「startOfDay()」、「startOfWeek()」、「startOfMonth()」、および「startOfYear()」も参照してください。
構文 | endOfDay() endOfDay("inc")
|
---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 | ~ , !~ , |
例 |
|
endOfMonth()
検索実行日の月末に基づいて検索を実行します。「endOfDay()」、「endOfWeek()」、「endOfYear()」、「startOfDay()」、「startOfWeek()」、「startOfMonth()」、および「startOfYear()」も参照してください。
構文 | endOfMonth() endOfMonth("inc")
|
---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 | ~ , !~ , |
例 |
|
endOfWeek()
検索実行日の週末に基づいて検索を実行します。「endOfDay()」、「endOfMonth()」、「endOfYear()」、「startOfDay()」、「startOfWeek()」、「startOfMonth()」、および「startOfYear」も参照してください。
endOfWeek()
関数については、結果はロケールにより異なります。たとえば、週の初日は、ヨーロッパでは一般に月曜日と見なされますが、米国では日曜日と見なされます。
構文 | endOfWeek() endOfWeek("inc")
|
---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 | ~ , !~ , |
例 |
|
endOfYear()
検索実行日の年末に基づいて検索を実行します。「startOfDay()」、「startOfWeek()」、「startOfMonth()」、「endOfDay()」、「endOfWeek()」、「endOfMonth()」、および「endOfYear()」も参照してください。
構文 | endOfYear() endOfYear("inc")
|
---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 | ~ , !~ , |
例 |
|
everBreached()
Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。
目標の 1 つを達成できなかった課題を返します。
構文 | elapsed() |
---|---|
サポートされるフィールド | |
サポートされる演算子 | = , != |
サポートされない演算子 | |
例 |
|
futureSprints()
まだ開始されていないスプリントに割り当てられている課題を検索します。
1 つの課題が完了したスプリントと未完了のスプリントの両方に属する可能性もあります。
構文 | futureSprints() |
---|---|
サポートされるフィールド | Sprint |
サポートされる演算子 | IN , NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= |
例 |
|
issueHistory()
最近閲覧した課題、つまり [課題] ドロップダウン メニューの [最近の課題] セクションにある課題を検索します。
注意:
issueHistory()
は最大 60 件の課題を返すのに対し、[最近の課題] ドロップダウンは 5 件のみを返します。- Jira にログインしていない場合、現在のブラウザ セッションから取得した課題のみが含まれます。
90 日よりも古い課題は、スケジュールされたジョブによって毎日削除されます。
構文 | issueHistory() |
---|---|
サポートされるフィールド | 課題 |
サポートされる演算子 |
|
サポートされない演算子 |
, |
例 |
|
issuesWithRemoteLinksByGlobalId()
指定されたグローバル ID のいずれかを持つリモート リンクに関連付けられている課題に基づいて検索を実行します。
この関数では 1 から 100 の globalId を指定できます。0、または 100 よりも大きい globalId を指定するとエラーになります。
構文 | issuesWithRemoteLinksByGlobalId() |
---|---|
サポートされるフィールド | 課題 |
サポートされる演算子 |
|
サポートされない演算子 |
, |
例 |
|
lastLogin()
現在のユーザーによる前回のセッションの開始時間に基づいて検索を実行します。「currentLogin()」も参照してください。
構文 | lastLogin() |
---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
latestReleasedVersion()
特定のプロジェクトのリリース済みバージョンの中で一番最後にリリースされたバージョンに基づいて検索を実行します。「releasedVersions()」も参照してください。
"一番最後" かどうかは、実際のバージョン期限ではなく、バージョンに割り当てられた序数に基づいて判断されることに留意してください。
構文 | latestReleasedVersion(project) |
---|---|
サポートされるフィールド | 影響バージョン、修正バージョン、Version タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
linkedIssues()
特定の課題にリンクされている課題に基づいて検索を実行します。検索を特定のタイプのリンクに制限することもできます。
LinkType では大文字と小文字が区別されることに注意してください。
構文 | linkedIssues(issueKey) linkedIssues(issueKey,linkType) |
---|---|
サポートされるフィールド | 課題 |
サポートされる演算子 |
|
サポートされない演算子 |
, |
例 |
|
membersOf()
特定のグループのメンバーに基づく検索を実施します。
構文 | membersOf(グループ) |
---|---|
サポートされるフィールド | 担当者、報告者、投票者、ウォッチャー、User タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 |
, |
例 |
|
myApproval()
Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。
現在のユーザーによる承認が必要または必要だった課題を検索します。
構文 | myApproval() |
---|---|
サポートされるフィールド | Approval タイプのカスタム フィールド |
サポートされる演算子 | = |
サポートされない演算子 | ~ > , >= , < , <=
|
例 |
|
myPending()
Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。
現在のユーザーによる承認が必要な課題を検索します。
構文 | myPending() |
---|---|
サポートされるフィールド | Approval タイプのカスタム フィールド |
サポートされる演算子 | = |
サポートされない演算子 | ~ > , >= , < , <=
|
例 |
|
now()
現在の時刻に基づいた検索を行います。
構文 | now() |
---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 |
|
例 |
|
openSprints()
未完了のスプリントに割り当てられている課題を検索します。
1 つの課題が完了したスプリントと未完了のスプリントの両方に属する可能性もあります。「closedSprints()」も参照してください。
構文 | openSprints() |
---|---|
サポートされるフィールド | Sprint |
サポートされる演算子 | IN , NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= |
例 |
|
outdated()
Only applicable if Jira Service Management (Server) is installed and licensed.
Returns issues whose SLAs are out of date because someone has changed the SLA in the settings. After the site reindexes and recalculates the SLAs, the function shouldn't return any issues. Use this function if a reindex is taking a long time or if you've deferred the reindex because you're making a lot of changes.
構文 | outdated() |
---|---|
サポートされるフィールド | |
サポートされる演算子 | = , != |
サポートされない演算子 | ~ , !~ , > , >= , < , <= , IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED |
例 |
|
paused()
Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。
特定の条件によって一時停止されている SLA を持つ課題を返します。
カレンダー時間外のために一時停止されている課題を検索するには、withincalendarhours() を使用します。
構文 | paused() |
---|---|
サポートされるフィールド | |
サポートされる演算子 | = , != |
サポートされない演算子 | |
例 |
|
pending()
Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。
承認が必要な課題を検索します。
構文 | pending() |
---|---|
サポートされるフィールド | Approval タイプのカスタム フィールド |
サポートされる演算子 | = |
サポートされない演算子 | ~ > , >= , < , <=
|
例 |
|
pendingBy()
Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。
リスト内の 1 人以上のユーザーによる承認が必要な課題を検索します。OR
演算子を使用し、ユーザー名を指定する必要があります。
構文 | pendingBy(user1,user2) |
---|---|
サポートされるフィールド | Approval タイプのカスタム フィールド |
サポートされる演算子 | = |
サポートされない演算子 | ~ > , >= , < , <=
|
例 |
|
projectsLeadByUser()
特定のユーザーが主導するプロジェクト内の課題を検索します。必要に応じてユーザーを指定できます。ユーザーを指定しない場合、現在のユーザーが使用されます。
Jira にログインしていない場合は、ユーザーを指定する必要があります。
構文 | projectsLeadByUser() projectsLeadByUser(username) |
---|---|
サポートされるフィールド | プロジェクト |
サポートされる演算子 | IN , NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= |
例 |
|
projectsWhereUserHasPermission()
自身が特定の権限を持つプロジェクト内で課題を検索します。この関数は、プロジェクト レベルで実行されます。たとえば、プロジェクトで課題の報告者に特定の権限 ("課題の編集" など) が付与されている場合、自身が報告者ではない (したがって権限を持たない) 課題が返される可能性があります。この関数は、Jira にログインしている場合にのみ利用できます。
構文 | projectsWhereUserHasPermission(permission)
|
---|---|
サポートされるフィールド | プロジェクト |
サポートされる演算子 | IN , NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= |
例 |
|
projectsWhereUserHasRole()
自身が特定のロールを持っているプロジェクトの課題を検索します。この関数は、Jira にログインしている場合にのみ利用できます。
構文 | projectsWhereUserHasRole(rolename) |
---|---|
サポートされるフィールド | プロジェクト |
サポートされる演算子 | IN , NOT IN |
サポートされない演算子 | = , != , ~ , !~ , > , >= , < , <= |
例 |
|
releasedVersions()
指定したプロジェクトで、リリース バージョン (Jira 管理者がリリースしたバージョン) に基づいた検索を行います。project パラメーターを省略することで、すべてのプロジェクトのリリース済みバージョンを検索できます。latestReleasedVersion() もご確認ください。
構文 | releasedVersions() releasedVersions(project) |
---|---|
サポートされるフィールド | 影響バージョン、修正バージョン、Version タイプのカスタム フィールド |
サポートされる演算子 | IN , NOT IN |
サポートされない演算子 |
|
例 |
|
remaining()
Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。
目標に対し、クロックが特定の相対的なタイミングにある課題を返します。
構文 | remaining() |
---|---|
サポートされるフィールド | |
サポートされる演算子 | = , !=, |
サポートされない演算子 | |
例 |
|
running()
Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。
カレンダーにかかわらず、実行中の SLA を持つ課題を返します。
カレンダー時間に基づいて実行中の課題を検索するには、withincalendarhours() を使用します。
構文 | running() |
---|---|
サポートされるフィールド | |
サポートされる演算子 | = , != |
サポートされない演算子 | |
例 |
|
standardIssueTypes()
"標準" 課題タイプに基づいて検索を実行します。つまり、サブタスク以外の課題を検索します。subtaskIssueTypes() もご確認ください。
構文 | standardIssueTypes() |
---|---|
サポートされるフィールド | タイプ |
サポートされる演算子 | IN , NOT IN |
サポートされない演算子 |
|
例 |
|
startOfDay()
検索実行日の開始時刻に基づいて検索を実行します。「startOfWeek()」、「startOfMonth()」、「startOfYear()」、「endOfDay()」、「endOfWeek()」、「endOfMonth()」、および「endOfYear()」も参照してください。
構文 | startOfDay() startOfDay("inc")
|
---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 | ~ , !~ , |
例 |
|
startOfMonth()
検索実行日の月初に基づいて検索を実行します。「startOfDay()」、「startOfWeek()」、「startOfYear()」、「endOfDay()」、「endOfWeek()」、「endOfMonth()」、および「endOfYear()」も参照してください。
構文 | startOfMonth() startOfMonth("inc")
|
---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 | ~ , !~ , |
例 |
|
startOfWeek()
検索実行日の週初めに基づいて検索を実行します。「startOfDay()」、「startOfMonth()」、「startOfYear()」、「endOfDay()」、「endOfWeek()」、「endOfMonth()」、および「endOfYear()」も参照してください。
startOfWeek() 関数の場合、結果はロケールにより異なります。たとえば、ヨーロッパでは、週の初日は一般的に月曜日ですが、米国では日曜日とみなされます。
構文 | startOfWeek() startOfWeek("inc")
|
---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 | ~ , !~ , |
例 |
|
startOfYear()
検索実行日の年始に基づいて検索を実行します。「startOfDay()」、「startOfWeek()」、「startOfMonth()」、「endOfDay()」、「endOfWeek()」、「endOfMonth()」、および「endOfYear」も参照してください。
構文 | startOfYear() startOfYear("inc")
|
---|---|
サポートされるフィールド | 作成日、期限、解決日、更新日、Date/Time タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 | ~ , !~ , |
例 |
|
subtaskIssueTypes()
サブタスクである課題に基づいて検索を実行します。standardIssueTypes() もご確認ください。
構文 | subtaskIssueTypes() |
---|---|
サポートされるフィールド | タイプ |
サポートされる演算子 | IN , NOT IN |
サポートされない演算子 |
|
例 |
|
unreleasedVersions()
特定のプロジェクトの未リリース バージョン (つまり、Jira 管理者がまだリリースしていないバージョン) に基づいて検索を実行します。project
パラメーターを省略することで、すべてのプロジェクトの未リリース バージョンを対象に検索を実行することもできます。「earliestUnreleasedVersion()」も参照してください。
構文 | unreleasedVersions() unreleasedVersions(project) |
---|---|
サポートされるフィールド | 影響バージョン、修正バージョン、Version タイプのカスタム フィールド |
サポートされる演算子 |
|
サポートされない演算子 |
, |
例 |
|
updatedBy()
特定のユーザーが更新した課題を検索できます。オプションで期間も指定できます。ここでいう更新とは、課題の作成、課題のフィールドの更新、コメントの作成または削除、またはコメントの編集 (直前の編集のみ) を含みます。
時間範囲については、以下の形式のいずれかを使用します。
"yyyy/MM/dd"
"yyyy-MM-dd"
"w"
(週) または "d"
(日) を使用して現在の時刻に対する相対的な日付を指定することもできます。他の関数とは異なり、updatedBy
では 1 日よりも小さい値はサポートされず、常に 1 日に切り上げられます。
構文 | updatedBy(user) updatedBy(user, dateFrom) updatedBy(user, dateFrom, dateTo) |
---|---|
サポートされるフィールド | Issuekey 、およびそのエイリアス (id 、issue 、key ) |
サポートされる演算子 |
|
サポートされない演算子 | |
例 |
|
votedIssues()
自身が投票した課題に基づいて検索を実行します。[Voter (投票者)] フィールドも参照してください。
この関数は、ログイン済みのユーザーのみが使用できます。
構文 | votedIssues() |
---|---|
サポートされるフィールド | 課題 |
サポートされる演算子 |
|
サポートされない演算子 |
, |
例 |
|
watchedIssues()
自身がウォッチしている課題に基づいて検索を実行します。[Watcher (ウォッチャー)] フィールドも参照してください。
この関数は、ログイン済みのユーザーのみが使用できます。
構文 | watchedIssues() |
---|---|
サポートされるフィールド | 課題 |
サポートされる演算子 |
|
サポートされない演算子 |
, |
例 |
|
withinCalendarHours()
Jira Service Management がインストールされていてライセンスが付与されている場合にのみ適用可能です。
Returns issues that have an SLA that is running according to the calendar.
たとえば、プロジェクトに、初回応答時間をカウントする 2 つの SLA があるとします。これを使用する一部の課題では午前 9 時 - 午後 1 時のカレンダーを使用し、他の課題では午前 9 時 - 午後 5 時のカレンダーを使用します。エージェントが午後 3 時に作業を開始する場合、おそらく午前 9 時 - 午後 5 時の SLA にある課題から作業を行います。withincalendarhours() を使用して、午後 3 時時点で初回応答時間が実行中のすべての課題を検索できます。
構文 | withinCalendarHours() |
---|---|
サポートされるフィールド | |
サポートされる演算子 | |
サポートされない演算子 |
|
例 |
|