Welcome
Test Author Guide
This guide describes how to create test scripts and enhances them by applying different test elements such as dataset, variables, and verification points.
Extending the Functional Test perspective
You can use custom code to extend the default functional testing capabilities. You can write custom code and call the code from the test. You can also specify that results from the tests that are affected by your custom code to be included in reports.
Using the API to edit functional test scripts
These topics describe how you can take advantage of the HCL DevOps Test UI (Test UI) application programming interface (API) or the scripting framework to make changes to functional test scripts. As a general rule, the modifications that you make with the scripting SDK, should emulate as closely as possible, the user interactions to test with the application-under-test.

Release Notes
This document includes information about the new features introduced, features deprecated or removed, defects fixed, and known issues identified in this version of HCL DevOps Test UI (Test UI). You can also find the installation and upgrade instructions along with the contact information of HCL Customer Support.
System Requirements
This document includes information about hardware and software requirements for HCL DevOps Test UI (Test UI) 2024.03 (11.0.1).
Getting Started Guide
This guide provides an overview of HCL DevOps Test UI (Test UI). You can find the task flows to get you started with Test UI. This guide is intended for new users.
Tutorials
You can learn to start using Test UI by reviewing the information in the Tutorials for the UI Test perspective and Functional Test perspective.
Samples
You can find the sample project that you can use with HCL DevOps Test UI (Test UI) to test the functionality of an application.
Administrator Guide
This guide describes how to install HCL DevOps Test UI (Test UI) software. After you install the software, you can perform administration tasks such as license configuration and integration with other products. This guide is intended for administrators.
Test Author Guide
This guide describes how to create test scripts and enhances them by applying different test elements such as dataset, variables, and verification points.
- Tests in the UI Test perspective
  When you develop web applications, Windows-based applications, or mobile applications, you can use HCL DevOps Test UI (Test UI) to create functional tests for these applications. You must first record the tests and then use Test UI to run the tests before you can view the test results.
- Tests in the Functional Test perspective
  When you develop Java, HTML, or Terminal-based applications, you can use HCL DevOps Test UI (Test UI) to create traditional functional tests for these applications. You must first record the tests and then use Test UI to run the tests before you can view the test results.
- Extending the UI Test perspective with custom Java™ code
  You can use custom code to extend the default Web UI testing capabilities. You can write custom Java™ code and call the code from the test. You can also specify that results from the tests that are affected by your custom code to be included in reports.
- Extending the Functional Test perspective
  You can use custom code to extend the default functional testing capabilities. You can write custom code and call the code from the test. You can also specify that results from the tests that are affected by your custom code to be included in reports.
  - DevOps Test UI proxy SDK
    Extend automated functional testing support for your application's user interface controls.
  - Customizing a script template
    HCL DevOps Test UI (Test UI) uses its default script templates to format and provide basic information when you create a script. You can customize the information and format by customizing the script templates.
  - Using the API to edit functional test scripts
    These topics describe how you can take advantage of the HCL DevOps Test UI (Test UI) application programming interface (API) or the scripting framework to make changes to functional test scripts. As a general rule, the modifications that you make with the scripting SDK, should emulate as closely as possible, the user interactions to test with the application-under-test.
    - Writing messages to the log
      A log is a file that contains the record of events that occur while a Functional Test script is playing back. There are several different methods you can use to write messages to the log.
    - Modifying options for script execution
      Some scripting framework options that affect script execution can be specified through the user interface. Values that you set in the user interface persist as the default values from script to script. However, you can also use the scripting framework to set some of these options directly in the functional test script, for example, the amount of time between keystrokes.
    - Starting a test script from within a script
      Test scripts can contain methods that invoke other test scripts. You might want to take advantage of this functionality by creating a test script that serves as a command file for a suite of scripts.
    - Querying values of object properties
      Components in the application-under-test, such as dialogs, command buttons, and labels, have associated pieces of information called properties. Properties have a name and a value. This topic provides examples of why you may want to modify your script to access an object property.
    - Unregistering references to test objects
      Helper script methods refer to an object in the application-under-test by using the test object map. HCL DevOps Test UI (Test UI) finds such mapped objects each time a method is called on the object. In some cases; however, you might not want Test UI to do this.
    - Handling ambiguous recognition
      In some situations during playback, HCL DevOps Test UI (Test UI) might not be able to differentiate between two similar objects in the software that is being tested. This topic describes handling these situations.
    - Adding manual and dynamic verification points
      In addition to verification points specified during recording, you can also incorporate new verification points into a Functional Test script. Scripting manual and dynamic verification points enables you to specify data for comparison against an object that is not found in the test object map. The data, however, must be value-class based.
    - Handling unexpected active Windows
      A common problem in GUI testing is the appearance of an unexpected active window -- for example, a warning message box in an HTML browser. This topic describes how to handle this problem.
    - DevOps Test UI examples
      HCL DevOps Test UI (Test UI) ships with some example code you can use in your own scripts. You can open these examples from within the sample project shipped with Test UI.
    - Determining the values of cells in a table
      When working with Java™ or HTML tables, you might want to extract the value of a given cell in the table. There are many ways to do this; one simple approach is to query the table directly.
    - Reading the Windows registry
      The Windows® registry is a database used by the Windows operating system to store configuration information. Often it becomes necessary for a tester to read information out of this database using HCL DevOps Test UI (Test UI) commands. This topic provides examples for doing this.
    - Iterating through items in a tree control using the getTestData method
      This topic provides an example of using HCL DevOps Test UI (Test UI)'s getTestData method to programmatically access the values on the branches of a tree control.
    - Iterating through table cells using the getTestData method
      This topic provides an example of using HCL DevOps Test UI (Test UI)'s getTestData method to access the values in the cells of a grid control.
    - Passing parameters to the callScript method
      This topic describes how to use the different signatures of the callScript method to pass data from one script to another.
    - Extracting data from a combobox/list control (JComboBox)
      You can use HCL DevOps Test UI (Test UI)'s getTestData method to access the values in the list of a ComboBox/List control.
    - Playing back low level mouse and keyboard actions
      Low-level playback of mouse and keyboard actions provides more control of events of user actions. For example, HCL DevOps Test UI (Test UI) currently supports TestObject.click(), where the click consists of low-level actions including mouse move, left mouse button down, and left mouse button up. With this functionality, you can play back the individual components of a mouse click.
    - Searching for test objects
      You can search for one or more test objects that match specified search criteria. The search is based on name/value pairs that represent properties of the test object or test objects you are looking for. The search can either be global, or limited to children of a parent test object.
    - Searching for SAP TestObjects
      With HCL DevOps Test UI (Test UI), you can locate one or more SAP TestObjects matching a specified search criteria, even without using the Object Map.
    - Tracing AJAX requests
      You can test AJAX-based applications in two different ways; by setting the Auto Trace option to true or by setting the Auto Trace option to false on the corresponding document object. By setting Auto Trace option to true, you can trace the AJAX requests.
    - Searching for GEF objects
      HCL DevOps Test UI (Test UI) recognizes the GEF EditParts and Palettes. Some Figures may not have an association with an EditPart. You can use Test UI APIs to find such Figures as shown in the below examples.
    - Passing parameters by using the describe function in PowerBuilder
      In PowerBuilder, you can use the describe() function to identify the properties of DataWindow objects and their controls. The describe() function is available only with the PowerBuilder DataWindow. The describe() function returns a string as a result of the parameters that are specified as a part of the describe() function. For example, you can find the data types of the column in a table style presentation. You can use the describe function in HCL DevOps Test UI (Test UI) as shown in the following examples.
    - Finding the state of the browser
      When you record functional test scripts, if you find that some controls were not picked up by the recording, you can verify whether the browser used during the recording was in a ready state for recording. Similarly, if you encountered problems during playback, you can verify the state of the browser. You can use the dynamic find() API and use the Html.HtmlBrowser method for this purpose.
    - Finding objects in a Dojo tree
      You can use the dynamic find() API and the dojoTreeExpand() method to find all objects within a Dojo tree control within the application under test.
    - Reading multiple datasets from a functional test script
      You can use the dynamic find() API to read multiple datasets from a functional test script.
    - Selecting an item from a Java drop-down list
      You can modify the dynamic find() API to use the mapped and dynamic test objects, to select an item from a drop-down list in a Java application, as the following example illustrates:
    - Verifying the status of a radio button or check box
      You can use the dynamic find() API to verify the status of a radio button or check box during playback, such as whether the control was selected or not.
    - Closing active browsers before playback
      You can use the dynamic find() API to find and close all active browsers before you play back a script to ensure that there are no active browser instances before playback.
    - Closing unexpected HTML dialogs during playback
      You can use the dynamic find() API to close HTML dialogs that are displayed unexpectedly during playback, to ensure smooth playback.
    - Dynamic Find() API for JavaScript dialogs
      You can test the JavaScript dialogs when you play back a script by using the Web UI engine. You can use the dynamic find() API to find and take action on the controls of the dynamic JavaScript dialogs such as alert, prompt, or confirm dialogs.
- Extending the functionality in the Visual Studio IDE
  These topics describe various ways that you can customize HCL DevOps Test UI (Test UI) or use the application programming interface (API) to extend Test UI functionality.
- Experimental features
  HCL DevOps Test UI (Test UI) contains a set of pre-releases that enable you to test various experimental features. These experimental features, while still in progress, are introduced early in the release to seek your feedback on its overall functionality and performance. You can play around with these capabilities before they are made available and supported as a general feature in an upcoming release.
Test Execution Specialist Guide
This guide describes how to automate the playback of the tests by using different methods such as Docker, IBM Cloud Private, Jenkins and so on. The test results can be pushed to HCL DevOps Test Virtualization Control Panel (Test Virtualization Control Panel).
Test Manager Guide
This guide describes how to keep track of the performance of the application by evaluating the test results. Following topics cover how you can work with the test results.
Troubleshooting
This guide describes how to analyze and resolve some of the common problems that you might encounter while you work with HCL DevOps Test UI (Test UI).
Reference Guide
This guide describes the additional topics to gain more knowledge about HCL DevOps Test UI (Test UI).
All Guides (PDF)
You can find the link to view or download the content of the release notes, system requirements, and persona guides of HCL DevOps Test UI (Test UI) as a PDF file.
Security Considerations
You can take certain actions to ensure that your installation is secure, customize your security settings, and set up user access controls.
Notices
This document provides information about copyright, trademarks, terms and conditions for the product documentation.

Using the API to edit functional test scripts

These topics describe how you can take advantage of the HCL DevOps Test UI (Test UI) application programming interface (API) or the scripting framework to make changes to functional test scripts. As a general rule, the modifications that you make with the scripting SDK, should emulate as closely as possible, the user interactions to test with the application-under-test.

You can start by using the scripting framework to make some of these simple modifications to recorded functional test scripts:

Change a user action, such as object().drag() to object().click().
Delete recorded commands.
Place an often repeated sequence of actions into a method.