产品管理

产品、设备、大屏三者的关系

• 一个产品下可以有多台设备。设备的属性由所属产品的物模型决定，因此同类设备只需建模一次。
• 产品承载分类信息（行业、类别、子类别）、网络特征（节点类型、联网方式、操作系统）与物模型。
• 数据大屏取数时先选产品、再选该产品下的设备，最后选属性 —— 这个层级就是产品与设备的关系。

注意如果两类设备的属性差异很大，建议拆成两个产品，而不是在一个产品里塞很多用不到的属性：属性越多，设备详情、大屏选属性的下拉越长。

新建一个产品

1. 进入「产品管理」，点击右上角「添加产品」。
2. 填写产品名称，产品名要能一眼看出设备类型（例如"空压机 A 型"）。
3. 选择产品行业与产品类别：类别是两级结构，先选大类再选子类；只选到大类也可以。
4. 填写产品简介，说明这个产品的用途，便于团队其他成员理解。
5. 设置节点类型：直连（设备自己上网）、网关（设备作为网关，下挂子设备）或子设备。
6. 勾选联网方式（WiFi / 蜂窝 / 有线 / 其他，可多选），选择操作系统。
7. 保存后列表会出现该产品，记下产品 ID（点击卡片上的 ID 即可复制）。

注意产品 ID 在大屏配置、接口对接、问题排查时都会用到。列表卡片上的 ID 是可以直接点击复制的，不用手抄。

物模型：定义设备有哪些属性

物模型是产品对设备的抽象，它决定了设备上报的数据能被平台理解成什么。

• 属性：设备的状态量，例如温度、压力、开关状态。属性是平台最常用的部分，大屏取数、AI 查数依赖属性。
• 事件：设备主动上报的一次性动作或异常，例如告警、故障上报。
• 服务：平台可以对设备发起的操作，对应后文的「下发指令」。
• 属性的标识符建议用英文小写加下划线，便于接口对接时书写；显示名用中文，便于业务人员看懂。

注意物模型「发布才生效」：保存、导入都只写入草稿，点「发布」后才会生成新的已发布版本并对设备生效 —— 设备上行解析、下发指令、大屏取数、设备详情读的都是已发布版本。产品卡片与物模型弹框会显示「未发布（只有草稿）」「草稿待发布」等状态；「版本历史」里可以查看、导出任一历史版本，也能以某个历史版本的内容重新发布（切换版本）。另外，字段的数据类型创建后不可更改：导入一份同名不同类型的物模型会成功落成草稿，但点「发布」时会被拒绝（页面会提前提示冲突字段），需要改回原类型、清除该字段历史数据，或换一个新的标识符。

产品列表上能做什么

• 按产品名称、产品类别、产品行业筛选，筛选条件在后端生效，数据量大时依然准确。
• 查看该产品下的设备数量，点击可直接跳到设备管理并带上产品筛选。
• 查看联网方式汇总，快速确认某一类设备是怎么上网的。
• 编辑产品（改名、调整分类与网络设置）或删除产品。

注意删除产品前先确认它下面已经没有设备：设备仍在时删除会让这些设备失去归属。

注意

• 产品类别与行业是筛选与统计的依据，建模时不要随手乱选，否则后期按行业统计会失真。
• 联网方式可以多选，用于描述同一产品支持多种联网形态的情况。
• 物模型的改动只在点「发布」后生效：发布前设备仍按上一个已发布版本解析；从未发布过物模型的产品，设备上报的数据会被丢弃。
• 已经接入的设备最好在发布前确认设备上报字段是否需要同步调整。