(9.9-ja_JP) synapseRT JQL リファレンス

JQL クエリで以下の JQL 関数が synapseRT 関連検索用に提供されています。

testSuite()

testSuite() JQL 関数の使用例を以下に示します。

なお、この JQL 関数は 'project = <projectKey>' と共に使用する必要があります。

ID	用途	説明
1	project = <projectKey> AND issue in testSuite()	指定した Jira プロジェクトからの任意のテストスイートでテストケースを検索します。
2	project = <projectKey> AND issue in testSuite('Test Suite Name')	指定した Jira プロジェクトからのルートテストスイートでテストケースを検索します。
3	project = <projectKey> AND issue in testSuite('Test Suite 1/Sub Test Suite')	指定した Jira プロジェクトからの特定のテストスイートでテストケースを検索します (ルートテストスイート内)
4	project = <projectKey> AND issue in testSuite('Test Suite 1','Test Suite 2')	指定した Jira プロジェクトからの複数の特定のテストスイートでテストケースを検索します。
5	project = <projectKey> AND issue not in testSuite()	指定した Jira プロジェクトからのテストスイートにないテストケースを検索します。

stepText()

stepText() JQL 関数の使用例を以下に示します。

ID	用途	説明
1	issue in stepText("")	テストステップを含まないテストケースを検索します。
2	issue in stepText("Texts")	テストステップに <テキスト> というテキストを含むテストケースを検索します。

hasRequirements()

hasRequirements() JQL 関数の使用例を以下に示します。

なお、この JQL では入れ子関数がサポートされています。

ID	用途	説明
1	issue in hasRequirements()	要件が関連付けられているテストケースを検索します。
2	issue in hasRequirements('issueKey1','issueKey2')	指定の要件が関連付けられているテストケースを検索します。
3	issue not in hasRequirements() and type = 'Test Case'	要件が関連付けられていないテストケースを検索します。
4	issue in hasRequirements('project = <projectKey> AND component = "<Component Name>"') 注意 : 外側の引用符は単一引用符 ' にする必要があります。これを使用しない場合、構文エラーが返されます。	要件セットに関連付けられているテストケースを検索します。これらの要件は入れ子関数 (project = projectName AND component = "Component Name") で返されます。

hasTestCases()

hasTestCases() JQL 関数の使用例を以下に示します。

なお、この JQL では入れ子関数がサポートされています。

ID	用途	説明
1	issue in hasTestCases()	テストケースが関連付けられている要件を検索します。
2	issue in hasTestCases('issueKey1','issueKey2')	指定のテストケースが関連付けられている要件を検索します。
3	issue not in hasTestCases() and type = 'Requirement'	テストケースが関連付けられていない要件を検索します。
4	issue in hasTestCases('project = <projectKey> AND component = "<Component Name">') 注意 : 外側の引用符は単一引用符 ' にする必要があります。これを使用しない場合、構文エラーが返されます。	テストケースセットが関連付けられている要件を検索します。これらのテストケースは入れ子関数 ('project = <projectKey> AND component = "<Component Name">') で返されます。

requirementSuite()

requirementSuite() JQL 関数の使用例を以下に示します。

ID	用途	説明
1	issue in requirementSuite()	任意の要件スイートで要件を検索します。
2	issue in requirementSuite('Requirement Suite Name')	ルート要件スイートで要件を検索します。
3	issue in requirementSuite('Requirement Suite 1/Sub Requirement Suite')	(ルート要件スイート内の) 指定要件スイートの要件を検索します。
4	issue in requirementSuite('Requirement Suite 1','Requirement Suite 1')	複数の指定要件スイートで要件を検索します。
5	issue not in requirementSuite()	要件スイートにない要件を検索します。

requirementsFromBaseline()

requirementsFromBaseline() JQL 関数の使用例を以下に示します。

ID

用途

説明

1

issue in requirementsFromBaseline("projectKey", "groupName", "baselineName")

下記から要件を検索します。

プロジェクト = projectKey
ベースライングループ = groupName
ベースライン = baselineName

requirementsInBug()

requirementsInBug() JQL 関数の使用例を以下に示します。

ID	用途	説明
1	issue in requirementsInBug('issueKey')	指定の不具合 issueKey が報告された要件群を検索します。
2	issue in requirementsInBug('issueKey','True')	指定の不具合 issueKey が報告された要件群を検索します。
3	issue in requirementsInBug('issueKey','False')	指定の不具合 issueKey が報告された直接の要件を検索します。

bugsInTestPlan()

bugsInTestPlan() JQL 関数の使用例を以下に示します。

なお、この JQL では入れ子関数がサポートされています。

ID

用途

説明

1

issue in bugsInTestPlan('issueKey')

テスト計画から作成されたバグを検索します。

2

issue in bugsInTestPlan('issueKey1','issueKey2')

指定のテスト計画キー issueKey1 および issueKey2 に関連付けられているバグを検索します。

3

issue in bugsInTestPlan('project = <projectKey> AND component = "<Component Name">')

注意 : 外側の引用符は単一引用符 ' にする必要があります。これを使用しない場合、構文エラーが返されます。

テスト計画のセットに関連付けられているバグを検索します。これらのテスト計画は入れ子関数 ('project = <projectKey> AND component = "<Component Name">') で返されます。

bugsInCycle()

bugsInCycle() JQL 関数の使用例を以下に示します。

ID	用途	説明
1	issue in bugsInCycle('TestCycleName')	指定のテストサイクル名に関連付けられているバグを検索します。ワイルドカード検索を利用できます。

bugsInTestCase()

bugsInTestCase() JQL 関数の使用例を以下に示します。

なお、この JQL では入れ子関数がサポートされています。

ID	用途	説明
1	issue in bugsInTestCase('issueKey')	指定のテストケースキー issueKey に関連付けられているバグを検索します。
2	issue in bugsInTestCase('issueKey1','issueKey2')	指定のテストケースキー issueKey1 および issueKey2 に関連付けられているバグを検索します。
3	issue not in bugsInTestCase("") and issuetype = Bug	テストケースに関連付けられていないバグを検索します。
4	issue in bugsInTestCase('project = <projectKey> AND component = "<Component Name">') 注意 : 外側の引用符は単一引用符 ' にする必要があります。これを使用しない場合、構文エラーが返されます。	テストケースのセットに関連付けられているバグを検索します。これらのテストケースは入れ子関数 ('project = <projectKey> AND component = "<Component Name">') で返されます。

bugsInRequirement()

bugsInRequirement() JQL 関数の使用例を以下に示します。

なお、この JQL では入れ子関数がサポートされています。

ID

用途

説明

1

issue in bugsInRequirement('issueKey')

指定の要件キー issueKey に関連付けられているバグを検索します。

2

issue in bugsInRequirement('issueKey1','issueKey2')

指定の要件キー issueKey1 および issueKey2 に関連付けられているバグを検索します。

3

issue in bugsInRequirement('project = <projectKey> AND component = "<Component Name">')

注意 : 外側の引用符は単一引用符 ' にする必要があります。これを使用しない場合、構文エラーが返されます。

要件セットに関連付けられているバグを検索します。これらの要件は入れ子関数 ('project = <projectKey> AND component = "<Component Name">') で返されます。

bugsInBuild()

bugsInBuild() JQL 関数の使用例を以下に示します。

ID	用途	説明
1	issue in bugsInBuild('BuildName')	指定のビルド名に関連付けられているバグを検索します。
2	issue in bugsInBuild('BuildName1','BuildName2')	指定のビルド名に関連付けられているバグを検索します。

bugsInEnvironment()

bugsInEnvironment() JQL 関数の使用例を以下に示します。

ID	用途	説明
1	issue in bugsInEnvironment('EnvName')	指定の環境名に関連付けられているバグを検索します。
2	issue in bugsInEnvironment('EnvName1','EnvName2')	指定の環境名に関連付けられているバグを検索します。

hasActiveCycle()

hasActiveCycle() JQL 関数の使用例を以下に示します。

ID	用途	説明
1	issue in hasActiveCycle()	アクティブテストサイクルがあるテスト計画をすべて検索します。

hasCycleWithBugs()

hasCycleWithBugs() JQL 関数の使用例を以下に示します。

ID	用途	説明
1	issue in hasCycleWithBugs()	バグを持つテストサイクルがあるテスト計画をすべて検索します。

testPlansWithoutTestCases()

testPlansWithoutTestCases() JQL 関数の使用例を以下に示します。

ID	用途	説明
1	issue in testPlansWithoutTestCases()	テストケースが関連付けられていないテスト計画をすべて検索します。

hasCycleWithUnresolvedBugs()

hasCycleWithUnresolvedBugs() JQL 関数の使用例を以下に示します。

ID	用途	説明
1	issue in hasCycleWithUnresolvedBugs()	未解決バグを持つテストサイクルがあるテスト計画をすべて検索します。

hasCycleWithFailedTestCases()

hasCycleWithFailedTestCases() JQL 関数の使用例を以下に示します。

ID	用途	説明
1	issue in hasCycleWithFailedTestCases()	失敗したテストケースを持つテストサイクルがあるテスト計画をすべて検索します。

hasCycleWithBlockedTestCases()

hasCycleWithBlockedTestCases() JQL 関数の使用例を以下に示します。

ID	用途	説明
1	issue in hasCycleWithBlockedTestCases()	ブロックテストケースを持つテストサイクルがあるテスト計画をすべて検索します。

hasCycleWithUntestedTestCases()

hasCycleWithUntestedTestCases() JQL 関数の使用例を以下に示します。

ID	用途	説明
1	issue in hasCycleWithUntestedTestCases()	未テストのテストケースを持つテストサイクルがあるテスト計画をすべて検索します。

hasCyclesOfDefectCount()

hasCyclesOfDefectCount() JQL 関数の使用例を以下に示します。サポートされる演算子は、"=="、">="、および "<=" です。

ID	用途	説明
1	issue in hasCyclesOfDefectCount("10")	不具合数が 10 件のテストサイクルを持つテスト計画をすべて検索します。
2	issue in hasCyclesOfDefectCount("<=","10")	不具合数が 10 件以下のテストサイクルを持つテスト計画をすべて検索します。
3	issue in hasCyclesOfDefectCount(">=","10")	不具合数が 10 件以上のテストサイクルを持つテスト計画をすべて検索します。

testPlanMembers()

testPlanMembers() JQL 関数の使用例を以下に示します。

なお、この JQL では入れ子関数がサポートされています。

ID	用途	説明
1	issue in testPlanMembers("issueKey")	指定のテスト計画キー issueKey と関連付けられているテストケースを検索します。
2	issue in testPlanMembers("issueKey","Result")	指定のテスト計画と指定の実行結果に関連付けられているテストケースを検索します。
3	issue not in testPlanMembers("issueKey")	指定のテスト計画に存在しないテストケースを検索します。
4	issue in testPlanMembers('project = <projectKey> AND component = "<Component Name">') 注意 : 外側の引用符は単一引用符 ' にする必要があります。これを使用しない場合、構文エラーが返されます。	テスト計画のセットに関連付けられているテストケースを検索します。これらのテスト計画は入れ子関数 ('project = <projectKey> AND component = "<Component Name">') で返されます。
5	issue in testPlanMembers('project = <projectKey> AND component = "<Component Name">','Result') 注意 : 外側の引用符は単一引用符 ' にする必要があります。これを使用しない場合、構文エラーが返されます。	テスト計画のセットに関連付けられているテストケースを検索します。これらのテスト計画は入れ子関数 ('project = <projectKey> AND component = "<Component Name">') で返されます。

testPlanMembersWithLatestResult()

testPlanMembersWithLatestResult() JQL 関数の使用例を以下に示します。

なお、この JQL では入れ子関数がサポートされています。

ID	用途	説明
1	issue in testPlanMembersWithLatestResult("testPlanKey","Result")	最新のテスト結果が特定のテスト計画から指定した "Result" (例 : 失敗) と等しいテストケースを検索します。
2	issue in testPlanMembersWithLatestResult("testPlanKey","Result1","Result2")	最新のテスト結果が特定のテスト計画から指定した "Result1" または "Result2" (例 : 失敗またはブロック) と等しいテストケースを検索します。
3	issue in testPlanMembersWithLatestResult('project = <projectKey> AND component = "<Component Name">','Result') 注意 : 外側の引用符は単一引用符 ' にする必要があります。これを使用しない場合、構文エラーが返されます。	最新のテスト結果がテスト計画のセットから指定した "Result" (例 : 失敗) と等しいテストケースを検索します。これらのテスト計画は入れ子関数から返されます ('project = <projectKey> AND component = "<Component Name">')。
4	issue in testPlanMembersWithLatestResult('project = <projectKey> AND component = "<Component Name">','Result1','Result2') 注意 : 外側の引用符は単一引用符 ' にする必要があります。これを使用しない場合、構文エラーが返されます。	最新のテスト結果がテスト計画のセットから指定した "Result1" または "Result2" (例 : 失敗またはブロック) と等しいテストケースを検索します。これらのテスト計画は入れ子関数から返されます ('project = <projectKey> AND component = "<Component Name">')。

testCasesInBug()

testCasesInBug() JQL 関数の使用例を以下に示します。

なお、この JQL では入れ子関数がサポートされています。

ID

用途

説明

1

issue in testCasesInBug("bugKey")

指定のバグキー issueKey に関連付けられているテストケースを検索します。

2

issue not in testCasesInBug("") and issuetype = "Test Case"

バグに関連付けられていないテストケースを検索します。

3

issue in testCasesInBug('project = <projectKey> AND component = "<Component Name">')

注意 : 外側の引用符は単一引用符 ' にする必要があります。これを使用しない場合、構文エラーが返されます。

バグのセットに関連付けられているテストケースを検索します。これらのバグは入れ子関数によって返されます ('project = <projectKey> AND component = "<Component Name">')。

executePeriod()

executePeriod() JQL 関数の使用例を以下に示します。

なお、サポートされる日付形式は yyyy-MM-dd です。

ID	用途	説明
1	issue in executePeriod("startDate","endDate")	一定の期間中に実行されたテストケースを検索します。

childrenOfParentRequirement()

childrenOfParentRequirement() JQL 関数の使用例を以下に示します。

なお、この JQL では入れ子関数がサポートされています。

ID	用途	説明
1	issue in childrenOfParentRequirement("issueKey")	指定の要件キー issueKey の直下の子要件のみを検索します。
2	issue in childrenOfParentRequirement("issueKey","all")	指定の要件キー issueKey の直下の要件、およびすべてのレベルの孫要件を検索します。
3	issue in childrenOfParentRequirement('project = <projectKey> AND component = "<Component Name">') 注意 : 外側の引用符は単一引用符 ' にする必要があります。これを使用しない場合、構文エラーが返されます。	要件のセットから直下の子要件のみを検索します。これらの要件は入れ子関数によって返されます ('project = <projectKey> AND component = "<Component Name">')。
4	issue in childrenOfParentRequirement('project = <projectKey> AND component = "<Component Name">','all') 注意 : 外側の引用符は単一引用符 ' にする必要があります。これを使用しない場合、構文エラーが返されます。	要件のセットから直下の要件、およびすべてのレベルの孫要件を検索します。これらの要件は入れ子関数によって返されます ('project = <projectKey> AND component = "<Component Name">')。

parentRequirement()

parentRequirement() JQL 関数の使用例を以下に示します。

なお、この JQL では入れ子関数がサポートされています。

ID	用途	説明
1	issue in parentRequirement()	子要件がリンクされている要件をすべて検索します。
2	issue in parentRequirement("Root")	子要件がリンクされている上位レベルの要件をすべて検索します。
3	issue in parentRequirement("issueKey")	指定の子要件キー issueKey を持つ直接の親要件を検索します。
4	issue in parentRequirement("issueKey1","issueKey2")	指定の子要件キー issueKey1、issueKey2 を持つ直接の親要件を検索します。
5	issue in parentRequirement('project = <projectKey> AND component = "<Component Name">') 注意 : 外側の引用符は単一引用符 ' にする必要があります。これを使用しない場合、構文エラーが返されます。	子要件のセットから直接の親要件を検索します。これらの子要件は入れ子関数によって返されます ('project = <projectKey> AND component = "<Component Name">')。

testPlansForTester()

testPlansForTester() JQL 関数の使用例を以下に示します。

ID	用途	説明
1	issue in testPlansForTester("username")	テスター (= ユーザー名) が割り当てられているテスト計画を検索します。

testCycleMembers()

testCycleMembers() JQL 関数の使用例を以下に示します。サポートされる演算子は、"=="、">="、および "<=" です。

ID	用途	説明
1	issue in testCycleMembers('TestPlanissueKey','TestCycleName')	指定したテストサイクルからテストケースメンバーをすべて検索します。
2	issue in testCycleMembers('TestPlanissueKey','TestCycleName','Not Tested')	指定したテストサイクルから "未テスト" のテストケースメンバーをすべて検索します。
3	issue in testCycleMembers('TestPlanissueKey','TestCycleName','NA')	指定したテストサイクルから "該当なし" のテストケースメンバーをすべて検索します。
4	issue in testCycleMembers('TestPlanissueKey','TestCycleName','Passed')	指定したテストサイクルから "合格" のテストケースメンバーをすべて検索します。
5	issue in testCycleMembers('TestPlanissueKey','TestCycleName','Failed')	指定したテストサイクルから "失敗" のテストケースメンバーをすべて検索します。
6	issue in testCycleMembers('TestPlanissueKey','TestCycleName','Blocked')	指定したテストサイクルから "ブロック" のテストケースメンバーをすべて検索します。

testersOfCycle

testersOfCycle JQL 関数の使用例を以下に示します。

testersOfCycle JQL 関数で利用できる演算子は以下のとおりです : =、!=、is not、is、not in、in

なお、この JQL はテストサイクルページでのみ使用する目的で作成されています。

ID	用途	説明
1	testerOfCycle = <username>	指定の JIRA ユーザーに割り当てられたテスト実行を検索します。
2	testersOfCycle = currentUser()	現在の JIRA ユーザーに割り当てられたテスト実行を検索します。

resultsOfCycle

resultsOfCycle() JQL 関数の使用例を以下に示します。

resultsOfCycle() JQL 関数で利用できる演算子は以下のとおりです : =、!=、is not、is、not in、in

なお、この JQL はテストサイクルページでのみ使用する目的で作成されています。

ID	用途	説明
1	resultsOfCycle = <result>	指定のテスト結果のテスト実行を検索します。
2	resultsOfCycle in ("Result1","Result2")	指定のテスト結果 (複数) のテスト実行を検索します。

testersOfCycle()

testersOfCycle() JQL 関数の使用例を以下に示します。

なお、この JQL はテストサイクルページでのみ使用する目的で作成されています。

ID	用途	説明
1	issue in testersOfCycle("username")	指定の JIRA ユーザーに割り当てられたテスト実行を検索します。
2	issue in testersOfCycle("username1","username2")	指定の JIRA ユーザー (複数) に割り当てられたテスト実行を検索します。

resultsOfCycle()

resultsOfCycle() JQL 関数の使用例を以下に示します。

なお、この JQL はテストサイクルページでのみ使用する目的で作成されています。

ID	用途	説明
1	issue in resultsOfCycle("Result")	指定のテスト結果のテスト実行を検索します。
2	issue in resultsOfCycle("Result1","Result2")	指定のテスト結果 (複数) のテスト実行を検索します。

runAttributeOfCycle()

runAttributeOfCycle() JQL 関数の使用例を以下に示します。

なお、この JQL はテストサイクルページでのみ使用する目的で作成されています。

ID	用途	説明
1	issue in runAttributeOfCycle("runAttributeValue1")	指定の実行属性値でテスト実行を検索します。
2	issue in runAttributeOfCycle("runAttributeValue1","runAttributeValue2")	指定の実行属性値 (複数) でテスト実行を検索します。