基于 CDS 数据构建仪表盘¶

概述¶

EnOS 数字孪生可视化（Digital Twin Visualization, DTV）是一个基于模型的低代码应用开发工具，提供丰富的组件及灵活的配置能力，赋能平民开发者快速构建可视化应用，极大提升开发效率。EnOS 通用数据服务（Common Data Service, CDS）的统一 API 服务向数据消费者提供标准化、一站式的数据访问途径，可访问数据包括资产信息、测点、属性、指标、记录等，同时具备基于轻量计算自定义数据的能力。DTV 支持使用 CDS 中的数据配置可视化仪表盘页面。

本文以快速构建可视化应用页面为例，介绍如何通过 DTV 可视化展现 CDS 中的数据。涉及的产品如下表所示：

产品名称	必需/可选	依赖功能描述
EnOS 设备连接与管理（Device Connectivity & Management, DCM）	必需	接入所需资产
EnOS 通用数据服务	必需	配置业务指标数据
EnOS 应用门户	可选	承载应用

场景¶

本文教你快速搭建一个演示场景，可视化展示碳排相关数据，包括碳排量、碳排密度、不同范围的碳排趋势等碳排相关指标。

基于 CDS 数据的可视化页面示例如下：

组件清单：

组件	类型	数据源	描述
Total Carbon Emission（总碳排放量）	多指标卡（带比率）	Timeseries	按月显示碳排放总量和增长百分比
Carbon Emission Density （碳排放密度）	多指标卡（带比率）	Timeseries	按月显示碳排放总量和增长百分比

数据源清单：

数据源	数据源类型	描述
时序数据	CDS	从 CDS 中获得时序数据

有关 CDS 类型数据源的更多信息，参见准备 CDS 数据源。

端到端工作流程¶

前提条件¶

开始前，请确认以下事项：

当前 OU 已通过 DCM 接入了所需资产，确保资产所在的资产树或模型已拥有 auth_unit:ture 和 EnosCDS:true 标签。
已在管理后台中将资产同步到应用门户。
已将资产挂载到组织结构树，并将组织结构分配给数字孪生可视化和通用数据服务。
当前账号已拥有组织结构和资产的查看权限。
当前账号拥有 EnOS 管理控制台的管理员权限（可联系系统管理员获取权限），且有权访问管理控制台中的以下菜单：

菜单	必需/可选	描述
设备管理 > 设备资产	必需	检查所需资产是否已接入 DCM。

如需获取上述菜单的访问权限，可联系 OU 管理员。

当前账号拥有应用门户的（子）管理员权限（可联系系统管理员获取权限）有权管理菜单组，并有权访问以下行业应用组件（Industry Application Common Building Blocks，CBB）：

CBB	必需/可选	描述
DTV	必需	利用 TSDB 数据创建可视化页面。

如需获取上述 CBB 的访问权限，可联系 OU 管理员。

设计态¶

本章节介绍如何在 DTV 中配置可视化展示 CDS 数据的仪表板页面。

步骤 1：准备 CDS 数据源¶

在应用门户的 通用数据服务 中，配置需要的业务对象类型、指标、属性等内容：

步骤 2：启用数据源¶

在应用门户的 数字孪生可视化 > 数据源 > 内置数据源 中，启用 CDS 数据源。

更多信息，参见使用 CDS 数据源。

步骤 3：配置 DTV 页面¶

DTV 通过仪表板页面组织可视化组件。通过以下步骤创建用于展示可视化组件和资产数据的仪表盘页面：

在 EnOS 应用门户中选择 数字孪生可视化 > 仪表盘。
选择新建新建仪表盘，并配置页面名称，例如“碳排详情”。
选择 页面设置 并配置以下内容：

配置项	必需/可选	示例	描述
主题	可选	暗色（dark）	页面的主题色，DTV 目前支持白色（light）、绿色（green）、暗色（dark）三种主题色。

创建页面后，通过以下步骤将总碳排放量组件和碳排放密度组件添加到页面中:

4. 选择 添加 > 组件/容器 > 组件，并在弹窗中选择目标组件类型，添加下列组件至页面。

名称	类型	描述
碳排放总量	多指标卡（同环比）	在添加组件/容器弹窗中选择指标卡 > 多指标卡（同环比）。
碳排放密度	多指标卡（同环比）	在添加组件/容器弹窗中选择指标卡 > 多指标卡（同环比）。

5. 鼠标停在组件右上角，并选择下拉列表中的编辑，配置组件详细信息：

碳排放总量（Total Carbon Emission）

分类	配置项	示例	描述
基本	标题	输入”Total Carbon Emission”	输入组件标题。
数据	数据源	选择”Timeseries”	选择完数据源后，需要配置以下数据源参数：1.类别：选择对应的类别，即模型，获取模型下的数据在组件中展示。2.聚合维度：选择是指定当从数据源请求数据时需要聚合数据。3.开始时间。4.结束时间。5.聚合类型：选择avg，即以平均数聚合。6.聚合粒度：选择day，指以天数为维度聚合。7.自动获取资产：选择 true 指定自动获取资产。
数据	度量	选择”IAQ_zone_air_temp”	选择”添加数据项”，弹窗中选择总碳排放来展示温度数据。
数据	扩展	选择”Total Carbon Emission SPLM Growth Rate(DTV)”	选择”添加扩展数据项”，弹窗中选择 Total Carbon Emission SPLM Growth Rate(DTV) 来展示温度数据。
图表样式	度量样式	/	度量样式决定了所选度量数据在组件中的展示效果，此处需要配置以下样式信息：1.度量样式：包括图标、图标颜色、字体等设置。2.指标卡样式：包括布局、左右间距、行高等设置。

碳排放密度（Carbon Emission Density）

分类	配置项	示例	描述
基本	标题	输入”Carbon Emission Density”	输入组件标题。
数据	数据源	选择”Timeseries”	选择完数据源后，需要配置以下数据源参数：1.数据源：选择 Timeseries1。2.类别：选择对应的类别，即模型，获取模型下的数据在组件中展示。3.聚合维度：选择是指定当从数据源请求数据时需要聚合数据。4.开始时间。5.结束时间。6.聚合类型：选择sum，即以加总方式聚合。7.聚合粒度：选择day，指以天数为维度聚合。8.自动获取资产：选择 true 指定自动获取资产。
数据	度量	选择”单位面积碳排量”	选择”添加数据项”，弹窗中选择单位面积碳排量来展示数据。
数据	扩展	选择”Carbon Density SPLM Growth Rate(DTV)”	选择”添加扩展数据项”，弹窗中选择 Carbon Density SPLM Growth Rate(DTV) 来展示数据。
图表样式	度量样式	/	图表样式与组件 Total Carbon Emission 相同。

有关多指标卡的更多配置信息，参见多指标卡。

步骤 4：发布 DTV 页面¶

在配置完成仪表盘页面后，需要发布页面并获取页面 URL，以便后续将此页面集成到应用菜单中。

在 DTV 选择对应的 仪表盘，选择页面的编辑按钮。
选择 保存 > 保存并发布， 即可获取复制页面 URL，后续配置菜单只需要截取 /dt/…… 及之后的内容。

步骤 5：将 DTV 页面配置到应用菜单中¶

通过以下步骤将已获取的页面 URL 配置在应用中：

在管理控制台中选择 应用注册。
选择需要将 DTV 页面添加到的应用。
选择 菜单管理 > 新建菜单。
在 菜单名称 中输入菜单的名称，例如“碳排详情”。
在 URL 中输入上一步中复制的 DTV 页面的 URL。
参考管理菜单组，将新增菜单加入对应的菜单组下，并配置用户对菜单的访问权限。

运行态¶

查看 CDS 数据可视化页面¶

在应用门户中访问添加了此页面的应用，并在左侧菜单栏中选择 碳排详情 ，即可查看 CDS 数据可视化页面。

常见问题¶

问：为什么我在配置组件时无法选择 Timeseries 数据源？

答：可能因为未在 DTV 中启用 Timeseries 数据源。在应用门户中选择 数字孪生可视化 > 数据源 > 内置数据源，打开 Timeseries 数据源的开关即可。

问：为什么我无法在应用门户中看到已配置的页面菜单？

答：可能因为当前账号未获取相关菜单组的访问权限。如需获取菜单组访问权限，联系系统管理员。