Skip to Main Content
Return to Navigation

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.

Click

Description

Performs a mouse click on the specified object.

This is the list of objects that support this action:

Example

This example shows the use of the Click action with a Button object and a Link object:

Image: Example of the Click action

This example illustrates the use of the Click action with a Button object and a Link object:

Example of the Click action

Exists

Description

Checks whether the object exists on the page.

This is the list of objects that support this action:

Parameters

ret=&variable;

ret=true – the object exists

ret=false – the object does not exist

expected=value

Specify expected=true or expected=false. Logs a Pass or Fail based on whether the ret parameter matches the expected parameter.

Example

This example shows the use of the Exists action:

Image: Example of the Exists action

This example illustrates the Exists action.

Example of the Exists action

Get_Property

Description

Gets the property value of an HTML object based on the prop=value parameter and assigns 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.

See Using the Message Tool.

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.

This is the list of objects that support this action:

Parameters

prop=value;

The property name.

ret=&variable;

The return value.

Example

Image: Example of the Get_Property action

This example illustrates the Get_Property action.

Example of the Get_Property action

GetLabel

Description

Gets the label for the specified HTML object.

This is the list of objects that support this action:

Set_Value

Description

Sets the field value in the browser object.

This is the list of objects that support this action:

Example

Image: Example of the Set_Value action

This example illustrates the Set_Value action.

Example of the Set_Value action

Verify

Description

Compares the value in the browser to the expected value, and adds a pass or fail log entry for the validation.

This is the list of objects that support this action:

Example

Image: Example of the Verify action

This example illustrates the Verify action.

Example of the Verify action