4.1

WorkflowTokenAttribute objects' properties is not set, or if an attribute value is not one that the workflow
expects, the Web service sends the answerWorkflowInput request, with the invalid WorkflowTokenAttribute
object. If a WorkflowTokenAttribute object is invalid, the workflow fails, entering the failed state without
informing the Web service application. Your Web service application can check whether a workflow runs
correctly or fails by calling the getWorkflowTokenStatus operation during and after the workflow runs.
Type Value Description
String
workflowTokenId
The ID of a running workflow that is
waiting for input from a user interaction
or external application
Array of WorkflowTokenAttribute
objects
answerInputs
The result of the user interaction or
external application, passed as input to
the waiting workflow
String
username
Orchestrator user name
String
password
Orchestrator password
Return Value
No return value. Throws an exception if you pass it an invalid parameter.
cancelWorkflow Operation
The cancelWorkflow operation cancels a workflow.
The behavior of the cancelWorkflow operation depends on the workflow that it cancels. A canceled workflow
stops running in the Orchestrator server and enters the canceled state, but the actions that it has already run
or started running do not stop or reverse themselves. For example, if a workflow is performing a Power On
Virtual Machine operation when you cancel it, the virtual machine does not stop powering on, nor does it
power itself off if it has already started.
The cancelWorkflow operation is declared as follows.
public void cancelWorkflow(String workflowTokenId, String username, String password);
Type Value Description
String
workflowTokenId
The identifier of the running workflow
to cancel
String
username
Orchestrator user name
String
password
Orchestrator password
Return Value
No return value. The cancelWorkflow operation returns an exception if you pass it an invalid parameter.
echo Operation
The echo operation tests the connection to the Web service by returning a String message.
The echo operation is declared as follows.
public String echo(String echo);
Type Value Description
String echo An arbitrary String. If the Web service
connection is working correctly, it
returns the String.
vCenter Orchestrator Developer's Guide
266 VMware, Inc.