JQL 関数

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

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

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

approved()

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

承認され、最終決定が「承認済み」であるすべてのリクエストを検索します。

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

approver()

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

特定のユーザーが保留中または完了した承認ステップの承認者であり、承認をまだ承認または却下していない場合があるリクエストを検索します。これは OR 演算子を使用し、ユーザー名を指定する必要があります。

構文	`1approver(user,user)`
サポートされるフィールド	Approval タイプのカスタムフィールド
サポートされる演算子	=
サポートされない演算子	~ , != , !~ , >、>=、<、<= IS , IS NOT , IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED
例	John Smith による承認が必要または必要だったリクエストを検索: approvals = approver(jsmith) John Smith または Sarah Khan による承認が必要または必要だったリクエストを検索: approvals = approver(jsmith,skhan)

breached()

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

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

構文	`1breached()`
サポートされるフィールド	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" キーワードは、片方もしくは両方にのオプションに値を持たない課題を検索するときに使用します。

構文	`1 2cascadeOption(parentOption) cascadeOption(parentOption,childOption)`
サポートされるフィールド	"Cascading Select" タイプのカスタムフィールド
サポートされる演算子	IN , NOT IN
サポートされない演算子	= , != , ~ , !~ , > , >= , < , <= IS , IS NOT, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
例	"Location" カスタムフィールドの 1 階層の値が "USA"、2 階層の値が "New York" となっている課題を検索: location in cascadeOption("USA","New York") "Location" カスタムフィールドの 1 階層の値が "USA" となっているすべての課題 (2 階層目の値の内容や有無は問わない) を検索: location in cascadeOption("USA") "Location" カスタムフィールドの 1 階層の値が "USA" で 2 階層に値を持たない課題を検索: location in cascadeOption("USA",none) "Location" カスタムフィールドの 1 階層と 2 階層の両方に値を持たない課題を検索: location in cascadeOption(none) "Referrer" カスタムフィールドの 1 階層の値が "none" で 2 階層の値が "none" となっている課題を検索: referrer in cascadeOption("\"none\"","\"none\"") "Referrer" カスタムフィールドの 1 階層の値が "none" で 2 階層に値を持たない課題を検索: referrer in cascadeOption("\"none\"",none)

choiceOption()

複数選択またはドロップダウンのカスタムフィールドのオプションの基礎となる ID を提供します。たとえば、Yes、No、Unknown のオプションがある多肢選択フィールドでは、No を検索すると 2 が返されます。

少なくとも 1 つの引数が必要です。複数の引数の場合は、それぞれの ID を返します。引数は有効なオプション値でなければなりません。

構文	`1 2choiceOption(ValueOption) choiceOption(ValueOption1,ValueOption2,ValueOption3)`
サポートされるフィールド	タイプ multiple choice と dropdown のカスタムフィールド
サポートされる演算子	IN,NOT IN
サポートされない演算子	=、!=、~、!~、>、>=、<、<=、IS、IS NOT、WAS、WAS IN、WAS NOT、WAS NOT IN、CHANGED
例	オプションの数値（例えば productVersion: 121, 122, 123）を検索する場合: "productVersion[Select List (multiple choices)]" in choiceOption(123) 12345 が ID でもオプション値でもある場合は、オプション値が一致する課題を返します: "customFieldRelatedToSprint[Dropdown]" in choiceOption(12345)

closedSprints()

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

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

構文	`1closedSprints()`
サポートされるフィールド	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 を持つ課題を返します。

構文	`1completed()`
サポートされるフィールド	SLA
サポートされる演算子	= , !=
サポートされない演算子	~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
例	初回応答時間を 1 回以上達成した課題を検索: "Time to First Response" = completed()

componentsLeadByUser()

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

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

構文	`1 2componentsLeadByUser() 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 もご確認ください。

構文	`1currentLogin()`
サポートされるフィールド	作成日、期限、解決日、更新日、Date/Time タイプのカスタムフィールド
サポートされる演算子	= , != , > , >= , < , <= WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED* * Only in predicate
サポートされない演算子	~ , !~ IS , IS NOT , IN , NOT IN
例	現在のセッション中に作成された課題を検索: created > currentLogin()

currentUser()

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

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

構文	`1currentUser()`
サポートされるフィールド	担当者、報告者、投票者、ウォッチャー、作成者、ユーザータイプのカスタムフィールド
サポートされる演算子	= , !=
サポートされない演算子	~ , !~ , > , >= , < , <= IS , IS NOT , IN , NOT IN , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
例	自身に割り当てられた課題を検索: assignee = currentUser() 自分が報告したが自分に割り当てられていない課題を検索: `1reporter = currentUser() AND (assignee != currentUser() OR assignee is EMPTY)`

customerDetail()

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

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

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

構文	`1customerDetail( )`
サポートされるフィールド	担当者、報告者、投票者、ウォッチャー、User タイプのカスタムフィールド
サポートされる演算子	IN , NOT IN
サポートされない演算子	= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT IN, WAS NOT , CHANGED
例	APAC 地域のカスタマーから報告されたすべてのリクエストのキューを作成する: reporter in customerDetail("Region", "APAC") 技術担当者ではないカスタマーから報告されたすべてのリクエストのキューを作成する: reporter not in customerDetail("Role", "Technical Contact")

earliestUnreleasedVersion()

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

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

構文	`1earliestUnreleasedVersion(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)

everBreached()

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

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

構文	`1everbreached()`
サポートされるフィールド	SLA
サポートされる演算子	= , !=, > , >= , < , <=
サポートされない演算子	~ IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
例	初回応答を 1 時間より長く待機している課題を検索 "Time to First Response" > everbreached("1h")

endOfDay()

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

endOfWeek、endOfMonth、endOfYear、startOfDay、startOfWeek、startOfMonth、および startOfYear もご確認ください。

構文	`1 2endOfDay() endOfDay("inc")` inc は、(+/-)nn(y\|M\|w\|d\|h\|m). のオプションのインクリメントです。時間単位の修飾子が省略された場合、既定ではその関数の自然周期が設定されます。endOfDay("+1") は endOfDay("+1d") と同じと解釈されます。プラス/マイナス (+/-) 記号が省略された場合、プラスと見なされます。
サポートされるフィールド	作成日、期限、解決日、更新日、Date/Time タイプのカスタムフィールド
サポートされる演算子	= , != , > , >= , < , <= WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED** Only in predicate
サポートされない演算子	~ , !~ IS , IS NOT , IN , NOT IN
例	期限が今日中である課題を検索: due < endOfDay() 期限が明日中である課題を検索: due < endOfDay("+1")

endOfMonth()

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

endOfDay、endOfWeek、endOfYear、startOfDay、startOfWeek、startOfMonth、および startOfYear もご確認ください。

構文	`1 2endOfMonth() endOfMonth("inc")` inc は、(+/-)nn(y\|M\|w\|d\|h\|m). のオプションのインクリメントです。時間単位の修飾子が省略された場合、既定ではその関数の自然周期が設定されます。endOfMonth("+1") は endOfMonth("+1M") と同じと解釈されます。プラス/マイナス (+/-) 記号が省略された場合、プラスと見なされます。
サポートされるフィールド	作成日、期限、解決日、更新日、Date/Time タイプのカスタムフィールド
サポートされる演算子	= , != , > , >= , < , <= WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED** Only in predicate
サポートされない演算子	~ , !~ IS , IS NOT , IN , NOT IN
例	期限が今月中である課題を検索: due < endOfMonth() 期限が来月中である課題を検索: due < endOfMonth("+1") 期限が来月の 15 日である課題を検索 due < endOfMonth("+15d")

endOfWeek()

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

endOfDay、endOfMonth、endOfYear、startOfDay、startOfWeek、startOfMonth、および startOfYear もご確認ください。

構文	`1 2endOfWeek() endOfWeek("inc")` inc は、(+/-)nn(y\|M\|w\|d\|h\|m). のオプションのインクリメントです。時間単位の修飾子が省略された場合、既定ではその関数の自然周期が設定されます。endOfWeek("+1") は endOfWeek("+1w") と同じと解釈されます。プラス/マイナス (+/-) 記号が省略された場合、プラスと見なされます。
サポートされるフィールド	作成日、期限、解決日、更新日、Date/Time タイプのカスタムフィールド
サポートされる演算子	= , != , > , >= , < , <= WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED** Only in predicate
サポートされない演算子	~ , !~ IS , IS NOT , IN , NOT IN
例	期日が今週中である課題 (初期設定では最終日は土曜日) を検索: due < endOfWeek() 期日が今週中である課題を検索 (最終日は日曜日): due < endOfWeek("+1d") 期限が来週中である課題を検索: due < endOfWeek("+1")

endOfYear()

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

startOfDay、startOfWeek、startOfMonth、endOfDay、endOfWeek、endOfMonth、およびendOfYear もご確認ください。

構文	`1 2endOfYear() endOfYear("inc")` inc は、(+/-)nn(y\|M\|w\|d\|h\|m). のオプションのインクリメントです。時間単位の修飾子が省略された場合、既定ではその関数の自然周期が設定されます。endOfYear("+1") は endOfYear("+1y") と同じと解釈されます。プラス/マイナス (+/-) 記号が省略された場合、プラスと見なされます。
サポートされるフィールド	作成日、期限、解決日、更新日、Date/Time タイプのカスタムフィールド
サポートされる演算子	= , != , > , >= , < , <= WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED** Only in predicate
サポートされない演算子	~ , !~ IS , IS NOT , IN , NOT IN
例	期限が今年中である課題を検索: due < endOfYear() 期限が来年の 3 月中である課題を検索: due < endOfYear("+3M")

entitlementDetail()

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

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

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

この関数は、最大 32000 のエンタイトルメントを返します。

構文	`1entitlementDetail("Field Name", "Field Value")`
サポートされるフィールド	エンタイトルメント
サポートされる演算子	IN , NOT IN
サポートされない演算子	= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT IN, WAS NOT , CHANGED
例	「Support Level」が「Gold」のエンタイトルメントに関連するすべての課題のキューを作成する entitlement in entitlementDetail("Support Level", "Gold")

entitlementProduct()

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

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

構文	`1entitlementProduct("ProductName")`
サポートされるフィールド	エンタイトルメント
サポートされる演算子	IN , NOT IN
サポートされない演算子	= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT IN, WAS NOT , CHANGED
例	製品「Acme Widget」のエンタイトルメントに関連するすべての課題のキューを作成する entitlement in entitlementProduct("Acme Widget")

everBreached()

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

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

構文	`1everbreached()`
サポートされるフィールド	SLA
サポートされる演算子	= , !=
サポートされない演算子	~, > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
例	初回応答時間の目標を達成できなかった課題を検索: "Time to First Response" = everbreached()

futureSprints()

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

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

構文	`1futureSprints()`
サポートされるフィールド	Sprint
サポートされる演算子	IN , NOT IN
サポートされない演算子	= , != , ~ , !~ , > , >= , < , <= IS , IS NOT, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
例	未開始のスプリントに割り当てられているすべての課題を検索: sprint in futureSprints()

issueHistory()

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

注意:

[最近の課題] ドロップダウンでは課題が 5 件だけ返されるのに対して、issueHistory() では最大 50 件の課題が返されます。
Jira にログインしていない場合、現在のブラウザセッションから取得した課題のみが含まれます。

構文	`1issueHistory()`
サポートされるフィールド	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 を指定するとエラーになります。

構文	`1issuesWithRemoteLinksByGlobalId()`
サポートされるフィールド	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 もご確認ください。

構文	`1lastLogin()`
サポートされるフィールド	作成日、期限、解決日、更新日、Date/Time タイプのカスタムフィールド
サポートされる演算子	= , != , > , >= , < , <= WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED** Only in predicate
サポートされない演算子	~ , !~ IS , IS NOT , IN , NOT IN
例	前回のセッション中に作成された課題を検索: created > lastLogin()

latestReleasedVersion()

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

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

構文	`1latestReleasedVersion(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

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

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

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

linkedIssues()

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

構文	`1 2 3linkedIssues(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()

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

構文	`1membersOf(Group)`
サポートされるフィールド	担当者、報告者、投票者、ウォッチャー、作成者、ユーザータイプのカスタムフィールド
サポートされる演算子	IN , NOT IN , WAS IN , WAS NOT IN
サポートされない演算子	= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS NOT , CHANGED
例	担当者が "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 サブスクリプションがあるサイトにのみ適用されます。

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

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

myPendingApproval()

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

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

構文	`1myPendingApproval()`
サポートされるフィールド	Approval タイプのカスタムフィールド
サポートされる演算子	=
サポートされない演算子	~ , != , !~ , >、>=、<、<= IS , IS NOT , IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN, CHANGED
例	現在、自身による承認が必要なすべてのリクエストを検索する approvals = myPending()

myPending()

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

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

構文	`1myPending()`
サポートされるフィールド	Approval タイプのカスタムフィールド
サポートされる演算子	=
サポートされない演算子	~ , != , !~ , >、>=、<、<= IS , IS NOT , IN , NOT IN , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED
例	現在、または以前に自身による承認が必要だったすべてのリクエストを検索する approvals = myPending()

now()

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

構文	`1now()`
サポートされるフィールド	作成日、期限、解決日、更新日、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() もご確認ください。

構文	`1openSprints()`
サポートされるフィールド	Sprint
サポートされる演算子	IN , NOT IN
サポートされない演算子	= , != , ~ , !~ , > , >= , < , <= IS , IS NOT, WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
例	未完了のスプリントに割り当てられた課題を検索: sprint in openSprints()

organizationDetail()

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

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

この関数は、最大 32000 の組織を返します。

構文	`1organizationDetail()`
サポートされるフィールド	組織
サポートされる演算子	IN , NOT IN
サポートされない演算子	= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT IN, WAS NOT , CHANGED
例	APAC 地域の組織と共有されているすべてのリクエストのキューを作成する: organizations in organizationDetail("Region", "APAC") プラチナサポートレベルではない組織と共有されているすべてのリクエストのキューを作成する: organizations not in organizationDetail("Support level", "Platinum") YYYY-MM-DD 形式の日付で 2023 年 8 月 24 日に参加した組織と共有されているすべての未解決リクエストのキューを作成する: resolution = Unresolved AND Organizations in organizationDetail("Joined on", "2023-08-24") 最大 2 つの値 (オプション 1 とオプション 2) を含む複数選択ドロップダウンを考えてみましょう。両方の値が存在するすべての組織のキューを作成するには、次の手順に従います。 resolution = Unresolved AND Organizations in organizationDetail("Options", "option1") AND Organizations in organizationDetail("Options", "option2")

organizationMembers()

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

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

構文	`1organizationMembers()`
サポートされるフィールド	担当者、報告者、投票者、ウォッチャー、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()

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

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

構文	`1parentEpic()`
サポートされるフィールド	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() を使用します。

構文	`1paused()`
サポートされるフィールド	SLA
サポートされる演算子	= , !=
サポートされない演算子	~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
例	初回応答時間が一時停止している課題を検索: "Time to First Response" = paused()

pending()

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

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

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

pendingBy()

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

特定のユーザーが保留中の承認ステップの承認者であり、そのリクエストをまだ承認または拒否している場合があるリクエストを検索します。これは OR 演算子を使用し、ユーザー名を指定する必要があります。

構文	`1pendingBy(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()

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

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

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

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

構文	`1projectsWhereUserHasRole(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()

指定したプロジェクトで、リリースバージョン (Jira 管理者がリリースしたバージョン) に基づいた検索を行います。project パラメーターを省略することで、すべてのプロジェクトのリリース済みバージョンを検索できます。latestReleasedVersion() もご確認ください。

構文	`1 2releasedVersions() 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 クロックが特定の相対的なタイミングにある課題を返します。

構文	`1remaining()`
サポートされるフィールド	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() を使用します。

構文	`1running()`
サポートされるフィールド	SLA
サポートされる演算子	= , !=
サポートされない演算子	~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
例	初回応答時間の計測が実行中の課題を検索: "Time to First Response" = running()

standardIssueTypes()

"標準" 課題タイプに基づいて検索を実行します。つまり、サブタスク以外の課題を検索します。subtaskIssueTypes() もご確認ください。

構文	`1standardIssueTypes()`
サポートされるフィールド	タイプ
サポートされる演算子	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 もご確認ください。

構文	`1 2startOfDay() startOfDay("inc")` inc は、(+/-)nn(y\|M\|w\|d\|h\|m). のオプションのインクリメントです。時間単位の修飾子が省略された場合、既定ではその関数の自然周期が設定されます。startOfDay("+1") は startOfDay("+1d") と同じと解釈されます。プラス/マイナス (+/-) 記号が省略された場合、プラスと見なされます。
サポートされるフィールド	作成日、期限、解決日、更新日、Date/Time タイプのカスタムフィールド
サポートされる演算子	= , != , > , >= , < , <= WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED** Only in predicate
サポートされない演算子	~ , !~ IS , IS NOT , IN , NOT IN
例	今日作成された課題を検索: created > startOfDay() 昨日以降に作成された課題を検索: created > startOfDay("-1") 過去 3 日間で作成された課題を検索: created > startOfDay("-3d")

startOfMonth()

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

構文	`1 2startOfMonth() startOfMonth("inc")` inc は、(+/-)nn(y\|M\|w\|d\|h\|m). のオプションのインクリメントです。時間単位の修飾子が省略された場合、既定ではその関数の自然周期が設定されます。startOfMonth("+1") は startOfMonth("+1M") と同じと解釈されます。プラス/マイナス (+/-) 記号が省略された場合、プラスと見なされます。
サポートされるフィールド	作成日、期限、解決日、更新日、Date/Time タイプのカスタムフィールド
サポートされる演算子	= , != , > , >= , < , <= WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED** Only in predicate
サポートされない演算子	~ , !~ IS , IS NOT , IN , NOT IN
例	今月作成された課題を検索: created > startOfMonth() 先月の 1 日以降に作成された課題を検索: created > startOfMonth("-1") 今月の 15 日以降に作成された新しい課題を検索 created > startOfMonth("+14d")

startOfWeek()

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

startOfDay、startOfMonth、startOfYear、endOfDay、endOfWeek、endOfMonth、および endOfYear も参照してください。

構文	`1 2startOfWeek() startOfWeek("inc")` inc は、(+/-)nn(y\|M\|w\|d\|h\|m). のオプションのインクリメントです。時間単位の修飾子が省略された場合、既定ではその関数の自然周期が設定されます。startOfWeek("+1") は startOfWeek("+1w") と同じと解釈されます。プラス/マイナス (+/-) 記号が省略された場合、プラスと見なされます。
サポートされるフィールド	作成日、期限、解決日、更新日、Date/Time タイプのカスタムフィールド
サポートされる演算子	= , != , > , >= , < , <= WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED** Only in predicate
サポートされない演算子	~ , !~ IS , IS NOT , IN , NOT IN
例	今週作成された新しい課題を検索 (既定では週の初めは日曜日) created > startOfWeek() 今週作成された新しい課題を検索 (週の初めは月曜日): created > startOfWeek("+1d") 先週以降に作成された課題を検索: created > startOfWeek("-1")

startOfYear()

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

同様の関数に startOfDay, startOfWeek, startOfMonth, endOfDay, endOfWeek, endOfMonth, endOfYearといった関数もあります。

構文	`1 2startOfYear() startOfYear("inc")` inc は、(+/-)nn(y\|M\|w\|d\|h\|m). のオプションのインクリメントです。時間単位の修飾子が省略された場合、既定ではその関数の自然周期が設定されます。endOfYear("+1") は endOfYear("+1y") と同じと解釈されます。プラス/マイナス (+/-) 記号が省略された場合、プラスと見なされます。
サポートされるフィールド	作成日、期限、解決日、更新日、Date/Time タイプのカスタムフィールド
サポートされる演算子	= , != , > , >= , < , <= WAS* , WAS IN* , WAS NOT* , WAS NOT IN* , CHANGED** Only in predicate
サポートされない演算子	~ , !~ IS , IS NOT , IN , NOT IN
例	今年作成された課題を検索: created > startOfYear() 昨年以降に作成された課題を検索: created > startOfYear("-1")

subtaskIssueTypes()

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

構文	`1subtaskIssueTypes()`
サポートされるフィールド	タイプ
サポートされる演算子	IN , NOT IN
サポートされない演算子	= , != , ~、!~、> , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
例	サブタスクである課題 (課題タイプがサブタスク課題タイプである課題) を検索: issuetype in subtaskIssueTypes()

unreleasedVersions()

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

構文	`1 2unreleasedVersions() 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 日に切り上げられます。

構文	`1 2 3updatedBy(user) updatedBy(user, dateFrom) updatedBy(user, dateFrom, dateTo)`
サポートされるフィールド	Issuekey、およびそのエイリアス (id、issue、key)
サポートされる演算子	IN , NOT IN
サポートされない演算子	=, ~ , != , !~ , >、>=、<、<= IS , IS NOT , WAS, WAS IN, WAS NOT, WAS NOT IN , CHANGED
例	John Smith が更新した課題を検索: issuekey IN updatedBy(jsmith) John Smith が過去 8 日間以内に更新した課題を検索 issuekey IN updatedBy(jsmith, "-8d") 2018 年の 6 月から 9 月の間に更新された課題を検索 issuekey IN updatedBy(jsmith, "2018/06/01", "2018/08/31") 以下の例のように過去 1 時間以内に更新された課題を検索する場合、小さな値はサポートされないため、1 日に切り上げられます。 issuekey IN updatedBy(jsmith, "-1h")

votedIssues()

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

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

構文	`1votedIssues()`
サポートされるフィールド	Issue
サポートされる演算子	IN , NOT IN
サポートされない演算子	= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
例	自身が投票した課題を検索: issue in votedIssues()

watchedIssues()

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

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

構文	`1watchedIssues()`
サポートされるフィールド	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 時時点で初回応答時間が実行中のすべての課題を検索できます。

構文	`1withinCalendarHours()`
サポートされるフィールド	SLA
サポートされる演算子	= , !=
サポートされない演算子	~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
例	初回応答時間がカレンダー時間内の課題を検索: "Time to First Response" = withinCalendarHours()

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

正確ではなかった

明確ではなかった

関係なかった

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

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

コミュニティに質問