Workflow tutorials C# #1182

marcduiker · 2025-03-21T08:38:03Z

Description

This PR adds workflow examples for C# in the tutorials folder.

Issue reference

We strive to have all PRs being opened based on an issue, where the problem or feature have been discussed prior to implementation.

Please reference the issue this PR will close: #1183

Checklist

Please make sure you've completed the relevant tasks for this PR, out of the following list:

The quickstart code compiles correctly
You've tested new builds of the quickstart if you changed quickstart code
You've updated the quickstart's README if necessary
If you have changed the steps for a quickstart be sure that you have updated the automated validation accordingly. All of our quickstarts have annotations that allow them to be executed automatically as code. For more information see mechanical-markdown. For user guide with examples see Examples.

Signed-off-by: Marc Duiker <[email protected]>

tutorials/workflow/csharp/challenges-tips/VersioningWorkflow.cs

Signed-off-by: Marc Duiker <[email protected]>

WhitWaldo

Several changes for .NET syntax and formatting changes (e.g. use var, primary constructors and static classes for constants), improvements to how instances should be injected from DI and

WhitWaldo · 2025-04-15T21:17:06Z

tutorials/workflow/csharp/challenges-tips/DeterministicWorkflow.cs

+    {
+        // Do use these deterministic methods and properties on the WorkflowContext instead.
+        // These operations create the same value when the workflow is replayed.
+        var orderId = context.NewGuid().ToString();


This isn't deterministic

WhitWaldo · 2025-04-15T21:19:50Z

tutorials/workflow/csharp/challenges-tips/IdempotentActivity.cs

+    public override async Task<InventoryResult> RunAsync(WorkflowActivityContext context, OrderItem orderItem)
+    {
+        // Beware of non-idempotent operations in an activity.
+        // Dapr Workflow guarantees at-least-once execution of activities, so activities might be executed more than once.


While true, I'd supplement with some context in that if the workflow activity successfully returns a value, it will not be run again as its value will be used from the workflow context. This makes for a better argument then that workflows should do as little as possible so they improve their success rate and minimize being executed more than once (but should they be, yes, designing for idempotency would be ideal).

WhitWaldo · 2025-04-15T21:20:34Z

tutorials/workflow/csharp/challenges-tips/IdempotentActivity.cs

+    }
+}
+
+internal sealed record OrderItem(string Id, string Description, double UnitPrice, int Quantity);


As the OrderItem's ID was previously created from a Guid, there's little reason the ID couldn't just remain a GUID all the way through.

WhitWaldo · 2025-04-15T21:22:29Z

tutorials/workflow/csharp/challenges-tips/VersioningWorkflow.cs

+{
+    public override async Task<int> RunAsync(WorkflowContext context, string orderItem)
+    {
+        int resultA = await context.CallActivityAsync<int>(


It's far more common for developers to use var as in var resultA instead of repeating the type.

WhitWaldo · 2025-04-15T21:23:49Z

tutorials/workflow/csharp/challenges-tips/VersioningWorkflow.cs

+/// If there are in-flight workflow instances that were started with the previous version
+/// of this workflow, these will fail when the new version of the workflow is deployed 
+/// and the workflow name remains the same, since the runtime parameters do not match with the persisted state.
+/// It is recommended to version workflows by creating a new workflow class with a new name:


Might also mention something about avoiding use of perpetual workflows as this removes the opportunity to swap out workflows.

WhitWaldo · 2025-04-15T21:48:46Z

tutorials/workflow/csharp/workflow-management/WorkflowManagement/Program.cs

+
+app.MapPost("/terminate/{instanceId}", async (string instanceId) => {
+    await using var scope  = app.Services.CreateAsyncScope();
+    var workflowClient = scope.ServiceProvider.GetRequiredService<DaprWorkflowClient>();


Nope, see above

WhitWaldo · 2025-04-15T21:48:54Z

tutorials/workflow/csharp/workflow-management/WorkflowManagement/Program.cs

+});
+
+app.MapPost("/resume/{instanceId}", async (string instanceId) => {
+    await using var scope  = app.Services.CreateAsyncScope();


Nope, see above

WhitWaldo · 2025-04-15T21:49:05Z

tutorials/workflow/csharp/workflow-management/WorkflowManagement/Program.cs

+
+app.MapPost("/suspend/{instanceId}", async (string instanceId) => {
+    await using var scope  = app.Services.CreateAsyncScope();
+    var workflowClient = scope.ServiceProvider.GetRequiredService<DaprWorkflowClient>();


Nope, see above

WhitWaldo · 2025-04-15T21:49:16Z

tutorials/workflow/csharp/workflow-management/WorkflowManagement/Program.cs

+
+app.MapGet("/status/{instanceId}", async (string instanceId) => {
+    await using var scope  = app.Services.CreateAsyncScope();
+    var workflowClient = scope.ServiceProvider.GetRequiredService<DaprWorkflowClient>();


Nope, see above

WhitWaldo · 2025-04-15T21:49:31Z

tutorials/workflow/csharp/workflow-management/WorkflowManagement/WorkflowManagement.csproj

+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Dapr.Workflow" Version="1.15.2" />


Version bump

marcduiker added 6 commits March 21, 2025 09:40

Add C# TaskChaining

3ce6f18

Signed-off-by: Marc Duiker <[email protected]>

Add C# FanOutFanIn

4f59915

Signed-off-by: Marc Duiker <[email protected]>

Add C# Monitor

eaeaaae

Signed-off-by: Marc Duiker <[email protected]>

Add C# ExternalEvent

2da416e

Signed-off-by: Marc Duiker <[email protected]>

Add C# ChildWorkflows

b2d70f1

Signed-off-by: Marc Duiker <[email protected]>

Add C# CombinedPatterns

72668f5

Signed-off-by: Marc Duiker <[email protected]>

marcduiker force-pushed the workflow-tutorials branch from c6914e5 to 72668f5 Compare March 21, 2025 08:41

marcduiker changed the title ~~Workflow tutorials~~ Workflow tutorials C# Mar 21, 2025

marcduiker added 11 commits March 21, 2025 10:42

Add C# WorkflowManagement

8ee7b05

Signed-off-by: Marc Duiker <[email protected]>

Fix port numbers

9cc59c6

Signed-off-by: Marc Duiker <[email protected]>

Add C# Basics

53996a5

Signed-off-by: Marc Duiker <[email protected]>

Add READMEs

ca2f2ad

Signed-off-by: Marc Duiker <[email protected]>

Update READMEs

7ed9923

Signed-off-by: Marc Duiker <[email protected]>

Update folder structure

4bc32fd

Signed-off-by: Marc Duiker <[email protected]>

Update Basic Workflow

b2f3dbc

Signed-off-by: Marc Duiker <[email protected]>

Add BasicWorkflow comments

790c73e

Signed-off-by: Marc Duiker <[email protected]>

Add mermaid diagrams

551f81e

Signed-off-by: Marc Duiker <[email protected]>

Add code comments

a44a0bd

Signed-off-by: Marc Duiker <[email protected]>

Merge branch 'master' into workflow-tutorials

2f154ea

marcduiker marked this pull request as ready for review March 25, 2025 14:48

marcduiker requested review from a team as code owners March 25, 2025 14:48

marcduiker added 3 commits March 26, 2025 13:39

Combine pattern examples is working

d2eeaac

Signed-off-by: Marc Duiker <[email protected]>

Add diagram

2f67550

Signed-off-by: Marc Duiker <[email protected]>

Add README content for challenges& tips

92ffc2e

Signed-off-by: Marc Duiker <[email protected]>

WhitWaldo reviewed Mar 26, 2025

View reviewed changes

tutorials/workflow/csharp/challenges-tips/VersioningWorkflow.cs Show resolved Hide resolved

marcduiker added 4 commits March 31, 2025 16:01

Update to .NET 9

9c04f72

Signed-off-by: Marc Duiker <[email protected]>

Use file based namespaces, make classes internal sealed

9562e15

Signed-off-by: Marc Duiker <[email protected]>

Make classes internal sealed

39fcfcf

Signed-off-by: Marc Duiker <[email protected]>

Fix paths for multi-app run

45d3a43

Signed-off-by: Marc Duiker <[email protected]>

WhitWaldo and others added 5 commits April 1, 2025 17:41

Merge branch 'master' into workflow-tutorials

c369d3d

Add workflow input and outputs to READMEs

7214b5b

Signed-off-by: Marc Duiker <[email protected]>

Add resiliency-and-compensation

c3906d1

Signed-off-by: Marc Duiker <[email protected]>

Add mechanical markdown

29443b0

Signed-off-by: Marc Duiker <[email protected]>

Add make files

5c3e991

Signed-off-by: Marc Duiker <[email protected]>

marcduiker requested a review from WhitWaldo April 15, 2025 12:57

marcduiker added 2 commits April 15, 2025 14:59

Update prerequisites

c47bd4d

Signed-off-by: Marc Duiker <[email protected]>

Add workflow validation to GH WF

fffb2c2

Signed-off-by: Marc Duiker <[email protected]>

WhitWaldo requested changes Apr 15, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Workflow tutorials C# #1182

Workflow tutorials C# #1182

marcduiker commented Mar 21, 2025 •

edited

Loading

WhitWaldo left a comment

WhitWaldo Apr 15, 2025

WhitWaldo Apr 15, 2025

WhitWaldo Apr 15, 2025

WhitWaldo Apr 15, 2025

WhitWaldo Apr 15, 2025

WhitWaldo Apr 15, 2025

WhitWaldo Apr 15, 2025

WhitWaldo Apr 15, 2025

WhitWaldo Apr 15, 2025

WhitWaldo Apr 15, 2025

Workflow tutorials C# #1182

Are you sure you want to change the base?

Workflow tutorials C# #1182

Conversation

marcduiker commented Mar 21, 2025 • edited Loading

Description

Issue reference

Checklist

WhitWaldo left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

marcduiker commented Mar 21, 2025 •

edited

Loading