模板制作与传参：从可复用组件到页面通信

参数类型与适用场景

按确定值的时机选择机制：实例设备地址用模板变量；运行页临时输入用 Input 或 Runtime Variable；打开页面或弹窗时的上下文用页面参数。

• 模板实例变量：插入模板后填写，例如 <PLC>、<RUN_TAG>；适合同一设备画面复用到不同点位。
• Input 模板值：由操作员在运行页输入，通过 template.getValue("实例名") 读取。
• Runtime Variable：当前运行页面内共享的临时状态，适合同页组件联动。
• 页面 / 弹窗参数：打开目标页时发送，由目标页 GetPageParameter* 读取。
• PLC Tag：设备数据绑定；不同页面可以读取同一 Tag，但它不是页面传参。

• 动手练习：复用方式与参数

1. 从零制作一个带参数的模板

绘制外观、文字并配置行为，将需共同复用的对象组合。把实例差异改为尖括号占位符，固定内容保留。占位符可用于文本、Tag 字段和脚本字符串；脚本中须放在字符串字面量内。

• 普通文本：设备 <DEVICE_NO>。
• Tag 路径：<PLC>.<RUN_TAG>。
• 脚本字符串：ReadTagBoolean("<PLC>.<RUN_TAG>", false)。
• 位引用：<STATUS_TAG>[3]；位号放在占位符外。
• 只把确实因实例而变化的内容做成变量，避免 Template Edit 出现大量无意义字段。

// 运行状态与报警状态都随实例变化
var running = ReadTagBoolean("<PLC>.<RUN_TAG>", false);
var alarming = GetAlarmTags([
  "<PLC>.<ALARM_TAG>"
]);

return running && !alarming;

6. 报警模板的显示列与筛选范围

报警模板既要决定显示哪些列，也要限定显示哪些报警。先勾选 Time、Message、Level、PLC、Function Group、Device Group、Signal Group、Tags、Status、Acknowledged 中实际需要的列，再按项目编码填写筛选范围。多个值可用逗号或换行分隔，字段应填编码而不是界面显示名称。

• Tags：完整 device-code.tag-code，例如 <PLC>.<ALARM_TAG>。
• PLC codes：只填 device-code，例如 <PLC>。
• Function groups：device-code.group-code。
• Device groups：device-code.group-code。
• Signal groups：device-code.group-code。
• 留空的筛选维度不额外限制范围；导出后用一条已知活动报警验证。

7. 在模板脚本中判断活动报警

报警判断方法返回 true / false，表示是否存在匹配范围的活动报警，可驱动图标、颜色或文字。参数接受数组或逗号、换行分隔文本；不查询历史或执行确认。

• GetAlarmTags(values)：按完整 Tag 范围判断。
• GetAlarmPlcCodes(values)：按 PLC / 设备编码判断。
• GetAlarmFunctionGroupCodes(values)：按功能组编码判断。
• GetAlarmDeviceGroupCodes(values)：按设备组编码判断。
• GetAlarmSignalGroupCodes(values)：按信号组编码判断。

var hasTagAlarm = GetAlarmTags([
  "<PLC>.<ALARM_TAG>"
]);

var hasDeviceAlarm = GetAlarmDeviceGroupCodes([
  "<PLC>.<DEVICE_GROUP>"
]);

return hasTagAlarm || hasDeviceAlarm;