Menu

Create Unified Functional Testing (UFT) Agent with Automation Host Version 1.3.8 or Later

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.

IMPORTANT

  • 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.

Prerequisites

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
PASSED Passed
FAILED Failed
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.

u-status-mapping.png

Step 1

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

Step 2

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

create-agent-btn.png

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

new-agent-dlg.png

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 https://github.com/QASymphony/uft-sample 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

uft-configuration.png

 Click Save to finish creating UFT agent.

 

Powered by Zendesk