Execute script

Invokes a script located in the Perfecto Repository. This functionality lets you include sub-scripts within a script.

The script parameters must be entered in the same order and with the correct types as defined in the original script. The script will not work otherwise.

Tip: If you locate and drag the desired script from the Perfecto Repository directly into the script, the run time parameters will be entered automatically in the correct order.
Important: For the child scripts to each have an execution video associated with them, you will need to have an Open Device function in the beginning of each as well as a Close Device function in the end.

Use String Encoder

When using the Secured String type in a sub-script within script:

  • If a runtime parameter variable in the executed script is defined as a Secured String type, then the variable parameter in the calling script MUST be defined as Secured String.
  • If a runtime parameter variable in the executed script is defined as a String type, then the parameter variable in the calling script can be defined as string or Secured String. This allows the user to decide whether or not to use a secured string.

When using Embedded script execution, the devices used are shared between the parent and child scripts; Whereas, Sync or Async run separate script executions, and the devices are not shared. In Async script execution, multiple sub-scripts can be invoked and executed simultaneously within a script.

Parameters

Name

REST Name

Type

Default Description

Script path*

script

STRING


The full repository path, including directory and file name, where to locate the script.
Example -
PRIVATE:myapp/script.xml

Script parameters*

parameter

STRING


The script parameters.
These must be in the same order and of the correct types as defined in the original script.

Script execution mode

execution
embedded (Embedded)
sync (Sync (separate))
async (Async (separate))

STRING

Embedded

The script execution mode.
Embedded - executed as an embedded part of the parent script line is executed only once the child script is generated
Sync - executed as a separate script with its own devices, report, and abort; the next script line is executed only once the child script is completed
Async - executed as a separate script with its own devices, report, and abort; the next script line is executed without waiting for the child script to be completed

* Mandatory parameter