6.1 事件模板
事件模板定义了事件的架构和行为。分析生成的每个事件都必须基于某个事件模板。模板在基础库 → 事件模板中集中管理，可被系统中任意分析复用。
6.1.1 创建事件模板
事件模板在基础库中集中管理，支持被系统中的任意分析引用。创建新事件模板的步骤：
- 在左侧导航中进入基础库 → 事件模板。
- 点击 +（新建事件模板）按钮。
- 配置模板字段（见下文）。
- 点击保存。
6.1.2 模板配置
事件模板的配置包括基本设置、事件命名规则和模板继承三个部分，用于定义事件的标识信息、命名方式及模板间的层次关系。
6.1.2.1 基本设置
以下字段用于定义事件模板的基本属性和行为规则。
| 字段 | 说明 |
|---|---|
| 名称 | 模板的唯一标识符 |
| 分类 | 用于组织模板的标签（例如"基础模板"或自定义分类） |
| 仅作为基础模板 | 启用后，该模板不能直接用于创建事件，只能作为其他模板的父模板 |
| 严重程度 | 由此模板创建的事件的默认严重等级：严重、主要、次要、警告或常规 |
| 允许扩展 | 启用后，其他模板可继承此模板 |
| 允许确认 | 启用后，由此模板创建的事件需要人工确认。未确认的活动事件将按照元素通知规则继续触发重新通知 |
| 原因代码 | 对事件原因进行分类的可选枚举集，需提前在基础库 → 枚举集中定义 |
| 原因代码值 | 原因代码枚举集中的某个具体值，提供更详细的原因描述 |
| 事件间通知最小发送间隔 | 同一分析产生的事件之间发送通知的最小时间间隔。防止分析频繁触发事件时产生通知过载——例如设置为 20 分钟后，无论触发多少次事件，每 20 分钟窗口内只发送一条通知 |
| 描述 | 模板用途的自由文本描述 |
6.1.2.2 事件命名规则
由模板生成的每个事件名称由事件命名规则构建。在字段中输入静态文本，并通过点击右侧的 + 图标插入占位变量。可用变量包括：
| 变量 | 说明 |
|---|---|
${Element#name} | 触发事件的元素名称 |
${Analysis#name} | 触发事件的分析名称 |
${EventTemplate#name} | 事件模板名称 |
${startTime} | 事件开始时间 |
${endTime} | 事件结束时间 |
${createTime} | 事件创建时间 |
${attributes["AttrName"]#value} | 元素属性的当前值。AttrName 为占位符，必须手动替换为元素上实际存在的属性名称。例如，若元素包含名为 location 的属性，则写为 ${attributes["location"]#value}，系统在生成事件时会将其解析为该属性的实际值。 |
建议在命名规则中包含元素名称、分析名称和开始时间，使每个事件名称都具有自描述性：${Element#name} - ${Analysis#name} - ${startTime}。
6.1.2.3 模板继承
事件模板支持层次化继承机制，子模板可基于父模板的配置进行扩展和定制。创建模板时，可选择基础模板，新模板将继承其配置。子模板可在基础模板属性架构的基础上进行扩展，并覆盖个别设置。
若模板标记为仅作为基础模板，则在配置分析时无法直接引用，只能作为父模板使用。
6.1.3 事件属性模板
事件属性模板用于定义事件可携带的自定义属性，以记录事件发生时的关键数据——例如超限期间的峰值温度或故障时的批次 ID。这些属性在事件模板编辑器的事件属性模板部分定义。
每个属性的配置项如下：
| 字段 | 说明 |
|---|---|
| 名称 | 属性名称 |
| 分类 | 可选标签 |
| 数据类型 | 值的类型（数值、字符串等） |
| 默认值 | 分析未写入此属性时使用的值 |
| 常量 | 启用后，值在创建后不可修改 |
| 隐藏 | 启用后，属性在普通事件视图中不显示 |
配置分析时，计算输出可写入事件模板中定义的任意属性。该功能支持将计算值——例如窗口期间的平均值或最大超限值——直接捕获到事件记录中。
提示
事件属性数据存储在 TDengine IDMP 内置关系数据库中，而非时序存储中。事件属性不支持数据引用配置。
6.1.4 管理事件模板
基础库 → 事件模板列表集中展示所有模板及其名称、分类、严重程度和描述信息，支持对模板进行编辑和删除操作。使用每行右侧的操作图标可以：
- 编辑 — 修改模板配置
- 删除 — 删除模板（仅在没有分析引用该模板时才能删除）
