Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Workflow- Scoped

The scoped Workflow API provides methods that can be used in an activity definition script.

There are no constructors for creating an instance of a scoped workflow object. Instead, use the global workflow object available in activity scripts. This workflow object is available in any script location inside a workflow.

Parent Topic:Server API reference

Scoped Workflow - debug(String message, Object args)

Adds a debug message to the log.

NameTypeDescription
messageStringThe message to add to the log.
argsObjectArguments to add to the message.
TypeDescription
StringThe message added to the log.
var loggedMessage = workflow.debug("All is well");

Scoped Workflow - error(String message, Object args)

Adds an error message to the log.

NameTypeDescription
messageStringThe message to add to the log.
argsObjectArguments to add to the message.
TypeDescription
StringThe logged message
var loggedMessage = workflow.error("An error has occurred. ");

Scoped Workflow - getVariable(String name)

Returns the specified variable's value.

NameTypeDescription
nameStringThe variable name
TypeDescription
ObjectThe variable's value
var value = workflow.getVariable("task");

Scoped Workflow - info(String message, Object args)

Adds an informational message to the log.

NameTypeDescription
messageStringThe message to add to the log.
argsObjectArguments to add to the message.
TypeDescription
StringThe message that is logged.
var loggedMessage = workflow.info("All is well");

Scoped Workflow - inputs

Object that contains the workflow variables.

This is not a method, but rather a way to reference the variables in a workflow object, such as the user. Workflow variables are defined in the properties of the workflow or by scripted activities.

NameTypeDescription
inputsObjectWorkflow variables as name value pairs. The variables of a workflow object are custom to an integrator's implementation.
var user = workflow.inputs.u_user;

Scoped Workflow - name()

Returns the workflow name.

NameTypeDescription
None  
TypeDescription
StringThe workflow name
var name = workflow.name();

Scoped Workflow - removeVariable(String name)

Removes the specified variable from the workflow.

NameTypeDescription
nameStringThe variable name
TypeDescription
void 
var value = workflow.removeVariable("task");

Scoped Workflow - result

Element of the workflow object that contains the workflow results.

This is not a method, but rather the element in the workflow object that contains the results of a workflow.

NameTypeDescription
resultStringWorkflow results.
var wfResult = workflow.result;

Scoped Workflow - scratchpad()

Returns the workflow's scratchpad object.

NameTypeDescription
None  
TypeDescription
ObjectThe scratchpad object.
var scratchpad = workflow.scratchpad();

Scoped Workflow - setResult(String result)

Sets the workflow's result.

NameTypeDescription
resultStringThe workflow's result
TypeDescription
void 
workflow.setResult("Success");

Scoped Workflow - setVariable(String name, Object value)

Sets the specified variable to the specified value.

NameTypeDescription
nameStringThe variable name
valueObjectThe value to be assigned to the variable.
TypeDescription
void 
workflow.setVariable("task", "terrible");

Scoped Workflow - warn(String message, Object args)

Adds a warning message to the log.

NameTypeDescription
messageStringThe message to add to the log.
argsObjectArguments to add to the message.
TypeDescription
StringThe logged message
var loggedMessage = workflow.warn("Check your permissions.");