Receive Task

A Receive Task is a simple task that waits for the arrival of a certain message, i.e., the process will stay in this wait state until a specific message is received by the engine, which triggers the continuation of the process. The sample related to this task is the BuyProduct.bar found in the <BPS-HOME>/repository/samples/bpmn directory.

Flow of the sample

This sample executes as follows:

1. The user (admin) fills the details of the product, including the product name and quantity.
2. The receive task waits for a signal. Once a signal is received by the receive task, the process will continue to the next task.
3. The user confirms/gets the product details.

Running the sample

1. Follow the steps in Deploying BPMN Samples to deploy the sample using the WSO2 BPS management console. 
2. Log in to the BPMN Explorer using the admin/admin credentials.
3. Access the PROCESSES tab to view the task in the task list.
   
4. Click the Start button next to the receive task sample.
5. Once the above step is done, a task appears in the MY TASKS tab.
   
6. Fill the form associated with the task and click Complete.
   

After completing the first task, i.e., after filling the details of the product, send a message to the engine that triggers the process to continue after the receive task. 

1. Get the execution ID of the process instance using:
   GET bpmn/runtime/executions (https://localhost:9443/bpmn/runtime/executions)
2. Identify the exucution ID of the execution with the task id "waitTask".
3. After getting the execution ID, use this REST call to signal the specific execution:
   PUT bpmn/runtime/executions/{executionId} 
   
   Request body (signal an execution):
   { "action":"signal" }
4. Then a message will be sent to the engine, and the receive task will be triggered which will allow the process to continue further.
5. There will be a user task created after receiving the message.