Link TestCases directly with qTest

You can integrate Tricentis Tosca and qTest. This allows you to manage your test objectives and releases in qTest, with the results from your automated tests in Tosca. To do so, you need to create qTest TestEvents in Tosca. This links your automated Tosca tests to your qTest Releases. It doesn't matter where you trigger these tests; you see results in Tosca and in qTest.

If you just want to track your Tosca automation progress in qTest, you can link individual Tosca TestCases directly to qTest instead. Linking TestCases gives you an overview of how many - and which - TestCases you have already automated in Tosca.

What you can link

You can link the following objects with qTest:

Tricentis Tosca object:

Link with the following qTest object:

Resulting qTest object:

TestCase

Module

Test case

TestCase folder

Module

A qTest test case for every Tosca TestCase in the folder.

For TestCases, Tricentis Tosca only transfers the first level: the TestCase itself. It doesn't transfer TestSteps.

If you link a TestCase folder, Tricentis Tosca links the objects within the folder to qTest. Tricentis Tosca doesn't transfer the folder(s) themselves or the hierarchical structure.

Link with qTest

To link a Tosca TestCase to qTest, follow the steps below:

  1. In Tricentis Tosca, select the object(s) that you want to link to qTest.

    Note that you can only multi-select objects of the same type. For instance, you can select multiple TestCases at once, but not a TestCase and a TestCase folder.

  2. Right-click and select Link with qTest from the context menu.

  3. In the Connection Details section of the Link with qTest dialog, sign in to qTest. You only have to do this once; Tricentis Tosca remembers your credentials.

    Choose from the following options:

    • Login with qTest account

      Enter the qTest API endpoint into the qTest URL field: <url of your qTest instance>/api/v3

      Then enter your qTest user name and password.

    • Login with SSO account

      Enter the qTest API endpoint into the qTest URL field: <url of your qTest instance>/api/v3

      Then enter your qTest bearer token into the SSO token field.

      To get your qTest bearer token, open qTest and click Download qTest Resources. From the API & SDK section, copy the alphanumeric bearer token without the word Bearer.

  4. Click Save and connect.

  5. Select a location for your linked objects in qTest:

    • Select a qTest project from the Select qTest Project drop-down menu.

    • Select a qTest Module in the Select qTest Module section.

Link a TestCase to a qTest Module in Sample Project

  1. Click Link.

  2. In the confirmation dialog, click OK. This saves the information in Tosca.

  3. To transfer the information to qTest and create the linked objects in qTest, click Checkin All.

By default, Tosca tries to connect to qTest and transfer information for a maximum of 70 seconds. If Tosca is not successful within that window, it aborts. You can define a different time frame under Project->Options->QTestIntegrationAddin->Maximum time allowed for linking attempts (in seconds).

View linked TestCases in qTest

You can open linked TestCases in qTest directly out of Tosca.

To do so, right-click TestCase in Tosca and select View in qTest from the context menu. This opens qTest in your default browser and jumps right to the object in qTest.

Change linked TestCases

Tricentis Tosca transfers the first level to qTest: the TestCase name itself. It does not transfer TestSteps, test configuration parameters, or any other TestCase details. So you can make changes to these elements without having to update the linked object in qTest.

If you change the TestCase name and want to transfer these changes to qTest, you need to update the link.

Remove links

Testing needs can change over time; some of your TestCases may become obsolete. If you no longer need the link between your Tosca TestCase(s) and qTest, you can remove the link and delete your TestCases as needed.