Release notes for HCL OneTest UI 9.5.0

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 9.5.0

  • Ability to create a test asset for Accelerated Functional Test suite. See Creating accelerated functional test asset. You can use a new command line argument -aftsuite to specify and run Accelerated Functional Test suite. See Running test from the command line. You can also specify the Accelerated Functional Test suite name when running the tests from UrbanCode Deploy, Jenkins, Ant, and Maven.
  • Support to integrate with HCL OneTest API to run API tests and functional tests as part of a compound test. See Testing with HCL OneTest API.
  • Support for playing back tests in Microsoft Edge 44. See Running a test in Microsoft Edge.
  • Support to run multiple tests from a single build step using the Jenkins plugin. See Testing with Jenkins.
  • Support for a new browser-based CSV editor for datasets to edit the dataset. Eclipse-based datapool is now replaced with dataset that is built on new technology. See Dataset overview.
  • eGit is now bundled along with the product. So, you can store the test assets in the Git repository and perform the related actions using eGit.
  • Introduction to the experimental features. These features should not be used in the production environment. See Experimental features.
    • Ability to record and play back tests for applications that use mixed content that is from both HTTP and HTTPS protocols.
    • Ability to view reports in the proper JSON format.
  • Ability to shell-share HCL OneTest UI and HCL OneTest Performance using the stand-alone installer.
  • Ability to perform a silent installation of the product using the stand-alone installer. See Installing the product silently.

Installing the product

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

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.