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

...

  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

      Location,
        • 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

To view and edit a connection

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

  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 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. Image Added
  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.

    Image Added

To test if a Tosca connection works,

  1. Add or view a connection and click test connectionView or edit 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

    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.

      Image Added

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 Vera currently supports linked locations 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 add linked location 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 location connection name

  2. 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:

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

  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, there is no validation on this field

  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