Step properties
This topic describes step properties that you can edit in the TruClient 2.0 Step editor.
About step properties
TruClient records your actions exactly as you performed them. However, when testing you may want the test to run differently than you recorded it. For example, you may want to run some steps only if a condition is true, or to vary the data you enter in the application.
You can edit many of the properties for both recorded steps and manually added steps using the Step editor.
To open the Step editor, expand a step in the Actions view and click More. The properties in the Step editor are divided into three categories:
Category | Description | For details, see: |
---|---|---|
Step | Properties defining how to run the step, including end event and timeouts. | Step category |
Arguments |
Properties controlling how an action is carried out. |
Arguments category |
Object | Properties to identify the test object for the step. | Object category |
Note:
-
Explanation of the icons and buttons used for the properties are available here: Step options
-
The actual categories and category properties for a step vary, depending on the step type and actions.
-
For information on properties used by manually-added steps, see Steps box.
Step category
The following table provides information for some of the Step category properties:
UI Element | Description |
---|---|
Action |
The action that defines the step. The list of relevant actions is determined by the object or step type. |
Step timeout |
If the End event is not reached by this time in seconds, the step returns an error. The default value is defined in the runtime settings. |
Object timeout |
If the object does not appear before this time in seconds, the step returns an error. The default value is defined in the runtime settings. |
End event |
The end event occurrence is defined during the first script replay on the browser. You can use the automatically-identified end event, or you can assign a different end event for the step. End event values can be one of the following:
For details on working with end events, see End events. |
Minimum time |
The least time, in seconds, that the execution of the step will take. The value of this field can be either 0 or another manually-set number. If the minimum time is set to 0, the step execution will end immediately after the step's end event. A minimum time value greater than 0 forces TruClient to wait the additional time (if not elapsed already) from the step's end event before moving on to the next step. |
Use recorded duration |
When set to true, the minimum runtime for the step is the duration it took during recording. When set to false, the recording duration is ignore. The default value is defined in the runtime settings. Note: Once you manually edit the script, the test run may no longer reflect the same duration as during recording. |
Arguments category
The arguments included for a step are determined by the operation defined in the Action property. Some operations can be performed on the browser window or on an object, but may have different arguments depending on the context, for example, Scroll.
Where applicable, you can use the argument dropdown to choose how the value of the argument is evaluated:
Icon | Step Editor | Description |
---|---|---|
![]() |
Plain text | Plain values. These are primitive types, such as: text, number, Boolean. |
![]() |
JavaScript | JavaScript expression to be evaluated during replay. |
![]() |
Parameter name |
The key for the parameter. The current value of the parameter is used during replay. |
The following table provides information on arguments used by specific actions:
Action | Role/target object | Arguments |
---|---|---|
Activate tab/Close tab | browser |
|
Add tab | browser |
|
Click/Double click Mouse down/Mouse up |
element |
|
Dialog - confirm | browser |
|
Dialog - prompt | browser |
|
Dialog - prompt password | browser |
|
Drag | element |
Note: The X Offset, Y Offset, and Path arguments are mutually exclusive. |
Drag to | element |
|
Enter credentials | browser |
Note: If you want to use dynamic values for the username, password, or domain, we recommend using the Parameter argument type instead of the JavaScript type. |
Evaluate JavaScript | n/a |
|
Get property | element |
|
Go back/Go forward | browser |
|
Multi select |
multi_listbox |
|
Navigate | browser |
|
Press key | focusable |
|
Resize | browser |
|
Type | textbox/flash object |
|
Scroll (for object) | element |
Note: Both arguments must be integers, with minimum value of 0. The scrolling is done on the containing document, rather than on the element itself. |
Scroll (for browser window) | browser |
|
Seek | audio/video |
|
Select |
listbox/ |
|
Set day
|
datepicker |
|
Set value | checkbox/ filebox/ slider |
|
Upload | element |
Note: This action is available for non-standard file upload, which cannot be recorded. Select in a Generic object action step. |
Verify | element/ browser |
|
Wait for property | element |
|
Object category
The following table provides information for some of the Object category properties:
Action | How to |
---|---|
Name | The Name box displays a logical name for the object. This does not affect replay and can be modified to enhance readability. |
ID method | The ID Method box displays the object identification method used for the object:
|
<Selected ID method> |
After changing the object identification method in the ID method field to anything other than TruClient identification, a field is added to provide details. Click the Edit button to open the relevant Object identification editor. |
Target for drag and drop | The target object when the step action is Drag to. |
See also: