Versions Compared

Key

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

...

To create a new Test Plan Issue, 

Step 1: Click the Create Issue+ at the top left of the screen to open the Create Issue dialog box / page or by pressing the key "C" on the keyboard.

Image RemovedImage Added

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

Step 3:  Under the General tab, type Type Summary for the test execution test plan and fill all appropriate fields — mandatory fields are marked with an asterisk. If you're working with versions, then you should also fill out the Fix Version to indicate that you're tracking the results of the Tests for that version. This will be used to automatically fill out the Fix Version of the planned Test Executions (i.e., the ones linked to/created from this Test Plan).

Step 4: Under the Test Plan Details tab, you can populate the Test Plan custom fields provided by Xray, namely the Begin/End date. In this tab, you can also add tests to the Test Plan.

Image RemovedImage Added

Optional: To create a series of similar Test Plans – within the same Project – select the Create another checkbox at the bottom of the dialog.

...

Step 2: Choose to add either Tests or Test Sets. Note that if you choose Test Sets, you are not actually adding Test Set(s); instead, you are adding the Tests that belong to that Test Set(s).

Image RemovedImage Added

Step 3: Choose the Tests you want, by using the Select or Search tabs and then selecting some or all of them.

Step 4: Click Add selected or Add all.

 Image Removed

Reorder Tests

Ranking of Tests within the Test Plan can be done in two ways: directly in the Test Plan issue screen (if Hierarchical Test Oganization is disabled) or in the Test Plan Board (if Hierarchical Test Organization is enabled). This means you can rank Tests, whether you use hierarchies or not.

Info
titleLearn more

If you are using Hierarchical Test Organization, you can and have to the ranking within the Test Plan Board. More info here.

Image Added

Reorder Tests

The following procedure details how you can change the order of the Tests, directly in the Test Plan issue screen. 

...

Section
Column

There are two ways of changing the order of Tests within a Test Plan:

Drag-and-Drop

To reorder Tests,

Step 1: Open the Test Plan issue.

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

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

Change Rank Action

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

To change the rank of a Test,

Step 1: Open the Test Plan issue.

Step 2: Hover over the desired Test (under the Tests section on the view page)Step 3: Click the gear Click the ... on the desired Test Set row and click on the Change Rank option that appears in the last column. The actions menu should pop up with the available actions.Step 4: Click the Move To action. drop down menu. The change rank dialog appears.

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

Column










Image RemovedImage Added


Associate Test Executions to the Test Plan

...

You can also add existing Test Execution issues directly to a Test Plan. 

Image RemovedImage Added

The selected Test Executions will be added, including the Tests associated with those Test Executions.

Test Executions can also be associated with a Test Plan by editing the custom field Associated Test Plan Plans in the Test Plans section in Test Execution issue view page or directly in the create issue screen in the Test Execution Details tab. Note that with this method, only the Test Execution shall be associated with the Test Plan; the Tests will not be associated. To inline edit the Associated Test Plans field, just hover over the field view area, click it and add or remove the Test Plans you wish to associate to the Test Execution.

Image AddedImage AddedImage RemovedImage Removed


Test Plan table

The Test Plan Test view section in the issue page provides you with a table where you can see all the Tests that were added to the Test Plan and their Test Executions (if they are associated to the Test Plan). 


Image RemovedImage Added

  1. Create planned Test Execution (see next Section), so its results be reflected on the current Test Plan
  2. Add Tests and Test Sets
  3. Test Plan Progress Bar
  4. Table Filters
  5. Use a Test Environment to calculate the status for test issues for that environment.

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

Filter Issues based on statusImage Removed

Each row represents a Test with configurable columns, with the exception of the Latest Status. Each row also contains an inner table with information about the Test Execution. Click on the blue arrow to see the inner table for a particular test.

Image Removed

Image Removed

  1. Opens a dialog that has a table that displays information about the Test Runs of a particular Test.

Image Added


This dialog's table is This inner table is similar to the Test Run table as it allows for inline execution ( 1 )  and for operations like assignee and remove ( 2 ). This inner table's columns are not configurable. Similarly to the Tests table in the Test Plans issue view page its possible to use a Test Environment to calculate the status for test runs for that environment ( 3 ).

Create Test Executions from the Test Plan

...

The most common and straightforward option to create a Test Execution for all the Tests, or for a subset of those that are currently in some consolidated status, is by using the option available at the top of the Test Plan issue screen.


Image RemovedImage Added

The Create Test Execution button will open a dropdown with some options that will allow you to select the Tests that will be part of the Test Execution. 

...

Info
titlePlease note

In order to create a related Test Execution from the Test Plan, the user must be allowed to the edit the current Test Plan since the results on the Test Execution will affect the consolidated information shown at the Test Plan. The user will only be able to create Test Executions in certain projects, therefore the list of projects shown in the creation dialog will be filtered out accordinglyif the user is not allowed to create Test Executions for a project he selects an error message will be displayed.

All tests...

Lets you create a Test Execution with all the tests that are associated with the Test Plan.

Note: If the revision field is not configured in the create issue screen of the Test Execution for the selected Project, the field will not appear in the dialog. If there are some mandatory fields, the standard create issue screen will be shown.


Image RemovedImage Added

With status...

Choose the Tests based on their consolidated status in a specific Test Environment. You can choose all Tests using the top left-side option; . In the Test Environment can be chosen in the top right-side option. For all shown status, you can see the amount of Tests that are currently in that consolidated status. You may choose one or more statuses. In the example below, we will be including just the (1) Test that is currently failing.  case below a Test Execution will be created with all the tests that are in the status Failed.

Image AddedImage Removed

Bulk action

You can select some Tests, using the bulk selection (1), and then schedule a Test Execution for them .Image Removed

Clone Test Plan and respective Board

A Test Plan along with its respective hierarchical information (i.e. the Board folder structure) can be cloned.

The new Test Plan will be created in a clean state, containing the original Tests without any execution related infomraation. If hierarchical test organization, the Board folder structure is also cloned.

( 2 ).


Image AddedImage Removed