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 Web UI test runs
See the different ways to play back Web UI tests.
Prerequisites to running Web UI tests
Before you can run a Web UI test, you must complete the prerequisite tasks.
Setting a specific browser profile for the playback
When you play back a Web UI test in a browser, the test is played back in the temporary profile of the browser. You can set a specific user profile, which includes the extensions and settings to use for the test, for the browser in HCL DevOps Test UI (Test UI) to play back the Web UI test.

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.
    - Prerequisites to running Web UI tests
      Before you can run a Web UI test, you must complete the prerequisite tasks.
      - Setting a specific browser profile for the playback
        When you play back a Web UI test in a browser, the test is played back in the temporary profile of the browser. You can set a specific user profile, which includes the extensions and settings to use for the test, for the browser in HCL DevOps Test UI (Test UI) to play back the Web UI test.
      - Clearing cache, cookies, and history of browsers
        To optimize the performance of web browsers that are used to play back Web UI tests, you can clear cache, cookies, and history of browsers.
      - Setting or changing the ANDROID_HOME path in Linux operating systems
        When you want to run or play back recorded mobile tests by using the UI Test agent in HCL DevOps Test UI (Test UI), you must ensure that the ANDROID_HOME path is set correctly in computers that run on Linux.
      - Setting or changing the ANDROID_HOME path in Mac operating systems
        When you want to run or play back recorded mobile tests by using the UI Test agent in HCL DevOps Test UI (Test UI), you must ensure that the ANDROID_HOME path is set correctly in computers that run on Mac operating systems.
      - Setting or changing the ANDROID_HOME path in Windows operating systems
        When you want to run or play back recorded mobile tests by using the UI Test agent in HCL DevOps Test UI (Test UI), you must ensure that the ANDROID_HOME path is set correctly in computers that run on Windows operating systems.
    - Running a Web UI test
      To verify that a web application works as designed, run the test in a browser. Optionally, you can run the test in more than one browser at a time to speed up your test effort. Before running the test, you can choose to use a specific browser profile for the test.
    - Running Web UI tests on BitBar Cloud
      You can run Web UI tests on mobile devices that are connected to the BitBar cloud device. After the test run is completed, you can view the test reports in HCL DevOps Test UI (Test UI).
    - Running Web UI tests on BrowserStack Cloud
      You can run Web UI tests on the BrowserStack Cloud so that you can choose devices from a wide range of Android and iOS devices that are available for testing.
    - Running Web UI tests on the pCloudy cloud
      You can run Web UI test on Android or iOS devices that are connected to the pCloudy cloud testing platform. After the test run is completed, you can view the test reports in HCL DevOps Test UI (Test UI).
    - Running Web UI tests on Perfecto mobile cloud
      You can run Web UI test on Android or iOS devices that are connected to the Perfecto mobile cloud testing platform. After the test run is completed, you can view the test reports in HCL DevOps Test UI (Test UI).
    - Running a Web UI test by using industry-standard mobile browsers
      You can use industry-standard mobile browsers, such as Chrome and Safari, to run Web UI tests for mobile web applications. You can run tests with Chrome on Android devices and emulators and with Safari on iOS devices and simulators.
    - Running a test recorded in Google Chrome Device Mode
      You can run a test that you recorded in Chrome Device Mode. Doing so allows you to emulate the testing of applications on the browser of a mobile device.
    - Running tests in the headless mode
      When you do not want to view the GUI of the application under test as the recorded test is played back on a web browser, you can choose to run the test in the headless mode. Running of tests in the headless mode is useful when you use an automated testing environment.
    - Running tests in the private or incognito mode
      When you play back Web UI tests, if the user profile that is stored in the browser prevents the test from running without intervention, then you can use the private or incognito mode. Also, when you do not want cookies, caches, and user information to affect your test play back, you can choose the private mode.
    - Testing with Docker images
      HCL DevOps Test UI (Test UI), HCL DevOps Test Performance (Test Performance), and Test Performance Agents are available for download as Docker images. You can use them to fulfill the continuous testing aspects of your DevOps lifecycle.
  - 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.
  - 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.

Setting a specific browser profile for the playback

When you play back a Web UI test in a browser, the test is played back in the temporary profile of the browser. You can set a specific user profile, which includes the extensions and settings to use for the test, for the browser in HCL DevOps Test UI (Test UI) to play back the Web UI test.

About this task

You can set a specific browser profile path for the following browsers:

Google Chrome
Mozilla Firefox
Microsoft Edge
Opera

When you set the user profile for a browser, the user profile is used when you run the test from the workbench, command line, HCL DevOps Deploy (Deploy), and IBM® Engineering Test Management.

Note:

When you set a specific profile for the Firefox browser, Test UI creates a copy of the profile that you set and the tests are played back in the profile copy.
If the test script modifies the Firefox browser profile during the test run, the profile goes back to the default state after the run completes. The Chrome browser persists the changes that occurred during the test run. The difference in behavior is due to the way each browser manages a profile.

Procedure

Click Window > Preferences > Test > Test Execution > UI Test Playback.
Click the Browser tab.
Select the checkbox of the browser for which you want to set the profile path.

The Browse button for the browser is enabled.
Click Browse to browse and select the user profile for the browser.
Optional: Click the Report tab, and then select the Launch report after playback option if you selected the default profile of the default browser in the previous step.
As a result, the unified report is displayed after the playback is complete in the default profile of the default browser.
Click Apply and Close.

Results

You have set the user profile path for the selected browser.