管理产品¶

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

前提条件¶

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

查看产品信息¶

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

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

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

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

编辑产品基本信息和标签¶

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

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

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

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

查看日志 ¶

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

在 EnOS 管理控制台中选择 设备管理 > 产品管理。
在产品列表中找到目标产品，点击产品后的查看打开 产品详情 页面。
点击 日志服务 标签打开详细日志。
在 设备行为分析 标签输入需要查看日志的设备并设置目标查看时间端，即可查看该设备该时段的日志。
（可选）如需查看上下行信息日志，点击 上行消息分析 和 下行消息分析 标签页。
- 上行消息分析 页主要展示以下上行消息的日志:
  - 设备发送消息到 topic 队列。
  - 消息从 topic 队列流转至规则引擎。
  - 消息从规则引擎转发至 EnOS 云端其他服务和应用。
- 下行消息分析 页主要展示云端发送消息到设备的日志。

导出产品¶

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

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

导入产品 ¶

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

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

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

在 EnOS 管理控制台中选择 设备管理 > 产品管理。
点击 导入产品。
上传一个 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. 新产品导入成功后将会出现在 设备管理 > 产品管理 的产品列表中。

调试在线设备 ¶

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

在 EnOS 管理控制台中选择 设备管理 > 产品管理。
点击需要查看产品的后的查看，选择 在线调试。
在 调试设备 下拉框中，选择需要调试的设备。
在 调试功能 中模拟一个场景。
点击 发送指令。

迁移产品 ¶

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

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

产品可以通过共享，从一个 OU 迁移到另一个 OU。

共享时，若目标 OU 中不存在产品的模型，则该模型将与产品一起共享到目标 OU。模型和产品将分别出现在目标 OU 的模型和产品列表中，并且目标 OU 将获得对两者的读取权限。目标 OU 可以查看共享模型和产品的信息但无法编辑。

原始 OU 中对模型和产品所做的任何更改都将反映在目标 OU 中。删除原始 OU 中的模型和产品时也会在目标 OU 中将其删除。

在 EnOS 管理控制台中选择 设备管理 > 产品管理，并点击需要迁移的产品的迁移图标。
在操作选择共享。
输入目标 OU 的 OU ID。
选择 验证方式，可通过邮箱或通过手机。
点击 获取验证码，验证码将根据所选择的 验证方式，通过电子邮件或短信发送给目标 OU 的管理者。
输入验证码（6 位数字）并点击确定。
在确认迁移的弹出窗口中点击确定。
该产品将出现在目标 OU 的产品列表中。