Activate Automation Integrations


To submit automated execution results back to qTest Manager, make sure to activate the Automation Integration feature within your qTest Manager project. This step is required regardless of which automation integration offerings you choose to leverage:

NOTE: Turning on automation integration settings and mapping execution results requires Project Admin permission.

How to Get Here

To activate Automation Integration Settings for a qTest Project, follow these steps:

  1. Select the Gear icon in the top header.
  2. In the drop-down select Automation Settings. 
  3. The "Automation Settings" page displays. Select the Integration tab.
  4. In the Automation Integration section, switch on the Activation Status using the toggle.
  5. Turning on the Automation Integration enables a Convert button on a Test Case that allows you to convert a manual test case to an automation test case. 

Map Automation Status to Test Run Status

After Automation Integration is turned on for your project, make sure to map your Automation Statuses to qTest Manager statuses:

  1. In the "Automation Settings" page, select + Add Mapping.
  2. Input the Automation Status in the left column.
  3. Select one of qTest' Manager's statuses in the right column.
  4. You can select the Delete icon to delete an existing mapping.
  5. Select Save.

Example to Map Statuses for UFT Test Automation Scheduling

PASSED, FAILED, DONE and WARNING are UFT’s default values and will report to the Test Step level. PASS and FAIL are the agent values and will report to Test Log level following this logic:

  • If there is no FAILED step, the Test Log is PASS
  • Otherwise, the Test Log is FAIL

Example to Map Statuses for the Tosca Integration

Passed and Failed are default values for Tosca Automated Test Runs. 

Tosca Integration

If you are using Tosca Commander, you can integrate a qTest Project with a Tosca Workspace by converting your manual qTest Test Cases to Tosca Automation Test Cases. 
Note: Each qTest Project can be integrated with one Tosca Workspace.


  • Determine which Tosca Workspace you want to use for the qTest Integration.
  • Install the Tosca Commander REST Webservice (TCRS) using instructions found here. The Tosca Workspace URL used below, is defined through the TCRS. 
  • Tosca Distributed Execution must be set up. For more information, refer to this article.
  • Map Automation Statuses of Passed and Failed. 
  • IMPORTANT: Your REST API will have to be accessible for this service to work correctly.

Enable and Configure the Tosca Integration

  1.  On the Automation Settings page, toggle the Tosca Integration to activate.
  2. In the Tosca Integration section, enter the:
    • Tosca Workspace URL
      • You will use the {Workspace} GET method highlighted in the example below as the Tosca Workspace URL. The {WORKSPACE} value should be the name of your Tosca Workspace where you want the converted qTest test cases to populate.
    • Username for Tosca Workspace Login
    • Password for Tosca Workspace Login
  3. Try Connection.
    NOTE: The Try Connection may take a few seconds, to a minute to complete, depending on your network. The Tosca Workspace you are integrating with qTest or the RestAPI cannot be open simultaneously when using the 'Try Connection.' If both are open at the same time, the 'Try Connection' option will fail. 
  4. Save your integration entries at the top of the window.
  5. You will receive a pop-up confirming the Tosca Integration feature is on. You must refresh your browser for changes to take effect.


  • A Connection Failed/ Connection Time Out error can occur as Tosca and qTest are on different servers and a corporate firewall is blocking the connection between them. When using qTest Cloud, the web services running on port 80 natively must be exposed to the internet. This can either be achieved by using a reverse proxy in a corporate network or using simple port forwarding when you are located in a home network.
    Therefore, in order to establish a connection between these two servers, you should contact your IT department and request:
    • to do a static IP assigned to your machine. (Static IP addresses are necessary as it helps your router know which computer on the network is the server. )
    • to expose web services to the internet

MORE INFORMATION: Convert Test Case to Tosca


Powered by Zendesk