更新时间:2023-03-01 GMT+08:00

导入导出设备

概述

ROMA Connect支持导入导出设备,可以把设备以文件形式导出到本地,也可以把本地的设备文件导入ROMA Connect,实现设备信息的批量迁移。

前提条件

  • 导入设备前,请确保设备所属的集成应用已创建,否则请提前创建集成应用
  • 导入设备前,请确保设备所属的产品已创建,否则请提前创建产品
  • 导入设备前,请检查导入设备的实例中是否存在重名设备,若存在重名设备,会导致导入设备失败。
  • 导入设备前,请确保设备的配额满足需求。
  • 导入文件格式为csv,并需要使用UTF-8 BOM编码。
  • 在使用导出的文件导入设备时:
    • 如果要新增设备,则需要另外新建导入文件,并在新建的文件中添加新的设备信息。

      设备导入文件中表头的名称和顺序固定不能更改,表头名称请参考设备导入文件说明

    • 确认导入文件是否从老版本实例中导出:打开导入文件,查看是否存在“Base64:”开头的字段值。如果没有“Base64:”开头的字段值,则说明是老版本实例导出的文件。

      如果是老版本实例导出的文件,需要重命名文件,在文件名后添加“-none-base64-prefix”,例如原文件名为“import.csv”,则需要重命名为“import-none-base64-prefix.csv”。

  • 若使用Excel工具编辑导入文件,在编辑完成后需要按如下操作保存。
    1. 在Excel中保存时,以另存的方式保存为“CSV(逗号分隔)(*.csv)”类型文件。
    2. 使用文本编辑器打开1中保存的csv格式文件,并再次另存,另存时编码选择“带有 BOM 的 UTF-8”,保存后即得到最终的csv格式导入文件。

导入设备

  1. 登录ROMA Connect控制台,在“实例”页面单击实例上的“查看控制台”,进入实例控制台。
  2. 在左侧的导航栏选择“设备集成 LINK > 设备管理”,在“设备”页签中单击“导入设备”。
  3. 在弹窗中选择本地保存的设备文件,并导入。
  4. 导入成功后,在页面的设备列表中可查看导入的设备。

导出设备

  1. 登录ROMA Connect控制台,在“实例”页面单击实例上的“查看控制台”,进入实例控制台。
  2. 在左侧的导航栏选择“设备集成 LINK > 设备管理”。
  3. 导出设备。
    • 导出指定设备:勾选您想要导出的设备,然后单击“导出”,导出设备文件到本地。
    • 导出所有设备:单击“导出所有设备”,导出设备文件到本地。

设备导入文件说明

设备的导入文件内容要求见表1
表1 设备导入文件内容说明

列名

描述

取值要求

DeviceName

设备名称。

必填,复杂度要求与页面创建相同。

ProductSerial

设备所属产品的产品标识。

必填,产品标识应已存在。

ParentDeviceClient

设备所属网关设备的客户端ID。

选填,网关设备应已存在。

ClientID

客户端ID。

选填。

DeviceIdentifier

设备标识。

必填,复杂度要求与页面创建相同。

Username

用户名。

选填。

Password

密码。

选填,复杂度要求与页面创建相同。

DeviceType

设备类型。

必填,根据所属产品的协议类型决定。

  • MQTT:COMMON。
  • Modbus:MODBUS。
  • OPC UA:OPCUA。

Remark

设备描述。

选填。

customTopic

自定义topic。

选填,建议在页面创建。

  • 发布权限的TOPIC格式为:产品标识/out/设备标识/TOPIC名称。
  • 订阅权限的TOPIC格式为:产品标识/in/设备标识/TOPIC名称。

多个TOPIC之间使用英文分号分隔。

Enable

设备状态。

必填,启用:0,禁用:1。