Manage step data

This topic describes the components and behavior of the steps in your TruClient script.

Managing step data in your script

Steps contain a user action to perform, object identification, and the point where the next step can start. They can be recorded steps, or other steps you manually add to the script.

You can manage some aspects of the steps within the editing area of the Actions view in the Development window. Other step components are edited in the Step editor.

The sections and data you can edit depend on the specific type of step.

Back to top

Step options

The steps area can include the following options and functionality. The specify contents vary, depending on the step type:

UI Elements Description
<Status icons>

The icons to the left of the step number indicate replay status or other information about the step:

  • Breakpoint. Click to the left of a step number to add a breakpoint. Click on the icon to remove it.

  • Playing. Step is currently being replayed.

  • Success. The step was replayed successfully.

  • Paused. The replay was paused at this step.

  • Stopped. Replay was stopped at this step.

  • Failure. Step replay failed. Place the cursor on the icon to view the error message.

unfold step fold step

Unfold/Fold step. Click on the arrows to expand or minimize the step display.

When expanded, the step displays the step toolbar, and up to two editable property fields for the step. For recorded steps, these are most often End event, and one of the key arguments for the step.

For details on the properties, see Edit step properties.

grab handle Grab handle. Use to change the step order of your script, by grabbing and dragging the step to a different location.

step level

Step level. Each step is assigned a level number between 1-3 at recording time (indicated by bars). Lower numbers represent higher level. For example, a level 1 step level step is necessary to the business process; a level 3 step has no apparent effect on the application.

Click the down arrow to the right of the Step level icon script level to modify the level for the step.

Note: For replay, you can filter the displayed steps by their level, using the Script level selector in the toolbar. For more information, see Step levels.

play this step Play this step. Click to play just that step (or group of steps).
disable or enable this step during replay

Disable/enable during replay. Click to deactivate the step. Deactivated steps are ignored during script replay.

Click the button again to activate the step.

highlight the object

Highlight the object. Click to check if the object is visible in the browser window at that time. The object is highlighted in the browser with a red outline.

For details, see Highlight an object.

replace the test object

Replace the test object. Use to replace the current object with a different object, without replacing the step.

For details, see Replace an object.

alternative steps

Alternative steps. Opens the Alternative steps dialog box, where you can redefine the step in alternative ways. Alternative steps allow you to view instances in which there are multiple ways to perform the same user action in a step.

Select the relevant step definition, and click OK.

For more information, seeUse alternative steps.

transactions editor Edit transaction. Opens the Transactions dialog box, where you can define new transactions and modify existing ones. For details, see Insert transactions in scripts.
more options More. Opens the Step editor, where you can modify the properties and arguments for the step. For details, see Edit step properties.
set default value Set the default value. Click to reset the value to the default value.
argument method

Argument method. Defines how the value of the argument is evaluated during replay. Click the right arrow to open a dropdown list where you can select a different argument method.

Available methods:

  • argument method Plain value. The plain value entered in the field is used during replay.

    Click the icon to open the Text editor, where you can insert or edit multi-line text. Use the plain value, without quotation marks.

  • JavaScript. The arguments for a step are all JavaScript-based and can accept JavaScript expressions, which are evaluated during replay.

    Click the icon to open the JavaScript editor, where you can insert or edit multi-line code in JavaScript. Do not use a return statement. The last line evaluated is the return value.

    For details, see Work with JavaScript.

  • Parameter name. The key for the parameter. The current value of the parameter is used during replay.

    To add a parameter, right-click in the field and select Create New Parameter From Selection or Replace Selection With Parameter.

    For details, see Use parameters in scripts.

encrypt or decrypt text

Encrypt/decrypt this text. For parameter fields, determines if the parameter value is shown encrypted or in plain text during replay. Select an option from the dropdown list:

  • encrypt or decrypt textText is encrypted. The parameter list value is displayed in encrypted format.

  • Text is not encrypted. The decrypted parameter is displayed as plain text.

Back to top

Next steps: