Home
Rational® Functional Tester
Tutorials
This section contains the tutorials which explains the main features of HCL OneTest™ 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 Rational® Functional Tester.
Create a functional test using Java scripts
This HCL OneTest™ 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 OneTest™ UI and walks you through the major use cases for testing and performing basic operations. This tutorial uses the sample application provided with HCL OneTest UI to perform all the tasks.

Rational® Functional Tester
- Release Notes
  This document contains information about what's new, installation instructions, known problems in and contact information of IBM Customer Support.
- System Requirements
  This document includes information about hardware and software requirements for HCL OneTest™ UI.
- Getting Started Guide
  This guide provides an overview of Rational® Functional Tester. You can find the task flows to get you started with Rational Functional Tester. This guide is intended for new users.
- Tutorials
  This section contains the tutorials which explains the main features of HCL OneTest™ UI.
  - Tutorials for testing in the UI Test perspective
    You can use the tutorials to get started with testing in the UI Test perspective in Rational® Functional Tester.
  - Tutorials for testing in the Functional Test perspective
    You can use the tutorials to get started with testing in the Functional Test perspective in Rational® Functional Tester.
    - 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 OneTest™ 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 OneTest™ 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 OneTest™ UI and walks you through the major use cases for testing and performing basic operations. This tutorial uses the sample application provided with HCL OneTest UI to perform all the tasks.
      - Lesson 1: Set up HCL OneTest™ 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 HCL OneTest™ 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 OneTest™ 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 OneTest™ 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 OneTest™ 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 OneTest™ 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 OneTest™ UI data-driven test wizard.
    - Test Adobe Flex application
      This tutorial walks you through the steps to enable your Adobe Flex application, and test the enabled Flex application from a local test computer using HCL OneTest™ UI. The steps are based on the roles that Flex developers and testers perform.
    - Test GEF applications
      The movies in this tutorial show you how to use HCL OneTest™ UI to test applications that are based on the Graphical Editing Framework (GEF). It also shows how HCL OneTest UI works with GEF objects.
    - Extend Rational® Functional Tester capabilities using Proxy SDK
      The movies in this tutorial show you how to extend the Rational® Functional Tester proxies using the proxy SDK.
- Samples
  This section describes about the sample project which can be used with HCL OneTest™ UI to test the functionality of an application.
- Administrator Guide
  This guide describes how to install HCL OneTest™ 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 Quality Server.
- 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 OneTest™ UI.
- Reference Guide
  This guide describes the additional topics to gain more knowledge about HCL OneTest™ 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 IBM® Rational® Functional Tester 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 OneTest™ UI and walks you through the major use cases for testing and performing basic operations. This tutorial uses the sample application provided with HCL OneTest™ UI to perform all the tasks.

The HCL OneTest™ 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

Note: Consider printing the tutorial before you begin and using the printed copy as you work through the lessons.

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 HCL OneTest™ UI.