Back to QMetry All Products Help Page

Migrate Zephyr Test Cases to QMetry Test Management for Jira

Owned by Mrunalini Potnis
Last updated: Jul 09, 2022
4 min read

QMetry Test Management for Jira allows its users to migrate test cases from Zephyr Squad to QMetry Test Management for Jira Cloud v4.0. Issues with issue type "Test" from the source project will be added as QMetry Test Cases in the target project.

The following document contains pre-requisites and steps migrating Tests from Zephyr Squad to Test Cases in QMetry Test Management for Jira.

Pre-requisites

  • The following Zephyr add-ons should have installed and enabled on the Jira instance.

    • ZAPI for Cloud

    • Zephyr Squad add-on

  • QMetry Test Management for Jira feature (Project Settings > QMetry Project Settings) should be enabled in the target project.

  • If the Permissions feature is enabled for the target project, users must have the Import permission (Project Settings > QMetry Permissions) assigned to them.

Zephyr Squad to QMetry Test Management for Jira test case migration steps

1. Open the QMetry Test Management for Jira instance.

2. Select Configuration on the navigation bar.

3. Then select External System Import.

The External System Import screen opens.

4. Select Zephyr as External System and click Next.

It opens Import from the Zephyr screen.

5. Enter Zephyr Access Key and Zephyr Secret Key. Refer to How to get Zephyr Access Key and Zephyr Secret Key below for more details.

 

Select options items that you like to copy from Zephyr test cases during import:

Create MetaData: If the field values (Label, Component, Status, Priority, Custom Fields) are not present in the target project, then the mentioned metadata values will be created in the target project. For Custom Fields, users should have access to modify/add custom fields. If the Create Meta Data option is not selected, then these fields will be ignored. Status and Priority will have default values in it TO DO and Medium respectively.
Comments: Select the check box to export Comments along with the other details of test cases.
Attachments: Select the check box to export Attachments along with other details of test cases.

Import Criteria

Users can provide single or multiple Import Criteria. The Import Criteria includes the following fields.

  • Source JQL: Enter valid JQL to import all issues with the Issue Type "Test" from Jira. You can also import issues from multiple projects by writing JQL accordingly e.g., project in (FR, RP) AND issuetype = Test. Use the "Order by key ASC" clause in JQL to import the test cases in ascending order.

  • Select Target Project: This is the QMetry for the Jira project in which you want to migrate the Zephyr test cases.

  • Select Target Folder: This is the folder in the target project in which the test cases will be imported.

  • Select Target Sprint: The drop-down shows all sprints along with boards from the target project. The selected sprint will be assigned to the test case in the target project.

  • Select Target Fix Versions: The drop-down shows all Jira fix versions from the target project. The selected version will be attached to the test cases in the target project.

Test Cases from Zephyr are imported into the target project of QMetry Test Management for Jira.

Test Cases that get copied to the target project have the following values that are as per the options selected on the Import screen.

  • Test Case details like Summary, Description, Status, Priority, Assignee, Reporter, Labels, Components

  • Custom Fields

  • Test Steps

  • Comments

  • Attachments

How to get Zephyr Access Key and Zephyr Secret Key?

 

1. Open the Zephyr Squad instance.

2. Select Tests on the navigation bar.

3. On the next screen, select API Keys option on the navigation bar. It opens the Zephyr API Key pop-up showing Access Key and Secret Key.

Note: The Access Key and the Secret Key are unique for every user. 
If you are generating the Access Key and Secret Key the very first time, the following pop-up appears. Click on the "Generate new key" button. Then the pop-up opens with Keys on it.

 

Back to QMetry All Products Help Page