Convert Test Case to Tosca


qTest provides the ability to convert a manual qTest test case to a Tosca automated test case. Use the Tosca Integration to connect your qTest Test Cases to Tosca Automated Test Cases.

Note: Each qTest Project can be integrated with one Tosca Workspace.

Tosca Integration Prerequisite

You must turn on and configure the Tosca Integration in Automation Settings, prior to converting manual test cases to automated test cases.

Tosca Test Case Conversion

Once you have activated the Tosca Integration settings, you are ready to get started. 

Conversion Process

To convert an individual Test Case:

  1. Select the drop-down menu on the blue Convert button and choose 'To Tosca Commander' in the drop-down menu.
  2. A Converting Tosca Automation message is received. Select Ok and refresh your screen. 
  3. When a test case is converted successfully:
    • the Automation Test Case Type checkbox is automatically selected
    • the Tosca Test Case Type checkbox is automatically selected
    • the icon in the Test Design tree changes from an orange dot to a blue dot automated_test_case_icon.png 
    • the Automation Content field is populated with the ID and name of the Test Case.
      IMPORTANT: Your Automation Content field is the identifier that is used to point automation execution results to a Test Run linked to this Test Case. The Automation Content should be unique when you want to create new test cases and corresponding test runs. If you want to add a test log to an existing test run, then you must match the Automation Content field. 
  4. Once the Test Case is converted successfully, you can view it in your Tosca Workspace.

Access qTest Test Case in Tosca Workspace

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

You can rename the folder in your Tosca Workspace if you would like, and 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 to allow you to add/view test cases.


When the converted qTest Test Case is executed in Tosca, an 'Imported from qTest' folder will be automatically added to the 'Execution' folder in your Tosca Workspace. Nested under the 'Imported from qTest' folder is a list of the converted Test Cases

The execution list of your qTest Test Cases includes the following information:

  • qTest Test Case name
  • Execution entry


qTest Information Available in Converted Test Case

When you convert a manual qTest Test Case to a Tosca Automation Test Case, you will see the following information:

  • Tosca Test Case Name: qTest Test Case Name and Test Case ID number
  • Tosca Test Case Description: qTest Test Case Description (will not display any rich text formatting)
    • qTest Test Steps will append to the description (will not display any rich text formatting)
      Note: The Test Case description in Tosca is limited to 400,000 characters. If the combination of description and test steps of the qTest Test Case is longer then 400,000 characters, the overage does not display.

Conversion Notification

When the conversion is successful, the Tosca Test Case checkbox will be selected in the qTest Test Case Properties.

Receive Tosca Test Results Back into qTest

Read this article to integrate Tricentis Tosca with the Universal Agent.

Known Limitations:

  • Currently, we cannot inform you via a pop-up message when a qTest Test Case is converted successfully, or if there have been any errors while converting the Test Case.
  • You are not able to convert a Tosca Test Case back to a qTest Test Case.
Powered by Zendesk