版本: v1.0 修改日期: 2026-05-29 完成后你将能做到：从 viSCADA 导出三类核心数据，填入北向对接模板，通过校验后交付技术团队。
阅读路径：准备工作（第 2 节）→ 导出数据（第 4 节）→ 填入模板（第 5 节）→ 校验提交（第 7 节）。
1 你需要整理哪三类数据
北向对接需提交一份标准 Excel 文件，包含以下三类数据：
| 数据类型 | 核心字段 |
|---|---|
| 设备基础信息 | 设备标识、设备名称、设备类标识、设备类名称 |
| 设备类信息 | 设备类标识、设备类名称 |
| 设备类物模型属性 | 标准化名称、属性名称、单位、数据类型、读写模式 |
交付文件命名规范：
项目名称_viSCADA北向对接数据_YYYYMMDD.xlsx示例：XX 能源站_viSCADA 北向对接数据_20260327.xlsx
2 开始前的准备
2.1 确认账号权限
当前账号需具备：
- 设备列表查看与导出权限
- 设备类查看权限
- 设备类物模型查看权限
2.2 准备好工具
- 可正常访问的 viSCADA 系统账号
- Excel 办公软件
- 官方模板：【附件】viscada-northbound-data-template.xlsx
2.3 整理原则（必读）
⚠️ 以下原则贯穿整个整理过程，违反将导致数据无法通过校验。
- 一台设备仅保留一条唯一记录
- 一个设备类对应一个属性 Sheet
- 设备必须能匹配到设备类；属性必须归属到明确的设备类
- 标准化名称优先参考数仓标准字段
- 系统原生标识字段（设备标识、设备类标识）不得修改
3 操作流程总览
完整流程分三个阶段：导出 → 整理入表 → 校验交付。
导出设备列表（4.1）
→ 补充设备类名称（4.2）
→ 记录设备类列表（4.3）
→ 导出物模型属性（4.4）
→ 填入北向模板（第 5 节）
→ 数据校验（第 7 节）
→ 交付4 导出核心数据
4.1 导出设备列表
路径：登录 viSCADA → 「设备管控」 → 「设备列表」
-
进入「设备列表」页面。
-
按需筛选设备（支持按设备类、通讯协议、在线状态、创建时间等条件）。
-
点击**「导出文件」**，选择导出范围：
选项 说明 导出全部 当前列表全部设备 导出选中 仅勾选的设备 导出筛选结果 当前筛选条件下的设备 -
下载系统生成的 Excel 文件。
图 1 设备列表导出入口
图 2 选择导出范围
图 3 导出结果示例
📌 至少保留「设备标识、设备名称、设备类标识」三列，最终提交以标准字段为准（详见 第 6 章）。
4.2 补充设备类名称
路径：登录 viSCADA → 「设备管控」 → 「设备类」 → 「设备类列表」
- 在导出的设备列表 Excel 中新增一列「设备类名称」。
- 打开系统中的「设备类列表」。
- 按设备类标识逐项匹配对应的设备类名称，回填至 Excel。
图 4 在 Excel 中补充设备类名称
📌 设备类名称必须与系统完全一致，不得缩写或修改；同一设备类标识对应唯一设备类名称。
本步骤建立以下映射链路，缺失将导致后续属性归类与接口对接失败：
设备标识 → 设备名称 → 设备类标识 → 设备类名称4.3 记录设备类列表
路径：登录 viSCADA → 「设备管控」 → 「设备类」 → 「设备类列表」
- 进入「设备类列表」。
- 记录以下字段：设备类标识、设备类名称。
图 5 设备类列表
ℹ️ 设备类是设备数据与物模型属性之间的中间层，属性整理以设备类为单位归类，本步骤数据准确性直接影响交付质量。
4.4 导出物模型属性
路径：登录 viSCADA → 「设备管控」 → 「设备类」 → 选择目标设备类 → 「物模型」
- 在「设备类列表」中选择目标设备类。
- 进入该设备类的「物模型」页面，查看所有属性（字段说明见 6.2 属性表字段规范）。
- 在 Excel 中为每个设备类建立一个独立 Sheet，存放属性数据。
图 6 在设备类列表中选择目标设备类
图 7 设备类物模型属性页面
图 8 每个设备类对应一个独立 Sheet
Sheet 命名规则：
设备类标识_设备类名称示例：S8DRAfbgsb_热泵
5 填写 Excel 模板
5.1 模板结构
| Sheet 类型 | 数量 | 内容 |
|---|---|---|
| 设备总表 | 1 | 所有参与北向对接的设备基础信息 |
| 设备类属性表 | N | 每个设备类一个 Sheet，存放物模型属性 |
5.2 填写设备总表
- 每台设备仅保留一条记录；设备标识必须唯一。
- 设备类标识不能为空；设备类名称必须与设备类标识一一对应。
- 删除空行、重复行、测试垃圾数据。
图 9 设备总表填写示例
5.3 填写属性表
-
一个设备类仅对应一个 Sheet；同一 Sheet 内属性名称不得重复。
-
标准化名称优先采用数仓标准字段；无标准字段时由项目经理统一定义。
-
单位使用规范写法：
物理量 规范单位 温度 ℃压力 MPa流量 t/h电量 kWh -
数据类型统一使用
int/double/string/bool。 -
读写模式统一使用
只读/读写（北向仅需读取时填只读）。
图 10 设备类属性表填写示例
📌 标准化名称含
@后缀时（如m_007qc@20260327），Excel 中仅填写主体m_007qc，@后的后缀在备注列中注明所归属的设备标识或设备名称。
图 11 数据点表的标准化名称处理
6 模板字段规范
6.1 设备总表字段
| 字段名 | 必填 | 说明 | 填写规则 |
|---|---|---|---|
| 设备标识 | 是 | 设备唯一编码 | 取系统导出原生字段，不可修改 |
| 设备名称 | 是 | 设备自定义名称 | 与系统保持一致 |
| 设备类标识 | 是 | 设备类唯一编码 | 取系统原生字段，不可修改 |
| 设备类名称 | 是 | 设备类中文名称 | 按设备类标识匹配填写 |
6.2 属性表字段
| 字段名 | 必填 | 说明 | 填写规则 |
|---|---|---|---|
| 标准化名称 | 是 | 点位标准标识 | 优先参考数仓标准字段；语义明确、命名统一 |
| 属性名称 | 是 | 属性中文名称 | 与系统物模型显示名称一致 |
| 单位 | 否 | 数据单位 | 使用规范写法，如 ℃、MPa、t/h、kWh |
| 数据类型 | 是 | 属性值类型 | 统一填写 int / double / string / bool |
| 读写模式 | 是 | 属性访问方式 | 统一填写 只读 / 读写 |
💡 系统物模型中若已有标准化名称，直接沿用；无明确标准时由项目方统一确认后填写。
7 提交前校验清单
全部通过后方可提交。
| 校验类别 | 检查项 |
|---|---|
| 完整性 | 设备信息、设备类信息、物模型属性完整；必填字段无空值 |
| 唯一性 | 设备标识唯一；设备类标识与名称一一对应；同一设备类内标准化名称不重复 |
| 映射关系 | 每台设备能匹配到设备类；每个设备类能匹配到属性表；Sheet 名称与设备类一致 |
| 格式规范 | 数据类型、单位、读写模式填写统一；Sheet 命名符合 设备类标识_设备类名称 规则 |
⚠️ 校验不通过时，需在交付说明中明确列出所有缺失项与特殊说明项，并附备注。