Applies to ReadyAPI 2.7, last modified on June 25, 2019

About Zephyr

Zephyr is a test management solution you use to create and manage tests.

Zephyr has different editions. Currently, ReadyAPI integrates with the Zephyr for Jira Cloud edition only. So, when we say Zephyr, we mean Zephyr for Jira Cloud.

Zephyr 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:

Zephyr integration: A Zephyr test cycle

Click the image to enlarge it.

To learn more about Zephyr, see its documentation.

Supported Zephyr versions

There are different Zephyr editions:

Zephyr integration in ReadyAPI supports the Zephyr for Jira Cloud edition only. You cannot use it with the standalone Zephyr application and other Zephyr for Jira editions.

As we have said above, when we say Zephyr, we mean Zephyr for Jira Cloud.

How integration works

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:

Zephyr integration: How integration works

Click the image to enlarge it.

Requirements

To start using the integration, make sure your Jira instance has the following apps installed:

Show how to install apps

Enable integration

1. Connect ReadyAPI to Jira

Zephyr integration: ReadyAPI preferences

Click the image to enlarge it.

  1. Open ReadyAPI Preferences.

  2. Switch to the Zephyr Integration tab.

  3. Specify all the settings on the tab:

    Option Description
    JIRA Cloud URL The URL of your Jira instance.
    Zephyr Base URL The URL of the Zephyr for Jira Cloud API:
    https://prod-api.zephyr4jiracloud.com/connect
    Don’t place a slash or a backslash at the end of the URL above:

    https://prod-api.zephyr4jiracloud.com/connect← Wrong !!!

    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.
    If you use an API token (for example, when you use two‑step verification), you must use the email address.
    API Token or Password The API token or password of the user account.
    If you use two-step verification you must use an API token.

    How to get an API token

    Access Key
    Secret Key
    The access and secret keys for your ZAPI installation.

    How to get Access and Secret keys

  4. To check whether your settings are correct, click Test Connection.

  5. Click OK.

2. Map a ReadyAPI project to Zephyr

To map your ReadyAPI project:

  1. Open your project and click Map to Zephyr:

    Zephyr integration: Map project to Zephyr

    Click the image to enlarge it.

  2. Specify the following options in the subsequent dialog:

    Option Description
    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.

3. Associate a test case with a Zephyr test

To post the results of a test case run to a test execution, you need to associate your test case with a Zephyr test. To do this:

Zephyr integration: Associate a test case

Click the image to enlarge it.

  1. In the test case editor, click to open the TestCase options dialog.

  2. Switch to the Zephyr tab and select the ID of a Zephyr test.

  3. Click OK.

View ReadyAPI test results in Jira

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:

Zephyr integration: Cycle summary

Click the image to enlarge it.

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:

Zephyr integration: View test execution details

Click the image to enlarge it.

See Also

Integrations
JIRA Integration

Highlight search results