Advanced Search Integration

Owned by Angelica Salazar
Last updated: Jul 04, 2022 by David SedlockVersion comment
3 min read

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.

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")

Â