Page History
Xray for JIRA provides a built-in project template so all Xray Issue Types and Screens are associated to the newly created project. This way, each project can be customized without affecting other projects.
Table of Contents |
---|
Creating the project
To create an Xray project, you must select the Xray Test Project in the Create Project Module. Then, you must read read the short description and finally choose your project name and key.
...
Structure
When you create an Xray Project, a project-specific structure with several entities is created.
Issue Type Scheme
A specific Issue Type Scheme for the project. This scheme uses all Issue Types from Default Issue Type Scheme and adds, if not already added, all Xray Issue Types.
Screens
Xray creates 9 project-specific Screens. Each Xray Issue Type has 2 screens (one for create/edit and one for view the issueviewing) and all other Issue types are mapped to the default screen.
Screen Schemes
Xray creates 5 project-specific Screens Schemes. Each Xray Issue Type has 1 screen scheme (configured with the 2 screens shown above) and all other Issue types are mapped to the default screen scheme.
Issue Type Screen
...
Scheme
Xray creates a projectproject-specific Issue type Screen Scheme (configured with the 5 screen schemes shown above).
Requirements Project
When creating an Xray project to test a Requirement Project, there is are some configuration configurations that are optional but strongly recommended by the Xray team.
Replicate versions name to the newly created project
In order to calculate the overall requirement coverage by versions, you must guarantee that versions from the Requirement project and Test project are the same.
There are two ways to replicate the version names: Creating a Test Project using Xray Template and Creating a Test Project using Xray TemplateAutomated and Manual.
Automated
Info |
---|
Bear in mind that the Automated replication will copy all versions name from the chosen projects |
Go to Administration-> Projects -> Xray > newly created Xray project -> Actions -> Copy Project versions
- Chose Choose the projects which you want to copy the versions
- All versions from the selected projects will be replicated to your Xray your newly created Xray project.
Manual
- Go to Administration-> Projects -> Choose your Requirement project -> Versions
You'll see this screen: - Go to Administration-> Projects -> Xray > newly created Xray project -> Versions and replicate . Replicate the version names
See the Project Panel
a) Add Xray Issue Types to your project to see the Project Panel
The first option is to add Xray Issue Types to this project scheme. It's quite a quiet simple process.
Go to Administration -> Issue type schemes
...
Edit the requirement project adding Xray Issue Types.
b) Disable Project Aware Condition
Another way is to to disable the option "Project Aware Condition" option in the Xray configuration : (see Global Preferences).
This option disables Xray screens in projects which do not have the Xray Test issue type present. Please bear in mind that the screens will be available for all projects
Now, you're able to see Overall Coverage Chart panel.
Add Requirement Status field to your Requirement screens
When you install Xray addo-on, Xray it will add relevant fields to Defaul Issue Type Screens, if . If you only use these screens, then you should do not have to perform the following action. If you use customized screens, then Xray have not add added any custom field fields to those screens. We recommend you to add Requirement Status to you Requirement issue type screens. Follow these steps illustrated by those in the images below.
You must repeat these steps to each for every Requirement issue type screen.
...
This is a requirement without Requirement Status field.
You can see that a custom field is not associated to with this screen.
Just go to the specific screen listed on the previous screen and add the field to the screen.
Now, you can see the requirement status Requirement Status of this requirement.