Common Actions
The actions in this section can be used with multiple step types. The step types that support the action are listed with each action.
Description
Performs a mouse click on the specified object.
The following step types support this action:
Example
This example shows the use of the Click action with a Button object and a Link object:
|
Type |
Action |
Recognition |
Parameters |
Value |
|---|---|---|---|---|
|
Button |
Click |
Name=PB_FILTER |
||
|
Link |
Click |
Name=LAST_NAME$0 |
Description
Performs the action of dragging a PTF object. It is followed by the Drop_Over action where a previously selected object is dragged and released over a newly selected object on the same page.
PTF throws an error when a drag action is not immediately followed with a drop action or a drop action is not preceded with a drag action. You can select the Check Syntax option to display any errors or warnings. See Syntax Check.
The following step types support Drag_From and Drop_Over actions:
Div.
Keep in mind:
The Drag_From and Drop_Over actions are supported for PTF recorder and playback.
The actions are associated with Div step type when the HTML code includes div tag with attributes draggable=”true” and droppable=”true”.
Link.
Keep in mind:
The Drag_From and Drop_Over actions are supported for PTF recorder and playback.
When PTF records tests for Tree Manager, instances of step definitions with Link step type and these actions can be found.
Span.
Keep in mind:
The Drag_From and Drop_Over is only supported for PTF playback.
The actions are associated with Span step type when the HTML code includes the Span tag nested in the div tag with attributes draggable=”true” and droppable=”true”.
See Drop_Over.
Example
|
Type |
Action |
Recognition |
Parameters |
Value |
|---|---|---|---|---|
|
Div |
Drag_From |
id=win0divPTNUI_LAND_REC_GROUPLET$1 |
||
|
Div |
Drop_Over |
id=win0divPTNUI_LAND_REC_GROUPLET$6 |
|
Type |
Action |
Recognition |
Parameters |
Value |
|---|---|---|---|---|
|
Span |
Drag_From |
id=PTNUI_LAND_REC_GROUPLET_LBL$0 |
||
|
Span |
Drop_Over |
id=PTNUI_LAND_REC_GROUPLET_LBL$1 |
|
Type |
Action |
Recognition |
Parameters |
Value |
|---|---|---|---|---|
|
Link |
Drag_From |
id=PTPG_SIMPL_WRK_PTPG_CHARTSERIES |
||
|
Link |
Drop_Over |
id=PTPG_SIMPL_WRK_PTPG_CHARTXAXIS |
Performs the action of dragging and releasing a PTF object over a newly selected object on the same page. It is preceded by the Drag_From action where a previously selected object is dragged from a position.
For details and examples, see Drag_From.
Description
Checks whether the object exists on the page.
The following step types support this action:
Parameters
|
Field or Control |
Definition |
|---|---|
| ret=&variable; |
|
| expected=value |
Specify |
Example
This example shows the use of the Exists action:
Image: Example of the Exists action
This example illustrates the Exists action.
Description
Gets the property value
of an HTML object and assign to the prop=value parameter. Also stores it to the variable in ret=&variable.
Use the HTML Browser feature of the Message tool to identify the properties and values of an object. When this step type is recorded tagName and id properties are always shown.
Some objects have properties that are different from what you might expect. For example:
The value property for a check box returns Y for selected, N for deselected.
Combo boxes return the translate value of the selection for the value property.
The full text of the selected item is available as the text property.
Radio buttons return the translate value of the selection for the value property.
The label of the selected item is a separate label object.
The following step types support this action:
Parameters
|
Field or Control |
Definition |
|---|---|
| prop=value; |
The property name. |
| ret=&variable; |
The return value. |
Example
|
Type |
Action |
Recognition |
Parameters |
Value |
|---|---|---|---|---|
|
Text |
Get_Property |
Name=UserID |
ret=&TxtPropp;prop=Status |
|
|
Log |
Message |
This is the status: &TxtProp |
||
|
Button |
Get_Property |
Name=Submit |
ret=&BtnProp;prop=tagName |
|
|
Log |
Message |
This is the tagname for the button: &BtnProp |
||
|
Button |
Get_Property |
Name=Submit |
ret=&BtnProp;prop=Value |
|
|
Log |
Message |
This is the Value for the button:&BtnProp |
Description
Gets the style value
of properties in a class from the HTML stylesheet. The value is assigned
to prop=value parameter and stores it to the variable in ret=&variable.
You can use the HTML Browser feature of the Message tool to identify the properties and values of an object.
The following step types support this action:
Parameters
|
Field or Control |
Definition |
|---|---|
| prop=value; |
The property name. Supported property values are: font-face, font-family, font-weight, font-style, color, font-size, background-color. |
| ret=&variable; |
The return value. |
Description
Sets the field value in a browser object.
The following step types support this action:
Use the SetValue_InModal action to set the value of a long text field on a modal page.
Pwd.
Text.
Example
Image: Example of the Set_Value action
This example illustrates the Set_Value action.
Description
Compares the value in the browser to the expected value, and adds a pass or fail log entry for the validation.
The following step types support this action:
Example
|
Type |
Action |
Recognition |
Parameters |
Values |
|---|---|---|---|---|
|
Text |
Verify |
ID=PSE_DATES_SQA_DATE |
#TODAY |