Object Model Reference for GUI Testing > Utility Objects > Utility Statements > RunAction Statement

RunAction Statement

Description

Runs the specified action in the test.

Notes:

Syntax

RunAction ActionName, [Iteration ,Parameters]

Argument

Type

Description

ActionName

String

The name of the action.

Note: You must specify the action name explicitly on the statement. Do not use a variable. For example, write:
RunAction="Action1[ExternalTest]"
and not:
aName="Action1[ExternalTest]"
RunAction aName

Iteration

Variant

Optional.

-- oneIteration or 0 (Default)—Runs the action only once, using the row in the action's data sheet that corresponds to the global data sheet iteration counter.

If the action's data sheet contains fewer rows than the global sheet, the last row of the action's data sheet will be used for each subsequent iteration.

-- allIterations or 1—Runs iterations on all rows.

-- iteration row range (for example, "1-7")—Indicates the rows for which action iterations will be performed

Note: Iteration is required when calling an external action, but optional when calling a local action (from within the test).

Parameters

Variant

Optional.

The values and storage locations for the called action's input and output parameters. Input parameters are listed before output parameters.

For an input parameter, specify either a fixed value or the name of another defined parameter (data table parameter, environment parameter, or an action input parameter of the calling action) from which the argument should take its value.

For an output parameter, specify either a variable in which you want to store the value or the name of a defined parameter (data table parameter, environment parameter, or an action output parameter of the calling action).

Return Value

Variant.

If the action called by the RunAction statement includes an ExitAction statement, the RunAction statement can return the value of the ExitAction's RetVal argument. For more details, see ExitAction Statement.

 

See also: