
As QA teams begin adopting Automation Testing to streamline processes like Regression Testing, one of the initial steps is often integrating their existing test management tools with an automation framework. This post provides a guide on how to integrate qTest, a popular test management tool, with Katalon, an automation testing framework.
﷽
Background
qTest is a comprehensive test management tool that provides features such as test planning, execution, reporting, and integration with other tools. Before adopting automation testing, most QA teams rely heavily on manual testing and use test management tools to plan, execute, and track their tests—entirely manually. Over time, this leads to hundreds or even thousands of test cases being stored in the test management tool.
So, when the time comes to shift towards automation, it’s essential to integrate your test management tool with your automation framework. This ensures that all those existing test cases can be effectively reused and managed within the automated testing workflow.
This notes will focus on how to integrate qTest with Katalon using the qTest plugin for Katalon.
Download qTest Plugin
To integrate qTest with Katalon, you need to download the qTest plugin for Katalon. You can find the plugin on the qTest website: https://store.katalon.com
.
Please note that you need to have a Katalon account to download the plugin. The account must be same as Katalon Studio account that you use to access the plugin.
Configure qTest Plugin for Katalon
Once you have downloaded the plugin, you need to configure it with your qTest account in the Katalon Studio. Follow the steps below to configure the plugin:
-
Open the Katalon Studio in your local machine.
Some tips are:
- Make sure your Katalon Studio account is the same as in Katalon Store when you download the qTest plugin.
-
To verify the plugin is installed, click user icon in the top right corner of the Katalon Studio. Try to reload the plugin by clicking the “Reload Plugins” button.
wait until the plugins list is reloaded. You will see the qTest plugin in successfully installed.
then close the plugin popup.
-
Click on the
Project
then click on theSettings
button. -
The
Project Settings
popup will open. Expand on thePlugins
the click on theqTest
.at this popup, you need to fill the following fields, please follow the instructions below carefully. Since I have spent some time to understand, how to configure the qTest plugin correctly. Otherwise, you might face some issues, like the qTest project won’t be loaded.
-
Fill the following fields:
- Tick the
Enable Integration
. - Fill the
Token
with your qTest’s token.- The
qTest
token can be found in your qTest account. - Choose the qTest project (any project, since the
arrow down icon
will shown if you have already selected a project), then you will find thearrow down icon
on the right side. Click on thearrow down icon
. - You will be redirected to the
Download qTest Resources
page. Click on theAPI & SDK
button. - Now you will see the qTest
Token
. Then copy the token value.
- The
- Finally the popup should look like this:
You could tick some options in the
Test Result
andReport format
based on your needs.
- Tick the
-
Click on the
Quick Setup
text on the top right side, based on image above. TheqTest Integration Setup Wizard
will open.Fill the following fields:
qTest Version
choose the latest version. Now it’s 7 or higher.Server URL
fill with your qTest server URL. For example https://Your_QTest_Subdomain.qtestnet.comUsername
fill with your qTest username.Password
fill with your qTest password.Encrypt authentication data
tick the checkbox. Since this recommendation from Katalon.
-
Click on the
Connect account
button. Wait until the connection is successful. -
Click on the
Next
button. If everything is correct, you will see theqTest Project
is loaded.since I haven’t create any qTest project, the project list only show the
qConnect - Sample Project
. But is ok, since before I have an issue the qTest project won’t be loaded. Now, choose the project that you want to use then click on theNext
button. -
Now you will see the
qTest Module
is loaded.Choose the
qTest Module
that you want to use then click on theNext
button. -
Now choose the
Katalon Test Case Folder
by default, the folder will be inKatalon Test Cases.
Leave it default then click on theNext
button. -
Now choose the
Katalon Test Suites Folder
by default, the file will be inKatalon Test Suites.
Leave it default then click on theNext
button. -
Now tick some options in the
Katalon Execution Options
based on your needs.Then click on the
Next
button. -
Now you will see the message
The Finish Up
successfully. Click on theFinish
button.
That’s all my notes.
Reference:
- qTest Integration in Katalon (This docs missing step how to get qTest token, so it will be a little bit confusing)