Menu

Tosca and qTest Integration: Quick Start Guide

Overview

The Tosca and qTest Integration allows Elite users to convert qTest Test Cases to Tosca Test Cases in qTest Manager, schedule/execute them via qTest Launch with the test results returning to qTest, as well as, Tosca. 

On the other hand, if you do not need to convert a qTest Test Case to a Tosca Test Case, but would still like to execute your Tosca Test Cases via the Universal Agent (and even see those results in qTest) we have instructions for this as well! Please read this article, to integrate Tosca with the Universal Agent.

Feature Compatibility

The integration features are dependent on the Product compatibilities below.

qTest Manager 9.6.1 OnPremise

Tosca 12.2+ Launch 1.4.1
qTest Manager 9.7+ OnPremise/OnDemand Tosca 12.2+ Launch 1.4.8+

Understanding the Workflow

  1. Convert a manual qTest Test Cases to an automated Tosca Test Cases.
  2. Access the converted qTest Test Case in your Tosca Workspace.
  3. Prepare to execute the converted qTest Test Case.
  4. Schedule and kickoff your Test Automation.

Convert qTest Test Cases to Tosca Test Cases

Please read this article, for instructions on converting qTest Test Cases to Tosca Test Cases. 

Access Converted qTest Test Case in Tosca Workspace

Initially, an 'Imported from qTest' folder will be automatically created within the TestCases folder in your Tosca Workspace. Each additional converted qTest Test Case will be added to the same 'Imported from qTest' folder that is initially established.

You can rename the folder in your Tosca Workspace if you would like. The integration/conversion will remain intact.

Note: You will need to make sure that the Viewing/Owning permissions for the "Imported from qTest" folder are set so to allow you to add/view Test Cases.

view_qtest_test_case_in_tosca_workspace.png

Execution Preparation

Manager 9.7+ OnPremise/OnDemand

The instructions below are applicable to qTest Manager 9.7+ OnPremise/OnDemand only. 

Prerequisites

  • Install and configure the Tosca DEX server properly. Refer to this article for instructions.
  • Convert manual qTest Test Cases to Tosca Automated Test Cases. Refer to this article for instructions. 

Execution

  1. Create a separate Test Case in qTest, so that you can use this to kick off Tosca tests directly from qTest Launch.
    Example: Name the Test Case "Execute all Tosca Tests" or another logical grouping, such as "Execute Tosca Smoke Tests", or "Execute Tosca Regression Tests."
  2. In your Tosca Workspace, add a TestEvent folder on the Execution Tab. This folder must be called TestEvents (no spaces.)
    tosca_testevent.png

Manager 9.6.1 OnPremise

The instructions below are applicable to qTest Manager 9.6.1 OnPremise only. 

Prerequisites

  1. Install the Automation Host if you have not done so already.
  2. Setup ToscaCI

Execution

  1. Create a Test Case in qTest, so that you can use this to kick off Tosca tests directly from qTest Launch.
    Example: Name the Test Case "Execute all Tosca Tests" or another logical grouping, such as "Execute Tosca Smoke Tests", or "Execute Tosca Regression Tests."
  2. Manually create and setup your ExecutionLists in Tosca, that you’ll want to execute from this special test case. The ExecutionList needs the appropriate entries in Tosca and ensure the ContinuousIntegration flag is set to 'True'. 
    Read these instructions for a more detailed explanation on how to create an ExecutionList in Tosca.
    • The config file needs to be set up per each logical grouping.
    • A different Agent will need to exist per test case logical grouping so that the ToscaCI command line in the universal agent execution area can have a different config file attached.

Additionally...

You can create a Test Suite within qTest with all the Test Runs that you want results for – after they’re executed from the RUN in your single "special" Test Case in qTest, the results should appear in the appropriate Test Run in this Test Suite.

Schedule and Kickoff Test Automation

Please read the articles below for the instructions that align with your current deployment versions.

Manager 9.7+ OnPremise/OnDemand

Schedule and KickOff Tosca Test Cases against Tosca Distributed Execution Server

Manager 9.6.1 OnPremise

Schedule and KickOff Test Automation in qTest Launch 1.4.1

View your Results 

View Tosca execution results in qTest

After Launch is successful, the results display in Manager on the Test Execution tab.

  • passed= no detailed results are included
  • failed= a detailed log is attached with the failed details 

What gets automatically generated in Tosca by qTest Launch?

  • a Tosca execution list with the qTest generated test case
  • a Test Event based on the execution list, which is executed automatically by the configured Tosca DEX agents
Powered by Zendesk