ATC: CALL and ATC: INVOKE

ATC: CALL [scriptname or GUID]
ATC: INVOKE [scriptname or GUID]

The CALL command runs a workflow script from the Workflow Script tool. When the called script finishes, execution of the calling script resumes (unless the called script causes errors).

INVOKE runs the script with elevated “system” level permissions.  For security, this command can only be used in a script in a Workflow Library (not a route script).   If you require a ROUTE workflow, first use ATC: CALL to invoke a script in the library/tool, then have that script use ATC: INVOKE to elevate permissions. Permissions are restored when the invoked script returns.

  • [scriptname or GUID] is required. It specifies a workflow script that exists in the system’s Workflow Script library, either by name or by GUID. Square brackets are required.

Recursion

Recursive calls are possible to a maximum call depth of 1024.  Each document has its own call stack.

Example

ATC: CALL [OutForBid]

The above example means “run the workflow written in the OutForBid script, as created in the Workflow Scripts tool.”

Example

ATC: INVOKE [ApprovePayment]

The above example means “run the workflow written in the ApprovePayment script, as created in the Workflow Scripts tool.  Run the script with SYSTEM level permission, and reverts to user permissions upon return. ”


Last updated: February 14, 2023 at 13:57 pm;