Connections Management

Overview of Connections

A system administrator in Vera has the ability to configure and manage Vera connections to source applications. This allows the admin to add, edit or delete connections, aliases, and test these connections on the Web Portal.

Add a Connection

1. Open Site Administration > Settings tab

2. Click Connections tab

3. Click Add Connection, select desired system, enter the required fields and click Add Connection

   1. All fields are required

   2. System selection would determine if additional fields are shown.

      • For example:

        • Tosca > Auth Mode

        • Jira > Linked Connection

        • qTest > qTest Name

   3. Field Validation is done on Name and URL fields.

      1. Name Field only supports alphanumeric, @, -, _, +, and .

   4. Admin can reset all updated fields (which include linked locations and aliases) when adding a connection by clicking reset fields.

View and Edit Connection Details

1. Click on the connection name from the connections table or the edit icon

2. In the details area, you can view the added connection’s fields and edit all fields except the connection’s system.

3. You can add more aliases to the connection

4. For a Jira connection, you can delete the linked location and add a new one

5. Click save changes to save your changes

6. If you would like to reset the updated fields to previously filled data, click on cancel changes.

Editing Vera Connection

To view and edit Vera connection

1. Click on the connection name from the connections table or the edit icon

2. Only the following details would be displayed and can be modified

   1. Name

   2. Server

   3. API URL

   4. Browser URL

3. Click on save changes to save your changes.

Delete a Connection

If you delete a connection, it is removed from the connections table and deleted from the server.

1. On the connections table, click the delete icon on the same row as the connection.

Test Connections

To test if a Jira connection works,

1. Add or view a connection and click test connection

2. Modify the GET call with required information for the target system with known data

   1. In the example below, replace {Issue ID} with an Issue ID of a record in a Jira project that is integrated with Vera

   2. Open

      

3. Click test connection

4. If the connection test was unsuccessful, an error will appear. Contact Tricentis Support if needed.

To test if a qTest test case or test run connection works,

1. Add or view a connection and click test connection

2. Modify the GET call with required information for the target system with known data

   1. In the example below, replace {Project ID} with a qTest project ID that is integrated with Vera e.g 125080

   2. For test cases, replace the {Item Type} with test-cases

   3. For test runs, replace the {Item Type} with test-runs

   4. For test cases, replace the {Entity ID} with the test case number e.g 80518514

   5. For test runs, replace the {Entity ID} with the test run number e.g 80518514

   6. Click test connection

   7. If the connection test was unsuccessful, an error will appear. Contact Tricentis Support if needed.

   Open

   

To test if a Tosca connection works,

1. Add or view a connection and click test connection

2. Modify the GET call with required information for the target system with known data

   1. In the example below, after “toscacommander/” input the workspace name e.g tosca-vera-qtest-mssq. Note this workspace must be a Tricentis Server Repository type.

   2. Next, input the treeview (this is static)

   3. Then input the unique ID e.g 3a092628-2031-3aec-297d-b0ae7c635eb9

   4. Click test connection

   5. If the connection test was unsuccessful, an error will appear. Contact Tricentis Support if needed.

To test if an Xray connection works,

1. Add or view a connection and click test connection

2. Modify the GET call with required information for the target system with known data

   1. In the example below, we module authenticate as the specific entity

Source System Specific Fields

Certain source systems supports/require specific location information. See below for more details on each field.

Linked Locations

Vera currently supports linked connections for only Jira connections.

To add a linked connection:

1. Add an Xray connection

2. Add or edit a Jira connection and click on Linked Connection

   1. System is pre-filled as Xray

3. Select name of a previously added Xray connection.

4. Click save changes to save your changes

To edit a linked location:

1. When editing a connection, edit the linked connection name

2. Click save changes to save your changes

To remove a linked connection:

1. When adding or editing a Jira connection, click the delete icon by linked connection

2. Click save changes to save your changes

Aliases

Alias support is available for Jira, qTest, Xray, and Tosca system connections. System administrators can add multiple aliases while adding a connection if needed.

To add an alias to a connection:

1. When adding or editing a connection, click on add alias

2. Enter alias name

3. Click save changes to save your changes

To edit an alias:

1. When editing a connection, edit the alias

2. Click save changes to save your changes

To remove an alias from a connection:

1. When adding or editing a connection, click the delete icon by the alias

2. Click save changes to save your changes