Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Changed "Test for Jira" to "Test Management for Jira".
PanelSearching for tests

Overview

The advanced search functionality of

JIRA allows to use structured queries to search for issues. These queries are written

Jira supports using structured queries in Atlassian's

JIRA

Jira Query Language (JQL) to search for issues. The

result set is

results are displayed as a list of issues in the Jira 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

Management for Jira provides additional JQL functions to search for issues contained in T4J specific entities such as test plans or definition trees.

Saved JQL queries can be further

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

matching the query

to

a

definition

tree. PaneltitleContents

trees.

Table of Contents
indentTable of Contents
Panel

How to search for

tests

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 InfoThe
  • 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 Folderexpand

testDefinitionFolder()

Returns the

issues/tests

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

Syntax

Code BlockthemeConfluencefirstline1linenumbers

truePath

testDefinitionFolder(path)

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

The path parameter should be of the following form: "project name/parentFolder/.../childFolder"

 

.

Supported

Fields

fields

Issue

Supported

Operators

operators

IN , NOT IN

Unsupported operators

=

, !=

, ~

, !~

, >

, >=

, <

, <=

IS

, IS NOT

INNOT INWAS

, WAS , WAS IN

, WAS NOT

, WAS NOT IN

, CHANGED

(error)(error)

(error)(error)(error)(error)(error)(error)(error)(error)(tick)(tick)(error)(error)(error)(error)(error)

Examples

  • Find all

issues that are contained
  • test cases in the folder named "

Webtests" within the definition tree of the project "OnlineHotelReservation: Code Block
themeConfluence
firstline1
linenumberstrue
issue in expand
  • OnlineHotelReservation/Webtests":
    issue in testDefinitionFolder("OnlineHotelReservation/Webtests")

Test Definition Path

testDefinitionPath()

Returns the

issues/tests

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

.
Also returns the issues/tests of subsequent

, as well as those contained in child folders.

Syntax

Code BlockthemeConfluencefirstline1linenumberstrue

testDefinitionPath(path)

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

Path

The path parameter should be of the following form: "project name/parentFolder/.../childFolder"

 

.

Supported

Fields

fields

Issue

Supported

Operators

operators

IN , NOT IN

Unsupported operators

=

, !=

, ~

, !~

, >

, >=

, <

, <=

IS

, IS NOT

INNOT INWAS

, WAS , WAS IN

, WAS NOT

, WAS NOT IN

, CHANGED

(error)

(error)(error)(error)(error)(error)(error)(error)(error)(error)(tick)(tick)(error)(error)(error)(error)(error)

Examples

  • Find all

issues that are contained
  • test cases in the folder named "

Webtests" or one of its subfolders within the project "OnlineHotelReservation: Code Block
themeConfluence
firstline1
linenumberstrue
issue in Returns all issues/tests
  • OnlineHotelReservation/Webtests", as well as those contained in child folders:
    issue in testDefinitionPath("OnlineHotelReservation/Webtests")

Test Plan

Expand

testPlan()

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

Syntax

Code BlockthemeConfluencefirstline1

linenumberstrue

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. Both parameters are optional.

Supported Fields

Supported fields

Issue

Supported

Operators

operators

IN , NOT IN

Unsupported operators

=

, !=

, ~

, !~

, >

, >=

, <

, <=

IS

, IS NOT

INNOT INWAS

, WAS , WAS IN

, WAS NOT

, WAS NOT IN

CHANGED(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(tick)(tick)(error)(error)(error)(error)(error)

, CHANGED

Examples

  • Find all

issues/tests
  • test cases that are

part of
  • in the

test plan
  • project "Example Plan"

on
  • in the project "OnlineHotelReservation"

Code Block
themeConfluence
firstline1
linenumberstrue
issue in
  • :
    issue in testPlan("OnlineHotelReservation","Example Plan")

  • Find all test cases that are in the project "OnlineHotelReservation", regardless of plan:
    issue in testPlan("OnlineHotelReservation","

Example Plan
  • ")

  • Find all

issues/tests
  • test cases that are part of the test plan "Example Plan", regardless of project

Code BlockthemeConfluencefirstline1linenumberstrue
  • :
    issue

  • in

  • testPlan("","Example

  • Plan")

  • Find all

issues/tests
  • test cases in project "OnlineHotelReservation" that are not

yet
  • part of any test plan

Code Block
themeConfluence
firstline1
linenumberstrue
issue not in
  • :
    issue not in testPlan("OnlineHotelReservation","")

  • Find all

issues/tests
  • test cases in all projects not

yet
  • part of any test plan

Code BlockthemeConfluencefirstline1linenumberstrue
  • :
    issue

  • not

  • in

  • testPlan("","")

Failed in Execution

ExpandReturns all issues/tests

failedinExecution()

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

given failedInExecution

test plan.

Syntax

Code Block
themeConfluence
firstline1
linenumberstrue

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.
All parameters are manatory.

Supported Fields

Supported Operators

=!=~!~>>=<<=ISIS NOTINNOT INWASWAS INWAS NOTWAS NOT INCHANGED(error)(error)(error)(error)(error)(error)(error)(error)(error)(error)(tick)(tick)(error)(error)(error)(error)(error)

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"

created on
  • in the project "OnlineHotelReservation"

, which
  • that were marked as failed during "Test

Execution
  • Run 1":

Code BlockthemeConfluencefirstline1linenumberstrue

  • issue

  • in

  • failedInExecution("OnlineHotelReservation","Example

  • Plan","Test

Execution
  • Run 1")