Home
Rational® Functional Tester
Test Execution Specialist guide
A test executor automates 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.
Running tests from Web UI Test perspective
In this section, you will learn how to play back tests from the Web UI Test perspective.
Running Web UI tests
See the different ways to play back Web UI tests.
Running tests from an Android mobile test client
You can run a test from an Android mobile device or emulator. After the run, the report is automatically uploaded to HCL OneTest™ UI. You can also view the report on the mobile test client.

Rational® Functional Tester
- Release Notes
  This document contains information about new features, system requirements, and known limitations in 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.
- 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
  Typically, a user with the administrator role is responsible for certain tasks including installation, configuration, and integration of the product. This guide lists all such topics.
- Test Author guide
  As a test author, you are responsible to create test scripts and enhances them by applying different test elements such as dataset, variables, and verification points.
- Test Execution Specialist guide
  A test executor automates 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.
  - Running tests from Web UI Test perspective
    In this section, you will learn how to play back tests from the Web UI Test perspective.
    - Running Web UI tests
      See the different ways to play back Web UI tests.
      - Prerequisites to running Web UI tests
      - Running tests from an Android mobile test client
        You can run a test from an Android mobile device or emulator. After the run, the report is automatically uploaded to HCL OneTest™ UI. You can also view the report on the mobile test client.
      - Running Web UI tests on BitBar mobile device cloud
        You can run Web UI tests on mobile devices available in BitBar cloud device from the test workbench and to view the execution reports in the BitBar cloud.
      - Running Web UI tests on Perfecto mobile cloud
        To check the connection between the application and mobile cloud device, ideally before the test execution, you can enter the Perfecto mobile cloud credentials and get it verified.
      - Running a test using industry-standard mobile browsers
        Starting with 9.2.1, you can use industry-standard mobile browsers, such as Chrome and Safari, to run Web UI tests for mobile web applications. You can run tests with Chrome on Android devices and emulators and with Safari on iOS devices and simulators. This capability uses Appium to actually run the tests. Before 9.2.1, you could only run tests on mobile devices using the generic browser that is bundled with HCL OneTest™ UI.
      - Running a test recorded in Google Chrome Device Mode
        You can run a test that you recorded in Chrome Device Mode. Doing so allows you to emulate the testing of applications on the browser of a mobile device.
      - Testing with Docker images
        HCL OneTest™ Performance, HCL OneTest UI, and HCL OneTest Performance Agents are available for download as Docker images. You can use them to fulfill the continuous testing aspects of your DevOps lifecycle.
      - Testing with IBM Cloud Private
        You can automate your testing environment by using Docker container images of the workbench and agents on top of IBM Cloud Private.
      - Starting a new recording immediately after playback
        Starting from 9.1.1.1, you can keep the Google Chrome browser active after Web UI test playback is complete. This feature allows you to continue recording at the point where playback finished without the need to re-record the earlier steps.
      - Adding custom JavaScript code as a test step in a Web UI test
        You can manually add JavaScript files (*.js) to test scripts with defined functions. You might want to run your own JavaScript snippet such as retrieving some data from the application, doing some actions within the application, or validating some complex logic actions within the application for example. To be able to execute specific code in a test, write your own JavaScript code and insert the custom JavaScript statement as a new test step in your test script.
    - Running mobile tests
      After you record the tests for mobile applications by using HCL OneTest™ UI, you can play back the recorded tests by using HCL OneTest UI. The test reports help you to analyze the functional and performance issues in the mobile applications developed.
    - Configuration of AFT Suite runs
      When you create Web UI, mobile, or Windows tests, you must configure the play back of the recorded tests as AFT Suite runs before you can view their test results.
    - Running a test on multiple browsers and devices simultaneously
      Rather than run a Web UI test on one browser at a time, you can run a single Web UI test on multiple browsers simultaneously. Doing so can significantly speed up your test effort. You can also extend your test coverage by adding mobile devices to the test run. You can run the test from HCL OneTest™ UI, from the command line, or from Rational® Quality Manager. This topic describes how to run a test from the Web UI Test perspective.
    - Running a test or schedule from a command line
      You can run a test or schedule without opening the product by using the command-line interface.
  - Running tests from Functional Test perspective
    In this section, you will learn how to play back tests from the Functional Test perspective.
- Test Manager guide
  As a test manager, you can 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
  While working with HCL OneTest™ UI, you might encounter some problems that you can easily troubleshoot. The topics in this section address some of these problems.
- Reference
  Use these additional topics to gain more knowledge about the product.
- 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.

Running tests from an Android mobile test client

You can run a test from an Android mobile device or emulator. After the run, the report is automatically uploaded to HCL OneTest™ UI. You can also view the report on the mobile test client.

Before you begin

You must first record and generate a test as mentioned in Recording Android tests.
To be able to test your application on a mobile device, the mobile device must be running the mobile test client and be connected to HCL OneTest™ UI.
For Android 6 devices that are connected to the computer running HCL OneTest™ UI with a USB cable, open Device Settings > Developer Options on the device and deselect Verify apps over USB. Otherwise, a conformation dialog opens each time the mobile test client or an application under test (AUT) is installed.

About this task

This task applies to native, hybrid and web applications recorded on an Android mobile test client that you run on a simulator or mobile device. You can play back tests for web applications on either Android or iOS. In addition, you can record a test on one device, such as a phone, and play back the test on another type of device, such as a tablet, if the application tested has the same behavior on both types of devices.

With the mobile test client for Android, you can also play back GPS locations and hardware actions such as volume up and down, mute, the use of headphones, and all media actions (play, pause, and so on), making calls, and ending calls. Camera and microphone functions are not supported.

Procedure

In the mobile test client, tap Manage Applications for a native application or Manage Web Applications for a web application, and then tap the application under test.

A list of available tests is displayed.
Tap a test script in the list, and then tap Run Test.

What to do next

You can now evaluate the test results. See Evaluate results.