This section describes how to add, view, edit, test and delete connections.
Overview of Connections
The site A system administrator in VERA Vera has the ability to configure and manage connecting VERA Vera connections to source applications. This allows the admin to add, edit or delete connections, aliases, linked connection and test these connections on the web portalWeb Portal.
Info |
---|
VERA Vera system connections would be are added by default and can not be deleted, but can be edited. |
Add a Connection
...
Open Site Administration > Settings tab
Click Connections tab
Click Add Connection,select desired system, enter the required fields and click Add Connection
All fields are required
System selection would determine if additional fields are shown.
For example
:
Tosca > Auth Mode
Jira > Linked
Connection
qTest > qTest Name
Field Validation is done on Name and URL fields.
Name Field only supports alphanumeric, @, -, _, +, and .
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
To view and edit a connection
Click on the connection name from the connections table or the edit icon
In the details area, you can view the added connection’s fields and edit all fields except the connection’s system.
You can add more aliases to the connection
For a Jira connection, you can delete the linked location and add a new one
Click save changes to save your changes
If you would like to reset the updated fields to previously filled data, click on reset fields cancel changes.
Fields | Description |
---|---|
System | This is a dropdown field that shows the source system of the connection/integration |
Name | Name of connection |
Server | URL of the source system’s server |
Service Account | Set up a service account for the source system with administrator access |
Password | Service account password |
Browser URL | Browser URL for the source system |
API URL | API URL for the source system |
Alias | One or more aliases can be added per connection |
qTest Name | This is a required field for qTest system connections only |
Linked LocationConnection | This is an optional button for Jira system connections. Please see linked locations section for more info |
Auth Mode | This is a required field for Tosca system connections and there are only two options: none and client credentials. |
Editing
...
Vera Connection
To view and edit VERA Vera connection
Click on the connection name from the connections table or the edit icon
Only the following details would be displayed and can be modified
Name
Server
Urls.API URLUrls.
Browser URL
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.
To delete a connection,
On the connections table, click the delete icon on the same row as the connection.
Note |
---|
Connections that have records associated to a domain cannot be deleted. |
Test Connections
To test if a Jira connection works,
Add or view a connection and click test connection
Modify the GET call with required information for the target system with known data
In the example below, replace {Issue ID} with an Issue ID of a record in a Jira project that is integrated with Vera
Click test connection
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,
Add or view a connection and click test connection
Modify the GET call with required information for the target system with known data
In the example below, replace {Project ID} with a qTest project ID that is integrated with Vera e.g 125080
For test cases, replace the {Item Type} with test-cases
For test runs, replace the {Item Type} with test-runs
For test cases, replace the {Entity ID} with the test case number e.g 80518514
For test runs, replace the {Entity ID} with the test run number e.g 80518514
Click test connection
If the connection test was unsuccessful, an error will appear. Contact Tricentis Support if needed.
To test if a Tosca connection works,
Add or view a connection and click test connection
Modify the GET call with required information for the target system with known data
In the example below, after “toscacommander/” input the workspace name e.g tosca-vera-qtest-mssq
Next, input the treeview (this is static)
Then input the unique ID e.g 3a092628-2031-3aec-297d-b0ae7c635eb9
Click test connection
If the connection test was unsuccessful, an error will appear. Contact Tricentis Support if needed.
To test if an Xray connection works,
View Add or edit view a connection and click test connection
Modify the GET call with required information for the target system with known data
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 Vera currently supports linked locations connections for only Jira connections.
To add a linked
...
connection:
Add an Xray connection
Add or edit a Jira connection and click on add linked location Linked Connection
System is pre-filled as Xray
Select name of a previously added Xray connection.
Click save changes to save your changes
To edit a linked location:
When editing a connection, edit the linked location connection name
Click save changes to save your changes
Info |
---|
Linked location system The system of a linked connection can not be changed/edited |
To remove a linked
...
connection:
When adding or editing a Jira connection, click the delete icon by linked locationconnection
Click save changes to save your changes
Aliases
Add Alias support is available for Jira, qTest, Xray, and Tosca system connectionconnections. Site admins System administrators can add multiple aliases while adding a connection if needed.
To add an alias to a connection:
When adding or editing a connection, click on add alias
Enter alias name, there is no validation on this field
Click save changes to save your changes
To edit an alias:
When editing a connection, edit the alias
Click save changes to save your changes
To remove an alias from a connection:
When adding or editing a connection, click the delete icon by the alias
Click save changes to save your changes