You can use either the InvokeVcoWorkflow or the InvokeVcoWorkflowAsync activity to call a vRealize Orchestrator workflow from an IaaS workflow.

About this task

Some vRealize Orchestrator workflows require user interaction during execution. For these workflows, the user prompt appears in the vRealize Orchestrator client rather than in the vRealize Automation console, so it is not apparent to the end user in vRealize Automation that a workflow is waiting for input.

To avoid workflows that block on user input, do not call vRealize Orchestrator workflows that require user interaction from IaaS workflows.

Procedure

  1. In vRealize Automation Designer, open a workflow and navigate to the context where you want to call a vRealize Orchestrator workflow.
  2. Drag the InvokeVcoWorkflow or the InvokeVcoWorkflowAsync activity into the Designer pane.
  3. Select the vCenter Orchestrator workflow to execute.
    1. Under General, click the ellipsis next to Workflow.
    2. In the Browse for vCO workflow dialog box, select a workflow.
    3. Click OK.

    The Inputs and Outputs sections display the input and output parameters of the selected workflow.

  4. In the Properties pane, specify one of the following target parameters.
    • 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.

    • VcoEndpointName is the endpoint name that is used to run the workflow. If specified, this value overrides the VirtualMachineId value when selecting the vRealize Orchestrator endpoint.

    • WorkflowTimeout is a timeout value in seconds. If the vRealize Orchestrator workflow does not finish in the specified time, an exception is generated rather than blocking the workflow until a response is returned. If no value is defined or a value of zero is supplied, the timeout is not activated. The workflow status is checked every 10 seconds during that period unless the polling time is modified for the endpoint by specifying a value in the VMware.VCenterOrchestrator.PollingInterval custom property.

  5. Specify the parameters for the vRealize Orchestrator workflow.
    • Enter the values in the activity in the Designer pane.

    • In the Properties pane, click the ellipsis next to InputParameters or OutputParameters to open the Parameters dialog box. This dialog box displays the IaaS type of each parameter. If the parameter type appears in bold, the parameter is required.

    Point to the text box for any parameter to view a tooltip indicating the vRealize Orchestrator type.

    If you are using the InvokeVcoWorkflowAsync activity, the output parameters of the vRealize Orchestrator workflow are displayed with their corresponding types for informational purposes, but you cannot specify an expression for the parameter in this activity.

What to do next

To retrieve the results of a workflow that you execute asynchronously, use the WaitForVcoWorkflowCompletion activity.