基于 TSDB 数据构建仪表盘¶
概述¶
EnOS 数字孪生可视化（Digital Twin Visualization, DTV）是一个基于模型的低代码应用开发工具，提供丰富的组件及灵活的配置能力，赋能平民开发者快速构建可视化应用，极大提升开发效率。DTV 支持使用 EnOS 时序数据管理（Time Series Data Management, TSDB）中的数据配置可视化仪表盘页面。TSDB 为设备上传的实时数据、经流数据处理的数据、以及通过离线通道整合的时序数据提供高效和稳定的存储和管理。
本文以快速构建可视化应用页面为例，介绍如何通过 DTV 可视化展现存储于 TSDB 中的资产测点数据。涉及的产品如下表所示：
产品名称 |
必需/可选 |
依赖功能描述 |
|---|---|---|
EnOS 设备连接与管理（Device Connectivity & Management, DCM） |
必需 |
接入所需资产 |
时序数据管理 |
必需 |
存储时序数据 |
EnOS 应用门户 |
可选 |
承载 DTV 应用 |
场景¶
本文教你快速搭建一个演示场景，可视化展示某个空气设备传感器实时上传的空气质量数据，包括实时室内温度、湿度及其他楼宇空气相关指标。其中，室内温度和湿度来自于 TSDB 中存储的数据。
基于 TSDB 数据的可视化页面示例：
组件清单：
组件 |
样式 |
数据源 |
描述 |
|---|---|---|---|
Indoor Temperature（室内温度） |
指针仪表盘 |
LatestData |
展示实时的室内温度 |
Indoor Humidity （室内湿度） |
指针仪表盘 |
LatestData |
展示实时的室内湿度 |
有关指针仪表盘的更多信息，参见 指针仪表盘。
数据源清单：
数据源 |
数据源类型 |
描述 |
|---|---|---|
Latest Data |
TSDB |
从 TSDB 获取最新上传的数据。 |
有关 TSDB 类型数据源的更多信息，参见 准备 TSDB 数据源。
端到端工作流程¶
前提条件¶
开始前，请确认以下事项：
当前 OU 已通过 DCM 接入了所需资产，且资产或资产所属模型已添加
auth_unit:true标签。资产已同步至应用门户，且当前账号在应用门户中已获取资产的权限。如有需要，可联系 OU 管理员。
当前账号拥有 EnOS 管理控制台的管理员权限（可联系系统管理员获取权限），且有权访问管理控制台中的以下菜单：
菜单 |
必需/可选 |
描述 |
|---|---|---|
设备管理 > 设备资产 |
必需 |
检查所需资产是否已接入 DCM。 |
时序数据管理 > 时序洞察 |
必需 |
检查 TSDB 数据是否可在 DTV 中使用。 |
如需获取上述菜单的访问权限，可联系 OU 管理员。
当前账号拥有应用门户的（子）管理员权限（可联系系统管理员获取权限）有权管理菜单组，并有权访问以下 EnOS 行业应用组件（Industry Application Common Building Blocks，CBB）：
CBB |
必需/可选 |
描述 |
|---|---|---|
DTV |
必需 |
利用 TSDB 数据创建可视化页面。 |
如需获取上述 CBB 的访问权限，可联系 OU 管理员。
设计态¶
本章节介绍如何在 DTV 中配置页面，可视化展示 TSDB 数据。
步骤 1：准备 TSDB 数据源¶
本场景中，所需设备均通过 DCM 接入，相应数据存储在 TSDB 中，并可在 DTV 中用于配置可视化仪表盘页面。此处，由于需要在 DTV 页面中可视化展示实时室内空气质量数据，因此需要准备 LatestData 数据源，从而获取最新上传的时序数据。通过以下步骤检查所需设备和所需数据：
在管理控制台的 设备管理 > 设备资产 中，检查以下内容：
资产 ID：所需资产设备的 ID。此处为获取实时空气质量数据的传感器的 ID，如：9PC9LNpk。后续在配置组件数据时，需要通过输入 ID 指定设备。
设备名称：所需设备的名称。如：IAQ_1_1。
模型：所需设备的模型，如：EnOS_CITY_IAQ。后续在配置组件数据时，需要选择模型作为数据源类别。
在管理控制台的 时序数据管理 > 时序洞察 中，配置以下信息，查看所需的 TSDB 数据项和对应的设备数据。
配置项 |
示例值 |
描述 |
|---|---|---|
选择设备 |
IAQ_1_1(9PC9LNpk) |
获取实时空气质量数据的传感器设备。 |
选择测点 |
IAQ_zone_air_humidity |
室内湿度数据。 |
选择测点 |
IAQ_zone_air_temp |
室内温度数据。 |
步骤 2：启用数据源¶
在应用门户的 DTV 中心 > 数据源 > 内置数据源 中，启用 LatestData 数据源:
更多信息，参见 使用 TSDB 数据源。
步骤 3：配置仪表盘页面¶
DTV 通过仪表盘页面组织可视化组件。通过以下步骤创建用于展示可视化组件和资产数据的仪表盘页面：
在应用门户中选择 DTV 中心 > 仪表盘。
选择 新建 并配置页面名称，例如“空气质量”。
选择 页面设置 并配置以下内容：
配置项 |
必需/可选 |
示例 |
描述 |
|---|---|---|---|
主题 |
可选 |
暗色（dark） |
页面的主题色，DTV 目前支持白色（light）、绿色（green）、暗色（dark）三种主题色。 |
创建页面后，通过以下步骤将室内温度组件和室内湿度组件添加到页面中:
选择 添加 > 组件/容器 > 组件，并在弹窗中分别选择以下组件类型，添加组件至页面。
名称 |
类型 |
描述 |
|---|---|---|
Indoor Temperature |
指针仪表盘 |
在添加组件/容器弹窗中选择 仪表盘 > 基础指针仪表盘。 |
Indoor Humidity |
指针仪表盘 |
在添加组件/容器弹窗中选择 仪表盘 > 基础指针仪表盘。 |
2. 鼠标悬停在组件右上角，并选择下拉列表中的 编辑，分别配置以下组件信息：
室内温度组件（Indoor Temperature）
分类 |
配置项 |
示例 |
描述 |
|---|---|---|---|
基本 |
标题 |
输入”室内温度” |
输入组件标题。 |
数据 |
数据源 |
选择”LatestData” |
选择完数据源后，需要配置以下数据源参数：1.类别：选择对应的类别，即模型，获取模型下的数据在组件中展示。2.聚合维度：选择 false 指定当从数据源请求数据时不需要聚合数据。3.资产 ID：指定资产ID，查询指定设备的数据。 |
数据 |
度量 |
选择”IAQ_zone_air_temp” |
选择”添加数据项”，弹窗中选择 IAQ_zone_air_temp 来展示温度数据。 |
图表样式 |
度量样式 |
/ |
度量样式决定了所选度量数据在组件中的展示效果，此处需要配置以下样式信息：1.单位名称：指定度量单位名称为 ℃。2.小数位数：指定组件中展示的度量数据的小数位数是 1。3.轴线范围：指定组件展示的指针轴线范围是 -20 作为最小值, 50 作为最大值。4.以百分比显示：不勾选该选项，指定数据不以百分比效果展示。5.颜色规则：选择”添加”, 配置当数据落在相应数据范围时的展示颜色位渐变蓝。 |
室内湿度组件（Indoor Humidity）
分类 |
配置项 |
示例 |
描述 |
|---|---|---|---|
基本 |
标题 |
输入”室内湿度” |
输入组件标题。 |
数据 |
数据源 |
选择”LatestData” |
选择完数据源后，需要配置以下数据源参数：1.类别：选择对应的类别，即模型，获取模型下的数据在组件中展示。2.聚合维度：选择 false 指定当从数据源请求数据时不需要聚合数据。3.资产ID：指定资产 ID，查询指定设备的数据。 |
数据 |
度量 |
选择”IAQ_zone_air_humidity” |
选择”添加数据项”，弹窗中选择 IAQ_zone_air_humidity 来展示湿度数据。 |
图表样式 |
度量样式 |
/ |
度量样式决定了所选度量数据在组件中的展示效果，此处需要配置以下样式信息：1.单位名称：指定度量单位名称为 %rh。2.小数位数：指定组件中展示的度量数据的小数位数是 1。3.轴线范围：指定组件展示的指针轴线范围是 0 作为最小值, 100 作为最大值。4.以百分比显示：不勾选该选项，指定数据不以百分比效果展示。5.颜色规则：选择”添加”, 配置当数据落在相应数据范围时的展示颜色位渐变粉。 |
有关指针仪表盘的更多配置信息，参见 指针仪表盘。
步骤 4：发布仪表盘页面¶
在配置完成页面配置后，需要发布页面并获取页面 URL，以便后续将此页面集成到应用菜单中。
进入 DTV 的 DTV 中心 > 仪表盘页面，选择页面的编辑按钮。
选择 保存 > 保存并发布 即可获取复制页面 URL，后续配置菜单只需要截取“/dt/……”及之后的内容。
步骤 5：将仪表盘页面配置到应用菜单中¶
通过以下步骤将已获取的页面 URL 配置在应用中：
在管理控制台中选择 应用注册。
选择需要将 DTV 页面添加进去的应用。
选择 菜单管理 > 新建菜单。
在 菜单名称 中输入菜单的名称，例如“空气质量”。
在 URL 中输入上一步中复制的 DTV 页面 URL。
参考 管理菜单组，将新增菜单加入对应的菜单组下，并配置用户对菜单的访问权限。
运行态¶
查看 TSDB 数据可视化页面¶
以上操作配置完成后，即可通过以下步骤在集成的应用中查看 TSDB 数据可视化页面：
在应用门户中访问添加了该页面的应用，并在左侧菜单栏中选择 空气质量 ，即可查看 TSDB 数据可视化页面。
在管理控制台中选择 时序数据管理 > 时序洞察, 配置以下信息，查看该设备的当前 TSDB 数据。若与可视化页面中所展示的数据一致，则代表配置正确。
配置项 |
示例值 |
描述 |
|---|---|---|
选择设备 |
IAQ_1_1(9PC9LNpk) |
获取实时空气质量数据的传感器设备。 |
选择测点 |
IAQ_zone_air_humidity |
室内湿度数据。 |
选择测点 |
IAQ_zone_air_temp |
室内温度数据。 |
常见问题¶
问：为什么我在配置组件时无法选择 LatestData 数据源？
答：可能因为未在 DTV 中启用 LatestData 数据源。在应用门户中选择 数字孪生可视化 > 数据源 > 内置数据源，打开 LatestData 数据源的开关即可。
问：为什么配置组件数据后，运行态无法看到 TSDB 数据？
答：可能原因 1： 模型未打标。前往管理控制台的 模型 > 模型列表，资产模型上打标：auth_unit : true 。
可能原因 2： 未进行资产同步。前往应用门户管理后台的 资产管理 > 资产同步，需要能够看到在时序洞察中的资产，若无该资产则点击 资产同步。
可能原因 3： 未进行资产对用户授权，前往应用门户管理后台，检查当前用户对应的组织结构中是否授权该资产，角色中是否分配了新菜单，用户是否有该角色。
问：为什么我无法在应用门户中看到已配置的页面菜单？
答：可能因为当前账号未获取相关菜单组的访问权限。 如需获取菜单组访问权限，联系当前 OU 的管理员。