Welcome
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.
Tutorials for testing in the Functional Test perspective
You can use the tutorials to get started with testing in the Functional Test perspective in HCL DevOps Test UI (Test UI).
Create a functional test using Java scripts
This HCL DevOps Test UI (Test UI) tutorial walks you through the major use cases for creating and playing back functional tests that use Java scripts. This comprehensive tutorial uses a sample Java™ application that is installed with the product.
Introduction: Create a functional test using Java scripting
This tutorial teaches you how to get started using HCL DevOps Test UI (Test UI) and walks you through the major use cases for testing and performing basic operations. This tutorial uses the sample application provided with Test UI to perform all the tasks.

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.
- Tutorials for testing in the UI Test perspective
  You can use the tutorials to get started with testing in the UI Test perspective in HCL DevOps Test UI (Test UI).
- Tutorials for testing in the Functional Test perspective
  You can use the tutorials to get started with testing in the Functional Test perspective in HCL DevOps Test UI (Test UI).
  - Get started with functional testing using simplified scripts
    This tutorial introduces you to simplified test scripts and the application visuals and helps you get started with HCL DevOps Test UI (Test UI) for testing applications. It uses a sample Java™ application that is installed with the product for functional testing.
  - Create a functional test using Java scripts
    This HCL DevOps Test UI (Test UI) tutorial walks you through the major use cases for creating and playing back functional tests that use Java scripts. This comprehensive tutorial uses a sample Java™ application that is installed with the product.
    - Introduction: Create a functional test using Java scripting
      This tutorial teaches you how to get started using HCL DevOps Test UI (Test UI) and walks you through the major use cases for testing and performing basic operations. This tutorial uses the sample application provided with Test UI to perform all the tasks.
    - Lesson 1: Set up DevOps Test UI
      IBM® provides a Java™ Runtime Environment (JRE) that is installed and enabled for testing Java applications. Use this JRE for the tutorial. When you want to test your own Java or HTML applications, you must run the enabler and configure your environments and applications. For more information on these set-up tasks, see the Getting Started with Test UI wizard in the First Steps section of the product Welcome. For now you do not need to do anything to use the preconfigured JRE to continue.
    - Lesson 2: Record a script
      In this lesson, you will record a script using the HCL DevOps Test UI (Test UI) Recording Monitor.
    - Lesson 3: Create verification points
      In this lesson, you will record verification points to test objects. Verification points verify that a certain action has taken place, or verify the state of an object.
    - Lesson 4: Play back the script
      In this lesson, you will play back the script and look at some parts of the HCL DevOps Test UI (Test UI) interface. Because the script you just recorded is the active script, that script will play back when you click the playback button.
    - Lesson 5: View verification points and object maps
      In this lesson, you will learn how to view and modify the properties of verification points and object maps.
    - Lesson 6: Perform regression tests
      In this lesson, you will execute your script on a different build. When you have a new build of an application, you can run the automated test you recorded by playing back your script on the new build. To execute your script on the new build, you must change the name of the application in your script. (You would not need to do this on a development project; you do it here to simulate getting a new build of the application.)
    - Lesson 7: Use the Comparator to update a verification point
      You can use the Verification Point Comparator to compare verification point data after you play back a script. Verification points provide a baseline of the properties or data of an object. If the verification point fails on a subsequent build of an application, you have found a defect or an intentional change to the application. If the change is intentional, you can update the information in the verification point so that the test continues to be valid for future builds.
    - Lesson 8: Update the object map
      In this lesson, you will fix the object recognition warning by using the object map. You will also use a regular expression for more flexible object recognition.
    - Lesson 9: Change the Recognition Preferences
      In the previous lesson, you saw how you can update the recognition properties of an object when they change. Another factor you can change is the recognition weights that HCL DevOps Test UI (Test UI) uses during playback. You use the ScriptAssure™ recognition preferences to set this. The label object that you tested with the second verification point can demonstrate how this works.
    - Lesson 10: Use regular expressions
      The last thing you will do using the object map is convert a property value to a regular expression. In this case, the regular expression provides more flexibility in the object recognition.
    - Summary: Create functional tests
      This tutorial has shown you how to set up HCL DevOps Test UI (Test UI) for testing, recording and playing back scripts, creating verification points and using the Verification Point Comparator to update object properties or data, and several ways to use the object map to your advantage.
  - Perform a data-driven functional test using Java scripts
    In this tutorial, you will learn how to create a data-driven functional test using the HCL DevOps Test UI (Test UI) data-driven test wizard.
  - Test GEF applications
    The movies in this tutorial show you how to use HCL DevOps Test UI (Test UI) to test applications that are based on the Graphical Editing Framework (GEF). It also shows how Test UI works with GEF objects.
  - Extend DevOps Test UI capabilities using Proxy SDK
    The movies in this tutorial show you how to extend the HCL DevOps Test UI (Test UI) proxies using the proxy SDK.
- Tutorials for testing in the Visual Studio IDE
  HCL DevOps Test UI (Test UI) tutorials contain educational materials to help you learn the technologies and concepts behind products.
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.
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.

Introduction: Create a functional test using Java scripting

This tutorial teaches you how to get started using HCL DevOps Test UI (Test UI) and walks you through the major use cases for testing and performing basic operations. This tutorial uses the sample application provided with Test UI to perform all the tasks.

The Test UI tutorial is divided into 10 lessons that must be completed in sequence for the tutorial to work properly.

Learning objectives

After completing this tutorial, you will be able to:

Create a functional test project and record a Java test script
Work with verification points, object maps, and regular expressions
Use a comparator to update a verification point
Play back a script
Perform regression tests

Time required

This tutorial should take approximately 45 minutes to finish. If you explore other concepts related to this tutorial, it could take longer to complete.

Prerequisites

This is an introductory tutorial. You should be able to perform the tasks with little or no experience with Test UI.