Configuring Local Options

To configure local options, access the Local Options dialog box (from the PTF menu, select Local Options).

Local options are specific to the machine on which the PTF client is installed. The local options settings are stored in the localoptions.xml file in the PTF data directory (C:\Documents and Settings\<User>\Application Data\PeopleSoft\PeopleSoft Test Framework) by default.

Note: Changes made to the local options settings will take affect the next time you start the PTF client, or after a PTF test suite refresh.

This example illustrates the fields and controls on the Local Options dialog box. You can find definitions for the fields and controls later on this page.

 Local Options dialog box

Term

Definition

Queued: Timeout (min.)

Enter the time in minutes for a process to be queued before PTF logs a warning or a fail message.

Queued: Log Result

Specify whether a timeout causes PTF to log a warning or a fail message. If LogFail is selected and Stop on Error is set in the Debug menu, then the run will stop if a timeout occurs.

Posting: Timeout (min.)

Enter the time in minutes for a process to post before PTF logs a warning or a fail message.

Posting: Log Result

Specify whether a timeout causes PTF to log a warning or a fail message. If LogFail is selected and Stop on Error is set in the Debug menu, then the run will stop if a timeout occurs.

Processing: Timeout (min.)

Enter the time in minutes for a process to complete before PTF logs a warning or a fail message.

Term

Definition

Interim Statuses: Timeout (min.)

Enter the time in minutes, in which the process monitor matches the distribution_expected value for interim statuses, such as N/A, None, Generated, Posting.

Interim Statuses: Log Result

Specify whether a timeout causes PTF to log a warning or a fail message. If the status specified for distirbution_expected is not matched then PTF logs a failed step.

Final Statuses: Timeout (min.)

Enter the time in minutes, in which the process monitor matches the distribution_expected value for final statuses, such as not Posted, or Posted.

Final Statuses: Log Result

Specify whether a timeout causes PTF to log a warning or a fail message.

Term

Definition

Output Folder

Enter or browse to the path to use for query output.

Output Format

Select the file format to use for query output. Options are: CSV, XLS, or XML.

Term

Definition

Default Folder

Enter a default file path to save or retrieve the data file of the Runtime Options. You can set the default location only from the PTF client.

You can overwrite the path during the migration process too.

Term

Definition

Grid: Show Field Label

Select Tooltip to show field labels as tooltips (hover text). Select Column to show field labels in a column in the test window.

Grid: Show Comment

Select Tooltip step information according to actual data of the env which to be tested/under testing. If the option is not selected, then only missing step information is filled out to show step comments as tooltips (hover text).

Auto-Check Syntax

Select Yes to be prompted to check syntax every time you save a test.

Term

Definition

File.Download: prompt for path

Select Yes to be prompted to specify the path to use for file downloads when executing tests.

Note: Any change in this section of the Local Options dialog box will be effective after PTF client is restarted.

These options specify whether to check for active web driver processes when you exit the PTF client, and how to manage them. Prior to version 8.55, PTF could run tests only using Internet Explorer. However, Internet Explorer is de-supported from 8.60 release. Multiple browsers are supported for test run via use of a web driver, which is a web automation framework that enables test run against different browsers. To assist in debugging, users have the option of leaving the test run browser session open after test execution, using a toggle available on the PTF Debug menu. However, the web driver used for each open session consumes machine memory, until that browser session is closed. Make sure the drivers and their associated browser sessions are properly managed, to prevent performance issues. There are also related options for managing the web drivers and test execution browser sessions in the PTF Debug menu and Tools menu.

Note: In the PTF session if Runtime Options has Chrome specified as the browser then all open browser sessions including Chrome, Firefox, and Microsoft Edge opened from PTF will get closed.

If any other browser is specified then all the instances of the specific browser opened from PTF will be closed.

Term

Definition

On Exit

Determines if PTF should automatically check for leftover active driver sessions when terminating the client.

Options are:

  • Yes: Select this option to include a check for existing active driver processes when you terminate PTF. The value selected in the Prompt vs. Terminate field determines what action is taken.

    • If Prompt is selected, you are prompted to close existing browser windows.

    • If Terminate is selected all open browser windows will close without any prompt.

  • No: PTF will not check for leftover sessions.

You can check for active driver processes at any time by selecting Tools, Check/Stop Leftover Drivers from the PTF client menu.

Prompt vs. Terminate

The value selected in this field controls how PTF manages existing active web driver sessions. Options are:

  • Prompt: Select this option to view a dialog box that includes a count and list of the active driver processes, and a prompt asking if you want to terminate them. Choose Yes to terminate all active driver processes, No to leave them active, or Cancel to return to the Test Editor window.

  • Terminate: Select this option to automatically terminate all active driver processes. No prompt or preview of active driver processes appears when you select this option.

Note: If the test includes steps to open new browser windows, set On Exit as Yes and Prompt vs. Terminate field as Terminate to avoid unexpected issues on the step Browser.WaitForNew.