更新时间:2023-05-30 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. 导入成功后,在页面的产品列表中可查看导入的产品。

若导入产品时出错,请等5分钟后再重新导入,否则会导入失败。

导出产品

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

产品导入文件说明

产品的导入文件内容要求见表1
表1 产品导入文件内容说明

列名

描述

取值要求

ProductName

产品名称。

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

ProductSerial

产品标识。

必填。

ManufacturerId

厂商ID。

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

ManufactureName

厂商名称。

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

Model

产品型号。

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

ProductType

产品类型。

必填,普通产品:0,网关产品:1。

ProtocolType

协议类型。

必填,取值MQTT、MODBUS或OPCUA。

Username

用户名。

选填。

Password

密码。

选填。

appName

应用名称。

必填,应用名称已存在。

DeviceType

设备类型。

必填,默认为Default。

DataFormat

数据格式。

必填,默认为JSON。

Services

物模型。

选填,建议通过页面创建。