# 产品管理
产品:指在项目下创建的产品,通过产品划分设备的类型、设备接入的认证鉴权方式、数据规范。原则上1个产品下为一组具有共同数据模型的设备。一款产品包含特定的名称、型号、通讯方式及扩展类描述等信息。
产品分类:对产品/设备所属分类的描述,平台通过预定义设备的类型,建立该类设备的标准数据模型,方便开发者直接进行复用,以更快的完成对一款产品的功能定义。
数据模型:数据模型指将物理空间中的实体数字化,并在云端构建该实体的数据模型。在平台中,定义数据模型即定义设备功能。
# 创建产品
没有企业认证的账号,每个账号下最多可以创建25个产品;通过企业认证的账号,每个账号最多可创建100个产品。产品数可以申请提高,但每个项目下最多100个产品。 (备注:对于老用户,根据用户当前的数据自动生成对应产品,生成时不做限制。其他限制条件如下:
- 当生成出的产品超出限制时,该账号将不能再创建产品,只能对当前已有产品进行操作。
- 当用户删除当前产品,但产品数还是超出限制时,该账号依然不能再创建产品。)
创建产品必填字段包括:产品名称、所属品类、接入协议,非必填字段包括:产品描述、扩展信息(标签),系统生成字段包括:Product key、创建时间、产品鉴权信息。其中产品描述最多输入100字符,Product key为账号下唯一。
提供产品级的数据推送接口,通过该接口可以一次性获取/查询该产品下的产品信息、设备数、设备数据。
点击创建产品:
创建完成后:
# 数据模型
数据模型定义:
数据模型分为标准数据模型和自定义数据模型。
数据模型定义指定义该产品下接入设备的数据模型,通过数据模型规范设备上传数据与平台下发数据格式与内容。 定义的数据模型是一个JSON格式的文件。它是物理空间中的实体,如传感器、车载装置、楼宇、工厂等在云端的数字化表示,从数据流程、事件和命令三个维度,分别描述了该实体是什么,能做什么,可以对外提供哪些信息。定义了这三个维度,即完成了产品功能的定义。 数据模型:“数据流”“事件”“命令”的定义。
- 数据流(data stream)
- 一般用于描述设备运行时的状态,如环境监测设备所读取的当前环境温度等。属性支持 GET 和 SET 请求方式。应用系统可发起对属性的读取和设置请求。
- 事件(event)
- 设备运行时的事件。事件一般包含需要被外部感知和处理的通知信息,可包含多个输出参数。如,某项任务完成的信息,或者设备发生故障或告警时的温度等,事件可以被订阅和推送。
- 命令(command)
- 设备可被外部调用的能力或方法,可设置输入参数和输出参数。相比于属性,命令可通过一条指令实现更复杂的业务逻辑,如执行某项特定的任务。
数据模型标识符号规则:一个产品下的数据模型标识符必须保持唯一性,不区分标准与自定义。
平台操作:
点击产品进入模型定义:
其中点击右上角的“接入鉴权”查看链接,可查看鉴权信息,设备接入时需要填写鉴权信息。
(鉴权信息说明请参照“平台鉴权”说明页)
# 标准数据模型
标准数据模指平台为每个品类创建了默认的标准功能,用户可以直接选择生成使用。 标准数据模型由标准的点组成,每一个功能点需对应到产品品类,每一个产品品类需对应到产品种类。
标准数据模型列表规则:
1、 生成的标准数据模型功能根据三种功能类型进行排序,优先级分别为:数据流>事件 >命令;
2、 标准数据模型功能对应的序号范围为:1-200 。
3、 当添加新的标准数据模型功能时,需按照功能类型的排序方式,先遵循:数据流>事件>命令的顺序,再进行序号生成,例如:在以下表格中添加事件型功能,命令类的功能序号将依次递增,添加的事件功能排在已有事件功能的最后。
序号 | 功能类型 | … | … | … | |
---|---|---|---|---|---|
1 | 数据流 | ||||
2 | 事件 | ||||
3 | 命令 | ||||
5 | 命令 |
平台操作:
点击添加模型按钮,在弹框中选择模型直接添加:
选择全部并添加后:
可以对单各模型点进行预览、编辑和删除,也可以点击“查看数据模型“查看完整的模型,并导出模型:
可以在弹框中导出模型文件。
# 自定义数据模型
除使用标准数据模型外,也可直接导入数据模型或直接添加。
平台操作:
数据模型导入:
直接添加:
添加时,可选择“数据流”、“事件”、“命令”自由添加。
事件:
命令:
也可使用模型生成器,通过数据获得模型。
# 产品授权
产品授权可以通过授权的方式灵活地将产品授权给不同用户的不同项目,被授权方可以查看授权产品下所有的设备基本信息,通过使用授权设备鉴权码、设备密钥(可选权限)以实现第三方定制化开发的需求。
产品授权规则:
- 产品只能授权给不同用户,且同一个产品最多能授权10次;
- 产品授权需要被授权用户确认后方可生效,且未生效的授权产品在被授权用户下仍然可见,只是不可编辑;
- 授权产品会算作被授权用户的产品数量(包括未生效),出于安全考虑,同一个项目下最多只能拥有5个未确认授权产品;
名词解释:
- 一组一密:产品授权默认权限,指被授权用户在产品详情中能否查看授权设备鉴权码,并通过授权设备鉴权码进行授权API调用或者授权设备接入;
- 一机一密:产品授权可选权限,指被授权用户是否能够在授权产品的设备详情中查看设备证书中的DeviceSecret;
- 自身授权:在项目下创建的产品和项目的关联关系就属于自身授权,也可以说产品和项目隶属于同一用户就是自身授权;
- 全部授权:将产品下的设备全部授权给不同用户的项目下;
控制台操作:
进入产品详情页面即可看到授权列表,在这里可以对授权进行修改、收回和添加新的授权。修改主要是对权限进行修改,目前仅有一组一密和一机一密两种权限。
在授权界面需要输入被授权用户的projectKey,并点击搜索后可勾选授权权限,点击确认后需要等待被授权用户确认后方可生效。
与此同时在被授权用户的项目中可以看到未生效的授权,需要注意的是未生效的授权也会占用用户产品数 ,在授权之前请确认被授权方可创建产品数大于0。点击未确认授权的产品(置灰的产品)或者用户头像旁的消息中心则可以跳转到消息中心中查看授权确认消息。
授权消息中可以看到授权的基本信息,如果确定无误,则可以点击确认,至此整个授权动作就已经完成。
授权产品上会有一个授权产品的标签页,同时也可以点击解除授权按钮对授权进行解除,授权方也可以主动收回授权。