In this article, we will walk you thru how to create and configure a Unified Functional Testing (UFT) agent to a specific automation host machine.
Note: follow this article if you are using Automation Host version 1.3.8 or later. If you are using Automation Host prior to 1.3.8, follow these instructions.
- 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 Agent Host and UFT Integration tool must be installed on the same machine in order for the UFT agent type to kick off UFT scripts.
- The integration tool works with UFT version less than or equal to 14.
- UFT agent type does not work with UFT version 14.04.
- UFT agent can only be executed 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.
First, 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|
Screenshot below demonstrates how you do the mapping in Automation Settings of qTest Manager.
Download the sample UFT automation project at https://github.com/QASymphony/uft-sample and save it to your local machine, e.g. D:\uft-sample
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
- 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.