quickstarts/tutorials/workflow/csharp/fan-out-fan-in

Fan-out/Fan-in

This tutorial demonstrates how to author a workflow where multiple independent tasks can be scheduled and executed simultaneously. The workflow can either wait until all tasks are completed to proceed, or continue when the fastest task is completed. For more information about the fan-out/fan-in pattern see the Dapr docs.

Inspect the code

Open the FanOutFanInWorkflow.cs file in the tutorials/workflow/csharp/fan-out-fan-in/FanOutFanIn folder. This file contains the definition for the workflow.

graph LR
   SW((Start
   Workflow))
   subgraph for each word in the input
    GWL[GetWordLength]
   end
   SHORT[Select the
   shortest word]
   ALL[Wait until all tasks
   are completed]
   EW((End
   Workflow))
   SW --> GWL
   GWL --> ALL
   ALL --> SHORT
   SHORT --> EW

Run the tutorial

1. Use a terminal to navigate to the tutorials/workflow/csharp/fan-out-fan-in folder.

2. Build the project using the .NET CLI.

   dotnet build ./FanOutFanIn/
   

3. Use the Dapr CLI to run the Dapr Multi-App run file

   ```bash
   

   dapr run -f .

   <!-- END_STEP -->
   
   

4. Use the POST request in the fanoutfanin.http file to start the workflow, or use this cURL command:

   curl -i --request POST \
   --url http://localhost:5256/start \
   --header 'content-type: application/json' \
   --data '["which","word","is","the","shortest"]'
   

   The input for the workflow is an array of strings:

   [
       "which",
       "word",
       "is",
       "the",
       "shortest"
   ]
   

   The expected app logs are as follows:

   == APP - fanoutfanin == GetWordLength: Received input: word.
   == APP - fanoutfanin == GetWordLength: Received input: is.
   == APP - fanoutfanin == GetWordLength: Received input: the.
   == APP - fanoutfanin == GetWordLength: Received input: shortest.
   == APP - fanoutfanin == GetWordLength: Received input: which.
   

   Note that the order of the logs may vary.

5. Use the GET request in the fanoutfanin.http file to get the status of the workflow, or use this cURL command:

   curl --request GET --url http://localhost:3556/v1.0/workflows/dapr/<INSTANCEID>
   

   Where <INSTANCEID> is the workflow instance ID you received in the Location header in the previous step.

   The expected serialized output of the workflow is:

   "\"is\""
   

6. Stop the Dapr Multi-App run process by pressing Ctrl+C.