批量导入点位

用一份 JSON 在系统间迁移整台设备,或把 Kepware、TIA Portal、GX Works 等工程软件导出的点表直接导入,也可以在类 Excel 网格里成批录入。

  • 进阶
  • 动手约 12 分钟
  • 阅读 3 分钟
  • 更新于 2026-11-09

视频教程 · 灵犀·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 图标按钮,先选数据来源格式:

导入设备 / 测点:先选来源格式,共 10 种
  1. 1本系统导出
  2. 2表格粘贴
  3. 3各厂商工程软件的点表格式可直接导入,无需手工转换

10 种格式覆盖了主流工程软件:本项目设备 JSON、通用测点表(CSV / Excel)、Kepware、西门子 TIA Portal、三菱 GX Works、欧姆龙 CX、罗克韦尔 AB、Modbus Poll、组态王、OPC UA NodeSet。

导入一份点表文件#

选 通用测点表 后,可以直接选文件,也可以把 Excel 里一片单元格(含表头)复制粘贴进来,点 解析粘贴内容:

解析后的预览:统计 + 前 200 条明细,确认无误再应用
  1. 1来源格式
  2. 2确认导入

表头按列名自动识别,中英文别名都可以:

列识别的表头(部分)必填
名称变量名 / 名称 / 点名 / 位号 / 测点是
地址地址 / 寄存器 / 寄存器地址是
数据类型数据类型 / 类型 / 格式否,识别不出按 Int16
单位单位 / 工程单位否
分组分组 / 组 / 测点组 / 分类否,默认「导入测点」
描述描述 / 注释 / 备注 / 说明否

地址两种写法都认

40001 这类 Modicon 地址会自动换算成系统内部地址(换算依赖目标设备的「地址从 0 开始」属性,所以导入到具体设备最稳);x=4;100、%MW10 这类写法原样保留。

预览确认后选 导入到现有设备(下拉里挑目标)或 新建设备,点 应用导入。导入只写入本地编辑,顶部出现「配置发生变更,下发后生效」,点 下发 才开始采集。

在 Excel 网格里批量录入#

设备右键 → Excel 批量录入测点,打开类 Excel 网格:

Excel 批量录入:可直接从 Excel 粘贴整列,右下角拖拽填充
  1. 1下载模板
  2. 2加行

七列依次是:分组、测点名、地址、数据类型、单位、间隔ms、描述。工具栏常用操作:从设备载入(把设备已有点拉回来改)、+10 行、下载 CSV(当模板分发)、连续寄存器合并(把相邻寄存器并成一次读)。填完点 应用到设备(N 点)。

套用模板一次建好设备与点位#

点树顶部 套用模板,选一个设备模板(内置 Modbus-TCP / 西门子 S7-1500 / 电表 Modbus-RTU 等,也可以在 采集系统 → 设备模板 里自建),下一步填新设备的 IP / 串口等参数,点 套用并创建:

套用模板:模板沉淀「协议 + 参数 + 测点组」,同类设备一次成型
  1. 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同设备内重名,自动加后缀接受后缀,或改源文件里的点名

下一步#

这篇文档对你有帮助吗?