HCL OneTest API, HCL OneTest Virtualization release notes for Version 9.5

Read about new features, system requirements, installation, known issues, known limitations, and support for HCL OneTest™ API, HCL OneTest Virtualization, version 9.5.


This offering includes the following installable components:
  • HCL OneTest API, a scripting-free environment for developing tests for SOA messaging and business process integration projects. Tests can be built by recording existing system behaviors or from requirements, by entering the data to send and the data that is expected in return. You can also create virtual services to remove test dependencies and enable earlier testing. Virtual services can be deployed by HCL OneTest Virtualization to provide on-demand virtualized test environments that can support all phases of the test development lifecycle.
  • HCL Quality Server, a server-based web application that provides a central repository for virtualized services. With HCL Quality Server, you can use virtual services that are published by HCL OneTest API to create, share, and deploy virtualized test environments in HCL OneTest Virtualization. It also contains technology-specific components that are used by HCL OneTest API for recording SOA message conversations, HTTP(S) and JDBC traffic, and for monitoring middleware systems under test with minimal reconfiguration of client applications.

New features and enhancements

What's new in Version 9.5

v10 Tech Preview
  • The Project Settings dialog has a Tech Preview tab to configure access to trial features of the v10 Tech Preview - HCL Quality Server that includes capabilities such as management of secrets, and sharing and execution of test cases.
  • In 9.5, you can specify the name of the secrets collection configured for your v10 Tech Preview project in the HCL OneTest API Environment Editor. This name overrides the default secrets collection name, which is the name of the environment. For more information, see Accessing the v10 Tech Preview from HCL OneTest API.
  • In 9.5, HCL OneTest API uses the environment variable HCL_ONETEST_OFFLINE_TOKEN to access the v10 Tech Preview if no offline token is generated for use by the project member from the v10 Tech Preview. For more information, see Using the v10 Tech Preview offline tokens.
  • In 9.5, you can access secrets that are stored in a secrets collection configured for a project on the v10 Tech Preview from the HCL OneTest API UI. For more information, see Accessing the v10 Tech Preview from HCL OneTest API.
HCL Quality Server
  • The list of agents changed for a release was updated. See the Tools page of HCL Quality Server to see each tool and the version that it was last changed.
  • When starting a large number of stubs, the rate at which the Agent starts engines is now throttled so that the load on the HCL Quality Server is reduced.
  • When you are viewing agents in the Infrastructure Dashboard and you want to perform operations on the running stub containing the agent, you can open the running stub in the Environments Dashboard without having to navigate to the Environments Dashboard and looking up the stub. For more information, see Viewing running agents.
  • From the Environments dashboard, when you add stubs to a scenario, you can now select or deselect all stubs at once. For more information, see Adding stubs to a scenario.
  • Starting from 9.5, when a HCL OneTest API tool package containing a registration.xml file is downloaded from the HCL Quality Server Tools page, the URL used to connect to HCL Quality Server is configured based on the URL used to request the package. In previous releases, the URL was set statically during the installation of HCL Quality Server. For more information, see HCL OneTest API tool packages.

Deprecated capabilities

  • The following capabilities are deprecated. HCL will no longer invest in enhancing these capabilities, and is planning to remove them in a future release. If you have any concerns, contact either an HCL representative or your HCL Support team for this program:
    • Service Integration Bus (SIBus) transport
    • GUI interaction actions including support for QuickTest Professional (QTP) and TestDrive
    • Test cycles
  • Starting in 9.5, source code support for Git is now integrated into the HCL OneTest API workbench. With this change, the HCL OneTest API Tools application also known as the source control application is deprecated. HCL will no longer invest in enhancing this tool, and is planning to remove it in a future release. If you have any concerns, contact either an IBM representative or your HCL Support team for this program. For more information about using Git source control within HCL OneTest API, see HCL OneTest API and Git.
  • Deprecated features noted in HCL OneTest API 9.1.0 related to IBM BPM interaction and native Network Virtualization integrations were removed. Existing HCL OneTest API projects that rely on deprecated features might no longer work.


  • HCL OneTest API provides synchronization support for OpenAPI 3.0 definitions. With this support you can use an OpenAPI 3.0 definition to automatically create the resources that are required for testing the API that the definition describes. An example OpenAPI 3.0 definition is provided with HCL Quality Server. For more information, see OpenAPI 3.0 definitions.
  • HCL OneTest API ships with the required JAR files to communicate with RabbitMQ. No Library Manager configuration is necessary. For more information, see Testing with RabbitMQ.
  • HCL OneTest API now supports MongoDB as a transport to use in message actions in tests. For more information, see Testing with MongoDB.
  • Prior to 9.5.0, it was possible to virtualize SAP RFC calls by using the Java Agent to intercept calls made from applications that use the SAP Java Connector. The application still had to be connected to the SAP system to retrieve metadata. In 9.5.0, it is possible to record the calls that return the metadata and create stubs so that the application can be used without a connection to the SAP system. Example: Virtualizing SAP RFC calls.
  • A number of improvements were made to the authorization checks that are performed when using transport based recording of z/OS hosted Websphere MQ queue managers. For more information, see Configuring IBM WebSphere MQ on z/OS.
  • A new option Don't close connection when client closes its output stream (support half-closure) was added to the TCP transport. This option is used when you have a stub that expects to receive a single message on a connection and you want the client output stream closure to indicate that the complete message was sent. For more information, see Creating physical TCP servers.


The Database Stub Editor now supports a Pass-through tab, which provides pass-through capability for database stubs. A database stub can call a live database, depending on its pass-through settings (Pass through unlearned tables, stored procedures, and INSERT/UPDATE/DELETE statements to replay on a live database, and automatically learn data from tables and queries not already contained in the stub). For more information, see Modifying database stubs.


Previously, to use Git source control and share HCL OneTest API projects with teams, you integrated HCL OneTest API with EGit through the Eclipse Programming Development Environment (PDE), which is called HCL OneTest API Tools also known as the source control application. Now HCL OneTest API supports native Git integration so you can work directly with the Git source from the HCL OneTest API workbench. For more information, see HCL OneTest API and Git.


  • The Compare Files action was renamed to Compare Records action. For more information, see Compare Records.
  • HTTP Proxy now allows both secure and non-secure WebSocket traffic to pass through without being affected. Note that recording and routing of this type of traffic is not supported. For more information, see Recording HTTP and HTTPS traffic.
  • The version of Apache POI was updated to provide support for more recent features of the Excel file format.

A list of fixes are documented. For more information, see Fix List.

System requirements

For system requirements, see the PDF documents on the HCL License & Delivery Portal.

Installing HCL OneTest API and HCL Quality Server 9.5

Installing HCL OneTest Virtualization 9.5

For information about installation, see Installing HCL OneTest Virtualization.

Known problems

Known problems are documented. For more information, see Known Issues.

Known limitations

The known limitations are listed.
  • The Logical View does not display a diagram. Instead, a tree view, similar to that used in the Test Factory and Test Lab is used to support the logical components of the SUT.

Contacting HCL Support

HCL Products and Platforms Support provides you with technical assistance.