批量导入点位
用一份 JSON 在系统间迁移整台设备,或把 Kepware、TIA Portal、GX Works 等工程软件导出的点表直接导入,也可以在类 Excel 网格里成批录入。
视频教程 · 灵犀·Studio 从入门到精通 · 第 4 集 6:21
点位配置与批量导入
你将完成
读完本篇你将完成:
- 把本系统导出的设备 JSON 原样导入(迁移、备份、跨环境复制);
- 用厂商工程软件(Kepware / TIA Portal / GX Works 等)导出的点表文件批量建点;
- 在类 Excel 网格里粘贴整片单元格批量录入;
- 处理导入报错:地址换算失败、类型识别、重名。
开始之前
- 已完成配置采集点位,知道测点组、数据类型、地址写法;
- 准备好点表文件(CSV / Excel / 各工程软件导出),或从 Excel 复制的整片单元格。
四种导入方式怎么选#
| 方式 | 适用场景 | 入口 |
|---|---|---|
| 设备 JSON | 本系统导出的整台设备(含连接参数与测点组),跨环境迁移 | 树顶部 导入设备 JSON |
| 多格式点表 | Kepware、TIA Portal、GX Works、组态王等工程软件导出文件 | 树顶部 导入设备 JSON 或设备右键 导入测点 (多格式) |
| Excel 网格 | 手头只有纸面 / Excel 点表,逐格录入或整列粘贴 | 设备右键 Excel 批量录入测点 |
| 套用模板 | 按既有模板一次建好设备 + 全部测点组 | 树顶部 套用模板 |
打开导入对话框#
点树顶部 导入设备 JSON 图标按钮,先选数据来源格式:
- 1本系统导出
- 2表格粘贴
- 3各厂商工程软件的点表格式可直接导入,无需手工转换
10 种格式覆盖了主流工程软件:本项目设备 JSON、通用测点表(CSV / Excel)、Kepware、西门子 TIA Portal、三菱 GX Works、欧姆龙 CX、罗克韦尔 AB、Modbus Poll、组态王、OPC UA NodeSet。
导入一份点表文件#
选 通用测点表 后,可以直接选文件,也可以把 Excel 里一片单元格(含表头)复制粘贴进来,点 解析粘贴内容:
- 1来源格式
- 2确认导入
表头按列名自动识别,中英文别名都可以:
| 列 | 识别的表头(部分) | 必填 |
|---|---|---|
| 名称 | 变量名 / 名称 / 点名 / 位号 / 测点 | 是 |
| 地址 | 地址 / 寄存器 / 寄存器地址 | 是 |
| 数据类型 | 数据类型 / 类型 / 格式 | 否,识别不出按 Int16 |
| 单位 | 单位 / 工程单位 | 否 |
| 分组 | 分组 / 组 / 测点组 / 分类 | 否,默认「导入测点」 |
| 描述 | 描述 / 注释 / 备注 / 说明 | 否 |
地址两种写法都认
40001 这类 Modicon 地址会自动换算成系统内部地址(换算依赖目标设备的「地址从 0 开始」属性,所以导入到具体设备最稳);x=4;100、%MW10 这类写法原样保留。
预览确认后选 导入到现有设备(下拉里挑目标)或 新建设备,点 应用导入。导入只写入本地编辑,顶部出现「配置发生变更,下发后生效」,点 下发 才开始采集。
在 Excel 网格里批量录入#
设备右键 → Excel 批量录入测点,打开类 Excel 网格:
- 1下载模板
- 2加行
七列依次是:分组、测点名、地址、数据类型、单位、间隔ms、描述。工具栏常用操作:从设备载入(把设备已有点拉回来改)、+10 行、下载 CSV(当模板分发)、连续寄存器合并(把相邻寄存器并成一次读)。填完点 应用到设备(N 点)。
套用模板一次建好设备与点位#
点树顶部 套用模板,选一个设备模板(内置 Modbus-TCP / 西门子 S7-1500 / 电表 Modbus-RTU 等,也可以在 采集系统 → 设备模板 里自建),下一步填新设备的 IP / 串口等参数,点 套用并创建:
- 1选模板
预期结果
树里出现新设备,测点组与测点已按模板建好;顶部提示待下发,点 下发 后开始采集。
导出#
- 树顶部 导出全部 JSON:全部设备 + 测点组,文件名
iiot-devices-{时间戳}.json; - 设备右键 导出该设备为 JSON:单台迁移用;分类右键 导出该分类为 JSON。
导出文件可在另一套环境里用「本项目设备 JSON」导入,重复的设备 id 会自动加后缀,不会覆盖。
常见错误与处理#
| 提示 | 原因 | 处理 |
|---|---|---|
暂不支持旧版 .xls 二进制格式 | 文件是 Excel 97-2003 格式 | 在 Excel 里另存为 .xlsx 或 .csv |
未能识别测点表头 (缺少 名称/地址 列) | 表头行不含名称、地址列 | 表头改成「名称 / 地址」等可识别写法 |
N 个测点地址无法换算为采集网关地址 | Modicon 地址与目标设备属性对不上,或写了位 / 字符串后缀 | 导入到具体设备(而非模板 / 新建);或把地址改成 x=4;100 写法 |
输入寄存器是只读区, 不能生成写请求 | 点表里对 3x / 1x 区给了写请求 | 删掉写列,或把该行导入为只读点 |
| 某些点数据类型变成 Int16 | 类型列写法识别不出,按默认值兜底(不丢点) | 把类型列写成 Int16 / Float / Bool 等标准名重新导 |
重名点位自动变成 X_2、X_3 | 同设备内重名,自动加后缀 | 接受后缀,或改源文件里的点名 |
下一步#
这篇文档对你有帮助吗?