Panel

Searching for tests

Advanced search integration

The advanced search functionality of JIRA allows to use structured queries to search for issues. These queries are written in Atlassian's JIRA Query Language (JQL). The result set is displayed as a list of issues in the issue navigator. It is also possible to save advanced search queries for private or public use.

Test for JIRA enhances the advanced search of JIRA with new functions to search for issues in T4J specific entities such as test plans or definition trees.

Saved JQL queries can be further used for filtering or adding issues matching the query to a definition tree.

How to search for tests

Select Issues > Search for Issues from the main navigation bar
Switch to advanced searching by clicking the Advanced link from the filter bar
Enter a query in the search text box
Click on the Search button or hit enter to execute the query

Info

The query should be of the following structure: field operator function()

You can look up the supported fields and operators for the new Requirements for JIRA functions in the function reference below.

Function Reference

Test Definition Folder

Expand

Returns the issues/tests that are contained in a specific folder in the definition tree of a project.

Syntax

Code Block

theme	Confluence
firstline	1
linenumbers	true

testDefinitionFolder(path)

Where path represents a part of the hierarchical structure of the definition tree.

Path should be of the following form: "project name/parentFolder/.../childFolder"

Supported Fields

Issue

Supported Operators

Examples

Find all issues that are contained in the folder "Webtests" within the definition tree of the project "OnlineHotelReservation:

Code Block

theme	Confluence
firstline	1
linenumbers	true

issue in testDefinitionFolder("OnlineHotelReservation/Webtests")

Test Definition Path

Expand

Returns the issues/tests that are contained in a specific folder in the definition tree of a project.
Also returns the issues/tests of subsequent folders.

Syntax

=

!=

~

!~

>

>=

<

<=

IS

IS NOT

IN

NOT IN

WAS

WAS IN

WAS NOT

WAS NOT IN

CHANGED

Examples

Find all issues that are contained in the folder "Webtests" within the definition tree of the project "OnlineHotelReservation:

Code Block

theme	Confluence
firstline	1
linenumbers	true

issue in testDefinitionFolder("OnlineHotelReservation/Webtests")

Test Definition Path

Expand

Returns the issues/tests that are contained in a specific folder in the definition tree of a project.
Also returns the issues/tests of subsequent folders.

Syntax

Code Block

theme	Confluence
firstline	1
linenumbers	true

testDefinitionPath(path)

Where path represents a part of the hierarchical structure of the definition tree.

Path should be of the following form: "project name/parentFolder/.../childFolder"

Supported Fields

Issue

Supported Operators

=

Examples

Find all issues that are contained in the folder "Webtests" or one of its subfolders within the project "OnlineHotelReservation:

Code Block

theme	Confluence
firstline	1
linenumbers	true

issue in testDefinitionPath("OnlineHotelReservation/Webtests")

Test Plan

Expand

Returns all issues/tests that are part of a specific test plan.

Syntax

Code Block

theme	Confluence
firstline	1
linenumbers	true

testPlan(project,plan)

Where project is the name of the project that contains the desired test plan and plan is the name of the test plan.

Supported Fields

Issue

Supported Operators

!=

~

!~

>

>=

<

<=

IS

IS NOT

IN

NOT IN

WAS

WAS IN

WAS NOT

WAS NOT IN

CHANGED

Examples

Find all issues /tests that are part of the test plan "Example Plan" created on contained in the folder "Webtests" or one of its subfolders within the project "OnlineHotelReservation":

Code Block

theme	Confluence
firstline	1
linenumbers	true

issue in testPlantestDefinitionPath("OnlineHotelReservation","Example Plan/Webtests")

Failed in Execution

Test Plan

Expand

Returns all issues/tests that are marked as failed in part of a specific execution of a given test plan.

Syntax

Code Block

theme	Confluence
firstline	1
linenumbers	true

failedInExecution(project,plan,execution)

Where project is the name of the project that contains the desired test plan.
Plan is the name of the test plan.
Execution is the name of a specific execution of the given test plan.

Supported Fields

Issue

Supported Operators

test plan.

Syntax

Code Block

theme	Confluence
firstline	1
linenumbers	true

testPlan(project,plan)

Where project is the name of the project that contains the desired test plan and plan is the name of the test plan.

Supported Fields

Issue

Supported Operators

=

!=

~

!~

>

>=

<

<=

IS

IS NOT

IN

NOT IN

WAS

WAS IN

WAS NOT

WAS NOT IN

CHANGED

Examples

Find all issues/tests that are part of the test plan "Example Plan" created on the project "OnlineHotelReservation":

Code Block

theme	Confluence
firstline	1
linenumbers	true

issue in testPlan("OnlineHotelReservation","Example Plan")

Failed in Execution

Expand

Returns all issues/tests that are marked as failed in a specific execution of a given test plan.

Syntax

Code Block

theme	Confluence
firstline	1
linenumbers	true

failedInExecution(project,plan,execution)

Where project is the name of the project that contains the desired test plan.
Plan is the name of the test plan.
Execution is the name of a specific execution of the given test plan.

Supported Fields

Issue

Supported Operators

=

!=

~

!~

>

>=

<

<=

IS

IS NOT

IN

NOT IN

WAS

WAS IN

WAS NOT

WAS NOT IN

CHANGED

Examples

Find all issues/tests that are part of the test plan "Example Plan" created on the project "OnlineHotelReservation", which were marked as failed during "Test Execution":

Code Block

theme	Confluence
firstline	1
linenumbers	true

issue in failedInExecution("OnlineHotelReservation","Example Plan","Test Execution")

...

Versions Compared

Old Version 12

New Version 13

Key

Searching for tests

Advanced search integration

How to search for tests

Function Reference

Test Definition Folder

Syntax

Supported Fields

Supported Operators

Examples

Test Definition Path

Test Definition Path

Syntax

Supported Fields

Supported Operators

Examples

Test Plan

Syntax

Supported Fields

Examples

Test Plan

Syntax

Supported Fields

Syntax

Supported Fields

Supported Operators

Examples

Failed in Execution

Syntax

Supported Fields

Supported Operators

Examples

Page Comparison

Versions Compared

Old Version 12

New Version 13

Key

Searching for tests

Advanced search integration

How to search for tests

Function Reference

Test Definition Folder

Syntax

Supported Fields

Supported Operators

Examples

Test Definition Path

Test Definition Path

Syntax

Supported Fields

Supported Operators

Examples

Test Plan

Syntax

Supported Fields

Examples

Test Plan

Syntax

Supported Fields

Syntax

Supported Fields

Supported Operators

Examples

Failed in Execution

Syntax

Supported Fields

Supported Operators

Examples