导入导出设备
概述
ROMA Connect支持导入导出设备,可以把设备以文件形式导出到本地,也可以把本地的设备文件导入ROMA Connect,实现设备信息的批量迁移。
前提条件
- 导入设备前,请确保设备所属的集成应用已创建,否则请提前创建集成应用。
- 导入设备前,请确保设备所属的产品已创建,否则请提前创建产品。
- 导入设备前,请检查导入设备的实例中是否存在重名设备,若存在重名设备,会导致导入设备失败。
- 导入设备前,请确保设备的配额满足需求。
- 导入文件格式为csv,并需要使用UTF-8 BOM编码。
- 在使用导出的文件导入设备时:
- 如果要新增设备,则需要另外新建导入文件,并在新建的文件中添加新的设备信息。
设备导入文件中表头的名称和顺序固定不能更改,表头名称请参考设备导入文件说明。
- 确认导入文件是否从老版本实例中导出:打开导入文件,查看是否存在“Base64:”开头的字段值。如果没有“Base64:”开头的字段值,则说明是老版本实例导出的文件。
如果是老版本实例导出的文件,需要重命名文件,在文件名后添加“-none-base64-prefix”,例如原文件名为“import.csv”,则需要重命名为“import-none-base64-prefix.csv”。
- 如果要新增设备,则需要另外新建导入文件,并在新建的文件中添加新的设备信息。
- 若使用Excel工具编辑导入文件,在编辑完成后需要按如下操作保存。
- 在Excel中保存时,以另存的方式保存为“CSV(逗号分隔)(*.csv)”类型文件。
- 使用文本编辑器打开1中保存的csv格式文件,并再次另存,另存时编码选择“带有 BOM 的 UTF-8”,保存后即得到最终的csv格式导入文件。
导入设备
- 登录ROMA Connect控制台,在“实例”页面单击实例上的“查看控制台”,进入实例控制台。
- 在左侧的导航栏选择“设备集成 LINK > 设备管理”,在“设备”页签中单击“导入设备”。
- 在弹窗中选择本地保存的设备文件,并导入。
- 导入成功后,在页面的设备列表中可查看导入的设备。
导出设备
- 登录ROMA Connect控制台,在“实例”页面单击实例上的“查看控制台”,进入实例控制台。
- 在左侧的导航栏选择“设备集成 LINK > 设备管理”。
- 导出设备。
- 导出指定设备:勾选您想要导出的设备,然后单击“导出”,导出设备文件到本地。
- 导出所有设备:单击“导出所有设备”,导出设备文件到本地。
设备导入文件说明
列名 |
描述 |
取值要求 |
---|---|---|
DeviceName |
设备名称。 |
必填,复杂度要求与页面创建相同。 |
ProductSerial |
设备所属产品的产品标识。 |
必填,产品标识应已存在。 |
ParentDeviceClient |
设备所属网关设备的客户端ID。 |
选填,网关设备应已存在。 |
ClientID |
客户端ID。 |
选填。 |
DeviceIdentifier |
设备标识。 |
必填,复杂度要求与页面创建相同。 |
Username |
用户名。 |
选填。 |
Password |
密码。 |
选填,复杂度要求与页面创建相同。 |
DeviceType |
设备类型。 |
必填,根据所属产品的协议类型决定。
|
Remark |
设备描述。 |
选填。 |
customTopic |
自定义topic。 |
选填,建议在页面创建。
多个TOPIC之间使用英文分号分隔。 |
Enable |
设备状态。 |
必填,启用:0,禁用:1。 |