Robot definitions

Use the toolbar, Robot definitions pane, and context menu to add, configure, and modify the following robot definitions.

  • Input: View input parameter definitions that a robot takes, including test values.

  • Devices: Define the required devices that a robot uses.

  • Databases: Define the required database mappings that a robot uses.

  • Return Types: View lists of return types that a Robot delivers to a Basic Engine Robot.

  • Exceptions: View exceptions that may occur.

  • Tree Modes: Configure the application-tree type for different applications to deliver.

  • Variables: Configure Robot variables.

Toolbar and pane

Click the icon to collapse or expand the view from a toolbar to a pane of Robot definitions. Each view lists the definition areas in the same order.

  • Click an icon in the Robot definitions toolbar to go directly to the corresponding definition area.

  • Click the up and down caret marks to expand and collapse each definition and related elements. The caret mark must be up to add and view definitions and to access Tungsten RPA Help topics by clicking the ? symbol to go directly to the related topic.

  • If an area has definitions, a green plus sign appears after the existing definitions. Click the green plus sign to add definitions.

  • If an area has no definitions, a message appears such as "No devices available" followed by a button, such as . Click the button to add the first definition.

The following images show the Robot definitions toolbar, pane, and expanded areas where definitions are added and edited.

Robot definitions toolbar Robot definitions pane Expanded definitions

Context menu

Right-click within a definition, parameter, or the Robot definitions pane to view the context menu.

The options vary based on where you right-click.

The following example shows how the menu appears for an input parameter with a Record type.

The following table lists all context-menu options, with explanations of when options are available.

Button

Tooltip

Description

Icon for Rename option

Rename

Renames the selected element.

Icon for Delete option

Delete

Deletes the selected element.

The Delete option is available in all but the Exceptions area.

Icon for Update Value option

Update Value

Updates values for a Record value and is only active if the value type has changed since the value was last edited.

You may need to update Record type values, if Robots of older versions are executed in standalone mode.

Icon for Find Usage option

Find Usage

For Input, Devices, Exceptions, and Variables, use the Find Usage feature to find where they are used.

This option is similar to the text search, except that the list in the Search Result panel only shows instances of a specific element.

Icon for Open Type option

Open Type

Opens a type in the Design Studio Type Editor. Opens the type from parameter or variable definitions.

Open Type is available on Input and Variable definitions and on Return Types.

See Types.

Select in My Projects View

Selects (finds) the corresponding mapping file in the My Projects view so that you can edit the file by double-clicking on it in the My Projects view.

This option is available on Devices and Databases definitions.

Expand all steps button

Expand

Expands fields and entries in the active definition.

Icon for Collapse option

Collapse

Collapses fields and open entries for the selected element.

Icon for Add option

Add

Adds a new element.

Based on the definition, this right-click option displays text that matches.

Examples: Add Input, Add Device, and Add Database.

Icon for Add Below option

Add Below

Adds a new element below the current selection.

The Add Below option is available in all but the Exceptions area.

  • To add a new definition between existing entries, select the preceding definition, then select Add Below to insert the new one.

  • To add a new definition at the top, place the cursor at the top of the Robot definition pane and use the Add context-menu option to add an element.