Rational TestFactory Patch

These Release Notes provide information that is not available in the printed documentation or the online Help for Rational TestFactory 7.5.

About the TestFactory Patch

Limitations known to exist in the version of TestFactory released with Rational Suite TestStudio 7.5 have been addressed in the TestFactory patch. Java support in particular is much improved over the earlier release. If you have Rational Suite TestStudio 7.5 installed, we strongly recommend that you download and install the TestFactory patch.

Contents

About Your License Agreement
Installing the TestFactory Patch
Improvements Included in the TestFactory Patch
General Notes
Known Limitations

About Your License Agreement
Contents

This software is protected by United States and by international copyright laws. Your company has been granted permission to use the software only in accordance with the terms of your license.

Installing the TestFactory Patch

Contents

You can obtain the TestFactory patch on Rational's Web site.

To download the TestFactory patch:

1. Start your Web browser and go to http:\\www.rational.com.

2. In the Choose a Rational product list, click Rational Suite TestStudio.

3. In the left margin, click upgrade it!

4. Under Patches and Upgrades, click Downloadable Software Patches and Upgrades.

5. Under Patches and Upgrades, click Patches for Download.

6. Under Patches, click Rational TestFactory.

7. To complete the download, follow the instructions provided.

The TF751089.zip file downloaded consists of two folders (common and Rational Test 7) and the Release Notes. The common and Rational Test 7 folders contain all of the necessary TestFactory files including Help.

To install the TestFactory patch:

1. Extract the TF751089.zip file to a location on your hard disk.

2. Copy the contents of the common folder to ..\Rational\common.

3. Copy the contents of the Rational Test 7 folder to ..\Rational\Rational Test 7.

4. Read the Release Notes.

Improvements Included in the TestFactory Patch

Contents

This patch includes improvements to the following TestFactory features and functions:

• Mapping, testing, and script generation (general)

• Mapping and testing Java applications

• TestStudio project management

• Reclassification of UI objects in the application map

• Performance (virtual memory use)

• PureCoverage functionality across operating systems

• Improved memory error reporting during testing

Contents

Changing the System Font Size between Mapping Sessions

If you change the size of the system font between mapping sessions, TestFactory recognizes the controls that contain the changed text as new controls and maps them as such.

Work-around:

• Change back to the system font size used previously.

• Delete all objects (except the StartAUT object) in the application map, and then map the AUT from scratch.

If you change the size of the system font after you map the AUT, and you then try to run a Pilot, the Pilot run fails. TestFactory sees the controls that contain the changed text as unmapped controls.

Work-around:

• Change the system font size to the size used when you mapped the AUT.

• Delete all objects (except the StartAUT object) in the application map, map the AUT from scratch, and then proceed with testing.

Recommended Java Virtual Machine

We recommend that you run Java on Jview so that you can obtain code coverage information for the scripts that your Pilots generate. If you run Java on the Sun JVM, TestFactory does not calculate code coverage values for generated scripts in this release. Your application can be built in Java, but should be run in TestFactory using Jview.

Note: Future releases of TestFactory will support the Sun JVM for generating scripts that produce code coverage.

If you are using JDK version 1.2 (2.0), you cannot run Jview as the virtual machine. Use an earlier version instead.

Mapping and Testing Java Applications Developed Using the Java Development Kit 1.1.8 or an Earlier JDK Release

If the application-under-test was developed using the Java Development Kit (JDK) 1.1.8 or an earlier release, you cannot use the Java virtual machine included with that JDK to run the application during mapping and testing from TestFactory. Instead, you must use the Jview virtual machine or the Java virtual machine included with the JDK 1.2.1 or later release.

Installing the Rational Test Java Enablers before Mapping a Java Application

If you map a Java AUT without first installing the Rational Test Java Enablers, the resulting application map contains only a top-level window object and an exit transition object. To correct the problem, install the Rational Test Java Enabler, delete the top-level window and exit transition objects, and then remap the Java application.

You can install the Rational Test Enablers from the Rational Software Setup program. For information about how to install the Rational Test Enablers, see the Rational Suite Installation Guide.

Known Limitations

Contents

Working with Third-Party Controls

TestFactory does not support the mapping and testing of certain third-party controls. If the AUT contains a third-party control that TestFactory does not recognize, you can create a region object to represent the control and assign an interaction method to use on the control during mapping and testing. However, there is no guarantee that Pilots will test it correctly.