In this module you will learn how to create a new project that has both Requirements & Xray entities, as an All-In-One project.

Create Project

Go to Jira Administration > Projects > Create Project or directly from the header (global menu) Create Project.

Onboarding > Creating a new project with Xray > Screenshot 2020-08-06 at 11.51.25.png

Select Template

When creating a project you have different templates available that will bring you different schemes ( issues, screens & workflows) and that can have different features.

You either select a Jira template, like the SCRUM Software Template or the Project Management template or you can select an Xray Test Project Template.

Select the desired template, and click next to follow the wizard.

Onboarding > Creating a new project with Xray > Screenshot 2020-08-06 at 12.04.31.png

When creating a new project you can either created based on a template or you can create with the shared configuration.

The main difference is that when you create based on a template you will create new schemes.

Schemes Created

Based on a template

Workflow scheme

Issue type scheme

Issue type screen scheme

Based on a shared configuration

None ( its uses the same schemes from the shared project)

You might find it useful to re-use the schemes that you have already configured in another project. If so, use the "Create with shared configuration" option.

Onboarding > Creating a new project with Xray > Screenshot 2020-08-06 at 14.55.18.png

Depending on the template you have chosen you may need to perform specific configurations to make the project totally enabled for Xray:

		Need to Enable Xray Requirement Coverage?	Need to add Xray Issue Types?
JIRA Software	SCRUM software development Kanban software development Basic software development
JIRA Service Desk	Basic IT Service Des Customer Service
JIRA CORE	Project Management Task Management Process Management
XRAY	XRAY Test Template

The Xray Project template uses Default Scheme and adds the Xray Issue Types.

If you use the Xray Project Template, you may need to update the project type to "Software" in order to get software projects features, like backlog, sprints and others.

Get to know more about Xray Templates in the step "Understanding the Xray Test Project Template".

Check the next step to understand how to perform these configurations.

Enable Xray in your projects

In the project Administration page, go to Actions at the top right-hand side. You must:

a) set your project as a Requirements project by choosing "Enable Xray Requirement Coverage," so the requirements are covered by tests;

and

b) If you didn't use a template that already has Xray issue types (i.e., Test, Test Set, Test Execution, Test Plan) you need to add them to the project.

To "Add Xray Issue Types" you must belong to a group allowed to do so in Xray settings. This permission is set in Jira Administration > Manage Apps > Miscellaneous > Users Groups allowed to add Xray Issue Types.

This module details you the minimum configuration that needs to be done to create a new project with Xray enabled. Go to Basic & Advanced Setup to explore other configuration possibilities.