Skip to Main Content
Return to Navigation

Using the PTF Test Recorder

You use the PTF Test 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. As you are recording, you can add additional steps, such as Verify, Log, and Conditional, that do not directly correspond to actions performed in the target application.

This section discusses:

Test Recorder Toolbar

To access the Test Recorder toolbar, select Test, Open Recorder or click the Show Test Recorder icon.

Image: Test RecorderToolbar

This example illustrates the tools and controls on the Test Recorder toolbar. You can find definitions for the tools and controls later on in this section.

Test Recorder Toolbar

Note: To move the Test Recorder toolbar, click in the title bar to the left of the close icon and drag to the new location.

The Test Recorder toolbar is divided into four areas:

  • Recording action tools.

  • Step modification tools.

  • Tool hints bar.

  • Status bar.

Recording Action Tools

This section describes the recording action tools.

Using Drag and Drop

Some recording action tools use drag and drop to get page element recognition data.

During recording, when you drag the icon from the Test Recorder tool bar, your mouse image changes to a bold question mark. As you hover over a page element, the page element highlights. The element that you intend to reference must be highlighted when you drop the icon over it. If the field is not highlighted, PTF will not recognize it. Drag and drop actions are not applicable to all HTML objects.

The Test Recorder recording action tools provide the following functions:

Select browser to use

Hook 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. You can drag the hook icon to any portion of the PIA application. No page objects will be highlighted.

Start web client and go to the default URL

Launch a PeopleSoft application in a browser window using the URL of the default execution option and hook the recorder to that browser.

See Configuring Execution Options.

Start recording

Begin recording or resume recording. When you begin recording, the recorder adds or inserts steps following the current step. When you resume recording after pausing you are prompted to choose from the following options:

  • Insert new steps at the current step (do not delete subsequent steps in the test)

  • Insert new steps at the current step (delete subsequent steps in the test)

  • Insert new rows at the end of the test

Stop recording

Stop recording and write recorded steps to the test.

Pause recording

Pause recording.

Verify icon

Add a Verify step. Drag and drop over a page element. The step is automatically populated with the object ID and value of the field.

See Verify.

Open field popup/Org chart menu items

Open field pop ups or organization chart menu items.

See MouseOver.

Add a log step

Add a Log step.

You are prompted to select a Log action and enter text for the Message and Details.

Add a GetProperty step

Add a GetProperty step. Drag and drop over a page element. You are prompted with a list of properties for the selected page element. Enter a variable name or select an existing variable name for one or more properties. The recorder adds a GetProperty step for each property you identify.

See Get_Property.

Add Exists command

Add an Exists step. Drag and drop over a page element. You are prompted to enter a variable name or select an existing variable and to select an Expected value. Valid values are True, False, or Ignore.

See Exists.

Add If Then statement

Add a Conditional If_Then construct. You are prompted for an expression, such as &Exists=True. The Recorder inserts a Conditional.If_Then step. Record additional steps, then click the icon again to add a Conditional.End_If step.

See Conditional.

Add new variable

Add a Variable.Set_Value step. You are prompted for Variable Name and Value. User-defined variables and PTF test variables appear in the drop down list.

See Variable, System Variables.

Scroll Key element icon

Add a Scroll.Key_Set step. Drag and drop over a key field in a scroll. Enter a Scroll ID in the Step Modification area and click the Confirm icon.

See Incorporating Scroll Handling.

Add a scroll action command

Add a Scroll.Action step. You are prompted to enter a Scroll ID, return variable, and action. Click the Confirm icon.

Get Label icon

Add a Field.GetLabel step. You are prompted for Return Variable.

HTMLTable CellGetIndex icon

Return the index value for an HTML table. Drag and drop over the HTML table label. You are prompted for return variable that will contain the HTML index..

HTMLTable CellGetValue icon

Return the label value. Drag and drop over the HTML table label. You are prompted for return variable that will contain the HTML label text.

Step Modification Tools

As you are recording, you can modify steps recorded during the current session without stopping the recording and exiting the Test Recorder.

The Test Recorder toolbar step modification icons provide the following functions:

Move to the previous step

Move to the previous step in the recording. When you move to the previous step or the next step, recording is paused. You must click the Start Recording icon to continue recording.

Move to the next step icon

Move to the next step in the recording. When you move to the previous step or the next step, recording is paused. You must click the Start Recording icon to continue recording.

Mark step as Active/Inactive

Specify whether the step is active or inactive.

Confirm value modifications icon

Accept step modifications. If you move to another step or continue recording without accepting modifications, the modifications are lost.

Cancel value modifications icon

Cancel modifications.

Edit step icon

Modify the step.

Add Prefix icon

Insert a #PREFIX# keyword at the beginning of the text in the Value field.

Edit test step comments

Edit test step comments.

Recorder Utility Tools

The Test Recorder toolbar utility icons provide the following functions:

Copy recording to clipboard icon

Copy the recording to the clipboard.

Configure recording settings icon

Configure recording settings.

  • Use Page Prompt

    If you select the Use PagePrompt check box, the Test Recorder will replace menu navigation steps with a Page.Prompt step and Page.PromptOK step. The Test Recorder records menu navigation steps, but they are set to inactive.

    Note: When recording a search page with facets, PTF does not automatically insert Page.Prompt constructs because all user actions with facets must be recorded.

    When using Page Prompt mode, explicitly enter the values for the key fields. Do not perform a partial search and pick from the list. If you must click a dropdown list, search, or take any other action on a search page, do not use Page Prompt mode.

    Use explicit menu navigation.

    Note: Page Prompt uses advanced search mode on search pages. In certain cases, objects that are available in basic search mode are not available in advanced search mode. If you record in Page Prompt mode on a search page that uses basic search mode, you may encounter ‘Object not found’ errors. If that occurs, you can either delete the extra steps or inactivate the Page.Prompt steps and activate the navigation steps.

    See Page.

  • Message Recognition

    Select the Message Recognition check box to automatically configure message recognition for any messages, such as error, warning, or information messages, that the application generates during recording. When the Test Recorder adds a new message it also sets Use Message Recognition to True.

    See Handling Application Messages.

  • Run Control Recognition

    If you select the Run Control Recognition check box the Test Recorder will replace all recorded actions on a PsRun Control (Process Scheduler page) with the Process.Run Step.

    Note: Similar to the Page Prompt with facet, this option is only applicable to a conventional Process Scheduler page.

    See Run

  • File Download Prompt

    Select the File Download Prompt check box to prompt for the file path when recording a step that does a file download.

    See Download