Release notes for HCL OneTest UI 9.2.1

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 top 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

What's new in 9.2.1

  • Ability to run multiple tests using the Ant plugin for HCL OneTest UI. See Testing with Ant.
  • Ability to 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. This capability uses Appium to actually run the tests. Before 9.2.1, you could only run tests on mobile devices using the generic browser that is bundled with HCL OneTest UI. See Running a Web UI test using industry-standard mobile browsers.
  • Ability to use pre-built Docker images to deploy the workbench and agents and start testing right away, with no need to install the product and the agents on different machines. See Testing with Docker images.
  • Cucumber integration has been enhanced with better reporting and a simplified approach to Cucumber dependencies. See Release notes for HCL OneTest UI 9.2.1.
  • A new check box in the User Action Details section of the Test Editor to perform the Click, Hover, and Press Enter object actions asynchronously. By using this option, you can perform more robust tests that run reliably in test automation scenarios. See Improving test script robustness.
  • Ability to use Guided Healing for variables and verification points. You can delete and replace snapshots and hierarchies for multiple selected steps. See Guided Healing.
  • Ability to compare multiple reports and view the trend of a test from the Reporting dashboard of HCL Quality Server. See Actions in the reporting dashboard.
  • Ability to integrate with HCL OneTest Data to automatically generate data when creating a datapool. See Using HCL OneTest Data.
  • Tutorial about Getting started Web UI Testing in the Web UI Test perspective. See Getting started with the Web UI Testing.

Installing the product

To install HCL OneTest UI 9.2.1, first uninstall any previous installations of HCL OneTest UI. Then, use the Install procedure in IBM Installation Manager to install 9.2.1.

Installing .NET 2010 help

If you installed Microsoft Visual Studio 2010 .NET Integration, you must install Microsoft Visual Studio 2010 .NET help manually.

  1. After you install HCL OneTest UI Microsoft Visual Studio 2010 .NET Integration, open HCL OneTest UI, click Help and then click Manage Help Settings. This opens the Visual Studio Help Library Manager.
  2. Select the Install content from disk option.
  3. Click Browse and select the helpcontentsetup.msha file that is available by default in C:\ProgramData\Microsoft\HelpLibrary\VS2010\. The help manifest files for other translations are found within the locale folders available in the VS2010 directory. Click Next.
  4. Select FT and click Add. The Update button is enabled.
  5. Click Update. You are prompted to confirm the installation. Click Yes. The HCL OneTest UI .NET help is installed as local help for Visual Studio 2010.
Note: To view the HCL OneTest UI .NET Scripting help in the Visual Studio 2010 IDE, you must enable the local help option in the Help Library Manager.

Tip: To view the complete table of contents of the installed local help in the Visual Studio 2010 IDE, install the Visual Studio Help Keyword Index plug-in that is available from the Microsoft website. Alternatively, you can upgrade to Visual Studio 2010 Service Pack 1 to view help in the Microsoft Help Viewer.

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.

Adobe Flex support

  • Testing Flex applications are supported only on 32-bit browsers.
  • Testing Flex applications are not supported on Mozilla Firefox 17.0 and later or on Google Chrome.
  • While taking a data verification point on multiple selected elements of a Flex list control, not all selected values are picked up.
  • Insert Test Object does not work for Flex and SparkFormControl.
  • It is not possible to play back actions that are recorded on the vertical scroll bar of a SparkList.
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.
Microsoft Visual Studio 2010 Ultimate support
  • This limitation only applies to 64-bit versions of Windows. If you face any errors related to the loading of the package while creating a project in HCL OneTest UI, Microsoft Visual Studio 2010 Ultimate Integration, download and install any missing dependencies (for example, msvcp80.dll and msvcr80.dll). Then, create a project.
PDF 9.0, 10.0 and 11.0 file testing support
  • When you record the tool bar buttons in Adode 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
  • To enable Google Chrome for testing, the extension must be installed from the Chrome Web Store.
  • 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 an Appium limitation.