Xray provides useful and detailed information about the Requirement Coverage in every project trough a project tab panel named "Requirement Coverage Charts" and also the Requirement Status Custom Field.
The Requirement issue coverage status is calculated based on all Tests that are associated with the Requirement and all the Sub-Requirements Status. The following list details the coverage status of a requirement:
The Status of a Test for a particular Requirement is calculated based in the Requirement Coverage Strategy.
| REQ ∧ SUB-REQ | OK | NOK | NOT RUN | UNKNOWN | UNCOVERED |
|---|---|---|---|---|---|
| OK | OK | NOK | NOT RUN | UNKNOWN | OK |
| NOK | NOK | NOK | NOK | NOK | NOK |
| NOT RUN | NOT RUN | NOK | NOT RUN | UNKNOWN | NOT RUN |
| UNKNOWN | UNKNOWN | NOK | UNKNOWN | UNKNOWN | UNKNOWN |
| UNCOVERED | OK | NOK | NOT RUN | UNKNOWN | UNCOVERED |
Even if you have sub-requirements, when you have tests directly linked to the parent requirement, Xray considers that you are validating the requirement directly, thus it's irrelevant if the sub-requirements are uncovered by tests. |
Requirement issues with certain statuses can be excluded from the Requirement Coverage charts. These statuses can be configured in Xray configuration.
Requirement issues with certain labels can be excluded from the Requirement Coverage charts. These labels can be configured in Xray configuration.
Test issues with certain statuses can be excluded from the Requirement Coverage calculation. Test issues with ignored statuses will not be considered when calculating the Requirement Status, even if they are associated with Requirement issues. These statuses can be configured in Xray configuration.
The Requirement Status and the Test Coverage are presented in the Requirement issue view.
You can choose a specific analysis version to calculate the Requirement Status. This can be useful when testing multiple versions of your requirements at the same time or if you need to see the requirement coverage for previous versions. The analysis version can be "No Version". In this case, the requirement status will be calculated based in the latest execution for each Test, independently of the execution version.
You can also choose a specific Test Plan to calculate the Requirement Status. This will calculate the requirement status based on the executions for that Test plan. This can be useful when you have multiple test plans and need to see the requirement coverage for a specific Test Plan.
The "Requirement Coverage Charts" is divided in two reports:
The requirement coverage reports provide allow you to analyse the test status of requirement issues in the current project and have na overview of how the many requirements are OK, NOK, Not Run and Uncovered.
These reports will also give you an overview of requirement status by version or test plan.
You can choose a specific analysis version to generate the report. This will calculate the requirement status based on executions for that version. This can be useful when testing multiple versions of your requirements at the same time or if you need to see the requirement coverage for previous versions. The analysis version can be "None". In this case, the requirement status will be calculated based in the latest execution for each Test, independently of the execution version.
You can also choose a specific Test Plan to generate the report. This will calculate the requirement status based on the executions for that Test plan. This can be useful when you have multiple test plans and need to see the requirement coverage for a specific Test Plan.
Besides being able to analyse the coverage status by Version and Test Plan, Xray also allows you to specify a Test Environment to calculate the status for requirement issues. You can specify an Environment when using both Version or Test Plan analysis. In case where you want to aggregate the status for all environments, just choose the "All Environments" option. If you choose a specific environment, then Xray will only consider the Test Execution issues that are scoped by this environment when calculating the Requirement Status.
You can also choose a grouping field to group requirements within these charts. You can for instance generate a report based on requirement Priority, Resolution, or any other field of type "Select List" that you have configured for your requirement issues.
In the Requirement Coverage charts, you can filter requirements to show in the charts either using the basic filter fields provided:
or use a previously "Saved Filter" with Requirement issues.
Each time a user accesses the "Requirement Coverage" project page, the chart will be generated with the user's last chosen options. This includes the report and all the filters for the requirement issues.
There is also an options menu where you can choose the visualisation type for the charts:
The Requirement Status custom field is created when Xray is installed and associated with the JIRA Default Issue Screen. This custom field is only shown for a particular issue if it's issue type is defined as a Requirement in the Xray configuration.
The Requirement Status displays a color bar reflecting the current Status of the Requirement coverage. When hovering this bar, a detail bar appears showing all the tests for the Requirement and their current status. The number of Tests in each status is also displayed and can be clicked to show the Test issues in the issue search page.
Because the Status of a Requirement can depend of the Version, there are 3 possible strategies you can choose that affect the versions displayed by this field. These strategies can be changed in the Xray configuration.
When this option is enabled, the status of each Test associated with the Requirement is calculated based in the latest TestRun, independently on the version it was executed.
When this option is enabled, only the earliest unreleased Fix Version is displayed in the Custom Field.
When this option is enabled, all unreleased Fix Versions are displayed in the Custom Field.
When this option is enabled, only explicitly assigned Fix Versions are displayed in the Custom Field.
The requirement coverage strategy defines how the Requirement Status must be calculated. The strategy to use must be configured in Xray configuration.
When the option for "Use versioned Test Executions for Requirement Coverage" is enabled in Xray configuration, the Status of a Requirement for a specific Fix Version V is calculated based on the latest Test Run with Fix Version V of each associated Test (check how the latest Test Run is chosen). With this strategy, a Requirement can have different Statuses one for each Fix Version in the project.
When the option for "Use versioned Test Sets for Requirement Coverage" is enabled in Xray configuration, the requirement coverage will be calculated based in Test Sets.
The main goal of this option is to use Test Sets as containers for tests of different versions related with the same requirement. This allows for regression Test Sets in subsequent versions.
Requirement Tests must be associated with Test Sets of a specific Fix Version to be considered for Requirement Coverage of that particular version. A given Test T is considered for requirement coverage of Requirement R in the version V if:
1) T is associated with R with link type relation "tests/is tested by"
2) T is associated with any Test Set with version V
Once Test T is considered for coverage in version V, it's Status is calculated based on the latest Test Run with the specified Fix Version V.
(check how the latest Test Run is chosen)
"I have an Xray Project to Test my Requirements project. I've created a Test and I have already executed the Test but I always get requirements status Covered but Not Run."
You might be using environments on Test Executions that are affecting the aggregated status for the Tests. If you have a couple of Test Executions, one with a specific environment (ex: Android) and another without any environment, then Xray will also consider the empty environment for calculating the aggregated status (this, of course, if all Test Executions are in the same scope of Version or Test Plan). |
You have not configured your versions accordingly. Remember that requirement coverage through are calculated with Test Execution and/or Test Set for a Requirement Fix version. |
You must have the same versions name between projects. You must guarantee you have set Test Execution fix version with the same value of Requirement Issue fix version |
