组合实体

创建组合实体

组合实体是一种特殊的虚拟实体，通常用于将多个不同实体的属性、事件、服务组合成一个统一的数据接口，且无需为每一个组合重新定义产品Profile。其上级关联到系统预置的 Dumb 网关。

[!NOTE] 关于组合实体的概念机制及使用限制，请参考概念定义 - 组合实体。

选择【添加组合实体】，输入组合实体devicelD以及实体名称。系统会默认生成deviceSecret。组合实体的创建的要点在于从各个产品和已有实体下选择所需的属性、事件、服务组合成一个新的虚拟实体。

说明： 1.属性，选择需要的属性字段；属性上报将默认使用组合上报的方式。 2.事件，选择需要的事件进行组合。 3.服务将按照成员实体的服务进行管理与调用。

编辑组合实体

在组合实体页面选择需要编辑查看的组合实体，点击”编辑”进入组合实体详情页面。

组合实体信息

查看组合实体的基本信息包含组合实体基本信息和组合实体的成员实体的信息。组合实体基本信息仅可修改名称，成员实体的信息不可更改也不可修改组合成员。

组合实体标签

通常根据组合实体的特性为其添加特有标记。组合实体标签信息会跟随组合实体在系统内部流转。该功能支持“可选择 + 可输入”的组合模式，支持两级标签管理，既可以从下拉列表中快速选择已有的分组或标签，也允许自定义输入新标签。

实体组合

实体的产品Profile不可编辑和修改。所有实体的产品profile都与产品一致。

组合属性

查看组合实体属性的最新值，可设置实时刷新。属性上报将默认使用组合上报的方式

组合事件

即便在组合实体时选择了不同产品下实体的事件，初始进入组合事件时也是空的。需要将选择的实体事件重新组合成新的组合事件。

步骤：

1. 选择【添加组合事件】；
2. 在已有成员实体的事件列表中，选择需要单一个或多个事件组合成为一个新的组合事件；
3. 定义组合事件的名称、标识符、上报类型等内容。
4. 不需要的事件输出参数可以删除，但不支持新增。

事件模板

事件模板是展示事件数据的一个可视化页面，可以展示以及渲染到第三方平台，进行静态页面展示。选择看板作为事件展示时的模板样式，可通过低代码设计器绘制看板。将选择的看板保存后就成为该事件的模板。 说明：将用来实时渲染展示，请确保输出参数identifier与看板使用的数据集identifier参数一致。不添加模板则不会进行页面渲染直接发送Json数据，默认发送模板链接以及json数据；

事件摘要

事件摘要是通过文本的形式简要明了的描述发生的事件。可以自行输入文本内容，也可以通过事件输出参数拼装组成。在发送事件摘要到通知中心时，会将数据值装载到摘要中。

组合上报时采用组合事件摘要，成员上报时使用成员事件摘要。

订阅关系

当前组合实体存在订阅时，可查看到所有订阅的信息。