Tosca Integration - Tosca Settings

The following changes need to be made in Tosca to enable Vera Integration:

Create a Common Repository

Follow the instructions provided on Tricentis Support to create a new common repository.

Create a Project using Tosca Server

Create a new project for the workspace

1. Open the Tricentis Tosca Server page in the web browser. This is configurable, but the default is http://localhost.

2. Navigate to the Admin Console and login with Admin credentials.

Open

3. Click the Add Project button and fill in the appropriate information for Project Details. Test connection to confirm it is valid and save.

Open

4. The project will now appear in the list of projects in Project Overview.

Create a Service Account User

Create a service account for Vera to access Tosca Commander

1. From the Tricentis Tosca Server page in the web browser, navigate to User Administration. Reauthenticate, if needed, using Admin credentials.

2. Navigate to the Users tab and click Invite users

3. Enter the email address that will be used by the service account. This will be used as the username in Tosca Commander. Click the Add button.

4. Specify a name for the service account. Note that this name will be displayed in Tricentis Server based Administration only. As mentioned above, the username shown in Tosca Commander will be automatically set to the service account email address.

Add a Locking Group

Create a group used to lock Tosca Test Cases

1. Navigate to the groups tab within User Administration. Click the Create Group button.

2. Click the Create group button and provide a name and optional description for the lock group. We recommend using ALM_Lock. Click Create.

3. The new group will now be shown in the list of user groups

Add the Service Account to Locking Group

Add the service account to the Locking group

1. Click on the tile for the newly created lock group and once inside the group summary, select edit.

2. In the next window, select service account checkbox and click the assign button. Save changes.

3. The service account will now be a member of the lock group.

Associate the group to the project

1. Navigate to Project Administration. The project that was created will be shown in the list of projects. Navigate to the project details page by selecting the Details icon.

2. In Project Details, click on the “+” (plus) icon to open the Select Groups window. Check the box next to the lock group that was created and click the Assign Groups button.

3. After assigning groups, the Save button will be enabled. Click Save.

4. The Lock group will now appear in the list of groups for the project.

Create the Workspace

1. Open Tosca Commander and click on the button Create New to create a new workspace

2. In the Create New Workspace window, select Tricentis Server Repository as the type of repository and click the button to log in to Tricentis Server.

3. In the next window, enter Admin login credentials

4. After authenticating, enter workspace information. Select the appropriate project from the Project name dropdown and select a name for the local workspace. Click OK.

5. Once inside the new workspace, navigate to the Usermanagement tab and checkout the project root.

6. While focused on the project root, right click and select Sync Users from Tosca Server from the context menu.

7. After the sync is completed, the lock group will be present in the list of groups and the service account will be a member of this group.

Enable Dokusnapper

If you wish to view Tosca run reports in VERA, you must enable the Dokusnapper functionality in Tosca; the setting is disabled by default.

1. In Tosca Commander, navigate to Settings → TBox → Dokusnapper.

2. Set the value of Enable Snapper to Yes and the Storage Location Type to Tosca.

3. Perform a Checkin All to save the changes to the common repository.

Enable Send Test Case Work State to qTest

In order to synchronize the test case workstate between Tosca and qTest, you must enable Tosca to send test case workstate to qTest.

1. Navigate to Settings → Commander → General → Advanced.

2. Right-click on the folder Advanced, and select Create… → Setting

3. In the new Setting, enter the name and value:

• Name: SendTestCaseWorkStateToQTest

• Value: True

4. Close Settings and perform a Checkin All to save the changes to the common repository.

Enable Pre-execution Approval Add-In

1. Enable the AddIn in Tosca Commander (client-side)

The following setting needs to be added to C:\Program Files (x86)\Tricentis\Tosca Testsuite\ToscaCommander\ToscaCommander.exe.config

2. Enable the AddIn in the Rest API (server-side)

The following setting need to be added to C:\Program Files (x86)\Tricentis\Tosca Server\RestApiService\TCAPIRestServiceStandalone.exe.config:

Enable Pre-execution Approval

EnableExecutionApproval from the Tosca workspace

1. From within the Tosca workspace, checkout the project root

2. Right click and select Enable execution approval from the context menu

3. Pre-execution approval is now enabled. Tosca Commander will display a message once the feature has been enabled.

Create Temporary File Storage Location for Dokusnapper Reports

1. Create a new folder in the file system. Make a note of the name and location. 

2. Modify the “AttachmentPath” setting in C:\Program Files (x86)\Tricentis\Tosca Server\RestApiService\TCAPIRestServiceStandalone.exe.config so it reflects the location of the folder.

Example:

Add Test Configuration Parameters to Execution section

1. Check out the top-level ExecutionLists folder.

2. Right-click on the folder and from the mini-tool bar select the option to add a Test Configuration Parameter

3. Add Test Configuration Parameters, TBox_DokuSnapper_EnableSnapper and TBox_DokuSnapper_StorageLocationType.

4. Perform a CheckinAll.