FIR项目通知模板中的动态变量使用指南

FIR作为一款优秀的事件响应管理工具，其通知系统支持通过动态变量实现个性化消息推送。本文将深入解析FIR通知模板中可用的变量及其应用场景。

核心变量解析

FIR的通知模板系统基于Django模板引擎构建，主要提供两类上下文变量：

1. 事件对象变量
   当新事件创建时，模板中的instance变量指向Incident模型实例，可调用以下属性：

   • instance.id：事件唯一标识符
   • instance.subject：事件主题
   • instance.description：事件描述详情
   • instance.severity：严重程度等级
   • instance.category：分类对象（可进一步访问is_major等子属性）
   • instance.date：事件发生时间
   • instance.detection：检测方式

2. 评论对象变量
   当添加评论时，instance变量指向Comment模型实例，包含：

   • instance.comment：评论正文内容
   • instance.action：关联操作类型
   • instance.opened_by：评论创建者（注意变量名非author）
   • instance.incident.id：关联事件的ID

高级应用技巧

1. 深度属性访问
   对于外键关联的对象，支持链式访问。例如通过instance.category.is_major可以获取该分类是否被标记为主要分类。

2. URL动态生成
   在模板中可直接构造事件详情页链接：

   https://your-domain/incidents/{{instance.id}}/  # 事件通知
   https://your-domain/incidents/{{instance.incident.id}}/  # 评论通知
   

3. 多场景适配
   建议为不同类型通知创建独立模板：

   • 事件创建通知：突出显示subject和severity
   • 评论通知：强调comment和action字段
   • 状态变更通知：结合detection和category信息

最佳实践建议

1. 在管理后台的"Notification templates"界面进行模板配置时，建议先测试简单变量如{{instance.id}}，确认通道正常后再逐步添加复杂逻辑。

2. 对于关键业务通知，建议包含以下要素：

   [{{instance.category}}] {{instance.subject}}
   事件ID：{{instance.id}}
   处理链接：https://your-domain/incidents/{{instance.id}}/
   

3. 注意评论通知中需要使用instance.incident.id来获取关联事件ID，这是与事件通知的重要区别。

通过合理运用这些动态变量，可以显著提升通知信息的实用性和可操作性，使团队成员能够快速定位事件并采取相应措施。