You can answer to a waiting user interaction of a workflow run by using the Orchestrator REST API.
Before you begin
Verify that you have imported the sample workflows package in Orchestrator. The package is included in the Orchestrator sample applications ZIP file that you can download from the Orchestrator documentation page.
- Retrieve the list of all user interaction objects by making a GET request at the URL that holds the available user interaction objects, or by filtering only the waiting user interactions:
Holds the available user interaction objects in Orchestrator
Filters only the waiting user interaction objects.
You receive a list of the available user interaction objects. User interactions that are waiting have an attribute with name state and value waiting.
- Make a GET request at the URL that holds the inventory item of the waiting user interaction to which you want to answer:
The inventory item contains a link to the user interaction instance.The user interaction instance is associated with a particular workflow run.
- Make a POST request at the URL of the user interaction instance for the particular workflow execution:
- Provide values for the input parameters of the user interaction in an execution-context element in the request body.
The REST API returns a 204 status when you answer to a user interaction successfully.
Answer to the User Interaction of the Interactive Hello World Workflow
You can run the Interactive Hello World sample workflow and answer to its user interaction.
Search for the waiting user interaction of the workflow by making GET request at the endpoint for the user interaction objects of the Catalog service:
Locate the user interaction inventory object for the Interactive Hello World workflow and make a GET request at its URL:
Make a POST request at the URL of the user interation objects for the currently running workflow execution:
Provide a value for the input parameter in the request body:
<execution-context xmlns="http://www.vmware.com/vco"> <parameters> <parameter name="name" type="string"> <string>John Smith</string> </parameter> </parameters> </execution-context>