Home
Rational® Functional Tester
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.
Results for tests in Functional Test perspective
In this section, you will learn how to analyze test results in the Functional Test perspective.
Log Extension
You can create customized Rational® Functional Tester logs in addition to the standard log formats: text, HTML, Test and Performance Tools Platform (TPTP), and XML. You can use the customized logs to view your playback results.
Extending a log
You can customize your log files by configuring the plug-ins to extend an extension point and writing a class that designs your log.

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 IBM® Rational® Functional Tester.
- 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
  You can learn to start using Rational® Functional Tester 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 Rational® Functional Tester to test the functionality of an application.
- Administrator Guide
  This guide describes how to install IBM® Rational® Functional Tester 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 Rational® Test 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.
  - Publishing test result to IBM® Rational® Test Automation Server
    The test result indicate the quality of the application under test. There could be different stakeholders to the application who do not have the product installed but want to check the quality of application. You, as the user of the product, can publish the test result to IBM® Rational® Test Automation Server so that others can view it from the web browser.
  - Publishing specific results to the server
    If you have a single test result or multiple test results that are not published to IBM® Rational® Test Automation Server, you can publish a single or all of them simultaneously.
  - Unified reports
    Unified reports in Rational® Functional Tester provide a detailed overview of the test results.
  - Results for tests in UI Test perspective
    In this section, you will learn how to analyze test results in the Web UI Test perspective.
  - Results for tests in Functional Test perspective
    In this section, you will learn how to analyze test results in the Functional Test perspective.
    - Functional test logs
      After the playback is complete, you can view the results in the log. The results include any logged events such as verification point failures, script exceptions, object recognition warnings, and any additional playback information.
    - Logging page
      You use the Logging page to set log and comparator options, such as preventing the script launch wizard from displaying on playback, displaying the log viewer after playback, and displaying a message before overwriting an existing log. You also use this page to indicate the type of log generated.
    - Setting log preferences
      You can set your log preferences to view functional test logs.
    - Disabling enhanced log results
      Logged events such as verification point failures, script exceptions, object recognition warnings, and other additional playback information are displayed in the playback log results. From Rational® Functional Tester version 8.2 and later, the results of the getProperty() command are also displayed in the log results. If you do not require the log event to be displayed in the playback log, you can disable the event in the log results.
    - Viewing logs in the Projects view
      You can open a log from the Projects view. In Projects view, the HTML, XML, and text logs are listed within each project. The log list is displayed below the project. The log has the same name as the project, with _logs appended, for example, projectname_logs.
    - Viewing Dojo logs
      Dojo logs are based on XML logs and display a graphical representation of the test results. You can use Dojo logs to select filters and view verification points, failed verdicts, warning verdicts, and the detailed information on each action that is recorded in the script. Dojo logs open in the default browser after script execution.
    - Renaming and deleting logs
      You can rename and delete logs from the Projects view.
    - Log Extension
      You can create customized Rational® Functional Tester logs in addition to the standard log formats: text, HTML, Test and Performance Tools Platform (TPTP), and XML. You can use the customized logs to view your playback results.
      - Extending a log
        You can customize your log files by configuring the plug-ins to extend an extension point and writing a class that designs your log.
      - Deploying the extended log file
        You can deploy your customized log file by exporting the plug-in in a format suitable for deployment.
      - Example: Creating a text log
        The following example shows how to create a text-log output from an empty test script.
- Troubleshooting
  This guide describes how to analyze and resolve some of the common problems that you might encounter while you work with Rational® Functional Tester.
- Reference Guide
  This guide describes the additional topics to gain more knowledge about Rational® Functional Tester.
- 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.

Extending a log

You can customize your log files by configuring the plug-ins to extend an extension point and writing a class that designs your log.

Procedure

Create a new plug-in project.
By default, the Eclipse environment displays the project Overview after you create the project.
Note: If the project Overview is not displayed by default, right-click MANIFEST.MF under the META-INF folder, and click Open With > Plug-in Manifest Editor.
Click the Dependencies tab, and click Add under Required Plug-ins.
Select com.ibm.rational.test.ft.playback from the Plug-in Selection list, and click OK.
Save the plugin.xml file.
Click the Extensions tab, and click Add.
Select the com.rational.test.ft.playback.logExtension extension point from the list, and click Finish.
Type the extension ID and Name.
Right-click com.ibm.rational.test.ft.playback.logExtension in the left pane of Extensions window.
Click New > Log.
The log file is displayed under the extension file.
Note: Customized or extended log files in formats other than the standard formats cannot be viewed in either the Rational® Functional Tester Eclipse Integrated Development Environment or the Visual Studio IDE.
In Extension Element Details, specify the properties of the log.
1. Type a unique ID for the log in LogID field. Rational® Functional Tester uses this LogID to list the log type on the Preference Page.
2. Type a class name in Class field. This class name extends the base class LogExtensionAdapter.
3. Optional: Type a description of the log in Description field.
Save the project.