Skip to Content

本文档面向现场运维与实施工程师,说明 viSCADA 升级至 1.7.2 版本后执行历史数据补点的前置条件、核心参数与标准操作流程。阅读本文后,你将能够完成脚本备份与恢复、校验关键配置项,并通过单设备类参数精确控制补点范围。

1 适用前提

项目要求
viSCADA 版本1.7.2 及以上
数据存储版本v2
操作角色具备设备类管理权限的后台运维人员

⚠️ 仅升级场景需要补点:现场若自 1.7.2 之后全新部署,无需执行本文第 4 节的补点操作流程,直接依据第 3 节配置参数即可。

viSCADA 版本信息示意 图 1 viSCADA 版本信息查看界面

数据存储版本查看 图 2 数据存储版本(v2)确认界面

2 版本迭代记录

版本号发布日期
v1.7.32026-01-29
v1.7.22026-01-14
v1.7.12025-12-30
v1.7.02025-12-12
v1.6.52025-11-27
v1.6.42025-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 及以上