This plugin enables continuous integration using Jenkins and Xray Test Management. In a nutshell, this connector provides tasks to publish test results from Jenkins to Xray.
Xray is the leading Quality Assurance and Test Management app for Jira. More than 4.5 million testers, developers and QA managers trust Xray to manage 100+ million test cases each month. Xray is a mission-critical tool at over 5,000 companies in 70+ countries, including 137 of the Global 500.
Full Documentation
The guide below it's a "Quick Start" version of our full documentation available in Xray official page:
You can also check the source code of the plugin here: https://github.com/jenkinsci/xray-connector-plugin
Xray for Jenkins is configured in the global settings configuration page:
Manage Jenkins > Configure System > Xray configuration.
To add a new Jira instance connection, you need to specify some properties:
Note: the Configuration ID is not editable. This value can be used in
the pipelines scripts.
After setting the instances, you can test your connection to Jira, by
using the and Test Connection button.
When you are done configuring your Jira instances, don't forget to
save the changes.
Currently, we support Freestyle, Pipeline, Multi-configuration Projects and Maven projects.
This plugin provides 2 new Build tasks:
The Xray: Cucumber Features Export Task and the Xray: Cucumber Features Import Task
Both tasks can be used while executing Cucumber tests: In a typical Cucumber Workflow, after having created a Cucumber project and the Cucumber tests specified in Jira, you may want to have a project that exports the features from Jira, executes the automated tests on a CI environment and then imports back its results.
For this scenario, the Jenkins project would be configured with a set of tasks responsible for:
Alternatively, you can also use Cucumber features that are hosted outside Xray and import them to Jira by using our Cucumber Features Import Task.
In the Post-build Actions, you can add the Xray: Results Import Task, in order to import your Test Results in the following formats:
Check out Xray Test Management website to understand how to leverage Jira for Test Management and start a free trial.
If you need any help using in Xray or this plugin, you can contact us by using our Support System.