Because Xray uses issue types for mapping test concepts, you can choose how to organize your projects to best suit your organisation needs. You can keep your current projects separate from Xray, or combine them together.
Xray is flexible enough to deal with scenarios where for security or compliance reasons you have to manage JIRA entities on different projects.
Creating or Configuring Test Projects
Please check the following links in order to:
- Create a new testing project using the Xray project template
- Configuring an existing project with the Xray issue types and screens
Project's Organisation Use Cases
Bellow we present some common use cases of how to use Xray in combination with other projects in JIRA. Xray issue types support associations from different projects. You can add Tests from one project to Tests Executions on another project, or even mix Tests from different Projects in the same Test Execution or Test Set issue.
All for One and One for All
You can use a single project to manage your Requirements and Defects, Test related issues and also have all your Test Executions.
Don't mix my Requirements and Defects with Tests
If you already have a JIRA project for managing requirements and defects and don't want to have any tests nor executions in this project, you can create a separate companion project just for testing purposes.
Dedicated repository for Tests
Another common use case for Xray is to have a dedicated project for Test (and Pre-Condition and Test Set) issues; sometimes called a Tests repository. Test Executions are the responsibility of other project(s). This separation allows to manage permissions more effectively, so maybe only a set of testers has permission to write tests and others to execute.
Of course, this use case can also be combined with the previous use case by having also separate projects for managing Requirements and Defects.
Test Execution Versioning
If you plan to have separate projects for managing Requirements/Defects and Tests Executions, and want to analyse Requirements by version, then your Requirement's project version names must match the names of the Test Execution's project, this is how to do it.
Completely Separated
In this use case, you have the Tests, Requirements, Executions&Plans and Defects all separated and being handled on different projects.
Isolated repository for Tests
In this more uncommon scenario, you would have your requirements outside of JIRA in some other tool and use JIRA only as a test repository, for creating Tests, Test Sets, Test Plans and Test Executions.
You can use Xray for this, but you will loose the benefits of requirement coverage and traceability.
User's implementing this scenario might gain huge benefits if they are able to synchronize requirements between the other tool and JIRA.