Release notes for HCL OneTest UI 10.0.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 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 10.0.1

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.
    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
    • 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.