Jenkins : Xray Connector Plugin

Plugin Information

View Xray - Test Management for Jira on the plugin site for more information.

Older versions of this plugin may not be safe to use. Please review the following warnings before using an older version:



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.


Full Documentation

The documentation 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

Upgrading from version below 2.1

If you are upgrading from a version below 2.1, you have to:

  1. Uninstall the old version of the plugin (xray-for-jira-connector)
  2. Go to the Xray configuration section and re-write your instances credentials
  3. Re-save (you don't need to change any data) any Project/Job that is using Xray steps.


Features

  • Integration with both Xray in Jira Cloud and Jira Server/Data Center
  • Export Cucumber features files from Xray
  • Import Cucumber feature files to Xray
  • Import your test results in any format supported by Xray

Requirements

  • Jenkins 2.60.3 or above
  • At least one Jira instance (Server, Data Center and/or Cloud) with the Xray installed.

Need help?

If you need any help using in Xray Test Management for Jira or this plugin, you can contact by using our Support System.

Configuration

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:

  1. Configuration alias: the name you want to give to this configuration
  2. Hosting: Hosting (instance type) in this case Cloud/Server/Data Center
  3. (Server/Data Center only) Server Address: The address of the Jira Server where Xray is running
  4. Credentials:
    1. Use the Jenkins Credentials Plugin to set the username/password (if you are using a Server/Data Center instance) or an API key/secret (if you are using an Cloud instance)
    2. Make sure that the user you are using have the following permissions in the projects where you want to import the results and import/export feature files: View, Edit, Create

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.

Job Tasks

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:

  1. Pulling the Cucumber project
  2. Exporting Cucumber features from Jira to your Cucumber project
  3. Executing the tests in the CI environment
  4. Importing the execution results back to Jira



In the Post-build Actions, you can add the Xray: Results Import Task, in order to import your Test Results in the following formats:

  • Xray JSON
  • Xray JSON Multipart
  • Cucumber JSON
  • Cucumber JSON Multipart
  • Behave JSON (Xray Server/Data Center Only)
  • Behave JSON Multipart (Xray Server/Data Center Only)
  • JUnit XML
  • JUnit XML Multipart
  • Nunit XML
  • NUnit XML Multipart
  • Robot XML
  • Robot XML Multipart
  • TestNG XML
  • TestNG XML Multipart
  • xUnit XML (Xray Cloud only)
  • xUnit XML Multipart (Xray Cloud only)


Want to learn more?

Check out Xray Test Management website if you want to learn more about Xray and understand how to leverage Jira for test management. Feel free to try it out.


Attachments:

configuration.png (image/png)
build-steps.png (image/png)
import-results.png (image/png)