Elsa Workflows 3.x版本中工作流恢复机制的变更解析

工作流恢复机制的历史演变

在Elsa Workflows 3.0.2版本中，开发者可以通过ResumeWorkflowsAsync方法来恢复被挂起的工作流实例。这个方法接收三个参数：活动类型名称、书签负载以及触发选项。这种设计简单直接，开发者可以轻松地通过关联ID来恢复特定的工作流实例。

3.3.1版本的重大变更

随着Elsa Workflows升级到3.3.1版本，原有的ResumeWorkflowsAsync方法被移除，这导致许多现有代码无法编译通过。这一变更属于未在文档中明确说明的重大破坏性变更，给开发者带来了升级障碍。

新的工作流恢复机制

在新的API设计中，Elsa团队引入了更精细的工作流控制机制。要恢复工作流，现在需要构造一个RunWorkflowInstanceRequest对象，其中包含：

1. ActivityHandle：标识要恢复的活动
   • ActivityId：活动类型名称
   • ActivityInstanceId：原关联ID
2. 通过CreateClientAsync创建客户端
3. 使用RunInstanceAsync方法执行恢复操作

正确的迁移方案

根据官方回复，3.3.2版本将会重新标记这些被移除的接口为过时而非直接删除。但在当前版本中，开发者可以采用以下两种方式之一来恢复工作流：

方法一：使用书签机制

1. 在活动中创建书签：

context.CreateBookmark(new CreateTodoStimulus(entity.Id), ResumeAsync, false);

2. 在需要恢复的地方：

var stimulus = new CreateTodoStimulus(todoId);
var input = new Dictionary<string, object> { [CreateTodo.InputKey] = resultPayload };
var activityTypeName = ActivityTypeNameHelper.GenerateTypeName<CreateTodo>();

await bookmarkQueue.EnqueueAsync(new NewBookmarkQueueItem {
    ActivityTypeName = activityTypeName,
    StimulusHash = stimulusHasher.Hash(activityTypeName, stimulus),
    Options = new ResumeBookmarkOptions { Input = input }
});

方法二：等待3.3.2版本

等待即将发布的3.3.2版本，该版本会恢复这些接口并标记为过时，给开发者更长的迁移过渡期。

技术建议

1. 对于新项目，建议采用新的书签机制，它提供了更精细的控制和更好的可扩展性
2. 对于现有项目，如果升级紧迫，可以暂时实现自己的IWorkflowRuntime扩展方法来封装新API
3. 密切关注3.3.2版本的发布说明，了解完整的变更细节

总结

Elsa Workflows 3.x版本对工作流恢复机制进行了重构，虽然短期内带来了升级挑战，但从长远看，新的API设计提供了更强大和灵活的工作流控制能力。开发者应当理解这些变更背后的设计理念，并根据项目实际情况选择合适的迁移策略。