Create UFT Agent for Automation Host 1.3 (Legacy)


In this article, we explain how to create and configure a Unified Functional Testing (UFT) Agent to a specific Automation Host machine.

Follow this article if you are using a version of the Automation Host released prior to 1.3.8. If you are using a version of the Automation Host after 1.3.8, follow these instructions.


  1. Activate Automation Integration and Map Execution Statuses
  2. Install and Register the Automation Host
  3. Install the UFT Framework Plugin

Configuring the Agent

After you've installed the Unified Functional Testing Framework plugin, fill in the details of the Agent Configuration window as below:

  • Agent name: Define the agent's name. This is the agent name that will be selected in qTest Manager Test Execution when scheduling Test Runs
  • qTest Manager Project: select one of the qTest Manager projects which UFT test results will be reported to. The list includes all projects which are accessible using the agent’s credentials. An agent only integrates with one qTest project, so if you wish to integrate multiple qTest projects with UFT, you will need to create multiple agents (one for each qTest project).
  • Automation framework: select Unified Functional Testing

In the Test Scripts section, you can specify the location of your UFT test scripts. These scripts should reside on the same machine where the Automation Host (and UFT Agent) is installed:

  • Directory: specify the location of your UFT tests
    • This directory should not be a drive letter (eg: C:)
    • This directory should not directly contain the .usr files or the tests will be ignored
  • Include: the plugin will scan the directory specified above for tests and create them as Test Cases in your qTest project's Test Design area. You can use ANT Style Pattern Matcher to define the patterns of files which will be scanned for tests. Use comma to separate the patterns (eg: use **/*.usr to let the plugin scan for all of .usr files under the directory)
  • Exclude: you can optionally define the patterns of files which will be excluded from being scanned

HINT: ANT Style Pattern Matcher uses the following rules

  • ? matches one character
  • * matches zero or more characters
  • ** matches zero or more 'directories' in a path

Test Case Creation

The UFT agent will use the configurations to accomplish two tasks:

  1. Scan for Test Cases and automatically create them in your qTest project's Test Design area. There is no need to manually create automated test cases using the Test Design UI, as these test cases will be automatically created from the agent scan.
  2. Report the execution results to your qTest project's Test Execution area, based on the scheduled execution

IMPORTANT: When these test cases are automatically created for the first time, they will be missing test steps. Once the UFT tests are executed for the first time, the test steps will show up as expected in test cases in Test Design as well as in the execution logs in Test Execution. In order to execute your UFT tests and pass back the results, follow the next steps below:


  • Once the UFT agent scans your directory to automatically create test cases in Test Design, Create your automation Test Runs using the qTest Test Execution UI.
  • Finally, Schedule Test Runs in qTest Test Execution UI. Automation agent(s) will poll schedule(s) from qTest and automatically execute your automation tests. The automated test logs will be collected and pushed back to qTest. You can view the existing schedules and their statuses inside the Schedules area of Automation Integration Settings. 
Powered by Zendesk