A WorkflowTokenAttribute object represents an input or output parameter of a running instance of a workflow.

A WorkflowTokenAttribute is a value that you pass to a predefined WorkflowParameter when a WorkflowToken begins, or in some cases, at runtime. When you run a workflow, you supply the input parameters for that particular workflow as WorkflowTokenAttribute objects. The executeWorkflow operation takes an array of WorkflowTokenAttribute objects as an argument when you call it, as the following example shows.

public WorkflowToken executeWorkflow(String workflowId, String username, 
String password, WorkflowTokenAttribute[] attributes);

Workflows also use WorkflowTokenAttribute as the output parameter of a run workflow. WorkflowTokenAttribute contains the results of a completed WorkflowToken created by running executeWorkflow. You can collect the result of a WorkflowToken, in the form of a WorkflowTokenAttribute, by calling getWorkflowTokenResult, as the following example shows.

public WorkflowTokenAttribute[] getWorkflowTokenResult(String workflowTokenId, 
String username, String password);

You can also pass an array of WorkflowTokenAttribute objects to the answerWorkflowInput operation to provide input that a workflow token needs while it runs.

public void answerWorkflowInput(String workflowTokenId, 
WorkflowTokenAttribute[] answerInputs, String username, String password);

The following table shows the properties of the WorkflowTokenAttribute object.

Type

Value

Description

String

name

Name of the input or output parameter

String

type

Type of input or output parameter

String

value

The value property represents either the input or output parameter value for this particular workflow token, in the form of a string.

If the type is an array of objects, the value is a string of the following format:

"#{#<type1>#<value1>#;#<type2>#<value2>#...}#"

If the value property specifies an object obtained from a plug-in, then the input or output parameter value is a dunesUri string that points to the object in question. The following example shows the format of the dunesUri.

dunes://service.dunes.ch/CustomSDKObject?id='<object_ID>'&dunesName='<plug-in_name>:<object_type>'