LoonFlow工单系统中通知模板获取审批状态的实现方法

在LoonFlow工单系统(v2.0.19版本)的实际使用过程中，许多开发者会遇到一个常见需求：希望在发送通知时能够在模板中显示当前审批流程的状态名称。这是一个非常合理的需求，因为状态名称比状态ID对用户来说更加直观和友好。

当前系统限制分析

LoonFlow的通知模板系统目前支持两类字段的引用：

1. 基础字段：直接来自工单基础表的字段，包括但不限于：

   • 工单编号(sn)
   • 工单标题(title)
   • 创建时间(gmt_created)
   • 创建者(creator)
   • 状态ID(state_id)等

2. 自定义字段：工单中定义的自定义字段，但需要注意：

   • 只能获取字段的原始值
   • 对于选项类型字段，获取的是存储值而非显示值
   • 例如一个选项字段country{"1":"国家A", "2":"国家B"}，获取的是"1"而非"国家A"

问题根源

当开发者尝试在模板中使用state_name时，系统会抛出KeyError: 'state_name'错误，这是因为状态名称并非直接存储在工单基础表中，而是需要通过状态ID关联查询获取。

解决方案

要实现通知模板中显示状态名称，需要修改系统的任务处理方法。具体来说，需要修改tasks.send_ticket_notice方法，在该方法中添加状态名称的查询逻辑。

实现思路如下：

1. 在发送通知前，先根据工单的state_id查询对应的状态名称
2. 将状态名称添加到模板变量上下文中
3. 这样在模板中就可以使用状态名称变量了

扩展建议

对于更完善的实现，可以考虑以下增强功能：

1. 支持关联字段显示值：不仅限于状态名称，还可以支持其他关联字段的显示值
2. 模板变量缓存：对于频繁使用的模板变量，可以加入缓存机制提高性能
3. 模板调试模式：提供模板变量调试功能，方便开发者查看可用变量

总结

LoonFlow作为一个开源的工单系统，提供了灵活的工单流转功能。虽然当前版本的通知模板系统在状态名称显示上存在一定限制，但通过适当的方法修改，开发者完全可以实现这一常见需求。理解系统的数据结构和模板机制，是进行此类定制开发的关键。