Back to QMetry All Products Help Page
Migrate Zephyr Test Cases to QMetry Test Management for Jira
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:
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