PeopleTools 8.51 PeopleBook: PeopleSoft Test Framework

Using PeopleSoft Test Framework

This chapter discusses how to use these PeopleSoft Test Framework (PTF) tools:

PTF Explorer
PTF Explorer menus
Test Editor
PTF Recorder
Log Viewer

Using PTF Explorer

PTF Explorer gives you access to the PTF test assets (tests, test cases, libraries, and logs) stored within an application database. Assets appear in a tree structure with collapsible folders for organizing test assets. PTF Explorer is the first pane visible to the user after startup. It is labeled with the name of the PTF environment:

You use PTF Explorer to:

Create tests and folders.
Delete tests and folders.
Copy and move tests.
Navigate to and open test assets.

Using myFolder

The PTF Explorer tree contains a folder called myFolder. You can use myFolder to store tests that you do not want to share with other users. Users with the PTF User role can create, edit, and delete tests only in myFolder.

Using PTF Explorer Menus

The following menus appear when PTF Explorer has focus. Note that many menu commands are specific to a currently selected item. The PTF Explorer menu name corresponds to the name of the current PTF environment. In the previous example, the PTF Explorer menu name is PBDEMO.

This table describes the PTF Explorer menu commands:

PTF Explorer Menu Command	Usage
Refresh	Refreshes the current view.
Local Options	Opens the Local Options dialog box.
Execution Options	Opens the Execution Options dialog box.

This table describes the Test menu commands:

Test Menu Command	Usage
Open	Opens the selected test or test case.
Refresh Selection	Refreshes the view for the selected test.
Delete	Deletes the selected test.

The Edit menu contains standard Microsoft edit commands, such as Cut, Copy, and Paste, and the following PTF Explorer Edit menu command:

Edit Menu Command	Usage
Copy Link to Clipboard	Copies the link to the selected test to the clipboard. You can use this information in conjunction with the Quick Open command.

Use the PTF Explorer Create menu to create folders and tests. This table describes the Create menu commands:

Create Menu Command	Usage
Folder	Creates a new folder within the selected folder.
Test	Creates a new test in the selected folder.
Shell Test	Creates a shell test in the selected folder.

This table describes the PTF Explorer Window menu command:

Window Menu Command	Usage
Quick Open	Opens a test using data that was copied to the clipboard using the Copy Link to Clipboard command. Using the Copy Link to Clipboard command and the Quick Open command together enables users to easily share tests without having to navigate to the test in PTF Explorer. You can select a test and select Edit, Copy Link to Clipboard. Then, you paste that data into a text message and send it to another user, who can then copy and paste the data into the Quick Open dialog box and open the test.

Window Menu Command

Usage

Quick Open

Opens a test using data that was copied to the clipboard using the Copy Link to Clipboard command.

Using the Copy Link to Clipboard command and the Quick Open command together enables users to easily share tests without having to navigate to the test in PTF Explorer. You can select a test and select Edit, Copy Link to Clipboard. Then, you paste that data into a text message and send it to another user, who can then copy and paste the data into the Quick Open dialog box and open the test.

This table describes the PTF Explorer Tools menu commands:

Tools Menu Command	Usage
Message	Opens the Message tool, which enables you to monitor test execution. The Message tool displays details about the current step, including name, object type, and value.
Log Manager	Opens the Log Manager tool, which enables you to delete logs from tests.

Using the Test Editor

When you create or open a test, test case, or shell test, it opens in the Test Editor. The Test Editor enables you to:

Record and edit test steps.
Add, copy, and delete test steps.
Create and edit test cases.
View both test and test case in a single view.
Debug tests.

This example shows a PTF Test Editor page:

This section discusses:

Test Editor menus.
Test Editor field.
Test window.
Test window fields.
Test window toolbar.
Test step fields.

Test Editor Menus

The following menus appear when the Test Editor has focus. Note that many menu commands are specific to the currently selected step.

This table describes the PTF menu commands:

PTF Menu Command	Usage
Save	Saves the current test.
Save As	Creates a copy of the current test with a new name.
Test Case Save As	Creates a test case as a copy of the current test case.
Copy Link to Clipboard	Copies a link to the test to the clipboard. You can send this information to another user, who can use the Window, Quick Open feature to open the test without having to navigate to it in PTF Explorer.
Run	Runs the current test.
Pause	Pauses execution of the test.
End	Stops execution of the test.
Open Test Recorder	Launches the Test Recorder.

The Edit menu contains standard Microsoft edit commands, such as Cut, Copy, Paste, and Delete, and the following PTF commands:

Edit Menu Command	Usage
Find	Finds occurrences of a specific text string in the current test. Select the List all Matching Lines check box to create a list of matches.
Again	Searches for the Find string again.

Edit Menu Command

Usage

Find

Finds occurrences of a specific text string in the current test.

Select the List all Matching Lines check box to create a list of matches.

Again

Searches for the Find string again.

This table describes Debug menu commands:

Debug Menu Command	Usage
Step Into	Executes the current step of the test and advances to the next step.
Step Over	Executes the current step of the test and advances to the next step, unless the next step calls another test. Steps over called tests.
Toggle Break	Sets a break point at the selected step or removes an existing breakpoint.
Clear All Breaks	Removes all break points.
Stop on Error	Stops execution if the test encounters an error.
Disable Screen Shots	By default, the recorder creates a screen shot with each error. Select this option to save space in the log by not creating screen shots.
Highlight Errors	Highlights errors in the log in yellow.

This table discusses the Window menu commands:

Window Menu Command	Usage
Quick Open	Using information from the Copy Link to Clipboard command, quickly opens a test without having to navigate to the log in PTF Explorer.
Again	Searches for the Find string again.

Test Editor Field

The Test Editor includes this field:

Prefix

Specify text that will be added to text fields when the test is executed. The prefix text is substituted for the #PREFIX# reserved word in the Value field. Using a prefix can help prevent an error caused by a duplicate entry when the page is saved.

Test Window

You can have multiple tests open in PTF. Each test has its own test window. This example shows a Test Editor test window:

Test Window Fields

The following fields appear in the test window:

Test Information

Name	Displays the test name. This field is display-only.
Prop (properties)	Click to access the Test Properties dialog box. You can enter a long description of the test. In the Language field, select the language for the PeopleSoft application. The default is English. Changing the value in the Language field only affects the language the test selects at sign in. It does not enable the test to execute against a different language. PTF tests should be executed against the same language in which they were recorded.
Library Test	If Library Test is selected, this test can only be called from another test. It cannot be run as a standalone test.
Use Error Handling	If this option is selected, PTF automatically handles all error messages defined in the Error Definitions dialog box. If this option is deselected, the system ignores error definitions. When the Error Handling field is selected, the Error/Message Definitions link is enabled.
Error/Message Definitions	The Error/Message Definitions link is enabled only when the Error Handling field is selected. Click to access the Error Definitions dialog box. Use the Error Definitions dialog box to define how PTF will respond to error messages that are encountered during execution of the test.

Test Case Information

Name	Displays the name of the current test case. You can select a different test case using the drop-down list. When you create a test, the system automatically associates it with a test case named DEFAULT.
New	Click to create a new test case. The new case will have blank values in the Value column. To create a new test case populated with values from the current test case, select Test, Save Test Case As.
Delete	Delete the selected test case.
Prop (properties)	Click to access the Test Case Properties dialog box. You can enter a long description of the test case.

Test Window Toolbar

In addition to buttons for the standard Microsoft cut, copy, and paste commands, the test window toolbar provides the following functions:

	Selects or deselects the Active check box for all steps.
	Inserts a new, blank row below the current row. Click the drop-down arrow to insert the new row above the current row.
	Deletes the current row.
	Displays the Line Information dialog box showing the PeopleTools metadata associated with the object referenced in the step. Line Information also includes a long description where you can enter comments about the step.

Test Step Fields

A PTF test consists of a series of steps. Each step in a test is composed of eight fields, as defined in this table:

Seq (sequence)	A system-generated sequence number. Test steps execute according to Seq order. When you move, add, or delete a step, Seq is refreshed.
ID	A system-generated unique identifier for each line (step) in a test. This value does not change when you move, add, or delete a step. Test maintenance reports use the ID value.
Active	Deselect this field to inactivate a step. PTF will skip inactive steps when the test runs. Each step is active by default. This field is grayed for inactive steps.
Scroll ID	This field is only required for scroll handling.
Type	The type of application object the step is to take an action on or to validate. Common object types are Text, Checkbox, Browser, and so on.
Action	The action the test is to take on the object. The two most common actions used on a Text object, for example, are Set and Verify.
Recognition	The means that PTF uses to identify the object within the application. Commonly, this is the HTML ID property.
Value	In a typical recorded step, this is the value the tester entered for an object. In a step recorded in field check mode, this would be the value that was present in the object when it was checked. Value is part of the test case, not the test itself.

Using the PTF Recorder

You use the PTF recorder to record the steps in a test. When you record a test, PTF monitors each action you perform in the target application and creates a corresponding step in the test.

This section discusses the Recorder toolbar.

Recorder Toolbar

Access the Recorder toolbar (select Test, Open Recorder or click the Show Test Recorder button).

Note. To move the Recorder toolbar, click in the region to the left of the close icon and drag to the new location.

The Recorder toolbar provides the following functions:

	Hooks a browser. Drag and drop this icon onto an active PeopleSoft browser session to hook the Recorder to that browser. PTF will only hook a browser that was originally launched by PTF.
	Launches a PeopleSoft application in a browser window using the URL of the default execution option and hooks the Recorder to that browser. See Configuring Execution Options.
	Begins recording. The recorder adds or insert steps following the selected step.
	Stops recording.
	Enables Field Check Mode. Field check mode displays field values in the Recorder toolbar during recording. You can drag and drop the Field Check Mode icon to a field in the application during recording to insert a step with a Verify or Exists action. The step is automatically populated with the object ID and value of the field. When you drag the Field Check Mode icon from the record tool bar, your mouse image changes to a bold question mark until you select a field to check. The field that you intend to check should be highlighted when you drag the Field Check Mode icon over it. Some HTML objects, such as labels, can not be verified. If the field is not highlighted, it will not be verified by PTF. See Verify, Exists.
	Opens a MouseOver text popup page and enables you to take an action on it, such a clicking a link. See MouseOver.
	Copies the recording to the clipboard.

Using the Log Viewer

Whenever you run a test, PTF creates an execution log. The log is located in PTF Explorer under the test name, in the log folder specified in Execution Options.

After you run a test, PTF automatically displays the log in the Log Viewer.

You can also view a log by opening it from PTF Explorer.

This example shows the Log Viewer:

The Log Viewer has three panes:

The left pane displays the log details.

Typically, the log will contain one high-level entry for each step in the test.
The right pane displays the execution options that were used for the test.
The bottom pane displays details about the selected entry in the log.

Log Viewer Menus

The following menus appear when the Log Viewer has focus. Note that many menu commands are specific to the currently selected item.

This table describes the Log menu commands:

Log Menu Command	Usage
Expand All	Expands all the selections in the log.
Collapse All	Collapses all the selections in the log.
Change Log View	Toggles between a view that shows log results as colored flags and a view that shows log results as shaded labels.
Highlight Errors	Highlights log entries with errors in yellow.
Copy Link to Clipboard	Copies a link to the log to the clipboard. You can send this information to another user, who can use the Window, Quick Open feature to open the log without having to navigate to it in PTF Explorer.

This table describes the Detail menu commands:

Detail Menu Command	Usage
Goto Script Line	Accesses the test and selects the step that corresponds to the selected log entry.
Open Link	Opens the application URL in the browser or opens an external file, such as a DataMover log.
Open Screenshot	Opens the screen shot that corresponds to the selected log entry.

You can double-click a log entry or right-click and select Open to access the test with the corresponding step highlighted.

This table describes the Window menu commands:

Window Menu Command	Usage
Quick Open	Using information from the Copy Link to Clipboard command, quickly opens a log without having to navigate to the log in PTF Explorer.
Close All	Closes all open windows.