本文档面向现场运维与实施工程师,说明 viSCADA 升级至 1.7.2 版本后执行历史数据补点的前置条件、核心参数与标准操作流程。阅读本文后,你将能够完成脚本备份与恢复、校验关键配置项,并通过单设备类参数精确控制补点范围。
1 适用前提
| 项目 | 要求 |
|---|---|
| viSCADA 版本 | 1.7.2 及以上 |
| 数据存储版本 | v2 |
| 操作角色 | 具备设备类管理权限的后台运维人员 |
⚠️ 仅升级场景需要补点:现场若自 1.7.2 之后全新部署,无需执行本文第 4 节的补点操作流程,直接依据第 3 节配置参数即可。
图 1 viSCADA 版本信息查看界面
图 2 数据存储版本(v2)确认界面
2 版本迭代记录
| 版本号 | 发布日期 |
|---|---|
| v1.7.3 | 2026-01-29 |
| v1.7.2 | 2026-01-14 |
| v1.7.1 | 2025-12-30 |
| v1.7.0 | 2025-12-12 |
| v1.6.5 | 2025-11-27 |
| v1.6.4 | 2025-11-13 |
💡 本文操作基于 v1.7.2 作为最低支持版本。若现场版本低于 1.7.2,请先完成版本升级再执行补点。
3 数据补点核心配置参数
| 配置项 | 取值 / 状态 | 说明 |
|---|---|---|
数据收集间隔(s) | 自定义输入 | 需在系统中手动配置具体数值 |
补工况时间(h) | 24 | 通用默认值,留空时自动填充为 24 |
通用补工况时间(h) | 24 | 需与「补工况时间」保持一致 |
图 3 「补工况时间」与「通用补工况时间」配置入口
📌 参数一致性要求:
补工况时间与通用补工况时间必须保持相同取值,否则可能出现补点范围不一致的问题。
4 补点操作流程
4.1 流程总览
4.2 操作步骤
步骤 1:备份原有脚本
在执行脚本重置前,定位目标设备类对应的「数据对接脚本」,完整复制脚本内容并备份。
💡 备份建议:通过系统导出功能或本地文档留存,并标注备份时间 + 设备类 ID,便于后续追溯。
步骤 2:执行脚本重置
登录系统后台,依次进入:
设备类 → 对接配置 → 重置脚本点击**「确认重置」** 完成操作。
⚠️ 操作中断风险:重置过程中请勿关闭页面,避免操作中断导致脚本状态不一致。
步骤 3:恢复备份脚本
重置完成后,打开设备类脚本编辑区,将备份内容完整粘贴至编辑区。粘贴后需确认:
- 脚本内容无遗漏
- 无格式错误(缩进、换行、特殊字符等)
步骤 4:校验关键配置项
在脚本编辑区或对应配置页面,核查 order 1450 配置项是否存在。
| 校验结果 | 处理方式 |
|---|---|
| 存在 | 无需操作,继续后续流程 |
| 缺失 | 按系统默认规则或项目要求补全,确保补点逻辑正常触发 |
图 4 补时间脚本编辑区示例,含 order 1450 配置项
5 单设备类补点启停控制
通过 commonIncludeSupplyTime 参数可以在单个设备类维度精确控制补点功能,其优先级高于全局补点配置。
5.1 参数规格
| 属性 | 取值 |
|---|---|
| 参数名 | commonIncludeSupplyTime |
| 取值范围 | true / false |
| 默认值 | true(开启补点) |
| 作用范围 | 单个设备类 |
| 优先级 | 高于全局补点配置 |
5.2 取值行为
| 取值 | 行为 |
|---|---|
true | 该设备类执行历史数据补点(默认) |
false | 该设备类不执行历史数据补点 |
图 5 commonIncludeSupplyTime 参数配置界面示意
📌 使用场景:当全局补点已开启,但某些设备类因数据质量或业务原因需要排除补点时,将该设备类的
commonIncludeSupplyTime设为false即可单独关闭。
6 常见问题
| 问题 | 可能原因 | 处理建议 |
|---|---|---|
| 补点未触发 | order 1450 配置缺失 | 按步骤 4 校验并补全 |
| 部分设备类未补点 | commonIncludeSupplyTime = false | 确认该参数取值,需要补点则改为 true |
| 补点范围异常 | 补工况时间 与 通用补工况时间 不一致 | 统一两个参数取值 |
| 脚本重置后功能异常 | 备份脚本未完整粘贴或含格式错误 | 重新从备份源完整复制粘贴 |
| 版本低于 1.7.2 无法补点 | 系统版本不满足前提 | 先升级 viSCADA 至 1.7.2 及以上 |