Welcome
Test Execution Specialist Guide
This guide describes how to automate the playback of the tests by using different methods such as Docker, IBM Cloud Private, Jenkins and so on. The test results can be pushed to HCL DevOps Test Virtualization Control Panel (Test Virtualization Control Panel).
Configuration of test runs from the UI Test perspective
When you create Web UI, mobile, or Windows tests, you must configure the play back of the recorded tests as test runs from the UI Test perspective before you can view their test results.
Configuration of AFT Suite runs
When you create Web UI, mobile, or Windows tests, you must configure the play back of the recorded tests as AFT Suite runs before you can view their test results.
Running a Web UI test using IBM® Engineering Test Management
Another way to automate your testing is to use IBM® Engineering Test Management. With Engineering Test Management, you can run an individual Web UI test or specify a particular browser to run the test on. You can also accelerate your testing by running the test on all browsers and mobile devices simultaneously or on a selected set of browsers.

Release Notes
This document includes information about the new features introduced, features deprecated or removed, defects fixed, and known issues identified in this version of HCL DevOps Test UI (Test UI). You can also find the installation and upgrade instructions along with the contact information of HCL Customer Support.
System Requirements
This document includes information about hardware and software requirements for HCL DevOps Test UI (Test UI) 2024.03 (11.0.1).
Getting Started Guide
This guide provides an overview of HCL DevOps Test UI (Test UI). You can find the task flows to get you started with Test UI. This guide is intended for new users.
Tutorials
You can learn to start using Test UI by reviewing the information in the Tutorials for the UI Test perspective and Functional Test perspective.
Samples
You can find the sample project that you can use with HCL DevOps Test UI (Test UI) to test the functionality of an application.
Administrator Guide
This guide describes how to install HCL DevOps Test UI (Test UI) software. After you install the software, you can perform administration tasks such as license configuration and integration with other products. This guide is intended for administrators.
Test Author Guide
This guide describes how to create test scripts and enhances them by applying different test elements such as dataset, variables, and verification points.
Test Execution Specialist Guide
This guide describes how to automate the playback of the tests by using different methods such as Docker, IBM Cloud Private, Jenkins and so on. The test results can be pushed to HCL DevOps Test Virtualization Control Panel (Test Virtualization Control Panel).
- Configuration of test runs from the UI Test perspective
  When you create Web UI, mobile, or Windows tests, you must configure the play back of the recorded tests as test runs from the UI Test perspective before you can view their test results.
  - Configuration of Web UI test runs
    See the different ways to play back Web UI tests.
  - Configuration of mobile test runs
    After you record the tests for mobile applications by using HCL DevOps Test UI (Test UI), you can play back the recorded tests by using Test UI. The test reports help you to analyze the functional and performance issues in the mobile applications developed.
  - Configuration of Windows test runs
    You can run Windows tests that you created for Windows desktop applications in HCL DevOps Test UI (Test UI).
  - Configuration of AFT Suite runs
    When you create Web UI, mobile, or Windows tests, you must configure the play back of the recorded tests as AFT Suite runs before you can view their test results.
    - Accelerating the test effort with distributed testing
      The HCL DevOps Test UI (Test UI) UI Test perspective helps you accelerate the test effort by providing ways to distribute test execution across multiple browsers and multiple computers simultaneously.
    - Playing back an Accelerated Functional Test asset
      After you create an Accelerated Functional Test (AFT) asset for Web UI or Compound tests, you can play back these tests anytime later by using the AFT XML file.
    - Running multiple tests simultaneously
      To maximize test coverage in the shortest possible time, you can set up distributed testing and run several Web UI tests and compound tests simultaneously on several remote computers, for several operating systems and browsers.
    - Running a Web UI test using IBM® Engineering Test Management
      Another way to automate your testing is to use IBM® Engineering Test Management. With Engineering Test Management, you can run an individual Web UI test or specify a particular browser to run the test on. You can also accelerate your testing by running the test on all browsers and mobile devices simultaneously or on a selected set of browsers.
    - Running tests from a schedule
      To run multiple Web UI tests in parallel on different browsers, you can add the test to an HCL DevOps Test Performance (Test Performance) schedule.
    - Running Web UI tests as an AFT Suite on BrowserStack Cloud
      After you create an AFT Suite for Web UI tests, you can run the AFT Suite on devices connected to the BrowserStack Cloud to accelerate the test efforts.
    - Running mobile tests as an AFT suite
      After you create an Accelerated Functional Test (AFT) suite for mobile tests, you run the AFT suite by using the Run Distributed Tests option.
    - Running mobile tests as an AFT Suite on BitBar Cloud
      After you create an AFT Suite for mobile tests, you can run the AFT Suite on devices connected to BitBar Cloud to accelerate the test efforts.
    - Running mobile tests as an AFT Suite on BrowserStack Cloud
      After you create an AFT Suite for mobile tests, you can run the AFT Suite on multiple devices connected to the BrowserStack Cloud to accelerate the test efforts.
    - Running mobile tests as an AFT Suite on pCloudy Cloud
      After you create an AFT Suite for mobile tests, you can run the AFT Suite on devices connected to pCloudy Cloud to accelerate the test efforts.
    - Running mobile tests as an AFT Suite on Perfecto Cloud
      After you create an AFT Suite for mobile tests, you can run the AFT Suite on devices connected to Perfecto Cloud to accelerate the test efforts.
    - Running mobile tests as an AFT Suite on multiple mobile clouds
      After you create an AFT Suite for mobile tests, you can run the tests simultaneously on devices connected to multiple mobile clouds to accelerate the test efforts.
  - Running a test on multiple browsers and devices simultaneously
    Rather than run a Web UI test on one browser at a time, you can run a single Web UI test on multiple browsers simultaneously. Doing so can significantly speed up your test effort. You can also extend your test coverage by adding mobile devices to the test run. You can run the test from HCL DevOps Test UI (Test UI), from the command line, or from Engineering Test Management. This topic describes how to run a test from the UI Test perspective.
  - Setting a global delay for test steps
    You can set the duration of a global delay in milliseconds between all the steps instead of adding the wait time manually for each of the steps in a recorded test. You can specify this global delay as a preference for the playback of Web UI, Windows, or mobile tests.
  - Configuration of test runs from the command line
    When you need to run Web UI, mobile, and windows tests using the command line without opening the desktop client to run these tests, you can use the command line of HCL DevOps Test UI (Test UI).
- Configuration of test runs from the Functional Test perspective
  When you created functional tests, you must configure the run of the recorded functional tests from the Functional Test perspective before you can view the test results.
Test Manager Guide
This guide describes how to keep track of the performance of the application by evaluating the test results. Following topics cover how you can work with the test results.
Troubleshooting
This guide describes how to analyze and resolve some of the common problems that you might encounter while you work with HCL DevOps Test UI (Test UI).
Reference Guide
This guide describes the additional topics to gain more knowledge about HCL DevOps Test UI (Test UI).
All Guides (PDF)
You can find the link to view or download the content of the release notes, system requirements, and persona guides of HCL DevOps Test UI (Test UI) as a PDF file.
Security Considerations
You can take certain actions to ensure that your installation is secure, customize your security settings, and set up user access controls.
Notices
This document provides information about copyright, trademarks, terms and conditions for the product documentation.

Running a Web UI test using IBM® Engineering Test Management

Another way to automate your testing is to use IBM® Engineering Test Management. With Engineering Test Management, you can run an individual Web UI test or specify a particular browser to run the test on. You can also accelerate your testing by running the test on all browsers and mobile devices simultaneously or on a selected set of browsers.

About this task

To run a test from Engineering Test Management, you first define a test in Engineering Test Management that includes the path to the Web UI test. You then configure and run the Engineering Test Management adapter that is installed by default when you install HCL DevOps Test UI (Test UI).

Procedure

Using the Test Workbench script details page of a Engineering Test Management test script, associate a Web UI test script with the Engineering Test Management script as shown below:

Be sure to specify the value in the Script Path field to be the path to the Web UI test script. For additional details, see Creating a reference to an automated test script on a local test machine.
To run the test on a set of browsers or on all browsers and connected mobile devices, go to the Execution Variables page of the Engineering Test Management test script and specify the execution variable to pass to the script.
1. To run the test on all available browsers and connected mobile devices, use the execution variable AllAvailableTargetsInParallel and specify the value as All.
2. To run the test on a selected set of browsers, use the execution variable AllAvailableTargetsInParallel and specify the value as a comma-separated list of browsers, for example, chrome, ff.
3. To run the test on a particular browser, use the execution variable RTW_WebUI_Browser_Selection and specify the browser as the value, for example, chrome.
  
  Note: You can also use RTW_WebUI_Browser_Selection as a test variable in the Test UI UI Test perspective. For details, see Defining a variable to run a test with a selected browser.
Save the test and run it using the Engineering Test Management adapter.