版本: v1.0 修改日期: 2026-05-29 版本： v1.0

本文说明历史数据补点的适用前提、核心参数及标准操作流程。完成本文操作后，可实现脚本备份与恢复、关键配置项校验，并可通过单设备类参数精确控制补点范围。

1 适用前提

⚠️ 仅升级场景需要执行补点：
若现场系统为 1.7.2 及之后版本的全新部署，无需执行本文第 4 节“补点操作流程”；仅需按第 3 节完成参数配置即可。

图 1 viSCADA 版本信息查看界面

图 2 数据存储版本（v2）确认界面

2 版本迭代记录

💡 若现场版本低于 1.7.2，请先完成版本升级，再执行历史数据补点。

3 历史数据补点核心配置参数

图 3 “补工况时间”与“通用补工况时间”配置入口

4 补点操作流程

4.1 流程总览

4.2 操作步骤

步骤 1：备份原有脚本

执行脚本重置前，先定位目标设备类对应的“数据对接脚本”，并完整复制脚本内容进行备份。

💡 备份建议： 建议通过系统导出功能或本地文档保存脚本内容，并标注“备份时间 + 设备类 ID”，便于后续追溯与恢复。

步骤 2：执行脚本重置

登录系统后台，依次进入：

设备类 → 对接配置 → 重置脚本

点击**“确认重置”**完成操作。

⚠️ 注意： 重置过程中请勿关闭页面或中断操作，以免导致脚本状态异常或内容不一致。

步骤 3：恢复备份脚本

重置完成后，进入设备类脚本编辑区，将备份的脚本内容完整粘贴回编辑区。粘贴完成后需确认：

• 脚本内容完整无遗漏
• 缩进、换行、特殊字符等格式正确
• 无粘贴错位或内容截断

步骤 4：校验关键配置项

在脚本编辑区或对应配置页面，检查 order 1450 配置项是否存在。

图 4 补点脚本编辑区示例，包含 order 1450 配置项

5 单设备类补点启停控制

通过 commonIncludeSupplyTime 参数，可在单个设备类维度精确控制历史数据补点功能，其优先级高于全局补点配置。

5.1 参数规格

5.2 取值行为

图 5 commonIncludeSupplyTime 参数配置界面示意

📌 适用场景：
当全局补点功能已开启，但部分设备类因数据质量、业务规则或项目要求不需要补点时，可将该设备类的 commonIncludeSupplyTime 设置为 false，以单独关闭其补点能力。

6 常见问题