7.3

5 When you are nished editing the workow, update the workow in the Model Manager by clicking
Send.
The workow is saved and appears as a new revision in the list the next time you load a workow. You
can access an earlier version of a workow at any time. See “Revert to a Previous Revision of a
Workow,” on page 61.
Using vRealize Orchestrator Workflow Activities
You can use vRealize Automation Designer activities to call vRealize Orchestrator workows either
synchronously or asynchronously.
A vRealize Orchestrator endpoint is specied in one of the following ways:
n
VirtualMachineId is the name of the variable representing the virtual machine ID. A virtual machine
with this ID is selected and the value that is retrieved from the
VMware.VCenterOrchestrator.EndpointName custom property for a virtual machine is used as the
vRealize Orchestrator endpoint name.
n
GetVcoEndpointByManagementEndpoint returns the value of a custom property on a specied
ManagementEndpoint object. If the CustomPropertyName is not specied, the value of the
VMware.VCenterOrchestrator.EndpointName property is used.
n
GetVcoEndpointByHost returns the value of a custom property on a specied host. If the
CustomPropertyName is not specied, the value of the VMware.VCenterOrchestrator.EndpointName
property is used.
Synchronous Execution
The InvokeVcoWorkflow activity calls a vRealize Orchestrator workow and blocks further execution of its
parent IaaS workow until the vRealize Orchestrator workow completes. The activity returns the output
parameters for the vRealize Orchestrator workow.
In addition, the synchronous execution supports the following property:
n
WorkflowTimeout is a timeout value in seconds. If the vRealize Orchestrator workow does not nish in
the specied time, an exception is generated rather than blocking the workow until a response is
returned. If no value is dened or a value of zero is supplied, the timeout is not activated. The workow
status is checked every 10 seconds during that period unless the polling time is modied for the
endpoint by specifying a value in the VMware.VCenterOrchestrator.PollingInterval custom property.
Asynchronous Execution
The InvokeVcoWorkflowAsync activity is a “re and forget” activity that calls a vRealize Orchestrator
workow and continues to execute activities in the IaaS workow without waiting for the
vRealize Orchestrator workow to complete.
The activity returns either a unique workow execution token that can be used to monitor the workow or
an error if the REST API call to the vRealize Orchestrator server failed (for example, if the server could not
be reached).
Two additional activities are available for use with this activity:
n
GetVcoWorkflowExecutionStatus enables you to poll the vRealize Orchestrator workow for its status.
n
WaitForVcoWorkflowCompletion enables you to block further execution of the IaaS workow until the
vRealize Orchestrator workow has completed or timed out. You can use this activity to retrieve the
results of a vRealize Orchestrator workow that you execute asynchronously.
Chapter 1 Life Cycle Extensibility
VMware, Inc. 53