管理产品


本文介绍如何查看产品信息、编辑产品基本信息和标签、导出/导入产品、查看设备日志和调试设备。

前提条件


管理产品前,你需要有 产品 服务相应的操作权限,如果没有请联系组织管理员添加。

查看产品信息


查看产品信息前,请确保当前账号拥有下列服务的操作权限。如果没有请联系组织管理员添加。

操作 需授权的服务 所需操作权限
查看产品详情 产品 Read(默认权限)
查看产品所采用的模型 模型 Read(默认权限)
查看 Product Secret 产品 Create 或 Update
查看产品下的设备信息 设备管理服务 Read(默认权限)


产品详情页 面,你可查看该产品的详细信息。

  1. 在 EnOS 管理控制台中选择 设备管理 > 产品管理
  2. 在产品列表中找到目标产品,点击产品后的 查看 view 打开 产品详情 页面。
  3. 在产品名称下方,可以查看产品的以下信息。
    • 模型:产品所采用的模型。点击 查看 view 查看模型的详细信息。
    • Product Key 和 Product Secret:标明产品身份的一组密钥凭证。
    • 设备数:点击 前往管理 manage 查看产品內包含的设备信息。

编辑产品基本信息和标签


编辑产品基本信息和标签前,请确保当前账号拥有下列服务的操作权限。如果没有请联系组织管理员添加。

需授权的服务 所需操作权限
产品 Update


产品详情页 面,你可编辑产品的基本信息和标签。

  1. 在 EnOS 管理控制台中选择 设备管理 > 产品管理
  2. 在产品列表中找到目标产品,点击产品后的 查看 view 打开 产品详情 页面。
  3. 产品信息 标签页,点击 基本信息标签信息 右侧的 edit 编辑
    • 基本信息:仅支持编辑 产品名称,启用/禁用 证书双向认证,以及 产品描述
    • 标签信息:点击 添加标签,输入标签的 Key:Value。完成后,选择 确定

查看日志


产品详情页 面,你可查看该产品下所有设备的重要行为日志。

  1. 在 EnOS 管理控制台中选择 设备管理 > 产品管理
  2. 在产品列表中找到目标产品,点击产品后的 查看 view 打开 产品详情 页面,选择 日志服务
  3. 点击 点击跳转 前往“运行日志”页面进行调试,相关操作见 在线调试

导出产品


该功能能导出不同模型的产品到一个 Excel 文件。

  1. 在 EnOS 管理控制台中选择 设备管理 > 产品管理,并点击 批量导出
  2. 导出有两种方式。点击 导出 > 导出全部 以导出在产品列表中所有的产品,或从产品列表中选择需要导出的产品,点击 导出 > 导出勾选项
  3. 将 Excel 文件保存到本地目录。

导入产品


导入产品前,请确保当前账号拥有下列服务的操作权限。如果没有请联系组织管理员添加。

需授权的服务 所需操作权限
产品 Create


该功能能使用 Excel 文件批量创建新产品或批量更新不同模型的现有产品。批量导入已存在的产品将更新原有产品的信息。若产品不存在,将新建产品。

  1. 在 EnOS 管理控制台中选择 设备管理 > 产品管理

  2. 点击 导入产品

  3. 上传一个 Excel 文件。对于文件大小,参见弹出窗口中的信息。


    若需要模板,点击 下载空白模板,以下载一个空白 Excel 格式模板。下载后填写模板并上传该模板文件。


Excel 模板参数
名称 必需/可选 描述
Product Key

取决于创建新产品或更新产品。

详细信息,参见描述。

产品的 product key。

  • 创建新产品,将此留空。产品创建成功后,系统会生成 product key。
  • 更新产品,Product Key 必须与更新的产品的 product key 匹配。如果找不到该 product key,将成为无效记录。
默认产品名称 必需 默认产品名称,在同一 OU 内必需是唯一。长度限制 1 - 64 字符,不支持输入 <>;@*%&\。
国际化产品名称 可选 产品的英文、中文、日语、德语等名称。如果未填写,将使用默认产品名称。长度限制 1 - 64 字符。
产品描述 可选 产品的描述,最长 512 字符。
节点类型 创建新产品时必需,更新产品时可选 产品的类型。可用值为 Device``(无需连接子设备)和 ``Gateway (需要连接子设备)。
接入方式 创建新产品时必需,更新产品时可选 设备接入到 EnOS 的方式。可用值为 ``Json``(通过 EnOS 标准 JSON 数据接入) 和 ``Custom``(通过自定义数据格式或通过可使用协议网关转换为 EnOS 标准协议的第三方设备协议)。
模型 ID 创建新产品时必需,更新产品时可选 产品所采用的模型的 ID。
协议网关

取决于 接入方式

详细信息,参见描述。

  • 如果 接入方式Json,可留空。EnOS 中使用的默认协议网关将被自动分配。
  • 如果 接入方式Custom 而方式为通过自定义数据格式,可留空。
  • 如果 接入方式Custom 而方式为通过协议网关,必需填写协议网关 ID。该 ID 可在 EnOS 管理控制台 > 设备接入 > 协议网关 中获取。
证书双向认证 必需
  • true:为该产品启用基于证书双向认证的认证方法。
  • false:为该产品禁用基于证书双向认证的认证方法。
默认证书有效期 如果 证书双向认证true,必需 当设备/网关申请证书但未指定有效期时,此参数将作为证书有效期。该值必需小于 最长证书有效期。范围:1 - 3650
最长证书有效期 如果 证书双向认证true,必需 当该产品下的设备/网关申请证书时,作为设备/网关的最大证书有效期。若超出有效期则报错,申请证书失败。范围:1 - 3650


注解

表格中请勿出现空行,否则可能导致文件无法导入成功。


../../_images/product_batch_import_upload.png


5. 点击 导入

6. 如果无效记录存在,将弹出窗口显示错误消息和 下载错误文件 链接。 点击链接下载文件,检查错误原因,并纠正错误,然后重新上传文件。

7. 新产品导入成功后将会出现在 设备管理 > 产品管理 的产品列表中。

调试在线设备


你可在产品详情界面调试该产品下的在线设备,虚拟设备模拟真实设备与云端建立连接,上报定义的属性及事件处理。此时,云端可根据虚拟设备的数据,完成应用的开发调试。而真实设备上线后,虚拟设备也会自动下线。

  1. 在 EnOS 管理控制台中选择 设备管理 > 产品管理
  2. 点击需要查看产品的后的 查看,选择 在线调试
  3. 点击 点击跳转 前往“在线调试”页面进行调试,相关操作见 在线调试