Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

These custom fields are located in the native Jira sections. The revision can be found in the Details section of the Test Execution issue while the Begin and End dates are located in the Dates section.

Section
Column
width40%

Image RemovedImage Added

Column
width60%

Image RemovedImage Added

Sections

Xray contributes an additional section to the Test Execution view issue screen.

...

It is possible to filter tests by status in Test Execution Progress Bar as shown in the image below:

Image Added

Image AddedFilter Issues based on statusImage Removed

Test Run Filters

A filter section is also present above the Test Runs table to allow you to filter Test Runs  by Assignee, Status, Test Set, or open text.

...

The #Def column provides the number of Defects created during the Test Execution or already related to the Test issue. For more information on how the calculation is done for this field, please refer to Defects Count.


Image RemovedImage Added


Actions

Table of Contents
maxLevel2
minLevel2

...

Step 1: Click the Create Issue at the top of the screen to open the Create Issue dialog box / page.

Image RemovedImage Added

Step 2: Select the Project and on Issue Type, select Test Execution.

...

Step 5a: If you selected the Create another checkbox, a new Create Issue dialog appears. This issue is automatically pre-populated with your previous test execution details, while leaving the Summary field blank.

Image RemovedImage Added

Edit

The Edit Issue dialog box / page is similar to the Create Issue dialog box / page, and can be accessed through the following steps:

...

Step 2: Click the Edit button (at the top-left of the 'view issue' page) to open the Edit Issue dialog box / page.
Alternatively, hover over a field and click the pencil icon to edit it inline. 

Image RemovedImage Added

Step 3: Modify your Test Execution details in the appropriate fields using either the General or Test Execution Details tab of the Edit Issue view.

Step 4: Click the Update button to save your changes.

Image RemovedImage Added

Clone

When cloning a Test Execution issue, all the Test issue associations will also be cloned.  However, a new Test Run is created for each Test so that the new Test Execution issue has no execution state. Also:

...

Step 2Select More > Clone. The Clone Issue screen will appear.

Image RemovedImage Added

Step 3Edit the clone Test Set's Summary if you wish.

 Step 4: Click Create.

Image RemovedImage Added

Adding Tests

Tests and Test Sets can be associated with Test Execution issues.

...

Step 2: Select Add > Tests  (under the Tests tab on the view page) to open the Add Tests dialog box.from the dropdown button in the Tests section.

Image AddedImage Removed

Step 3:  Select or search the Test issues to be associated with the Test Execution:

Select Test Issues - In order to select the Tests to be associated, you can, under the Select tab:

- Input the desired Test Issue Key on the Tests field.
- Click on the Down Arrow on the Tests field and select the Test from its History Search list.
- Click on the + button wich will prompt an Issue Selector Pop-Up. 
- Click on the Search tab to use the Find Jira issues browser.

Image Removed

Search Test Issues - In order to search for Tests to be associated, you can, under the Search tab:

- Browse for the desired Test ProjectType or terms it Contains.
- Click on the More button to add more browse fields such as LabelTest SetTest Set Fix VersionRequirement, Requirement Fix Version, Saved Filter and Workflow Status.
- Click on the Magnifier button after filling out the browse fields to get a list of matching entries 
- Click on the Advanced button to perform a JQL search.

Image Removed

Step 4: Click Add.

Add Tests from Test Sets

When adding a Test Set issue to a Test Execution, all the Test issues associated with the Test Set are added to the Test Execution. The Test Set issue is not directly associated with a Test Execution, so changes to the Test Set after it was added will not affect the Test Execution.

Step 1: Open the Test Execution you wish to associate a Test Set with.

Step 2: Select Add > Tests (under the Tests tab on the view page) to open the Add Test Sets dialog box.

Image Removed

Step 3: Select or search the Test Set issues to be associated with the Test Execution.

Select Test Set Issues - In order to select the Test Sets to be associated, you can, under the Select tab:

- Input the desired Test Set Issue Key on the Test Sets field.
- Click on the Down Arrow on the Test Sets field and select the Test Set from its History Search list.
- Click on the + button wich will prompt an Issue Selector Pop-Up. 
- Click on the Search tab to use the Find Jira issues browser.

Image Removed

Info
titlePlease note

Notice the setting for ignoring Tests in non-executable statuses at the bottom-left side. By default it will be selected, therefore restricting the shown Tests available for adding accordingly to the configuration "Disallow executions of Tests with workflow statuses".

Search Test Sets Issues - In order to search for Test Sets to be associ.ated, you can, under the Search tab:

- Browse for the desired Test Set Project or terms it Contains.
- Click on the More button to add more browse fields such as Label, Fix Version, Saved Filter and Workflow Status.
- Click on the Magnifier button after filling out the browse fields to get a list of matching entries.
- Click on the Advanced button to perform a JQL search.

Image Removed

Info
titlePlease note

Notice the setting for ignoring Tests in non-executable statuses at the bottom-left side. By default it will be selected, therefore restricting the shown Tests available for adding accordingly to the configuration "Disallow executions of Tests with workflow statuses".

...

Open the Search tab.

Image Added

Info
titleHow to use de Issue Picker Dialog

This is an example of how to add tests, using some of the features available in the Search tab.

For more information, please visit the Issue Picker Dialog detailed overview.

Step 4: Configure the search.

-Use the Filters dropdown button to include extra fields in the search criteria.

-Fill in the filters values.

-Press the search button.

Info
titlePlease note

Notice the setting for ignoring Tests in non-executable statuses at the bottom-left side. By default it will be selected, therefore restricting the shown Tests available for adding accordingly to the configuration "Miscellaneous > Workflow Status > ".


Image Added Image Added

Step 5: Select and Add tests.

- Once the results are obtained you can order, add/remove columns to the results list (the columns selection is saved as a preference).

- Before adding the selected tests you can define the execution assignee by using the upper right corner Assignee dropdown.

Info
titlePlease note

Since Xray 3.4.0, the Assignee dropdown provides you a suggestions list with the user type fields found in the tests. 

If you choose the "Test Reporter" from the list, the assignee of the resultant Test Run will be the user set in the Test Reporter field of the respective test.

  

- Check the tests you wish to add from the listed results.


Image AddedImage Added

Step 6:  Add tests by pressing "Add selected".

Add Tests from Test Sets

In practical terms this operation is very similar to adding tests, instead you will just be searching and selecting Test Set issues.

Keep in mind that when adding a Test Set issue to a Test Execution, all the Test issues associated with the Test Set are added to the Test Execution. 

The Test Set issue is not directly associated with a Test Execution, so changes to the Test Set after it was added will not affect the Test Execution.


Associate with a Test Plan

...

Section

There are two ways to distribute work between Testers.

  • A Test Execution issue can be created per Tester by assigning the issue to a specific Tester, or 
  • Within a Test Execution issue, you can assign individual Test Runs to Testers. Test Runs are assigned to the Test Execution issue assignee by default. Only users with permission to assign the Test Execution issue to a specific Tester, or 
  • Within a Test Execution issue, you can assign individual Test Runs to Testers. Test Runs are assigned to the Test Execution issue assignee by default. Only users with permission to assign the Test Execution issue can assign Test Runs. 
  • can assign Test Runs. 


When assigning individual Test Runs, it is also possible to assign based on any user type field present on the Test cases. For instance, you'll be able to assign Test Runs to the Test issue assignee. This allows users that are normally used to execute a specific Test case (that are assigned to the Test case), to be the default assignees on Test Runs within a Test Execution.


column
Column
width50%

To assign individual Test Runs to testers,

Step 1: Open the Test Execution issue.

Step 2: Hover over the desired Test Run (under the Tests section on the view page)

Step 3: Click the Actions button that appears in the last column. The actions menu should pop up with the available actions.

Step 4: Click the Assign action. The assign dialog appears.

Step 5: Start typing to find the user to assign the Test Run and click Assign to complete the action or Cancel to abort it.

Column
width50%

Image AddedImage Removed

Change Test Run Rank

Section
Column

There are three ways to change the rank of Test Runs:

Drag-and-Drop

Step 1: Open the Test Execution issue.

Step 2: Hover over the desired Test Run row (under the Tests section on the view page) and the drag handle column.

Step 3: Click the drag handle and move the Test Run up or down in the current page.

Image Added

Change Rank Action

This action allows users to change the Rank of a Test run between pages.

Step 1: Open the Test Execution issue.

Step 2: Hover over the desired Test Run (under the Tests section on the view page)

Step 3: Click the gear that appears in the last column. The actions menu should pop up with the available actions.

Step 4: Click the Move To action. The change rank dialog appears.

Step 5: Enter the desired index number (1-based) and click OK.

Image AddedImage Added

Apply Rank Button:

This button will apply the current display order to the Test Run Rank.

Step 1: Open the Test Execution issue.

Step 2: Click on the header cell of the sortable column you want to sort by.

Step 3: Click the Apply Rank button and confirm the action on the pop up.

Step 4: The Rank of the Test Runs is updated to match the ordering of the Test Runs by the selected column.

Step 5: The table reverts to sorting by Rank (ascending).


Image AddedImage Added


Image Removed
Column



Execute Test

To execute a Test from a Test Execution:

...

Step 2: Select the desired Test Runs. This can be done by using the checkbox that appears on each Test Run row or, since v3.1, by using the Bulk dropdown button options for easy selecting all Test Runs or the ones in the current page.

Image RemovedImage Added


Info
titlePlease note

As of v3.1, the selection will be preserved even if you navigate between pages.

...

Step 3: Click the bulk actions gear located on the actions column header and choose one of the available actions.

Image RemovedImage Added



Info
titleLearn more

Bulk operations may trigger some email notification(s) depending on your Xray settings. For more info on email notifications and how to set-up them, please have a look at Email Notifications.

...

  • Test Set - show only Test Runs that are associated with a specific Test Set issue.
  • Assignee - show only Test Runs that are assigned to a specific user.
  • Status - show only Test Runs with a specific status.
  • Contains Text -  show only Test Runs with Tests containing the entered text. This will query Test issues with the JQL keyword text ~  ...


Image RemovedImage AddedImage Added

Since v3.1, the filters will be stored in the user and Test Execution context, and will be applied whenever going into the execution screen from one of the filtered Tests.Image Removed    Image Removed


The execution screen shows a small notice, so you can quickly identify that the filter has been applied thus affecting the navigation options (Previous/Next) available in the execution screen.

...

If you decide to come back to the Test Execution issue screen, the filter will remain. If you wish, you can clear the filter in order to see all Test Runs once again.

Image RemovedImage Added

Configure Test Run Columns

...

clicking Execution Details if the test has been previously executed).

Image RemovedImage Added


Step 2: Click the Import Execution Results button.

...

Step 3: Click the Browse button to navigate the local disk and select the JSON/XML/ZIP file with the automated execution results for the Test Execution.

Image RemovedImage Added

Step 4: Click Import.

...