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.

To access the logging page, click Window > Preferences. In the left pane, expand Functional Test > Playback and click Logging.

Note: For Microsoft Visual Studio, click Tools > Options. In the left pane, expand Functional Test > Playback and click Logging.

The Logging page contains the following options:

Don't show script launch wizard: When selected, prevents the script launch wizard from displaying each time you play back a script.

Display log viewer after script playback: When selected, this option displays the log after you play back a script. If the log type is HTML, the log opens in your default browser. If the log type is Text, the log opens in the Script Window of Rational® Functional Tester. If the log type is XML, the log opens in your default browser.

Generally, the log file opens in the default browser that is associated with the html file extension in your computer. To view the html files in your desired browser, you can associate the html file extension with the specific browser. The file extension for different browsers are as follows:
  • For Google Chrome, you must associate .html=ChromeHTML
  • For Internet Explorer, you must associate .html=htmlfile
  • For Firefox, you must associate .html=FirefoxHTML-308046B0AF4A39CB

Log screen snapshot for each action on the application: When selected, this option records a screen snapshot in the playback log against every action performed on the application.

Prompt before overwriting an existing log: When selected, this option prompts you before you overwrite a log.

Log the count of test objects created/unregistered at particular script line: When selected, this option logs these details:
  • Number of objects created and unregistered at a specific script line
  • Total number of objects created and unregistered per call script
  • A cumulative number of test objects created and unregistered for the whole script during playback if Rational® Functional Tester scripting methods have been used to return test objects.
Warning messages are also logged at the call script level and the main script level, if the number of test objects created exceeds the number of test objects unregistered, which would suggest the possibility of memory leaks during playback.

Log a screen snapshot when playback fails: When you select this option, it captures a screen snapshot at the time of the failure and stores it in the log. You must clear the check box to save storage space (172 KB per snapshot).

Log GUI actions on the application: When you select this option, it adds a detailed record of any GUI-related actions performed on the application (without a screen snapshot) to the playback log.

Log type: This option Indicates the type of log Rational® Functional Tester generates to write results of script playback. The log types are as follows:

  • None: Generates no log, if selected.
  • Text: Displays the log in ASCII format in the Functional Test script window.
  • HTML: Displays the log in HTML format in your default browser. The left pane in the HTML log contains three boxes: Failures, Warnings, and Verification Points. The list of items in each box help you navigate to a specific location in the log. You can select an item to quickly find important errors, warnings, and verification point results in the log. To do so, double-click an item in a list, and Rational® Functional Tester scrolls to and displays the item in the log.
  • TPTP: Displays a log using TPTP in the Functional Test script window.
  • XML: Displays a log of XML data rendered in HTML format [using transformation and Cascaded Style Sheets] in your default browser.
  • Default: Displays the unified report for the test scripts in the browser window. This is also the default option to generate result for Functional test scripts.
  • JSON: Displays a log in JSON format in the Functional Test Script window. Each event in this log type is a separate JSON.
    Note: The JSON log type is not supported in the integration of Rational® Functional Tester with Visual Studio.

Use Default: Clear the check box to change the value in the Log type field. Select the check box to restore the default value.

Restore Defaults: Restores the default values on this page.

Apply: Saves your changes without closing the dialog box.