# 导入导出LINK设备
#### 概述
ROMA Connect支持导入导出设备，可以把设备以文件形式导出到本地，也可以把本地的设备文件导入ROMA Connect，实现设备信息的批量迁移。
#### 前提条件
- 导入设备前，请确保设备所属的集成应用已创建，否则请提前[创建集成应用](https://support.huaweicloud.com/usermanual-roma/create-application.html)。
- 导入设备前，请确保设备所属的产品已创建，否则请提前[创建产品](https://support.huaweicloud.com/usermanual-roma/define-product.html)。
- 导入设备前，请检查导入设备的实例中是否存在重名设备，若存在重名设备，会导致导入设备失败。
- 导入设备前，请确保设备的配额满足需求。
- 导入文件格式为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控制台](https://console.huaweicloud.com/roma3)，在左侧导航栏选择"资源管理"，在实例页面单击实例，进入实例控制台。
2. 在左侧的导航栏选择"设备集成 LINK \> 设备管理"，在"设备"页签中单击"导入设备"。
3. 在弹窗中选择本地保存的设备文件，并导入。
4. 导入成功后，在页面的设备列表中可查看导入的设备。
 
#### 导出设备
1. 登录[ROMA Connect控制台](https://console.huaweicloud.com/roma3)，在左侧导航栏选择"资源管理"，在实例页面单击实例，进入实例控制台。
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。                                                                                                                                                                                                                                                                                                                                                                                     |