This section describes how to add, view, edit, test and delete connections.
Overview of Connections
The site administrator in VERA has the ability to configure and manage connecting VERA to source applications. This allows the admin to add, edit or delete connections, aliases, linked connection and test these connections on the web portal.
VERA connections would be added by default and can not be deleted, but can be edited.
Add a Connection
Follow the steps below to add a new 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 Location, 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.
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 Location | 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 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
API URL
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.
Test Connections
To test if a connection works,
Add a connection and click test connection
View or edit a connection and click test connection
Linked Locations
VERA currently supports linked locations for only Jira connections.
To add a linked location,
Add an Xray connection
Add or edit a Jira connection and click on add linked location
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 name
Click save changes to save your changes
Linked location system can not be edited
To remove a linked location
When adding or editing a Jira connection, click the delete icon by linked location
Click save changes to save your changes
Aliases
Add Alias is available for Jira, qTest, Xray, and Tosca system connection. Site admins can add multiple aliases while adding a connection.
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