Qualio continues to evolve its capabilities to integrate information from different third party applications. The Zephyr Scale integration is an extension of this by adding support for another popular test case management tool.
Please note that this integration is for Zephyr Scale only. Zephyr Squad and Zephyr Enterprise are not currently supported.
Skip ahead to:
Integration Workflow
The integration between Zephyr Scale and Qualio starts, actually, with Jira. An Epic or Story is created in Jira. The previously configured integration between Jira and Design Controls automatically creates the requirements in Design Controls. Then, using the Jira/Zephyr Scale integration, a test case is created and linked to the epic or story.
This update will be pushed automatically to Design Controls and the test case will be reflected in Design Controls related to the correct requirement as displayed below.
Later, when a test is executed the result will be pushed to Design Controls. The result will be updated with any subsequent test result.
Test cases are created and managed through Zephyr Scale which can be added to test plans and cycles with no impact to Design Controls.
Integration Details
The integration between Zephyr Scale and Qualio is one way with information flowing from Zephyr Scale into Qualio. Zephyr Scale is considered the source of truth; when changes are made to the test case in Zephyr Scale this information will be reflected in Qualio. API calls are made to Jira/Zephyr every 5 minutes to check for new or updated test cases related to a Jira requirement, or new or updated test results and every 30 minutes to clean up any test cases that have reached the end of their workflow within Zephyr Scale.
Integration Requirements
Integration is for Zephyr Scale only; Zephyr Squad and Zephyr Enterprise are not currently supported
Must have a Zephyr API Access token generated
Design Controls is only available to customers on Starter, Growth, and Plus plans
Test cases can either be Validation (level 1) or Verification (level 2) tests. Validation tests are ones that apply to level one requirements (Epic in Jira) whereas Verification tests apply to level two requirements (Stories in Jira).
The following Test Case details are synced to Qualio:
Test case name
Description
Created Date
Last Modified Date
Related Jira ticket(s)
Test case status
Test Steps in one of the following formats:
Plain Text  |
Step-by-Step  |
BDD - Gherkin  |
In addition to test cases, the results of the test executions are pushed to Qualio. The following test result information is included:
Date of last test run
Person who ran the test
Comments
Links to test case
Test result
Mapped Test Status options from ZephyrScale to Design Controls
Zephyr Scale Status | Design Controls Status |
Not Executed | Failed |
In Progress | Failed |
Pass | Passed |
Failed | Failed |
Blocked | Blocked |
Reference Images
Design Controls - Requirement Preview showing related Test Case and no result  |
Zephyr Scale - Input test result  |
Design Controls - Test Case Preview with Passed Test Result  |
Design Controls - Test Case Preview with Blocked Test Result  |
Steps to Configure Integration
Zephyr Scale Configuration
Zephyr Scale is a Jira plugin that can be installed through the Jira marketplace.
Install Zephyr Scale app in Jira. (See third party instructions)
Once installed, enable the app for your Jira project/s. (See third party instructions)
Each project must be previously mapped to Design Controls via the Jira integration
Generate API Access Token. (See third party instructions)
This only needs to be generated once per customer account.
The Access Token ID is not the same as the token value itself
An access token value cannot be retrieved after the create dialog is closed; a new token will need to be generated if the token is lost
Configure Qualio Integration
At this time, customers will need to work directly with a Qualio engineer to enable the integration, similar to the previously configured Jira integration. Part of this process includes securely sharing the API access token with Qualio. To get started, contact our Customer Support team via the in-app chat. A support ticket will be generated and a Qualio engineer will respond with next steps.
Once the integration is complete and Zephyr Scale is set up as a data source, the in-app Integrations page will display Connected next to Zephyr Scale.
