Masthead, toolbars, and context menu

You can access most of the common activities in recording, developing and interactively replaying scripts using:

  • The masthead, available at the top of the Development window
  • The toolbars, available below the masthead in the Development window
  • The context menu, available by selecting a step and right-clicking

Masthead

This section describes the menus and buttons in the TruClient masthead.

UI Elements Description

Search. Find steps, functions, and transactions in your TruClient scripts that match the text string specified. For more information, see Search bar.

Go To. Goes to a specific step number.

General Settings. Opens the General Settings dialog box. For details, see Configure TruClient General Settings.

General Menu. Use to access the TruClient documentation and learn more about your version of TruClient.

Toolbars

The toolbars differ slightly depending on the TruClient version you are using.

User interface elements are described below:

UI Elements Description
  Upper toolbar

Save. Saves changes made to the script.

Script Level. Filters the steps that are visible and replayed in the script.

  • Displays and replays level 1 steps only. Level 1 steps are necessary to the business process.

  • Displays and replays level 1 and 2 steps. Level 2 steps affect the application in a way that is probably not important to the business process.

  • Displays and replays level 1, 2 and 3 steps. Level 3 steps have no apparent effect on the application.

For details, see Modify and view script and step levels.

Action list. Displays the actions (a set of steps) created for each segment of your business process. For details, see Actions overview

Manage Action. Opens the Manage Actions dialog box, enabling you to add, delete, and rearrange the order of actions. For details, see Actions tab.

Lower toolbar
Step

Opens the TruClient Steps box, enabling you to add steps to a TruClient script. For details, see Steps box.

This button is not available during recording or replay, nor in the Digital Lab tab in a Native Mobile script.

Record. Starts recording the script. Additionally, you can use the arrow to specify whether to record before, into, or after the selected step. For details, see Record a TruClient script.

Replay/Resume. Replays (or resumes replay of) the script. Additionally, you can use the arrow to specify whether to play the selected step only, or to run the script step by step. Running the script step by step pauses the replay after each step. For details, see Replay a TruClient script.

Stop. Stops recording or replaying the script.

Toggle Breakpoint. Toggles breakpoints on the selected step. For details, see Insert toggle breakpoints.

Undo/Redo. Reverses your last action, or restores your original change.

Transaction Editor. Opens the Transaction Editor, enabling you to define new transactions and modify existing ones. For details, see Insert transactions.
Event Handler Editor. Opens the Event Handler Editor box. For details, see Event handlers.

Snapshot Viewer. The snapshot viewer displays the snapshot in the right pane and adds the following elements:

Previous/Next. Navigates to the screenshot for the previous or next step. The corresponding step is highlighted in the script.

Back to top

Context menu

Select a step and right-click to display the context menu.

UI Element
Description

<Replay Actions>

Play This Step. Replay the selected step only.

Play Until This Step. Replay from the beginning. Stop before the selected step.

Play From This Step. Replay the script from the selected step.

Note: You cannot use Play From This Step if the target step:

  • Is located in an action that is not part of the run logic.

  • Is inside a For loop or If block.
  • Is a Catch Error step.
  • Acts on an Web object that is not available on the current Web page.

<Record>

  • Before step. Insert the next set of recorded steps before the selected step.
  • Into Step. Insert the next set of recorded steps into the selected step.
  • After Step. Insert the next set of recorded steps after the selected step.
Toggle Breakpoint

Insert/Remove a breakpoint.

<Transaction Steps>

  • Start Transaction. Insert a Start Transaction step into the script.
  • Surround With Transaction. Insert a Start Transaction and End Transaction steps around a single or multiple steps into the scripts.
  • End Transaction. Insert an End Transaction step into the script.
<Group Actions>

Group Steps. Multiple steps are grouped together as a single step.

Group Into. Multiple steps are group into:

  • Action. A group of steps that you define as a new or existing action.
  • If Clause. A logical structure that controls the flow of your script.
  • For Loop Clause. A logical structure that repeats the steps contained in the loop a specified number of times.
  • New Function. A group of steps, such as a login, that you define as a function.

Ungroup Steps. Ungroups the selected steps.

<Edit Actions>
  • Cut. Cut select step from the script.
  • Copy. Copy selected step in the script.
  • Paste. Paste selected step into the script.
Export/Import Steps

You can copy and paste steps from one script into a new or existing script using the Export/Import function.

The following limitations apply:

  • You can copy and paste steps between scripts that are developed using the same browser. For example, if you copy steps from a TruClient Browser script, you can only paste them into another script developed in TruClient Browser.

  • You can copy and paste steps to and from the Actions or Function Libraries tabs of a script.

Export. Copy selected steps in a TruClient script to paste into another script.

Import. Paste selected steps, that have been exported, into a second script.

Delete Delete a step from the script.
Enable/Disable Switch between disabling or enabling a step during replay.

Edit Step

Expand the step to display step, argument and transaction properties.

Unfold All Steps

Display all steps and groups.

Note: This differs from the Click to expand button (used inside groups and function libraries) which enables you to expand the contents inside a container only.

Fold/Unfold All Steps

Minimize all steps and groups.

Note: This differs from the Click to contract button (used inside groups and function libraries) which enables you to contract the contents inside a container only.

Reset Auto End Event Enables you to reset the selected step or steps to Automatic: Not Yet Set.
Change Object Identification Method

Enables you to change the method of identifying the object.

  • Automatic. Allows TruClient to use its internal advanced algorithms to locate the object.

  • XPath. Identifies the object based on its XPath expression that defines the object in the DOM tree.

  • JavaScript. Enables you to write JavaScript code that references the returned document and use CSS selectors and other standard functions.

  • Descriptors. Enables you to identify an object by its properties in an editor.

Back to top

See also: