UFT One tests

This topic describes how to run UFT One GUI and API tests from LoadRunner Enterprise.


Below is a list of prerequisites that are required to run UFT One GUI or API tests from LoadRunner Enterprise.

  • To run UFT One tests from LoadRunner Enterprise you need a LoadRunner GUI Virtual User bundle license.

  • To create a GUI test in UFT One, make sure that you allow UFT One to interrupt the desktop.

  • To check the PASS/FAIL criteria of checkpoints in LoadRunner Enterprise, you need to surround them with transactions because UFT One checkpoints are not recognized by LoadRunner Enterprise.

    Example:“Services.StartTransaction "transaction1"/ Services.EndTransaction "transaction1"

    These transactions are displayed when the test is run. If, for example, a verification point is valid, the transactions are passed.


If you want to run a UFT One API load test in LoadRunner Enterprise, you need to convert the script in UFT to an API Load Test. For details, see Prepare and run a Load test in the UFT documentation.

Note: The file path inside a script folder must not exceed 260 characters.

Back to top

Set up and run a UFT One test

This task describes how to run UFT One GUI and API tests from LoadRunner Enterprise.

  1. Upload UFT One tests to LoadRunner Enterprise.

    For details, see Upload a script to LoadRunner Enterprise.

    After uploading the script to LoadRunner Enterprise, the script is added to the test management tree. You can view and edit most scripts directly from within the LoadRunner Enterprise user interface. For details, see Edit a script.

  2. Create a LoadRunner Enterprise test, and assign the UFT One test to it.

    For details, see Design a test.

  3. Set the number of Vusers per group to run the script.

    Script Type Description

    Typically, set this number to 1, because UFT One does not support running multiple instances on the same Windows session.

    However, if you want to run multiple Vusers on the same load generator, you can do so by using the LoadRunner-Terminal Services integration. This enables you to create multiple Windows sessions on the same load generators, and as a result, run one UFT One GUI Vuser on each Windows session.


    API tests do not have the same constraints as GUI tests in relation to the number of Vusers that can be run per load generator.

  4. Select the machine on which UFT One is installed as the load generator.

    Note: Make sure that you restart the load generator after installing UFT One.

    For details, see Design a test.

  5. Run the test.

    For details, see Manage a performance test run.

Back to top

Notes and limitations

UFT One (GUI) scripts can run with Network Virtualization with Per Load Generator mode only; they cannot run with Per Group mode.

Back to top

See also: