Parameter input

While recording scripts, many of the methods that you’ll encounter require one or more parameters.

Starting with version 2.6.0, these parameters are set interactively using an enhanced dialog.

Here is an annotated example screenshot, with explanations given below:

1: Context information

At the top of the dialog, a short summary of the context is shown.

It consists of the method name for which a value is required (clickTableRow in the example), and the current parameter (Row) for which a value is to be set.

Note that if a method has multiple parameters, this dialog will be shown multiple times, once for each parameter.

2: Direct values

The “Use direct value” option is the simplest, and default, option for the dialog.

If it is selected, you only need to provide a value, which will directly be used in the script.

Validation and quoting

The dialog knows about the type of the parameter (e.g., String, Integer, Boolean), and will only accept values conforming to the expected type. Validation is performed in real time, and the result is shown in the status bar at the bottom of the dialog.

Values may also be quoted (e.g. the quoted String "42" is acceptable for a value of type Integer), though this should rarely be needed and is generally not recommended.

3: Creating new inputs

The “Create new input” option is a convenient way to provide a value to use, while assigning that value to a script input at the same time.

NOTE: When using this option, both the value, and the input name to which it is to be assigned, must be provided.

4: Using existing inputs

The final option allows you to select an existing script input.

As the screenshot shows, only existing inputs with compatible values are selectable; if no such inputs exist, this option is not available, and a corresponding status message is displayed.