Configuring Execution Options in PeopleSoft Internet Architecture

You use execution options to configure settings for the PeopleSoft applications that you test with PTF. Execution options are stored as part of the metadata for a PTF environment and are available to all users of that environment. Only a PTF administrator (a user with the PTF Administrator role) is able to insert, delete, or modify execution options. You can configure execution options either in the PTF client, or by using the Define Execution Options component in the PeopleSoft Internet Architecture.

This section describes how to define execution options using the Define Execution Options component in PIA. For information about defining execution options in the PTF client, see Configuring Execution Options in PTF Client.

To configure execution options in PIA, complete the following tasks:

  • Specify execution options.

  • Configure debugging options.

  • Define advanced options.

  • Specify PeopleTools options.

  • Establish Export Log options.

Use the Define Execution Options (PSPTTSTEXEOPTIONS) page to define PTF options for executing tests.

This example shows the Execution Options component - Options page in PIA:

Image: Define Execution Options Page

This example illustrates the fields and controls on the Define Execution Options page. You can find definitions for the fields and controls later on this page.

Define Execution Options page

The fields on the Define Execution Options page are the same as the fields on the Options tab in the PTF client, with the exception that you cannot modify passwords on the PeopleSoft application component.

Field or Control

Definition

Prompt

Specify whether the Execution Options dialog appears when a user executes a test.

Application URL

Enter the URL of the login page for the PeopleSoft application. PeopleSoft Test Framework uses this URL for the Browser.Start_Login step type/action when executing tests and when you click the Home icon (to start the web client and go to the default URL) in the test recorder.

Browser

Specify the browser to use to launch the PeopleSoft application. Options are Internet Explorer, Chrome, Edge, or Firefox. If the specified browser is not present on the system, an error will appear and the test will abort.

User ID

Enter a valid user ID for the application database.

Password

This field is unavailable for entry. The password must be specified using the Execution Options dialog in the PTF client. For more information, see Configuring Execution Options in PTF Client.

Process Server

Select a process server from the drop-down list. This list is populated by the Process Server List field in the Configuration Options page.

Date Format

Select a date format.

Skip Language

Select Yes to bypass the language selection on the PeopleSoft application login page.

Form Factor

Select the form factor size to use when launching the application.

Log Folder

Select or enter the folder name to which test logs will be written. If the folder does not exist it will be created.

Verbose

Specify the log format.

Select Yes to log a detail line for each step that is executed in the test.

Select No to log only the test status (Pass or Fail) at the test level and to log a detail line for failed steps.

See Configuring Execution Options in PTF Client.

Use the Define Execution Options – Debugging (PSPTTSTDEBOPTIONS) page to define PTF configuration options.

Select the Debugging Options tab.

Image: Define Execution Options-Debugging page

This example illustrates the fields and controls on the Define Execution Options – Debugging page. You can find definitions for the fields and controls later on this page.

Define Execution Options - Debugging page

Field or Control

Definition

Skip Save

Select Yes to prevent a test from executing a save. You would, for instance, select this option to avoid duplicate values in the application database if you plan to run a test repeatedly.

Skip Run Request

Select Yes to prevent the test from executing process requests.

Use the Define Execution Options - Advanced Options page (PSPTTSTADVOPTIONS) to define multiple portal URLs and to enable persistent variables.

PTF uses the portal URL to access the component when there is a step in the test to set the browser URL (Browser.Set_URL). See Set_URL. To add a portal URL, click the Add icon. To remove a portal URL click the Delete icon.

Image: Define Execution Options - Advanced Options page

This example illustrates the fields and controls on the Define Execution Options - Advanced Options page. You can find definitions for the fields and controls later on this page.

Define Execution Options - Advanced Options page

Field or Control

Definition

Portal Name

Enter a portal name.

Note: The name is saved in upper case.

URL

Enter the portal URL.

The portal URL is entered in the following format:

http://webserver/psp/domain/portalname/node

For example: http://myserver.us.oracle.com:8010/psp/ps/EMPLOYEE/QE_LOCAL/

Note: The ending backslash / is optional

Use Persistent Variables

Select to enable saving and using persistent variables. Selecting this option enables the other fields in this group.

By Execution Option Name

This option is automatically selected when you select the Use Persistent Variables check box. Persistent variables are stored in the database keyed by execution option name. Persistent variables can also be keyed by User ID, machine name or both.

By User ID

Select to store and retrieve persistent variables by PTF user ID.

By Machine Name

Select to store and retrieve persistent variables by machine name.

Use the PeopleTools page (PSPTTSTTOOLOPTIONS) to supply the information required to connect to DataMover.

This example shows the Define Execution Options - PeopleTools page:

Image: Define Execution Options - PeopleTools page

This example illustrates the fields and controls on the Define Execution Options - PeopleTools page. You can find definitions for the fields and controls later on this page.

Define Execution Options - PeopleTools page

The fields on the PeopleTools page are the same as the fields on the PeopleTools tab in the PTF client, with the exception that you cannot modify passwords on the PeopleSoft application component.

Field or Control

Definition

Tools Path

Enter the path to PS_HOME for this environment.

Connection Type

Select the connection type.

Database Name

Enter the name of the database for this environment.

User ID

Enter a valid database user ID.

Password

This field is unavailable for entry. The password must be specified using the PTF Client.

DMS Input Path

Enter the DataMover input path.

DMS Output Path

Enter the DataMover output path.

DMS Working Path

Enter the DataMover working path.

Use the Define Execution Options - Export Log page (PSPTTSTLOGOPTIONS) to automatically archive the result logs to a file system in XML + XSL format at the completion of each test.

This option provides the following benefits:

  • The logs are accessible from any browser.

  • The PTF client is not required to verify test results.

  • The logs are available even after the environment or database is brought down or upgraded.

  • Since the log is in XML format, you can write customized utilities to parse or interpret the logs as needed.

Image: Define Execution Options - Export Log page

This example illustrates the fields and controls on the Define Execution Options - Export Log page. You can find definitions for the fields and controls later on this page.

Define Execution Options - Export Log page

Field or Control

Definition

Use Log Export

Select Yes to activate the export log functionality.

Path

Specify the shared drive to store the log files.

Note: Ensure that the shared drive path allows users full read/write access. The path can be customized using existing system variables. See System Variables

Style Sheet File

(Optional) Specify the path to the stylesheet. If specified, the exported XML log will be saved with the stylesheet.

You can create your own stylesheet to format the XML. If this field is left blank, the XML will not be saved with a stylesheet.

Add Time Stamp

If set to Yes the XML filename will be appended with the Time Stamp in the following format:

<TEST_NAME>-<LOG_ID>-T<YYYYMMDD>_<HHMMSS>

Example: FSCM_INS_VER-LOG5-T20121128_163649.XML

Export Images

If set to Yes the Image will be saved in the same Log folder as the XML Log in the following format:

<TEST_NAME>-<LOG_ID>-T<OPTIONAL_TIME_STAMP>-<LINE_NUMBER_AS_SHOWN_IN_LOG>

Example: FSCM_INS_VER-LOG5-T20121128_163649-Line30.JPEG