Overview

The advanced search functionality of Jira supports using structured queries in Atlassian's Jira Query Language (JQL) to search for issues. The results are displayed as a list of issues in the Jira issue navigator. Test Management for Jira provides additional JQL functions to search for issues contained in T4J specific entities such as test plans or definition trees. Advanced queries, including those using T4J functions, can be saved for public or private reuse. They can also be used for filtering or adding issues to definition trees.

1 Overview
2 How to search for test cases
3 Function Reference
- 3.1 testDefinitionFolder()
- 3.2 testDefinitionPath()
- 3.3 testPlan()
- 3.4 failedinExecution()

How to search for test cases

Select Issues > Search for Issues from the main Jira navigation bar.
Switch to advanced searching by clicking the Advanced link from the filter bar.
Enter a query in the search text box. The expressions used with T4J functions are all of the following form: issue operator function(). See reference section below.
Click on the Search button or hit enter to execute the query.

Function Reference

testDefinitionFolder()

Returns the test cases that are directly contained in a specific folder in the definition tree of a project.

Syntax	`testDefinitionFolder(path)` The path parameter should be of the following form: "project name/parentFolder/.../childFolder".
Supported fields	Issue
Supported operators	IN , NOT IN
Unsupported operators	= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
Examples	Find all test cases in the folder named "OnlineHotelReservation/Webtests": `issue in testDefinitionFolder("OnlineHotelReservation/Webtests")`

testDefinitionPath()

Returns the test cases that are directly contained in a specific folder in the definition tree of a project, as well as those contained in child folders.

Syntax	`testDefinitionPath(path)` The path parameter should be of the following form: "project name/parentFolder/.../childFolder".
Supported fields	Issue
Supported operators	IN , NOT IN
Unsupported operators	= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
Examples	Find all test cases in the folder named "OnlineHotelReservation/Webtests", as well as those contained in child folders: `issue in testDefinitionPath("OnlineHotelReservation/Webtests")`

testPlan()

Returns the test cases that are part of a specific test plan.

Syntax	`testPlan(project,plan)`
Supported fields	Issue
Supported operators	IN , NOT IN
Unsupported operators	= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
Examples	Find all test cases that are in the project "Example Plan" in the project "OnlineHotelReservation": `issue in testPlan("OnlineHotelReservation","Example Plan")` Find all test cases that are in the project "OnlineHotelReservation", regardless of plan: `issue in testPlan("OnlineHotelReservation","")` Find all test cases that are part of the test plan "Example Plan", regardless of project: `issue in testPlan("","Example Plan")` Find all test cases in project "OnlineHotelReservation" that are not part of any test plan: `issue not in testPlan("OnlineHotelReservation","")` Find all test cases in all projects not part of any test plan: `issue not in testPlan("","")`

failedinExecution()

Returns the test cases that are marked as failed in a specific execution of a test plan.

Syntax	`failedinExecution(project,plan,execution)`
Supported fields	Issue
Supported operators	IN , NOT IN
Unsupported operators	= , != , ~ , !~ , > , >= , < , <= IS , IS NOT , WAS , WAS IN , WAS NOT , WAS NOT IN , CHANGED
Examples	Find all issues/tests that are part of the test plan "Example Plan" in the project "OnlineHotelReservation" that were marked as failed during "Test Run 1": `issue in failedInExecution("OnlineHotelReservation","Example Plan","Test Run 1")`

T4J - Test Management for Jira

Advanced Search Integration