Update qTest links

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

To do so, you need to link Tricentis Tosca objects to qTest. Tricentis Tosca is where you automate your tests. Linking them allows you to create the necessary objects in qTest (see chapter "Link with qTest").

You can update existing links if you, for instance, change the name of a TestEvent, or if you want to link a TestCase to a different qTest Module.

What can you update?

You can update TestCases and TestEvents.

When can you update?

You can update links once they are live in qTest.

For a link to go live, you have to perform the following actions (see chapter "Link with qTest"): 

  • Go through the linking dialog to save the information in Tricentis Tosca.

  • Check in (multi-user workspace) or save (single-user workspace) to transfer the information to qTest. Only then does the link go live.

For instance, if you work in a multi-user environment, you cannot go through the linking dialog and then immediately update this link. You have to check in first.

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.

Let's say you link a TestCase to a qTest Module named Create Contact. If you update the link and create a link to the Module Edit Contact, Tricentis Tosca removes the link from Create Contact. The TestCase is then only linked to Edit Contact.

Update an existing link

To update an existing link, follow the steps below:

  1. In Tricentis Tosca, select the object whose link you want to update.

  2. Right-click the selected object and select Update in qTest from the context menu.

    This opens the Update in qTest dialog, where you can perform the following actions:

    • Log in with different qTest access credentials, if needed.

      Tricentis Tosca remembers your login credentials, so if you want to sign in as a different user, enter the respective credentials and click Save and Refresh.

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

    • For TestCases: select a different Module from the Select qTest Module list.

      If you don't select a different Module, for instance if you only want to update the TestCase name, the TestCase stays in the same location in qTest.

Update an existing TestCase link

  1. Click Link.

  2. In the confirmation dialog, confirm your selection with OK.

    This saves the information in Tricentis Tosca.

  3. To transfer the updated information to qTest, click Checkin All. 

    By default, Tosca has a time window of 70 seconds to open the connection to qTest and update the objects. If the update is not successful within that time, Tosca aborts and gives an error message.

    You can define a different time frame under Project->Options->QTestIntegrationAddin->Maximum time allowed for linking attempts (in seconds).

You can only update objects in one qTest instance per checkin or save.

Let's say you have two TestCases and two qTest instances:

  • You want to update TestCase A in qTest instance A.

  • You want to update TestCase B in qTest instance B.

In this case, you need to update TestCase A and check in your objects.

After that, repeat the process for TestCase B.

Once you have updated the link and transferred the information to qTest, Tricentis Tosca updates the affected object properties.