如何通过Foundry Actions实现按条件路由通知？

核心思路 #

先捕获操作提交前后目标对象特定属性的状态变化，根据变化结果匹配对应的用户组，再触发对应的通知发送逻辑。

具体实现步骤 #

• 捕获属性快照：在执行提交操作前，先保存目标对象特定属性的原始值；操作完成后，获取更新后的属性值。
• 判断属性变更：对比前后快照，明确目标属性是否发生了实际变更（包括值的新增、修改、删除）。
• 映射路由规则：提前定义好「属性变更状态-目标用户组」的对应关系，比如特定属性修改时通知管理员组，未修改时通知普通编辑组。
• 触发定向通知：根据判断结果，调用通知服务给匹配到的用户组发送对应内容的通知。

代码示例（Python伪代码） #

# Workshop模块操作提交处理函数
def submit_workshop_operation(workshop_id, updated_data):
    # 1. 获取操作前的原始对象，提取关注的特定属性（比如status字段）
    original_workshop = WorkshopModel.get_by_id(workshop_id)
    original_status = original_workshop.status
    
    # 2. 执行对象更新操作
    original_workshop.update(**updated_data)
    original_workshop.save()
    
    # 3. 获取更新后的属性值
    new_status = original_workshop.status
    
    # 4. 根据属性变化匹配目标用户组
    target_groups = []
    if original_status != new_status:
        # 状态发生变更，通知管理员组和运营组
        target_groups = ["admin_group", "operation_group"]
    else:
        # 状态未变更，仅通知编辑组
        target_groups = ["editor_group"]
    
    # 5. 发送定向通知
    NotificationService.send(
        target_groups, 
        "Workshop操作完成通知", 
        generate_notification_content(original_workshop)
    )

注意事项 #

• 属性对比准确性：针对日期、枚举等特殊类型，要使用对应的对比逻辑，避免因类型差异导致的误判。
• 复杂属性处理：如果目标属性是嵌套对象或数组，需要递归对比内部值的变化，不能直接对比对象引用或数组整体。
• 事务一致性：把属性快照获取、对象更新、通知发送放在同一个事务中，避免数据不一致引发错误通知。
• 规则可配置化：建议将「属性-用户组」的路由规则存储在数据库或配置文件中，不要硬编码，方便后续调整。

内容的提问来源于stack exchange，提问作者Max Magid