Alarms
创建新的报警项 (Creating a New Alarm)
在定义一个新的报警项时,需要配置以下字段:
| 字段 | 描述 |
|---|---|
msgId |
报警的唯一数值标识符。这是系统主要的引用键。 |
Category |
定义报警的类型/严重程度,包括以下选项: |
- Warning – 非关键性问题,仅作提示。 |
|
- Error – 标准错误,需要用户关注。 |
|
- Information – 仅用于信息展示,不需要操作。 |
|
- Error without confirmation – 无需用户确认的错误。 |
|
Title |
当报警激活时显示的文本内容。用于提示用户发生的事件。 |
Title Inactive |
可选字段。当报警未激活但尚未确认时显示。用于在事件结束后继续提示发生过的状态。 |
标题格式与占位符使用 (Title Formatting and Placeholders)
Title 和 Title Inactive 字段支持动态内容和多语言翻译,具体语法如下:
1. 翻译键格式({{placeholder}})
标题中用双大括号 {{ }} 包裹的部分将被视为翻译键。
示例标题:
{{over_temperature}} on line %p%!
这将从翻译字典中获取 "over_temperature" 的对应本地化文本。
2. 值占位符(%p%)
标题中最多可以使用 5 个 %p% 占位符。
这些占位符在报警触发时会由 PLC 代码中传入的参数动态替换。
参数通过 CODESYS 中的 setActive 或 manage 方法传递:
setActive(msgId, param1, param2, param3, param4, param5, trans1, trans2, trans3, trans4, trans5, moduleId)
示例标题:
{{sensor_failure}} on unit %p%, value %p%
最终显示可能为:
Sensor Failure on unit 3, value 78.4
3. 翻译占位符(%t%)
%t% 占位符用于插入翻译字符串,与 %p% 类似,但专用于翻译键。
你最多可以传入 5 个 %t% 值,系统会在运行时使用翻译字典进行查找:
示例:
%t% alarm on %p%
如果 %t% = "low_pressure",翻译后为:
最终标题:
Low Pressure alarm on Zone 1
setActive(msgId, param1, param2, param3, param4, param5, trans1, trans2, trans3, trans4, trans5, moduleId)
manage
setActive
%p%
{{over_temperature}} on line %p%!
{{ }}
Title Inactive
Title
Title Inactive
Title
Error without confirmation
Information
Error
Warning
Category
msgId