Link with qTest

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.

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:	Resulting qTest objects
TestCase	Module	Test case
TestCase folder	Module	A qTest test case for every Tosca TestCase in the folder.
TestEvent	qTest project	A Test Cycle for the TestEvent. This Test Cycle contains further Test Cycles: one for every ExecutionList in your TestEvent. Within these Test Cycles, you'll have a Test Run for every ExecutionEntry. If one TestEvent contains the same ExecutionList multiple times under different configurations, qTest shows only one Test Cycle for this ExecutionList. A qTest test case for every Tosca TestCase that's referenced in your ExecutionList.
TestEvent folder	qTest project	A qTest Test Cycle for every TestEvent in the folder. All related objects (see "TestEvent" above).

Which information does Tricentis Tosca transfer to qTest?

Linking an object transfers the following object information to qTest:

• The value of the properties Name, Description, UniqueId, and NodePath.

• Type of the linked object: TestCase or TestEvent.

For TestCases, Tricentis Tosca only transfers the first level: the TestCase itself. It does not transfer TestSteps.

If you link a TestCase folder or a TestEvent folder, Tricentis Tosca links the objects within the folder to qTest. 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

To create a new link, follow the steps below:

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

   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 the selected object(s) and select Link with qTest from the context menu.

   This opens the Link with qTest dialog.

3. In the Connection Details section, 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 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. Then copy the bearer token from the API & SDK section. You only need to copy the alphanumeric code, not the word "Bearer".

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

4. Click Save and Connect. This gives you access to the following sections:

   • Select qTest Project drop-down menu

   • If you are linking TestCases or TestCase folders: Select qTest Module list

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

6. For TestCases and TestCase folders, select a qTest Module from the Select qTest Module list.

7. Click Link.

8. If you are linking a TestEvent which contains TestCases that are not linked with qTest yet, the subsequent dialog gives a warning. Perform the following actions:

   • Click OK. This re-opens the Link with qTest dialog.

   • In the Link with qTest dialog, select the qTest project and Module where you want your TestCases. Click Link.

9. In the final confirmation dialog, confirm your selection with OK.

   This saves the information in Tricentis Tosca.

10. To establish the link and transfer the information to qTest, click Checkin All. 

    By default, Tosca has a time window of 70 seconds to open the connection to qTest and link the objects. If the linking 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 link objects with one qTest instance per checkin or save. Let's say you have two TestCase folders and two qTest instances: You want to link TestCase folder A with qTest instance A. You want to link TestCase folder B with qTest instance B. In this case, you need to link TestCase folder A and check in your objects. After that, repeat the process for TestCase folder B.

Properties of linked objects

Once you have established the link, your Tricentis Tosca objects receive additional properties, which you can check in the Properties pane.

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

Property	Tosca object	Value
LinkedWithqTest	TestCase, TestEvent	True
ApiEndpoint	TestCase, TestEvent	API endpoint of qTest.
ModuleId	TestCase	ID of the linked Module in qTest.
ProjectId	TestCase, TestEvent	ID of the qTest project that contains the linked Module.
ObjectId	TestCase	ID of the corresponding qTest test case. Tricentis Tosca creates this property after you have saved or checked in your workspace.
qTestLink	TestEvent	Link to the corresponding qTest Test Cycle.
qTestUniqueId	TestEvent	ID of the corresponding qTest Test Cycle. Tricentis Tosca creates this property after you have saved or checked in your workspace.
type	TestEvent	test-cycles

View linked objects in qTest

You can open linked TestCases and TestEvents in qTest directly from Tricentis Tosca.

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

This opens qTest in your default browser and displays the linked qTest object.

Update or remove links

You can update or remove existing links at any time. For more information, see the following chapters:

• "Update qTest links"

• "Remove qTest links"