Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

About

Jira Integration: Zephyr Enterprise is an app that allows you to view the traceability of Zephyr test cases and create BDD scenarios in sections it adds to the Jira issue view. The plugin adds the following sections:

  • Zephyr Enterprise - Traceability - this section is available if you installed the app into a Jira Cloud or Server/Data Center instance. Here you can view all the test cases linked to the issue with information on the test cases' release, cycle, phrase, status, and so on. Zephyr updates this table whenever it detects any changes in test case data:

    Image RemovedImage Added
  • Zephyr Enterprise - Feature Content - this section is available if you installed the app into a Jira Server/Data Center instance. In this section, you can quickly create BDD scenarios. It is shown if your issue is mapped to Zephyr Enterprise requirements:

    Image RemovedImage Added

On this page:

Table of Contents
maxLevel3
minLevel1
exclude^On this page

Requirements

  • Zephyr Enterprise Cloud (*. yourzephyr.com or *.zephyrdemo.com). Version 6.6 or later is required.

  • Jira Cloud (*.atlassian.net), Jira Server 7.0 or later, or Jira Data Center 7.0 or later.

Installation & Configuration

To install the plugin, you must be an administrator in Jira. You may find the plugin at the Atlassian Marketplace here.

1. Install the plugin

Installation steps:

1. Click Apps > Find new apps in Jira:

2. On the subsequent page, type Zephyr Enterprise in the search box and press Enter:

3. Click the found Jira Integration: Zephyr Enterprise app:

4. Click Get app in the top-right corner of the subsequent page:

5. Click Get it now in the Add to Jira dialog:

6. A message informing that the add-on has been added successfully will appear in the top-right corner of the Jira window:

Now you can configure Zephyr Enterprise instances.

2. Configure integration with Jira

To configure integration with Zephyr, you must be an administrator both in Jira and in Zephyr. The configuration includes generating an API token in Zephyr Enterprise and configuring the connection in Jira by using this token.

Generate an API Token in Zephyr

1. Log in to Zephyr Enterprise as a Test Manager.

2. Navigate to Administration > API Token and click Create API Token:

3. Enter a name for your token and click Create:

4. Copy the generated API token - you will need it to configure the connection in Jira:

Configure the connection in Jira

1. Log in to Jira as an administrator.

2. Navigate to Apps > Manage Apps:

3. Expand the Jira Integration: Zephyr Enterprise item and click Configure,or just click Zephyr Enterprise integration in the panel on the left:

4. In the subsequent dialog, specify the following:

  • The configuration name (an arbitrary label).

  • The URL of your Zephyr Enterprise instance. Make sure to include https:// at the beginning.

  • The API token previously generated in Zephyr.

Click Configure to save the information.

Note

When specifying your Zephyr URL, make sure the address has no suffix after …yourzephyr.com (see the image above.)

Info

In the dialog, you can also:

  • Click Help in the top-right corner to view the add-on documentation or create a support request.

  • Click the link below the Zephyr Enterprise URL to start a free Zephyr trial.

(warning) If the connection with Jira is not set up properly, the sections show a warning informing about the issue:

Import Jira issues as requirements and map them to test cases

Both admins and non-admin users can import requirements to Zephyr and map them to test cases. To import requirements, follow the steps described in Importing Requirements. Below is a sample list of imported requirements:

Once done, map the imported requirements to the test cases the links to which you want to have in your Jira issues. To learn how to do that, see Mapping Requirements to a Test Case. Below is a sample list of test cases with mapped requirements:

Info

You can import a requirement to multiple Zephyr instances and map test cases to it in those instances, or import several requirements and map them to test cases. In either case, the Zephyr Enterprise section will contain links to all the mapped test cases.

View test case traceability in Jira

After configuring the integration and mapping requirements to test cases, you can view test case traceability in your Jira instance. To do that, open your Jira issue and scroll down to the Zephyr Enterprise - Traceability section to view all the traceability details:

The table shows the name of the project, as well as the names of the release, cycle and phase the test case belongs to. The section also shows the status of the last execution of each release. Clicking the status will open the execution in Zephyr.

Create BDD scenarios

If you installed the Jira Integration: Zephyr Enterprise app into a Jira Server/Data Center instance, you can create BDD scenarios after configuring Jira integration. To do that:

  1. Create a Jira issue you are going to work with.

  2. Import that Jira issue as a requirement in the release folder using Jira sync or Move the Imported folder to the release folder to any existing requirement in Zephyr Enterprise.

  3. If you don’t have a folder in Zephyr’s Test Repository, create one. Otherwise, you will get an error in Jira when trying to create a scenario.

  4. Go back to Jira and add the BDD_Feature label in the context fields of your Jira issue.

  5. The scenario editor will appear under Zephyr Enterprise – Feature Content. You can now create BDD scenarios:

    Image RemovedImage Added

(info) If the Zephyr Enterprise section is not visible, you can open it by clicking the ellipsis button at the top and selecting Zephyr Enterprise from the dropdown:

Image RemovedImage Added

Scenario Outline (Beta Feature)

Support for Scenario Outline - Make ZBot compatible with Scenario Outlines

Scenario Outlines can be created from Feature Editor and use ZBot for their execution.
The property checkSteps=true in zbot.properties is mandatory to allow the new behavior.
More details regarding ZBot can be found in Zephyr Test Automation.

Info

Note: This feature will be available from Zephyr Enterprise 7.13 release.

 

Example:

Step 1: Create a new Scenario in Feature Editor
The scenario can be named with a simple name e.g. Scenario 1 but it can be named also with parametrized name e.g. Scenario <num1>. This parameter should exist in the example table on the scenario outline.

 

Step 2: Add the content of the new scenario outline and save it.

Code Block
Given <num1> + <num2>
Then result equals <result>

Example: 
   |num1|num2|result|
   | 1  | 2  |  3   |
   | 2  | 2  |  4   |

 

Step 3: On Zephyr Enterprise one test case was created per example row.

With the previous example, there would be two test cases created:

  • Given 1 + 2
    Then result equals 3

  • Given 2 + 2
    Then result equals 4

 

Step 4: The result file for ZBot should have all example results that will be matched with test case.

See Also

Jira Integration