Skip to main content
Planview Customer Success Center

Tricentis qTest

89882945.png

 

 

Overview

Planview Hub allows testers, developers, business analysts and other members of the software delivery team to work together easily, automatically flowing artifacts across tools. This creates an integrated software delivery value stream while still allowing teams to work in their tool of choice.

By connecting Tricentis qTest (formerly QASymphony qTest Manager) with other software development and delivery tools, testers can leverage Tricentis’ purpose built testing tool, and still automatically participate in the software development flow. Requirements are the primary driver of tests as they flow automatically into the tool, ensuring optimal QA effort and application quality.

Key Features and Benefits

  • Automatically flow defects from Tricentis qTest to Agile Planning tools

  • Flow requirements into qTest to ensure traceability across teams

  • Automatically create defects in qTest from automated testing or DevOps tools

  • Improve team collaboration and effectiveness by synchronizing artifacts across the software delivery lifecycle

  • Connect qTest with other tools to enable visibility into lifecycle activity data

Demo Videos

 


 

Connector Setup Details

This section describes the basic steps needed to prepare your qTest instance for use with Hub. Note that additional fields for synchronization or configuration of queries may be required depending on the requirements of your integration.

Minimal User Permissions & Hub User

We recommend that you create a new user within your external tool, to be used only for your Hub integration. This is the user information you will enter when setting up your repository connection within Planview Hub. By creating a new user, you will ensure that the correct permissions are granted, and allow for traceability of the modifications that are made by the synchronization. 

In general, your user account should have sufficient permissions to create, read, and update artifacts in your repository. However, depending on the use case, your user may need different permissions. For example, if you are only interested in flowing data out of your repository, your user may not need to have full CRUD access, as the 'create' and 'update' permissions may not be needed.

Your user should have a secure password or token. Please be aware that Hub will not allow you to save a repository connection utilizing a weak password/token, such as 'tasktop.'

See instructions on how to create a custom user in qTest.

List of minimal user permissions:

  • Use the out of the box Developer User Profile
    • Note that "Edit Requirement Assignment" permission has to be enabled to allow for assignee values to be updated
  • Or create a User Profile with at least the following permission selected:

    • Create Modules
    • Edit Modules
    • Edit Requirement Assignment (needed for updating person field)
    • Create Requirements
    • Edit Requirements
    • View Requirements
    • Create Defects
    • Edit Defects
    • View Defects
    • Manage Field Settings (only required for qTest OnDemand 9.8.8+)

Connecting to the Tricentis qTest Repository

Password Grant OAuth 2.0 Authentication

Required Fields:

Optional Fields:

  • Skip Attachment Scan: If this field is checked, the attachments from qTest can still be synchronized if they are still scanning or if the attachment scan fails. 
  • Throttling Settings: This field indicates the number of API calls that can be made per minute. See details here.
    • Note: This field should only be set under the guidance of customer care as the ideal value is highly dependent on each customer's unique environment. 
  • Connection Security: If checked, insecure connections to this repository will be allowed. See details here.

Screenshot 2023-08-14 at 9.51.49 AM.png

Learn more about how to set up your repository in Planview Hub here. 

 


 

Other Configuration Settings

Planview Hub Upgrades

To prevent possible upgrade issues, stop all qTest integrations and end all user sessions for the configured qTest repository user before upgrading Planview Hub.

Person Reconciliation

For person reconciliation, the following fields are available:

Fields Used for Hub’s Default Person Reconciliation Algorithm

Field Names for Person Reconciliation Extensions

(Note that these are case sensitive)

Label in Tricentis qTest

ID

person-id

Numerical ID not shown in web UI

Username

person-username

Login Email

Email

person-email

Recovery Email

N/A

person-first-name

First Name

N/A

person-last-name

Last Name

N/A

person-display-name

Not shown in web UI

N/A

project

Project Name (we do not recommend searching by this label)

Learn more about how to configure person reconciliation in Planview Hub here.

Full Scan

In general, a full scan is not required to synchronize updates from this repository. However, it is possible that some read-only fields may require a full scan. Please consult with customer care for additional details.

 


 

Supported Features

Special Features Supported

You can learn more about special features in Planview Hub here.

Feature

Applicable Hub Versions

Applicable Repository Versions

Default Maximum Size in Repository

 1Not_allowed.svg.png Time Worked (Worklogs)

1Not_allowed.svg.png Impersonation

 

 

 

1checkicon.png Comments

1Not_allowed.svg.png Impersonation

1Not_allowed.svg.png Public/Private

Planview Hub: 17.2 and later

Any supported repository version:

N/A

1checkicon.png Attachments

1Not_allowed.svg.png Impersonation

Planview Hub: 17.2 and later

Any supported repository version:

50MB

Learn more about maximum attachment size here.

N/A - State Transitions

(qTest does not use state transitions. Status can flow out of or into qTest as a single-select.)

Planview Hub: 17.2 and later

Any supported repository version:

N/A

 


 

Supported Artifacts

Supported Work Items

Learn about the difference between containers and work items in Planview Hub here

Supported Work Item Type

Applicable Hub Versions

Applicable Repository Versions

Unique URL?

Requirement

Planview Hub: 17.2 and later

Any supported repository version:

Yes

Defect

Planview Hub: 17.2 and later

Any supported repository version:

Yes

Supported Containers

Learn more about containment in Planview Hub here

Containers that can synchronize between repositories

Applicable Hub Versions

Applicable Repository Versions

Unique URL?

Modules

See Functional Limitations table for details.

Note: Beginning in Hub version 22.4, containers can be treated as work items. Learn more here.

Planview Hub: 17.4 and later

Any supported repository version:

No

Containers used to define the boundary of a collection

(When clicking 'Manage Projects' on a Collection)

 

 

 

Projects

Planview Hub: 17.2 and later

Any supported repository version:

N/A

Containers used for artifact routing

 

 

 

Modules

(for Requirements and Defects)

Note: To properly route requirements to modules in qTest, you must ensure that the 'module' field is not mapped to 'parent artifact' on the relationship configuration page. This may happen automatically, depending on the model that is utilized.

Planview Hub: 17.2 and later

Any supported repository version:

N/A

Projects

(for Defects only)

Planview Hub: 17.2 and later

Any supported repository version:

N/A

 


 

Supported Field Types

Note: If one field of a given type is supported, others that are also that type in theory should also work. However, sometimes there are instances in which this is not the case due to the repository. So, while we can claim support for fields at the type level, there is a chance that some specific fields of a given type will not synchronize properly.

Standard Field Type

Does Hub support custom fields of this type?

How is field type referenced in the repository?

Sample Repository Fields Supported

Particular Repository Fields NOT Supported

1checkicon.png String

1checkicon.png

Requirement, Defect

Name

 

1checkicon.png Single Select

1checkicon.png

Requirement, Defect

Status

 

1checkicon.png Multi Select

1checkicon.png

Requirement, Defect

 

 

1Not_allowed.svg.png Boolean

 

 

 

 

1checkicon.png Date

1checkicon.png

Requirement, Defect

Created

 

1checkicon.png Date Time

1checkicon.png

Requirement, Defect

Created

 

1Not_allowed.svg.png Duration

 

 

 

 

1checkicon.png Double

1checkicon.png

Requirement, Defect

N/A

 

1Not_allowed.svg.png Long

 

 

 

 

1checkicon.png Person

1checkicon.png

Requirement, Defect

Creator

 

1checkicon.png Persons

1Not_allowed.svg.png

Requirement

Assigned To

 

1Not_allowed.svg.png Relationship(s)

 

 

 

 

1checkicon.png Rich Text

1checkicon.png

Requirement, Defect

Description

 

1checkicon.png Web Links

1checkicon.png

Requirement, Defect

URL

 

1Not_allowed.svg.png Other

 

 

 

 

 


 

Functional Limitations

Category

Limitation

Applicable Hub Versions

Applicable Repository Versions

Third Party API Limitation

Custom Fields

qTest's artifact revision is partially dependent on information retrieved from custom fields. If a custom field is added or removed, each qTest artifact will likely generate a change event and be processed.

Planview Hub: All

Any supported repository version:

Third Party API Limitation

Assigned To Field

Defects and Test Runs require an assignee in the “Assigned To” field. If an assignee is not designated, an API error will appear.

Planview Hub: 17.2 and later

onDemand version 10.0.3 and earlier

onPremise version 10.1.0-2 and earlier

Third Party API Limitation

Attachments

Due to a limitation in qTest's API, attachments are not supported in qTest version 11.0.

Planview Hub: All

11.0

Good to Know

Inactive Field Values

To avoid errors when synchronizing artifacts in qTest, you should avoid mapping inactive field values in Hub.

Planview Hub: 21.3.16+, 21.2.31+, 21.4.2+

Any supported repository version:

Third Party API Limitation

Modules

Due to the restrictive nature of qTest REST APIs, it is highly recommended for customers to have at least one module created or available via the user interface in the qTest repository before setting up a new integration. The connector relies on the qTest module API to retrieve metadata about modules, but that metadata is only available if one module is visible on the qTest user interface.

Planview Hub: 17.2 and later

Any supported repository version:

Third Party Functional Limitation

Field Management

Due to a bug in qTest, Hub cannot set a value for 3 defect fields: Target Release/Build, Affected Release/Build, Fixed Release/Build. If attempting to update those fields, a Hub error will be surfaced, "Invalid field value for field _____."

Planview Hub: 17.2 and later

Any supported repository version later than 8.4, including Current On Demand (Cloud) version:

Feature Unsupported

Modules

Modules are not supported as an artifact type (meaning they cannot flow to a target repository) in Planview Hub 17.1-17.3.

In Planview Hub 17.4, Modules can only flow to a target repository as a work item (not as a container). For example, you could flow a Module in qTest to a Requirement (a work item) in a target repository, but not to a Folder (a container) in that target repository.  This functionality (flowing modules to a work item) is only possible with the Hub container-to-work-item add-on.  

In Planview Hub 18.1 and later, users can flow Modules to a target repository as a container. 

Planview Hub: 17.2 and later

Any supported repository version:

Third Party API Limitation

Authentication

qTest enforces a strict limit of three active authentication tokens per user. While the connector manages to stay below that limit, it is especially important that customers dedicate an account for Hub use only.

Planview Hub: 17.2 and later

Any supported repository version:

Third Party API Limitation

Attachments

Unicode characters are not allowed in the file name of an attachment.

Planview Hub: 17.2 and later

Any supported repository version: