Home
Rational® Functional Tester
Samples
You can find the sample project that you can use with Rational® Functional Tester to test the functionality of an application.
Functional testing proxy SDK technology samples
Functional testing proxy SDK samples are simple examples of proxy source code and applications under test (AUT).
ButtonProxy
The ButttonProxy sample has two Rational® Functional Tester proxies. There is one button control each for the Abstract Window Toolkit (AWT) and the Java foundation class (JFC). The sample works with the application-under-test (AUT) sample.
Testing the button proxy sample
This proxy sample explains how to write a simple proxy, map proxies to controls, deploy proxies, and verify how proxies work.

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.
  - Sample project to test a Java application
    The sample functional test project is created using the first few lessons of the "Create a functional test" tutorial . You can look at the test assets while you do the tutorial or after you complete it.
  - A Rational® Functional Tester project to test an HTML application
    This is a sample functional test project that contains various functional test scripts for testing an HTML application. In this sample project, the IBM® Rational® Team Concert™ web client is used as an application under test.
  - Functional testing proxy SDK technology samples
    Functional testing proxy SDK samples are simple examples of proxy source code and applications under test (AUT).
    - ButtonProxy
      The ButttonProxy sample has two Rational® Functional Tester proxies. There is one button control each for the Abstract Window Toolkit (AWT) and the Java foundation class (JFC). The sample works with the application-under-test (AUT) sample.
      - Testing the button proxy sample
        This proxy sample explains how to write a simple proxy, map proxies to controls, deploy proxies, and verify how proxies work.
    - JFormattedTextFieldProxy
      This JFormattedTextFieldProxy sample explains how create a new proxy class add new control properties and control data. The sample works with the application-under-test (AUT) sample.
    - CheckBoxProxy
      This CheckBoxProxy sample explains how to create a new proxy class and new TestObjects and then map them to the javax.swing.JCheckBox control. The sample works with the application-under-test (AUT) sample.
    - Button OverrideProxy
      This ButtonOverrideProxy sample explains how you can extend the recording behavior of Rational® Functional Tester, add more properties and set up a simple value manager and value class. This sample proxy is written for the java.awt.Button control. The sample works with the application-under-test sample (AUT).
    - JSpinnerProxy
      This JSpinnerProxy sample explains how to extend recording behavior of a control with SubItems, and support the playback for the extended recording behavior. The sample works with the application-under-test (AUT) sample.
    - TreeProxy
      This TreeProxy sample explains how to extend recording behavior of a control with SubItems, and support the playback for the extended recording behavior. The sample works with the application-under-test (AUT) sample. To view the samples, you must import the tree proxy, tree application and the tree custom control for which the proxy is being written into your workspace.
    - Flex control proxy
      This FlexCustomControl sample explains how to extend the recording behavior of a control with SubItems and support the playback for the extended recording behavior. The sample works with the application under test sample. To view the samples, import the flex proxy for which the proxy is being written into your workspace.
  - Functional testing samples for the Visual Studio IDE
    Rational® Functional Tester ships with some example code you can use in your own scripts. You can open these examples from within the sample project shipped with Rational Functional Tester. The sample project was created using the Rational Functional Tester tutorial. For reference, you can look at the script and other test assets while you do the tutorial, or after you complete the tutorial, if you want to compare the script and test assets to your files or actually play back the script.
  - Functional testing proxy SDK samples for the Visual Studio IDE
    Rational® Functional Tester ships with some example proxy code you can use to learn about proxy SDK. You can open these examples from within the sample projects shipped with Rational Functional Tester.
- 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.
- 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.

Testing the button proxy sample

This proxy sample explains how to write a simple proxy, map proxies to controls, deploy proxies, and verify how proxies work.

Test the button application sample to view the default value of the button control

Open the AWTButtonApp.java and JButtonApp.java files that are available in the imported ButtonApp project folder.
Open the Functional Test perspective.
Run the AWTButtonApp.java script. The sample button application is displayed.
To test the button control, record a functional test script and click the button control of the sample application.
Open the test object map. Notice that the Proxy Class Name (#proxy) property under Administrative properties for java.awt.Button is .java.awt.ButtonProxy. This is the default value for this control.
Similarly run the JButtonApp.java script. The sample button application is displayed.
To test the button control, record a functional test script and click the button control of the sample application.
Open the test object map. Notice that the Proxy Class Name (#proxy) property under Administrative properties for javax.swing.JButton is .java.jfc.AbstractButtonProxy. This is the default value for this control.
Notice that the button click action is recorded as button.Click()

Deploy the binary files

Open the Java perspective.
From the ButtonProxy project, copy the ButtonProxy.jar and the ButtonProxy.rftcust to the customization directory. The default location for the customization directory is C:\ProgramData\IBM\RFT\customization .

Verify the proxy deployment

After deploying the proxy, you can now verify the value of the control.

Restart Rational® Functional Tester
Open the ButtonApp application as mentioned in the earlier section.
Record a functional test script to test the buttons of the sample application.
Open the test object map. Notice that the Proxy Class Name (#proxy) property under Administrative properties for java.awt.Button and javax.swing.JButton are sdk.sample.awt.ExtendedButtonProxy and sdk.sample.swt.ExtendedJButtonProxy respectively. This proxy sample extends the proxy method public String getDescriptiveName() to change the TestObject descriptive names for the java.awt.Button and javx.swt.JButton controls.
Notice that after you deploy the proxies, the click actions on java.awt.Button and javax.swing.JButton controls are recorded as button_button.click() and jbutton_button().click() respectively as the proxy changes the descriptive name given to the TestObject for these two controls