使用 CDS 数据源¶

使用 Common Data Service（简称 CDS）类型的数据源，可以在页面中展示来自 EnOS 通用数据服务的数据。

前提条件¶

使用前，确保以下内容：

已接入资产，并将资产挂载到一棵资产树上，且资产树已拥有 auth_unit:ture 和 EnosCDS:true 标签。
已在管理后台中同步资产，将资产同步到应用门户。
已将资产挂载到组织结构树，并将组织结构分配给 DTV 和 CDS。
当前账号已拥有组织结构和资产的查看权限。
已在 CDS 中创建需要使用的业务对象类型、业务指标、属性、测点等。

操作步骤¶

在 DTV 中心 > 数据源，启用所需数据源。
在 DTV 中心 > 仪表盘/单页应用 中，打开任一页面。
选择任一组件的编辑按钮，打开组件配置面板。
参照配置组件数据中的步骤，在组件中配置 CDS 数据源。
参照下列内容，配置数据源的请求参数。

Timeseries 数据源¶

Timeseries 数据源是 EnOS 模型关联资产在一段时间内的时序数据。在 Timeseries 数据源中，数据的默认结构和范围是由模型来定义的，默认情况下，Realtime 数据源的返回结构是模型相关联的用户权限内的资产时序数据。

Timeseries 数据源的请求参数包括：

名称	Key	默认值	说明
自动获取资产	autoData	false	是否自动获取当前用户有权限的资产，如果选择 True，将会自动获取用户有权限的对应模型的资产。
查询类型	查询类型		根据类别与资产 ID 之前的关系决定。同级关系：所选资产为所选类别下资产，即只返回所选资产的资产数据。层级关系：所选类别为所选资产下资产的资产类别，即返回所选资产下所有资产的资产数据。分组：所选类别为所选资产的资产类别，即返回根据该资产分组进行聚合后的资产数据。
累计粒度	accumulate	无	实时数据累计粗细度。例如：按不同时间间隔汇总数据。
资产 ID	mdmId	无	选择资产，即对应应用门户 > 开发者控制台中的资产 ID。
开始时间	startTime	无	设定查询数据的起始日期与时间。
结束时间	endTime	无	设定查询数据的结束日期与时间。
聚合类型	aggregation	无	时序数据聚合方式，例如：对一时间段内的时序数据计算平均值。
聚合粒度	interval	无	时序数据的聚合粗细度，例如：对每 5 分钟的数据进行一次聚合。
维度	dimension	无	除资产和时间之外的维度，例如：设备型号、设备制造商。该参数用于聚合查询或筛选，多个维度之间用英文逗号隔开。单次查询指定的维度数量不超过 10。如何获取维度标识符 >>
是否显示资产数据	rawAttribute	无	当该测点在某资产中不存在，仍显示该资产的其他数据。
占位	preserveIndex		对没有数据的时间，以空数据值占位显示。
插补	autoInterpolate		对没有数据的时间，以与前一时间相同的测点数据进行插补。

Realtime 数据源¶

Realtime 数据源是 EnOS 模型关联资产的实时数据。在 Realtime 数据源中，数据的默认结构和范围是由模型来定义的，默认情况下，Realtime 数据源的返回结构是模型相关联的用户权限内的资产实时数据。

Realtime 数据源的请求参数包括：

名称	Key	默认值	说明
自动获取资产	autoData	false	是否自动获取当前用户有权限的资产，如果选择 True，将会自动获取用户有权限的对应模型的资产。
查询类型	查询类型		根据类别与资产 ID 之前的关系决定。同级关系：所选资产为所选类别下资产，即只返回所选资产的资产数据。层级关系：所选类别为所选资产下资产的资产类别，即返回所选资产下所有资产的全部数据。分组：所选类别为所选资产的资产类别，即返回根据该资产分组进行聚合后的资产数据。
累计粒度	accumulate	无	实时数据累计粗细度，例如：按不同时间间隔汇总数据。
资产 ID	mdmId	无	选择资产，即对应应用门户 > 开发者控制台的资产 ID。
维度	dimension	无	除资产和时间之外的维度，例如：设备型号、设备制造商。该参数用于聚合查询或筛选，多个维度之间用英文逗号隔开。单次查询指定的维度数量不超过 10。如何获取维度标识符 >>
是否显示资产数据	rawAttribute	无	当该测点在某资产中不存在，仍显示该资产的其他数据。

Record 数据源¶

Record 数据源连接资产的事实数据，如告警、控制请求等。在 Record 数据源中，数据的默认结构和范围是由表来定义的，默认情况下，Record 数据源的返回结构是模型相关联的用户权限内的资产的事实数据。

Record 数据源的请求参数包括：

名称	Key	默认值	说明
起始页码	pageNo		将数据按照数据量分页后，请求数据的开始页码数。
数据量	pageSize		每页数据的条数。

Alarm 数据源¶

Alarm 数据源连接资产的告警数据。在 Record 数据源中，数据的默认结构和范围是由告警来定义的，默认情况下，Record 数据源的返回结构是模型相关联的用户权限内的资产的告警数据。

Alarm 数据源的请求参数包括：

名称	Key	默认值	说明
资产 ID	mdmId	无	选择资产，即对应应用门户 > 开发者控制台的资产 ID。
资产类型	scope		获取告警的资产范围场站：所选资产为场站，将查询场站下的所有告警。设备：所选资产为设备，将查询设备下的所有告警。
开始时间	startTime	无	设定查询数据的起始日期与时间。
结束时间	endTime	无	设定查询数据的结束日期与时间。
告警父类型 ID	parentTypeIds	无	告警父类型 ID。
告警类型 ID	alertTypeIds	无	告警类型 ID。
设备类型 ID	mdmTypeIds	无	设备类型 ID。
告警 ID	alertIds	无	告警 ID。
active	active		是否过滤激活的告警。

Topology 数据源¶

Alarm 数据源包含 EnOS 模型关联资产的层级结构（拓扑）信息。数据的默认结构和范围是由告警来定义的，默认情况下，Record 数据源的返回结构是模型相关联的用户权限内的资产的拓扑数据。

名称	key	默认值	说明
资产 ID	mdmId	无	选择资产，即对应应用门户 > 开发者控制台的资产 ID。
TopologyId	topologyId		配置在 CDS 的组织结构树的 ID。
是否裁剪	ifCut	无	是否根据选择的模型进行树的裁剪。
累计粒度	accumulate	无	实时数据累计粗细度，例如：按不同时间间隔汇总数据。
资产 ID	mdmId	无	选择资产，即对应应用门户 > 开发者控制台的资产 ID。
维度	dimension	无	除资产和时间之外的维度，例如：设备型号、设备制造商。该参数用于聚合查询或筛选，多个维度之间用英文逗号隔开。单次查询指定的维度数量不超过 10。如何获取维度标识符 >>
是否显示资产数据	rawAttribute	无	当该测点在某资产中不存在，仍显示该资产的其他数据。