Create Unified Functional Testing (UFT) Agent from Automation Host v 1.3.8 or Later

[Updated] This legacy UFT Agent type lacks a few features and flexibilities as compared to Universal Agent. So you are highly recommended to integrate your UFT project with Universal Agent instead.


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


  • To be able to launch your UFT tests, Automation Host must be running on a Windows Command Prompt with an active logged in Windows user. If automation host was installed as a Windows service, it cannot launch your UFT tests. Refer to this article for more detail about this limitation: IMPORTANT: Limitation of Automation Host service on Windows
  • The qTest Automation Host and your UFT tool must be installed on the same machine in order for the UFT Agent in Automation Host to kick off your UFT script execution
  • The UFT Agent in Automation Host works with UFT version less than or equal to 14.
  • The UFT Agent in Automation Host does not work with UFT version 14.04.
  • UFT Agent in Automation Host can only execute your UFT tests on Windows
  • If a failure occurs during test submission, the Failure Log will be included as a text file attachment in the Test Log details.


  1. Activate Automation Integration
  2. Install and Register the Automation Host

In addition, make sure you map UFT execution status to qTest test automation execution status. The table below shows which UFT execution status is mapped to qTest automation execution status:

UFT Execution Status qTest Execution Status
PASS Passed
FAIL Failed
SKIPPED Incomplete
SKIP Incomplete
WARNING Incomplete
DONE Passed
Passed Passed
Failed Failed
Pass Passed
Fail Failed
Skipped Incomplete
Skip Incomplete
Warning Incomplete
Done Passed

Screenshot below demonstrates how you do the mapping in Automation Settings of qTest Manager.


Step 1

Download the sample UFT automation project at and save it to your local machine, e.g. D:\uft-sample

Step 2

Access to Automation Host UI then Click on + Add button in the right corner of Agents list.


You will be presented with a New Agent dialog, as shown below.


Configure UFT Agent

  • Agent Name: name of the new agent, e.g. New Agent. This is the agent name that will be selected in qTest Manager Test Execution when scheduling Test Runs
  • qTest Manager Project: select a project that the new agent will be associated with, e.g. qConnect - Sample Project
  • Agent Type: Unified Functional Testing
  • Directory (required): specify the path to your UFT automation project in the source code that you have downloaded in step 1
    • IMPORTANT NOTES: your UFT project is located in the machine at <path to working directory>\<project name>\<file name>.usr. Conventionally, <project name> and <file name> must be the same. And you should put <path to working directory> to the Directory field, NOT <path to working directory>\<project name>
      • EXAMPLE: if you downloaded our sample at and saved it to your working directory at D:\uft-sample so your project structure will be as below:
        • D:\uft-sample: this is your working directory
        • D:\uft-sample\LoginFlights: this is your project folder
        • D:\uft-sample\LoginFlights\LoginFlights.usr: this is the path to your uft script file
        • Then your must put D:\uft-sample to Directory field
  • Include (required): define patterns to scan for tests in the UFT automation project using ANT Style Pattern Matcher. Use a comma as a separator between patterns.
  • Exclude: define patterns to ignore tests when scanning for tests, again you can use ANT Style Pattern Matcher

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.

Below is an example of UFT agent configuration


 Click Save to finish creating UFT agent.


Powered by Zendesk