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

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

2025-07-05 04:50:26作者:晏闻田Solitary

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

登录后查看全文
热门项目推荐
相关项目推荐