Versions Compared

Key

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

Table of Contents

Introduction Xray

Xray for Jira is a Test Management tool (app) that provides the structure to organize, plan, and report with accuracy on the progress of testing as well as the readiness to deploy.
More detailed information for this app can be found on:  https://docs.getxray.app/display/XRAY/About+Xray


Information how Wolverine team works with XRAY, can be found here

Issue types used for Testing

...

Test Image Modified

Test should be created within the ticket of a story. It represents one test case, with one or more steps. A story should have at least one Test linked to it, but it could be more depending on the story. These Tests should be added to a Test Plan at the start of a sprint. A Test also has different statusses:

...

The naming of the Test should reflect the naming of the corresponding story, but edited with the word "Test" as to make clear this is specially for testing. For example, if the title of the story is "Improve the interface" the Test should be named "Test Improve the interface"

Pre- Condition Image Modified

Pre-Conditions are generic steps that are not necessarily part of the actual Test case, but mostly used as some setup conditions before the real Test can start. These steps are reusable and may be linked to multiple steps. These pre condition should never be linked to any sprint.

Test Plan Image Modified

To be created at the start of each sprint and linked to that sprint. It is just needed to create an empty Test Plan, which can be filled with Tests created for each story in the sprint. The name should reflect the naming of the sprint, for example "DMS Test Plan sprint 1", "DMS Test Plan sprint 2" etc.

Test Set Image Modified

A Test Set is a collection of Tests that can be linked to each other for organizing purposes. These can be matched by subject or a specific part of the application. Using Test Sets can make looking up and re-using existing tests more easy and manageable. A Test can be linked to multiple Test Sets. It should be clear by naming the Test Set what the common factor of these Tests are, for examle "Test Set - parts master interface (DLITMPRT)" for all Tests regarding the parts master interface, regardless which story. A Test Set should not be linked to any sprint.

Test Execution Image Modified

Just like a Test Plan should a Test Execution always be linked to a sprint. Ideally the Test Execution should contain all Tests for every story in the current sprint. At this point just one Test Execution ticket is created for executing all Tests. It is possible to create that Test Execution ticket from the Test Plan ticket:

Image Modified

From the Test Execution it is clear which Tests has been executed, either successfully or not, and which Tests are still to be executed. Where the Test Plan is within the initial phase of the sprint, the Test Execution should be at the the end of the sprint after the story has been developed and the according Tests have been created.

The naming of this Test Execution ticket should have a link to the sprint just like the Test Plan. Example: for Test Plan of sprint 1 it should be something like "Test Execution for Test Plan Sprint 1". At a later stage it could be more preferable to have more Test Execution tickets.

Sub Test Execution Image Modified



Repositories (PreRequisites)

Do we need / want repositories. If yes, what status, what naming convention etc. 

Test Process Workflow (draft)

draw.io Diagram
bordertrue
diagramNameXray test process
simpleViewerfalse
width
linksauto
tbstyletop
lboxtrue
diagramWidth1401
revision4

Xray: Testing Process workflow within the Sprint YIS Project

Step-by-step guide

1. Create a new empty Test Plan

Image Modified

At this moment there will be no Tests yet in this Test Plan. When scrolling down this Edit screen, it is possible to add this Test Plan to the current screen:

Image Modified

2. Create one or more

...

Test tickets for each story on the (Scrum of Kanban)  Project board

For each story in this sprint it is possible to create one or more Tests. 

Image Modified

This will open up a pop up screen where various setups can be created. At this point the naming is important (a reference to the actual story), checking that the the linked story is correct (under Link Issues) and the the Test Plan is added (under Test Plans):

Image Modified

Optionally a Test Set can be linked here, for example to link this Test to other tests for the same interface. Another option is to add Pre Conditions, that should already have been pre defined. 

This test should not be linked to the sprint, so make sure the correct Test Plan is added in order for this Test to be executed once the development of the story is done. draw.io DiagrambordertruediagramNameXray test processsimpleViewerfalsewidthlinksautotbstyletoplboxtruediagramWidth1401revision4

Xray: Testing Process workflow within the Sprint

Step by step guide

  1. When the new Sprint is started TM creates Test Plan for this sprint in Jira

Image Removed

TM creates Tests (issue type) for all stories included into Sprint and associates them with Test Plan.

Tests should be created from the story:

Image Removed

Image Removed

Image Removed

2. When Tester starts work with the story, he/she creates Test Design for the story within the associated Test 

Image Removed

Tester add test steps with all necessary data and Expected Results

Image Removed

3. The development is done and story is deployed for testing, Tester goes to the story and creates Test Execution for the newly created Test

Image Removed

4. To start test execution click  icon "View runs"  from the Story:

Image Removed

or click on "Execute in" in Test issue:

Image Removed

Test run will open in a new tab.

(warning) If you don't see the "View runs" icons in the Story, open the Test, scroll down to Executions. There is a Play (Run) button near each execution.

Click it and select Execute:

Image Removed

(star) Please note: to be able to run the execution, it should be assigned to you. Otherwise you will not see the Execute button.

5. Tester executes all steps manually on test env and set the status for each step (Pass/Fail) within created Test Execution 

Image Removed

Bugs should be associated with test step if found

Image Removed

6. Each Test Execution should be added to Test Plan by Tester

Image Removed

7. If bug was found and test step is failed, new Test Execution should be created after bug fix. Steps 3-6 should be repeated

3. Defining the Test steps within the Test tickets

When the Test tickets have been created in step 2, it is possible to define the actual Test case in the newly created Test ticket. As many steps as possible can be added to each Test:

Image Added


Within each step there is room for the actual action where a description is to be entered about the Test case. Test data (conditions) can be added in the second space. And in the last space there is a space for the expected results, to be extracted from the requirements and functional documentation. At this point it is also a possibility that questions about these requirements will come up, so this would also be a good time to get some extra confirmation from the PO or BA in case of doubts about the expected results.

Image Added

After all test cases/test steps have been created and the tests have good coverage for this story, the Test ticket can be set to done, in order to know that this Test can be executed as soon as development and reviewing is done for the story.

4. Creating a Test Execution ticket for this sprint

Once all the Test tickets have been created it is possible to get an overview of their status by looking at the XRay Test Plan Board just to see which Test tickets should still be completed.

Image Added

If all Test tickets are done, it is possible to create a Test Execution ticket for all of them in once from within the Test Plan ticket:

Image Added

Once All Tests has been selected, a new ticket will be created with the Test Execution of all the tickets. It is of course also possible to add one Test at the time to the execution ticket, so it is not necessary to wait until all Tests are done. 

It is important to check that just as with the Test Plan, this Test Execution is linked to the current sprint.

5. Executing Tests

There are several ways to execute the Test created for the stories. It is possible to get to the execution from the Test Plan. Just click on the little triangle on the left side of the desirable Test and the Test execution will show. From there the Run icon on the right side shows and can be clicked to start the Execution of this Test:

Image Added

This same icon can also be used for Tests that already ran, to see the execution details for example:

Image Added

Another way to execute test is from within the Execution ticket itself. From there it will be possible to execute them immediately:

Image Added


A third option to execute the Test is from the Test ticket itself:

Image Added

If for some reason this Test has not yet been added to this sprints Test execution, this can also be done here:

Image Added

These 3 ways of getting to the actual execution will result in the same execution screen, where the earlier created Test case will show and be replayed by the Tester. It's following the exact steps and compare the expected result with the actual result.
Evidence like response body's or screenshots can be added for each step or in general. The final stage is of the execution is either to let it fail or pass by choosing the colored little box on the right bottom place of each test step:

Image Added

If all steps succeed (green box), the ticket will appear as a Pass in both the Test Plan and the Test Execution ticket, as well as on the Xray Test Plan Board and in the story. Once all Tests from the Test execution/Test Plan have passed, the stories can be set to ready for deployment and the sprint can be closed.8. Test is completed when all test steps are green for latest Test Execution


Boards


XRAY Test Plan Board

Planning per sprint
Image Modified


Jira Project Board YIS- All test products

Issue type visible on board: Plan and Plan Execution

Use Switch sprint at the top to filter on a specific sprint.

Image Modified