Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

Follow the steps below to add a new 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.

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 Connection

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

  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.

To delete a connection,

  1. 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 connection works,

  1. Add a connection and click test connectionView or edit or view a connection and click test connection

  2. Enter an address for a simple GET call that requires authentication to Modify the GET call with required information for the target system with known data

    1. In the example below,

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

    2. Image Added
  3. Click test connection

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

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 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

Info

The system of a linked connection can not be changed/edited

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

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:

  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