批量注册设备


使用批量导入设备功能,可以创建大量同类设备。

任务描述

当用户有大量同类设备需要创建时,可选择以下方式批量上传设备:

  • 可以下载空白模板,填入设备信息并上传以批量创建设备;

  • 利用已创建设备的信息生成模板,再将设备信息填入模板并上传,完成批量导入。

开始前准备

  • 该设备所属的产品已经被创建。有关如何创建,参见创建产品

  • 你需要有设备管理操作权限,如果没有请联系组织管理员添加,参见策略,角色,与权限

操作步骤

  1. 选择 设备管理 > 设备管理

  2. 选择 批量添加,选择批量添加的设备所属产品。

  3. 从以下方式中择一,下载模板:

    • 下载空白模板,然后点击 空白模板 下载。

    • 如果想导入的设备与设备列表上已创建的产品类型具有同类属性,选择 生成基础模板,在下拉列表中根据 device key 选择一个设备,点击 生成模板 下载。

    备注

    下载的模板文件名为 “Template_product_key.xlsx”,product_key 是设备所属产品的 product key,可以在 设备管理 > 产品管理 中查看。


    ../../_images/device_batch_import.png


  4. 在模板中按格式要求填入设备相关信息,模板包含以下固定字段:

    字段

    说明

    DeviceKey

    设备的Device key,推荐使用 SN、IMEI 或者 MAC 地址作为 Device key。支持大小写字母、数字和连字符(-)、下划线(*)、英文句号(.)、英文冒号(:)。长度为 4 到 64 个字符。需保证 DeviceKey 在 OU 下唯一。

    设备名称

    用于在控制台设备列表中搜索设备,中文、大小写字母、数字和连字符( - )、下划线( * )、英文句号(.)和英文冒号(:),长度不超过64个字符。

    设备时区

    设备所在时区。如果该地区使用夏令时,应在下拉列表中选择夏令时适用的城市。


    模板中的其他字段为该设备的属性,属性的名称、支持的数据类型、是否必填项都继承自设备所属产品的模型。


    由已有设备生成的模板中,包含了与空白模板相同的基础字段,在该模板文件(.xlsx)的第三行,还记录了该已有设备的属性信息。在填入新设备信息之前,应将已有设备信息删除。由已有设备生成的模板示例如下:


    ../../_images/batch_import_device_sample_template.png


  5. 点击 上传文件,浏览并选择已填好的模板,确认并上传文件。上传的模板必须为符合下列要求:

    • 文件格式必须是 .xlsx。

    • 文件大小不超过2M。

    • 包含的设备记录不超过 1000 条。如需上传超过1000条设备记录,可以将设备记录分多个模板文件上传。

    • 单个产品下的设备不超过10个,设备列表已有设备数量加上模板中的设备记录数不超过10万个。否则 EnOS 会提示到达上限,无法继续添加。

  6. 点击 确定,EnOS 开始解析文件。

结果

查看导入结果:

  • 如果模板中包含了无效记录,可以选择 导出无效记录,浏览器将下载一个名为 “errmsg.txt” 的文本文档。其内容为 “Line n: error_message”。n 代表无效记录所在行数,error_message 为无效的原因。常见原因如下:

    • 字段格式不合法、长度超过限制。

    • 必填项没有数据。

    • DeviceKey 不唯一。

  • 如果模板中包含了有效记录,可以点击 确定,将有效记录导入 EnOS。完成导入后,可在设备列表中查看批量导入的设备。

后续操作

为使设备上传的数据能存储在 TSDB,以便后续数据分析,你需要在激活设备之前配置 TSDB 存储。否则设备的上传的数据默认不会被存储到 TSDB 中。更多信息,参见 配置 TSDB 存储


新创建的设备在未上线的情况显示为未激活。如需激活设备,你需要通过设备端 SDK 发起连接。更多信息,参见 使用设备 SDK

相关信息