Release notes for HCL OneTest UI V10.0.2

This document contains information about new features, system requirements, and known limitations in HCL OneTest™ UI.


HCL OneTest UI is an automated testing tool that tests a broad range of applications, such as:

  • HTML5-based web applications built on modern frameworks, such as Angular, React and Vue.js in the latest versions of the world’s popular browsers, both on the desktop and mobile devices
  • Legacy HTML applications
  • Java™ and .Net-based thick client applications
  • ERP systems such as SAP
  • IIBM® zSeries, IBM iSeries, IBM pSeries, and mainframe applications
  • Ajax, Microsoft Windows, Microsoft .NET, Microsoft Silverlight, Microsoft Visual Basic, Siebel, Flex, GEF, and PowerBuilder applications
  • Adobe PDF documents

You can also import and work with Selenium tests and combine tests of various types into compound tests.

To view the list of supported domains, software, and platforms, see the requirements document on the HCL License & Delivery portal.

Some of the older versions of software supported by HCL OneTest UI are deprecated. To view the list of deprecated software, see

Integrated Development Environments

HCL OneTest UI is available in two integrated development environments (IDE): Eclipse and Microsoft Visual Studio .NET. The Eclipse integration supports both Java and simplified (non-programming) method of scripting while the Microsoft Visual Studio .NET integration supports Microsoft Visual Basic .NET scripting language.

Note: The ability to test HTML 5-based applications is available in the Eclipse environment, but not in the Microsoft Visual Studio .NET environment.

What's new in HCL OneTest UI V10.0.2

  • Starting from version 10.0.2, a 32-bit HCL OneTest UI installer and a shell-shared installer are also available to install HCL OneTest UI on a 64-bit Windows operating system. See Installing the product on Windows.
  • You can now install HCL OneTest UI on Mac OS by using stand-alone and shell-shared installers. See Installing the product on Mac OS.
  • You can now rerun the failed tests from the previous playback of an Accelerated Functional Test suite. This option is available only if the previous run of the Accelerated Functional Test has resulted in any failed tests. If the failed tests are rerun, the browsers and the location on which the tests failed in the previous run are only considered for execution. This feature allows you to save time and eases your testing as you can focus on the failed tests and take the required action. See Creating accelerated functional test asset.
  • You can now integrate HCL OneTest UI with Bitbar Cloud in Windows, Linux, and Mac operating systems. To run a Web UI test from the workbench on an Android or iOS mobile device in Bitbar Cloud, you must enable the Bitbar Cloud environment under Web UI playback preferences. Additionally, you can run a Web UI test for Bitbar mobile devices by using an Accelerated Functional Test XML file and the command-line interface. See Running Web UI tests on the Bitbar mobile device cloud.
  • Starting from HCL OneTest UI V10.0.2, datapool is replaced by dataset. You can convert a datapool, which you created by using an earlier version of the product, to a dataset by using HCL OneTest UI V10.0.2. See Dataset overview.
  • You can limit the recording and playing back of test scripts to applications that you start either through the recording monitor or by using the StartApp command. If you enable this feature, the recording captures the actions performed only on the application that starts through the recording monitor, and the playback considers only the actions performed on the application that starts by using the StartApp command. See Limit record and playback to the StartApp application.
  • In the previous versions of the product, you created the config file manually by adding parameters to it. Starting from HCL OneTest UI V10.0.2, you can create a command-line config file from the product by right-clicking the test asset and configuring the required options. See Creating a command-line config file.
  • Starting from V10.0.2, you can record and play back functional tests on Google Chrome and Mozilla Firefox browsers by using the JDK that is shipped with the product.
  • You can now perform image-based validation for test steps in Web UI tests. This experimental feature allows you to validate the test steps based on the newly available image property. You can either identify the contents through an image or create verification points on the image by using this property. See Experimental Features.
  • You can now generate a new unified report for Web UI tests. You must enable this experimental feature under Preferences before you generate the unified report from the Test Navigator. This report provides a detailed overview of your Web UI test results and has a new, improved user interface to analyze and filter your test result details. See Experimental Features.

Installing the product

For installation instructions, see Installing HCL OneTest UI.

Note: You cannot upgrade to the latest version of the product. You must uninstall the existing version of the product before installing the latest version of the product.

Known limitations and workarounds

Viewing help topics from the context sensitive help and the product Welcome
  • This product includes context sensitive help and a product Welcome, which, in turn, include links to the information center help. These links only work while the correct version of the information center help is open.
    Note: The link to the documentation in HCL OneTest UI V10.0.2 points to the documentation for V10.0.1. This issue will be fixed in the next release.
Microsoft Silverlight support
  • HCL OneTest UI only supports recording Silverlight applications on 32 bit Internet Explorer.
Microsoft .NET 4.5 support
  • Recording actions on the drop-down list of a RibbonFilterMenu is not supported.
PDF 9.0, 10.0 and 11.0 file testing support
  • When you record the tool bar buttons in Adobe Reader 10.0 and 11.0, the action is recorded based on the position of the button, click(atPoint(x,y)).
  • When you record on a PDF file that is opened in a Mozilla Firefox browser, you must first record actions in the browser and then begin the recording on the PDF file.
  • Playback fails when only the find() API is used to locate objects. As a workaround, click the captured object first and then play back.
  • In HCL OneTest UI Microsoft Studio Integration, the PDF crashes during the playback, following a few clicks.

HCL OneTest UI playback displays an unexpected message in the console

After playing back a script in HCL OneTest UI, a message such as the following is displayed in the console: The IBM Class Sharing Adaptor will not work in this configuration. You are not running on a J9 Java VM. This message is displayed because the version of Eclipse that is used in the IDE is from IBM and has the IBM Java optimizations enabled. To resolve the issue:

  1. Navigate to the HCL OneTest UI Plugins Shared Folder.
  2. Back up the plugin and delete it.
  3. Restart HCL OneTest UI.
Other limitations and workarounds
  • When you run the tests on iOS either with a core framework or with Perfecto cloud integration, the screenshots captured in the reports do not highlight the correct controls. This is because the core framework screenshot API captures the browser window instead of a specific browser content or viewport.
  • An Oracle Java Runtime Environment (JRE) must be installed and enabled for testing Google Chrome.
  • Clearcase integration is only supported with a 32-bit installation of HCL OneTest UI.
  • For testing 32-bit applications on Linux, HCL OneTest UI must be installed with 32-bit architecture.
  • For testing 64-bit applications on Linux, HCL OneTest UI must be installed with 64-bit architecture.
  • Mac OS is supported on agent computers only in HCL OneTest UI 9.2.
  • With parallel test execution in 9.2.1, mobile devices are sometimes listed twice in the Run Test wizard, once for running the test with Chrome, and once for using the generic browser that is included with HCL OneTest UI. Be sure to select only one or the other. Parallel execution on an individual mobile device is not supported.
  • When running mobile Web UI tests with Safari on iOS devices, tests containing JavaScript alerts fail to run. This is a core framework limitation.

Contacting HCL Support

HCL Customer Support provides you with technical assistance.

Before you contact HCL support, gather the background information that you will need to describe your problem. When describing a problem to an HCL support specialist, be as specific as possible and include all relevant background information so that the specialist can help you solve the problem efficiently. To save time, know the answers to these questions:

  • What software versions were you running when the problem occurred?
  • Do you have logs, traces, or messages that are related to the problem?
  • Can you reproduce the problem? If so, what steps do you take to reproduce it?
  • Is there a workaround for the problem? If so, be prepared to describe the workaround.