Zephyr is a test management solution you use to create and manage tests. It is available in the following editions:
Zephyr for Jira
Zephyr for Jira, in its turn, is available for different Jira Software editions: Cloud, Server, and Data Center.
ReadyAPI integrates with the following Zephyr editions:
|Edition||To learn how to configure|
|Zephyr for Jira Cloud||See this topic.|
|Zephyr Standalone||See the Zephyr Standalone documentation.|
Currently, ReadyAPI does not integrate with Zephyr for Jira Server and Data Center.
Zephyr for Jira (or Zephyr for short) adds a test issue type to your Jira projects. You use tests to declare test steps and describe the expected results. You organize tests by releases, link them to other Jira issues (tasks, stories, bugs and so on), assign tests to QA engineers and store the results of test runs.
For each release, you use one or more test cycles to plan your testing process and monitor the test results:
To learn more about Zephyr, see its documentation.
Zephyr contains information on how tests should be run and stores their results. QA engineers have to run tests manually and enter the results in Zephyr.
Using Zephyr integration in ReadyAPI, you can automate test runs and pass their results to Jira.
When you map your ReadyAPI project to Zephyr, you bind it to an individual test cycle and associate a SoapUI test case with a Zephyr test. Thus, each time you run the test case, ReadyAPI will post its results to the test execution of the related test in the specified test cycle:
|Note:||ReadyAPI will not update Zephyr tests that are not included in the test cycle you set in your project options.|
To start using the integration, make sure your Jira instance has the following apps installed:
Log in to your Jira instance as an administrator.
Open Jira settings > Apps > Find new apps.
Search for Zephyr:
Install the Zephyr for Jira - Test Management and ZAPI apps. To do this, select one of the apps and click Start trial in the subsequent dialog:
Open ReadyAPI Preferences.
Switch to the Zephyr Integration tab.
Specify all the settings on the tab:
|JIRA Cloud URL||The URL of your Jira instance.|
|Zephyr Base URL||The URL of the Zephyr for Jira Cloud API:
|Login||The username or email address of the user on behalf of which ReadyAPI will post the results. This user must have the appropriate permissions.
|API Token or Password||The API token or password of the user account.
How to get an API tokenHide steps
|The access and secret keys for your ZAPI installation.
To check whether your settings are correct, click Test Connection.
To post the results of test case runs to Zephyr's test executions, you need to map your test cases to Zephyr tests. To do this:
Open your project and click Map to Zephyr:
Specify the following options in the subsequent dialog:
|Project Name||The name of the Jira project.|
|Version||The release version of the Jira project with which you want to associate the ReadyAPI project.|
|Cycle||The test cycle with which you want to associate the ReadyAPI project.|
Associate test cases with Zephyr tests by using a drop-down list next to each test case.
|Tip:||You can also associate a test case in the TestCase options dialog.|
Each time you run a test case, ReadyAPI posts the results of the test case run to the associated Zephyr test execution within the specified test cycle:
For each failed test execution, ReadyAPI posts a comment with detailed information on what went wrong.
|ReadyAPI replaces the existing comments.|
To see the comments, select the needed test execution and switch to the Detail view: