Link with qTest

You can integrate Tricentis Tosca and qTest (see chapter "Tosca qTest integration").

To do so effectively, you need to link Tricentis Tosca objects to qTest. Tricentis Tosca is where you automate your tests. Linking them allows you to keep an overview of their results in qTest.

What can you link?

The table below lists all Tricentis Tosca objects that you can link with qTest.

Object in Tricentis Tosca

Link with the following qTest object:

TestCase

Module

TestCase folder

Module

Which information does Tricentis Tosca transfer to qTest?

Linking an object creates a corresponding object in qTest: a qTest test case for every Tricentis Tosca TestCase.

Tricentis Tosca only transfers the first level: the TestCase itself. It does not transfer TestSteps. With the TestCase, Tricentis Tosca transfers the values of the following properties to qTest:

  • Name

  • Description

  • UniqueId

  • NodePath

If you link a TestCase folder, Tricentis Tosca links the following objects to qTest:

  • All TestCases within the folder.

  • All TestCases within sub-folders.

Tricentis Tosca does not transfer the folder(s) themselves or the hierarchical structure.

How often can you link an object?

You can only have one link per object.

You can't link the same Tricentis Tosca object to multiple qTest objects. Whenever you update a link, Tricentis Tosca overwrites the old information.

Create a new link

You can create links for TestCases and TestCase folders.

To create a new link, follow the steps below:

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

  2. Right-click the selected object(s) and select Create/Update in qTest from the context menu.

    This opens the Link with qTest dialog.

Link with qTest dialog

  1. In the Connection details section of the Link with qTest dialog, enter the information that Tricentis Tosca needs to establish a connection to qTest.

    To do so, select one of the following sign-in 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 username 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 bearer token, open qTest and click Download qTest Resources.

    You only have to provide this information once; Tricentis Tosca remembers your credentials.

  2. Click Save and Refresh.

    This gives you access to the Select qTest Project drop-down menu and the Select qTest Module list.

Select a qTest project and Module

  1. From the Select qTest Project drop-down menu, select the qTest project that you want to link to.

  2. From the Select qTest Module list, select a qTest Module in the specified project.

  3. Click Link.

  4. Confirm your selection in the subsequent dialog and click OK.

    This saves the information in Tricentis Tosca.

    In single-user workspaces, you can save your workspace now. This establishes the link and transfers the information to qTest.

  5. To establish the link and transfer the information to qTest, perform the following actions: 

    • In multi-user workspaces, click Checkin All.

    • In single-user workspaces, save your workspace. This is only necessary if you haven't saved the workspace in the confirmation dialog.

Properties of linked objects

Once you have established the link, Tricentis Tosca adds new properties to the linked TestCases.

If you link a TestCase folder, Tricentis Tosca adds these properties to the TestCases within the folder, not the TestCase folder itself.

Property

Value

LinkedWithqTest

True

ApiEndpoint

API endpoint of qTest

ModuleId

ID of the linked Module in qTest

ProjectId

ID of the qTest project that contains the linked Module

ObjectId

ID of the corresponding qTest object

View linked objects in qTest

You can open linked qTest test cases directly from Tricentis Tosca.

To do so, right-click the TestCase in Tricentis Tosca and select View in qTest from the context menu.

This opens qTest in your default browser, right on the linked qTest test case.

Update links

You can update existing links at any time as described in chapter "Update qTest links".