How To Integrate JIRA With QTest: A Step By Step Guide

qTest for Jira Test Management Tutorial:

Atlassian Confluence was explained in simple terms in our previous tutorial.

At STH, we are all about sharing the best practices, tools, techniques, processes, tips and everything else that we have enjoyed learning and benefited from using. We believe this makes day to day tasks easier and helps us all grow as testers.

Suggested Reading => In-Depth Training tutorials on JIRA

Today is one such attempt – the integration of JIRA with qTest to gain the benefits of test management linked to requirements management.  

Jest Code-Coverage & Html Report Generation

What is JIRA?

JIRA is a leading issue and project tracking tool catering to agile QA and development teams. JIRA allows you to manage and track any kind of unit work in the form of “issues” bugs, stories, project tasks with a predefined workflow.

Also read => Complete JIRA tutorials

Now, What is qTest?

qTest by QASymphony is a test management solution that allows teams of all sizes the ability to easily, manage, organize and report on software testing and test case management efforts.

Also read => Hands-on qTest review

Why should you integrate JIRA with qTest?

When you pair JIRA’s best-of-breed issue and project tracking capabilities with qTest’s innovative test case management abilities, the result will change the way your development and testing teams work.

Here are just a few of the benefits for integrating JIRA and qTest:

1. Seamlessly move requirements and defects from qTest into JIRA
2. Get test coverage reports for JIRA issues
3. Real-time bug status changes viewable against Test Run Executions
4. Easily access a detailed traceability matrix report of requirements and test case associations
5. Autofill test run results in JIRA issues. No syncing required!

Great, how to integrate and what do I need?

Check out this JIRA test management integration video for all you need to know about this. The integration is seamless and super easy to set up.

OK, the tools are connected. Now, what?

Let’s start working through the steps of the resulting integrated requirement-test-defect management solution.

First of all, notice how the interface changes. You will no longer see the “defects” tab. This is because all defects raised through qTest will be created in JIRA as issue type “BUG”.

Check this- no defects tab.

Step #1: Retrieve requirements.

Requirements are always managed in a centralized way from JIRA. That part stays as is. But test management should start from requirements too, shouldn’t it? So, instead of having to create a brand new instance, the integration provides a way in which a certain issue type from JIRA can be retrieved into qTest.

Usually, the requirements are of the issue type- “New feature”, “Improvement” or “Story”.

Once requirements are downloaded, they would appear as:

Note that, the icons are different. The JIRA and qTest ID’s both exist; JIRA and qTest properties too. These requirements are read-only here. They can be linked to TCs that exist within JIRA. Any changes to these requirements in JIRA are reflected on refresh.

Step #2: Create test cases and link them to requirements

This process is the same with or without JIRA integration. The test cases once linked to a requirement (retrieved from JIRA) will result in a JIRA issue link so the developers can see the test/tests associated with it.

This not only improves awareness of what the cross-functional teams are up to, but also supports test-driven development.

Check out the link as it appears in JIRA:

Step #3: Create test cycles and run

This step too does not change at all with the integration. Test teams would go ahead and create Test cycles and/or Test suites within qTest and carry out test execution.

If a certain Test run results in a failure or if a defect reported is linked to a Test run, then this relationship reflects in JIRA. Two things happen here:

Number one: The defect gets linked to the requirement (if the test case was linked to a retrieved JIRA requirement).

Number two: The defect will get a link to the Test run whose failure resulted in the issue.

Step #4: Report defects

When a test run or a test step failure results in a defect and a qTest user clicks on the “BUG icon-”, JIRA Create Issue page (with issue type: Bug, auto selected) opens up automatically. Enter the information and create the issue.

The links are created as described in the earlier step.

Step #5: Analytics and Reports

For a quick look up on the JIRA-qTest integration, JIRA users are provided with a qTest Widget. The following information is available on a real-time basis:

• Unresolved Defects: By Test Run Status
• Resolved Defects: By Test Run Status
• Synced Requirements without Test Case
• Top 10 Synced Requirements with Defects submitted from qTest

qTest reports are all available as usual and can be created around JIRA retrieved assets too.

Benefits of integrating qTest and JIRA

#1) Testers can be testers and developers can be developers. I mean, test management systems are built for testers. Take a look at the qTest UI. The sequence of actions you would normally perform in a test project (STLC- Requirement gathering-Test design-Test execution-defects) is how the interface is organized. JIRA is more development centric, so you will not find this structure there.

#2) If your team is into TDD or BDD, your development teams can view the tests created and linked to each requirement right from their JIRA interface.

#3) Any updates to the requirements are automatically refreshed into qTest. So there will never be a discord.

#4) Defects are centralized in JIRA. It does not mean qTest users have to log out of their qTest instance when they have to log a defect. When you choose the option to log a bug, qTest automatically invokes the JIRA instance and returns back to the qTest when the bug is submitted.

#5) Developers can see the “Test run” information linked to a defect, so if there are multiple runs or if the developer wants to know if the defect was retested as the latest test run or not, they can do that from the JIRA interface itself.

#6) Reports both at JIRA and qTest. Through the qTest Widget in JIRA, the analytics can be viewed that show the highlights of the integration. qTest reports, on the other hand, use the JIRA retrieved elements to provide test statistics.

Conclusion

As always, we hope you find this tutorial interesting and useful.

Tool collaboration is a trend that QA and development teams are most thankful for (at least I hope they are) and integrations for JIRA test management, specifically qTest, is a definite benchmark.