Setting functional test preferences

You use the Preferences dialog box to customize Functional Tester in a number of different areas, such as settings for time options; colors for the Verification Point Editor, the Verification Point Comparator, and the Object Map Editor; highlight color for test objects; operating system; playback; delays; log; playback monitor; ScriptAssure(TM); recorder; recording monitor; and the workbench.

Procedure

To change Functional Tester preferences for the current Functional Tester user:

From the Functional Tester menu, click Window > Preferences.
In the Preferences dialog box, in the left pane, expand Functional Test.
Select the appropriate preferences page for the options you want to change.
Change the options.
In some cases, you might want to clear the Use Default field to edit the option.
Click Apply to save the new setting and continue changing options or click OK to save the new setting and close the Preferences dialog box.

Functional Tester preferences
You use the Preferences dialog box to customize various aspects of Functional Tester, such as settings for time options; colors for the Verification Point Editor, the Verification Point Comparator, and the Object Map Editor; highlight color for test objects; operating system; playback; delays; log; playback monitor; ScriptAssure(TM); recorder; recording monitor; and the workbench.
Changing the verification point and object map colors
You can change the color of information displayed in the Verification Point Editor, Verification Point Comparator, and Object Map. This feature is useful for enhancing the accessibility for people with disabilities.
Changing the syntax of Verification Point commands
During recording, a verification point captures information about a specified GUI component, for example, its size or its position. Functional Tester records a statement in the test script for each verification point.
Changing user interface fonts
You can change the font and point size of information displayed in dialog boxes for Functional Tester and those that are part of the Eclipse IDE. For IDE dialog boxes and the Java™ Editor, you do this through the Workbench Preferences.
ClearCase preferences
If you use ClearCase® for source control management, you can use the ClearCase Preferences page to define settings for Functional Tester integration, show ClearCase icons, show script details, save file with _keep extension, check out a file reserved, or to keep a script checked out after check in.
Functional Tester page
You use the General Rational® Functional Tester page to set all Functional Tester time options. These options are useful to accommodate different computer speeds.
Colors page
You use the tabs on the Colors page to specify color settings for the Verification Point Editor, Verification Point Comparator, and the Object Map Editor. This feature is also useful for enhancing the accessibility for people who have physical challenges, such as limited vision.
Highlight page
You use the Highlight page to specify how you want Functional Tester to emphasize test objects in applications-under-test when you select them in a test object map or in the Script Explorer. These settings also control how Functional Tester highlights objects you select with the Verification Point and Action Wizard and the Insert a GUI Object into the Object Map dialog box.
Logging and Tracing page
IBM® Rational Functional Tester allows you to collect the errors and warning messages into a log file (rft_log.txt). The logging and tracing functionality is controlled through certain configurable parameters such as level, file size, directory. With IBM Rational Functional Tester you can configure the ‘level' parameter for individual components. If a log and trace level is not defined explicitly for a component, then it defaults to the overall setting defined in the general page. With IBM Rational Functional Tester, you can set the preferences for logging and tracing through an user interface.
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.
Operating System page
You use the Operating System page to indicate the Foreground Lock Timeout setting for Windows 98/Me and Windows 2000 systems.
General Playback page
You use the General Playback page to set script playback options, such as the amount of time Functional Tester looks for an object and waits before trying to find an object again. You can also elect to skip all verification points in the script.
Setting general playback preferences in test scripts
You can set the general playback preferences in test scripts. The preference set in the script, if any, takes precedence over the one that is set through the Preferences dialog and it applies globally to all the scripts. Hence, ensure that the script includes a reset command that reverts the preference to its earlier setting.
Playback preferences example
This topic provides an example of the interaction between settings in the Playback Preferences page.
Dynamic Find Enablement page
You can use the Dynamic Find Enablement page to enable the dynamic find feature for all functional test scripts run within the integrated development framework (IDE). With the dynamic find feature, Rational Functional Tester can search for and locate objects in the script whose hierarchical position has changed, to prevent playback failure.
Delays page
You use the Delays page to set delays during Functional Tester script playback. These settings are useful to control the rate at which script commands are sent to the operating system.
Playback Monitor page
You use the Playback Monitor page to specify whether to display the playback monitor during playback.
ScriptAssure page--Advanced
You use the ScriptAssure(TM) Advanced page to set thresholds for recognition scores, which Functional Tester uses when searching for objects during script playback.
ScriptAssure page-standard
During playback, Functional Tester compares objects in the application-under-test with recognition properties in the test object map. You use the ScriptAssure(TM) Standard page to control object-matching sensitivity during playback. This feature enables you to successfully play back scripts when the application-under-test has been updated.
Enabling the unexpected window handling feature
You can enable the unexpected window handling feature to ensure that scripts playback smoothly. When you enable this feature, unexpected windows that open during script playback are handled according to the configuration in the Configure Handling of Unexpected Windows dialog box.
General Recorder page
You use the General Recorder page to indicate options for recording Functional Tester scripts, such as excluding an executable from being recorded and setting the delay before recording a mouse action or a keystroke. You can also select or clear the option to open the test object map if there is a new test object in the application.
Recorder Monitor page
You use the Recorder Monitor page to change settings in the Recording monitor, such as displaying the recorder toolbar or the Recorder Monitor, including a timestamp for messages, and selecting the types of messages you want to display and their colors.
Mapping keyboard shortcut keys
You can map keyboard shortcut keys in Functional Tester by changing the assignment of a shortcut key to a command. You can change the shortcut key for menu items and toolbar buttons.
Simplified Scripting preference page
Use this page to indicate whether the simplified scripts feature must be enabled while creating the test scripts.
Application Visuals preference page
Use this page to specify whether to capture the application visuals of the test application while recording the test scripts. You can also specify whether to enable the verification points or data-driven commands that are featured in the application visuals so that you can insert them in the script using the application visuals without opening the test application.
Simplified Script Editor preference page
Use this page to specify the preferences for simplified script editor operations such as undo, redo and undo history operations.
Webserver Configuration page
You can use the Webserver Configuration page to change the default web server port for communication between Google Chrome and Rational Functional Tester, and to enable logging of messages.
Workbench Preferences page
The Workbench Preferences page enables you to indicate how you want the Workbench to behave while playing back, recording, and debugging Functional Tester scripts.
Workbench Advanced Preferences for Functional Tester page
This Advanced page enables you to set advanced Workbench preferences for Functional Tester, such as switching to the Test Debug perspective rather than the Functional Tester perspective when debugging or turning on or off.

Related reference:

Functional Tester page

Preferences dialog box

Feedback