组态事件与脚本
一、功能用途
组态事件用于让画面具备交互能力，例如点击按钮下发指令、切换页面、显示弹窗、执行脚本、控制组件显隐或联动多个组件。
二、事件类型
| 类型 | 用途 | 示例 |
|---|---|---|
| 点击事件 | 用户点击组件时执行动作 | 打开弹窗、下发开关 |
| 页面跳转 | 跳转到其他组态或系统页面 | 设备详情、告警页面 |
| 变量联动 | 根据变量值改变组件状态 | 温度超限变红 |
| 分组控制 | 显示/隐藏一组组件 | 切换工艺段 |
| 脚本事件 | 执行自定义逻辑 | 计算、格式化、条件判断 |
| 视频事件 | 选择通道或播放流 | 切换摄像头 |
三、配置建议
1. 控制类事件
控制类事件会影响真实设备，应满足：
- 有明确按钮文案或图标。
- 危险操作需要二次确认。
- 下发值与物模型数据类型一致。
- 设备离线时有明确提示。
- 下发后等待设备回传刷新状态。
2. 跳转类事件
跳转事件建议只用于高频操作入口。跳转目标应稳定，避免依赖临时页面或测试地址。
3. 脚本类事件
脚本适合处理展示逻辑，不建议承载关键业务规则。关键业务规则应优先放在规则引擎或后端服务中。
四、显隐与分组
复杂组态页面建议使用分组管理：
| 场景 | 做法 |
|---|---|
| 多工艺段切换 | 每个工艺段一个分组，按钮控制显隐 |
| 弹窗面板 | 弹窗内容独立分组，默认隐藏 |
| 权限差异 | 不同角色展示不同分组 |
| 移动端适配 | PC 和移动端组件分组管理 |
分组命名应体现业务含义，例如 泵站详情弹窗、视频监控区、移动端控制区。
五、脚本维护规范
- 脚本只处理当前页面展示和交互。
- 命名清晰，避免魔法值。
- 对空值、离线值、异常值做保护。
- 不在脚本中写敏感信息。
- 复杂计算要写备注。
- 上线前用不同设备状态测试。
六、常见问题
点击没有反应
检查组件是否被上层元素遮挡、事件是否启用、目标组件或变量是否存在。
下发成功但状态没变化
检查设备端是否回传结果，平台状态通常依赖设备上报刷新。
脚本报错
检查变量是否为空、字段名是否变更、组件 ID 是否变化、脚本是否依赖浏览器不支持的语法。
显隐错乱
检查组件分组是否重复、事件顺序是否冲突、默认状态是否正确。