Patch 2024.1.5 QTV Improvements

In order to improve the performance of the qTest-Tosca-Vera integration, we have added several configurable options. Clients can choose to enable these options to significantly improve the performance of the integration. Please review the optional environment variables listed below to understand the new options.

Test Case Capture Improvements

A new environment variable can be added to the qTest Worker container in the Vera docker compose file, VERA_CAPTURE_TOSCA_TEST_AS_REPORT. When this variable is set to “true”, Vera will only import the Test Case overview report for any Tosca Test Cases that are routed for Approval. Records will not be created in Vera for the steps, values, and sub-values of the test case. This should speed up the import of the record and result in fewer API timeouts.

When the option is enabled, the Tosca Test Case Details section in Vera will only contain a single entry for the test case with an attachment.

image-20241108-161947.png
Example Tosca Test Case with TestCase Overview Attachment

The PDF attached will contain the details for the test case steps, values, and sub-values.

image-20241108-162113.png
Example TestCase Overview Report

Tosca Test Run Capture Improvements

A new environment variable can be added to the qTest Worker container in the Vera docker compose file, VERA_DISABLE_TOSCA_EXECUTION_DETAILS. When the variable is set to “true”, Vera will only import the Dokusnapper report for the Execution Lists and will not retrieve individual execution log steps, values, and sub-values.

Configuration Steps

To enable either of the improvements listed above, simply add the appropriate environment variable to the qTest Worker container definition.

Example docker-compose.yml container entry:

vera.worker.qtest: image: veraserver20190209075900.azurecr.io/tricentis/vera-worker-qtest:2024.1.5 container_name: vera.worker.qtest restart: always volumes: - "C:/Tricentis/data:/Data" environment: - ASPNETCORE_ENVIRONMENT=Development - ASPNETCORE_URLS=http://+:80 - VERA_SERVER_DATA_DIR=/Data - RabbitMQConnectionString=amqp://{rabbitmq}:5672 - MongoDBConnectionString=mongodb://{mongodb}:27017 - VeraServerUrl=http://vera.server:5000 - IdentityServerAddress=http://vera.server:5000 - LocalAddress=http://vera.worker.qtest - Vera.Worker.QTest.WebhookUrl=https://{veraUrl}/api/qtest/webhook - DEFAULT_HTTP_TIMEOUT=600 - VERA_CAPTURE_TOSCA_TEST_AS_REPORT=true - VERA_DISABLE_TOSCA_EXECUTION_DETAILS=true depends_on: - vera.worker.jobservice

 

Environment Variable Details

Variable

Description

Default Value

Variable

Description

Default Value

VERA_CAPTURE_TOSCA_TEST_AS_REPORT

Setting this option to “true” will cause Vera to only retrieve Tosca Test Cases as a Test Case Report PDF. Individual steps, values, and sub-values will not be imported.

Prerequisite: The “TestCase overview” must exist in the Tosca repository and must be not be renamed. If the report is renamed or missing, the calls to get the report will fail and tests cannot be routed for approval if this option is enabled.

 

 

False

VERA_DISABLE_TOSCA_EXECUTION_DETAILS

Setting this option to “true” will cause Vera to only retrieve the Dokusnapper report for each test execution log. The log steps, values, and sub-values will not be imported.

False