Tricentis qTest Manager

For information on what Tricentis qTest Manager is, see https://www.tricentis.com/products/unified-test-management-qtest.

The high-level solution architecture looks as follows:

  • Perfecto Agent: An universal agent to execute an automation framework from the command line. For more information, see here.

  • Framework: An automation test suite.

  • Perfecto Smart Reporting: The Perfecto reporting platform - Smart Reporting. For more information, see here.

  • Perfecto Report Parser: A custom report parser consumes the Perfecto Smart Reporting APIs and converts them into qTest result upload format. For more information on the custom report parser, see here.

Learn how to integrate Perfecto with qTest Manager so that you can view the status of automated tests run in Perfecto in qTest Manager and receive a link to the report created by the Perfecto Smart Reporting feature in the qTest Manager UI.

Important: This document includes references to a third-party product, Tricentis qTest Manager. The user interface and usage of third-party products are subject to change without notice. For the latest published information about qTest Manager, see https://documentation.tricentis.com/qtest/od/en/content/resources/home.htm.

Prerequisites

Before you can integrate Perfecto and qTest Manager, make sure to download the following:

Step-by-step instructions

Click a step to view details.

  1. Access qTest Launch. 

  2. Open the Settings pane.

  3. On the Universal Agent, click ADD.

  4. In the Add New Parser dialog, enter the following information:

    • Name: Perfecto Report Parser

    • Version: Latest version

    • Zip package: Browse to the location of your .zip package

  5. Click Save. Your parser is uploaded to qTest Launch as shown in the following screenshot.

  1. Open a browser and navigate to the qTest Automation host URL.

  2. Click Add.

  3. In the New Agent dialog box, provide the following information:

    • Agent Name

    • qTest Manager Project

    • Agent Type (Universal Agent)

  4. Provide the pre-execution script, such as git pull.

  5. Select Executor as node and provide the working directory (the path to the root folder of your project).

  6. Copy-paste the following code into the editor:

    Copy 
    // Environment Variable representing working directory provided above.
    var workingDir = process.env.WORKING_DIR;


    // Environment Variable exposed by qTest, represents Project related information.
    var projectData = JSON.parse($PROJECT_DATA);


    // Environment Variable exposed by qTest, represents information about test selected in qTest.
    var testrunList = JSON.parse($TESTRUNS_LIST);


    // Include qTestExecutor.js file available in the test suite framework's root folder.
    var executor = require(`${workingDir}/qTestExecutor`);


    // Call to execute test framework with data provided by qTest
    executor.executeTestSuite($TESTCASES_AC,projectData,testrunList,workingDir);

  7. In the Path to Results field, enter the path to your project's root folder .

  8. From the drop-down, select Perfecto Reports Parser.

  1. Implement the Smart Reporting API in your Project.
  2. Use JOB_INSTANCE_ID environment variable to provide the Smart Reporting Job Number.
  3. Copy qTestExecutor.js to root folder of your project.
  4. Modify the execute call according to your framework trigger command.
  5. Copy PerfectoCloudInformation.xml to the root folder of your project.

  6. Update the XML file with your cloud-related information:

    • perfecto.cloudname - The name your Perfecto cloud like demo etc.

    • perfecto.securityToken - The security token of your Perfecto cloud.

    • perfecto.jobname - The Smart Reporting job name under which the execution will be reported. (Use perfecto.jobname to report a test run in Smart Reporting.)

    • host - Proxy host if any else leave blank.

    • username - Proxy username if any else leave blank.

    • password - Proxy password if any else leave blank.