Params

The last 3 columns in the RVL table are used for passing parameters:

... ParamName ParamType ParamValue
... text string John Smith
... x number 5
... y number 7
... forceEvent boolean true

Param Rows

In RVL each parameter takes one row:

... Type ... ParamName ParamType ParamValue
... Param text string John Smith
... Param x number 5
... Param y number 7
... Param forceEvent boolean true

Param Arrays

Some methods accept arrays of values as input values. For example Tester.Message may take its 1st message parameter as an array and prints them combined. Making an array is easy, several consequent parameters having the same name are combined into an array, i.e.:

Flow Type Object Action ParamName ParamType ParamValue
Action Tester Message message string MyVar1 value:
Param message variable MyVar1
Param message string MyVar2 value:
Param message variable MyVar2

Should report a message like:

MyVar1 value: 25 MyVar2 value: 33

Extra Parameters

Several functions of the RVL Object support variable parameters (RVL.DoPlaySheet, RVL.DoPlayScript, RVL.SetLocatorOpts, RVL.FormatString and RVL.DoPlayTestParallel) support extra parameters.

Custom parameters added by user manually, by specifying row type Param and assigning any required param name.

Extra Parameters

There my be as many extra parameters as needed.

Mixed Rows

In some cases it is convenient to mix parameter cells with an Action or Condition.

For example, the 1st parameter of an Action may share the Action row:

Flow Type Object Action ParamName ParamType ParamValue
Action MyButton DoClick x number 5
Param y number 7

And this is equivalent to putting it in the next row:

Flow Type Object Action ParamName ParamType ParamValue
Action MyButton DoClick
Param x number 5
Param y number 7

Or param2 of the condition may be on the same row:

... Type Object Action ParamName ParamType ParamValue
Param param1 string Text1
Condition param1!=param2 param2 string Text2

Which is equivalent to:

... Type Object Action ParamName ParamType ParamValue
Param param1 string Text1
Condition param1!=param2
Param param2 string Text2

This allows saving space while keeping same readability. See also short condition syntax for real live example of mixed rows usage.

Map Params

If map is defined in the script it may be used directly as a parameter. ParamType should be set to Map Name and ParamValue is a column (or row) name:

Map Param