Release notes for HCL OneTest™ API

This document contains information about What's new, installation, known issues, known limitations, and contact information of HCL support.

Contents

Product description

HCL OneTest™ API is an integration testing and virtualization tool that includes capabilities to automate and run tests earlier and more often to find problems sooner in the development cycle. See HCL OneTest API overview.

What's new

You can find information about the features introduced in this release of HCL OneTest™ API.

The following sections list the new features, enhancements, or other changes made in this release.
  • HCL OneTest™ Server

    For information about HCL OneTest™ Server, see Release notes.

  • HCL® Quality Server
    • Tools page

      The list of agents changed for a release was updated. Review the Tools page of HCL® Quality Server to see each tool and the version that it was last changed.

    • Removed installation of the WINPCAP feature when using IBM® Installation Manager or stand-alone installer

      The WINPCAP feature that you installed by using IBM® Installation Manager or stand-alone installer in earlier releases is now removed as an installable feature. If you intend to use the packet capture feature in HCL OneTest™ API 10.5 or later, you can install the Win10PCAP feature from the website (https://www.win10pcap.org/).

  • Technologies
    • Support for creating stub populated with data

      You can now create a stub based on the structure of the schema that is defined for the operation and have response payload populated with data.

      See Creating a stub populated with data.

  • Support to run tests or resources as a GitHub Action

    You can now run tests or resources that are contained in your project in HCL OneTest™ API as a GitHub Action from a Git repository.

  • Support for additional parameters in Kafka and Mongo transport configuration

    You can now provide additional parameters when you configure and use either the Kafka or MongoDB transports in HCL OneTest™ API.

    See Testing with Apache Kafka and Testing with MongoDB.

  • Synchronizing project resources in the results database

    You can now configure an option to automatically synchronize the details in the results database of the tests, suites, or stubs that were run whenever these project resources are moved or renamed.

    You can also manually synchronize the details in the results database with details in the project by using the command line.
    Note: This mainly affects navigation; data that is used to generate reports might still use the resource names as they were at test run time.

    See Server Settings and Renaming Suites or tests in the results database by using the command line.

  • Enhanced SQL Query Action

    When editing an SQL Query Action in HCL OneTest™ API, the test feature limits the number of fetched results from the server with a default value of 100 records that you can change. This enhancement aims to reduce processing of unwanted records from a poorly defined query.

    However, you can modify the number of records to process in the SQL Action UI based on the expected number of records in the database. Entering a value of 0 will enable HCL OneTest™ API to display all records in the database.

    See Adding an SQL Query action to a test.

  • Details of memory usage by an engine

    You can now view details of the memory used by an engine on the Infrastructure dashboard in HCL® Quality Server.

    See Viewing running agents.

  • Option to include optional fields in data-driven tests

    An option to include the optional fields is now provided when you want to create data-driven tests under an operation in HCL OneTest™ API.

  • Git folders in imported or exported files are ignored

    When you import or export resources from a projects including a .git folder HCL OneTest™ API now ignores any file present from the .git folder.

  • Support to save test report as a JUnit report

    When you configure a run of the HCL OneTest API Task that you want to run as a job in the Azure DevOps pipeline, you can now configure the location on your computer where the JUnit report of the test can be saved.

    See Running tests in an Azure DevOps pipeline.

  • Support for managing credentials

    If you have external resources that must be accessed by project or test resources in Rational® Integration Tester and you do not want to expose the credentials used to access the external resources, then you can implement user defined access to a credential management system.

    See Managing credentials.

Deprecated capabilities

You can find information about the capabilities that are deprecated in this release and are planned for a removal in a future release.
Note: You can contact the HCL Client Support team if you have any concerns.
  • The following operating systems, supported software, or capabilities are deprecated in this release:
    • Execution of virtual services from within IBM® Rational® Quality Manager
    • Software AG CentraSite certification suites, templates, and stub publication

Removed capabilities

Support for the following operating systems or supported software that were announced in previous releases as deprecated are removed in this release:

  • Red Hat Enterprise Linux (RHEL) 8.5

Installing and upgrading

You can find information about the installation and upgrade instructions for HCL OneTest™ API.

Installing HCL OneTest™ API

For information about installation, see Installing HCL OneTest API.

Installing HCL® Quality Server

For information about installation, see Installing HCL Quality Server.

Upgrading HCL OneTest™ API

If you use Installation Manager, you can find the upgrade requirements in HCL OneTest API upgrade information and requirements.

If you use the stand-alone installer to install the software packages, you cannot upgrade the product software. You must uninstall the previous version of the product software and install the latest version by using the stand-alone installer.

Upgrading HCL® Quality Server

If you use Installation Manager, you can find the upgrade requirements in HCL Quality Server upgrade information and requirements.

If you use the stand-alone installer to install the software packages, you cannot upgrade the product software. You must uninstall the previous version of the product software and install the latest version by using the stand-alone installer.

Known issues

You can find information about the known issues identified in this release of HCL OneTest™ API.

Table 1. Release documents - Fix list and known issues
Product Download document Knowledge base
HCL OneTest™ API Release document HCL support

The knowledge base is continually updated as problems are discovered and resolved. By searching the knowledge base, you can quickly find workarounds or solutions to problems.

The only known limitation is that 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

  • For technical assistance, contact HCL Customer Support.
  • Before you contact HCL support, you must gather the background information that you might need to describe your problem. When you describe a problem to the 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.