通用组件设置¶
所有组件的 基本信息 和 数据项 部分都具有相同的字段。
基本信息¶
基本信息中包含 基本选项 与 其他选项。
基本选项¶
字段 |
说明 |
|---|---|
标题 |
指定组件的默认标题。 |
标识码 |
指定组件的标识码。通过 EnOS 数字孪生可视化 SDK 从外部派发事件时，如果提供了标识码，则只有指定标识符的对象会响应。 |
隐藏标题 |
选择此项可隐藏标题。 |
标题字体 |
设置标题标签的样式。 |
标题跳转 |
选择后在弹窗中配置标题跳转。更多信息，参见 标题跳转。 |
说明 |
编写关于组件的简短描述。如果已编写 描述，将光标移动到标题上将显示描述。 |
标题跳转
可将组件的标题设置为超链接。当标题配置跳转，标题右侧将会出现右箭头 
。
将鼠标悬浮在标题文本或箭头上时，会浮现跳转名称。
选择标题文本或箭头时，则会触发跳转。
标题跳转支持以下配置：
跳转名称：鼠标悬浮在标题或右侧的右箭头
上所展示的名称。打开方式
在新页面打开：在浏览器中打开新的页面。
替换当前页面：将当前页面替换为目标页面。
弹窗：在当前页面以弹窗方式显示新页面。
底部抽屉/侧边抽屉：在当前页面从底部/右侧边滑出新页面，会遮挡部分当前页面，选择 X 即可关闭抽屉。
跳转方式
不跳转：标题是正常的文本标签。
URL 跳转：将用户跳转到指定 URL。可以在 标题 URL 输入框中指定 URL。
应用门户：通过指定 应用标识符、菜单标识符 和 应用状态 字段将用户跳转到应用的菜单。
备注
如果在所选链接类型为 链接 URL 或 应用门户 时未指定 URL，用户将跳转回当前页面。
其他选项¶
字段 |
说明 |
|---|---|
刷新频率 |
选择组件刷新和从数据源检索数据的频率。 |
请求合并 |
当页面内多个使用同一数据源的组件同时刷新时，合并进行一次数据请求，默认开启。仅当开启页面设置中的合并请求时有效。更多信息，参见 自定义页面属性。 |
允许最大化 |
选择此项可将组件根据浏览器大小放大至撑满页面的全屏效果。 |
允许数据导出 [1] |
选择此项后，可下载 CSV 格式的展示数据。 |
图表内边距 |
指定组件内的相应间距。 |
背景色 |
为组件选择背景色。 |
标题装饰 |
选择标题的装饰方式。 |
上装饰线 |
添加容器的上边界装饰线。 |
下装饰线 |
添加容器的下边界装饰线。 |
数据项¶
字段 |
说明 |
|---|---|
数据源 |
选择数据源。若选择内置数据源，需要根据所选数据源种类配置数据源参数。详细信息，参见 内置数据源参数 <#dspara>。 |
类别 |
选择要展示的数据类别。 |
聚合 |
选择要使用原始数据还是聚合数据。参见 聚合。 |
维度、对比、度量、拓展 |
根据所选组件选择数据项。每个组件所需的数据项数量可能不同。更多信息，参见相应组件的参考页面。 |
别名 |
为字段添加别名以显示在图表中。 |
单位 |
为字段添加单位，优先级高于数据原始单位。 |
备注
如需为组件配置多个数据源中的数据，联系系统管理员。
如果更改数据源或类别，当前数据项将失效，但不会被自动清除。可替换当前数据项以保留图表样式，或移除当前数据项从头开始重新配置图表样式。
如果将现有图表更改为与现有数据项不兼容的新图表类型，将重置所有数据项，用户需要对数据项进行重新配置操作。例如，如果选择了维度字段，并且已将图表类型更改为环形仪表盘类型（不使用维度字段），所有数据项会被重置。
内置数据源参数
若使用内置数据源，应用构建者可通过配置数据源参数，对数据进行预处理，实现诸如聚合或过滤数据等目的。
TSDB¶
对于 TSDB 类型的数据源，应用构建者可在 图表设置 面板的 数据 标签页中配置以下信息（未列出没有参数的数据源）。
LatestData¶
配置项 |
可选/必需 |
描述 |
|---|---|---|
资产 ID |
必需 |
需要在页面中展示的资产的 ID，不填则展示指定“类别”下的全部资产。 |
Electric Power¶
配置项 |
可选/必需 |
描述 |
|---|---|---|
开始时间 |
必需 |
查询数据的开始时间。 |
结束时间 |
必需 |
查询数据的结束时间。 |
聚合类型 |
可选 |
按指定聚合粒度查询时，聚合粒度内数据的聚合方式。例如若选择“avg”，则会对聚合粒度内的数据取平均值。 |
聚合粒度 |
可选 |
数据聚合的时间粒度。例如，若选择 5 min，则对每 5 分钟内的时序数据进行一次聚合。 |
资产 ID |
可选 |
需要在页面中展示的资产的 ID，不填则展示指定“类别”下的全部资产。 |
Raw Data¶
配置项 |
可选/必需 |
描述 |
|---|---|---|
开始时间 |
必需 |
查询数据的开始时间。 |
结束时间 |
必需 |
查询数据的结束时间。 |
资产 ID |
可选 |
需要在页面中展示的资产的 ID，不填则展示指定“类别”下的全部资产。 |
DI Data¶
配置项 |
可选/必需 |
描述 |
|---|---|---|
开始时间 |
必需 |
查询数据的开始时间。 |
结束时间 |
必需 |
查询数据的结束时间。 |
资产 ID |
可选 |
需要在页面中展示的资产的 ID，不填则展示指定“类别”下的全部资产。 |
AI Raw¶
配置项 |
可选/必需 |
描述 |
|---|---|---|
开始时间 |
必需 |
查询数据的开始时间。 |
结束时间 |
必需 |
查询数据的结束时间。 |
资产 ID |
可选 |
需要在页面中展示的资产的 ID，不填则展示指定“类别”下的全部资产。 |
AI Aggregation¶
配置项 |
可选/必需 |
描述 |
|---|---|---|
开始时间 |
必需 |
查询数据的开始时间。 |
结束时间 |
必需 |
查询数据的结束时间。 |
聚合类型 |
可选 |
按指定聚合粒度查询时，聚合粒度内数据的聚合方式。例如若选择“avg”，则会对聚合粒度内的数据取平均值。 |
聚合粒度 |
可选 |
数据聚合的时间粒度。例如，若选择 5 min，则对每 5 分钟内的时序数据进行一次聚合。 |
资产 ID |
可选 |
需要在页面中展示的资产的 ID，不填则展示指定“类别”下的全部资产。 |
Generic¶
配置项 |
可选/必需 |
描述 |
|---|---|---|
开始时间 |
必需 |
查询数据的开始时间。 |
结束时间 |
必需 |
查询数据的结束时间。 |
资产 ID |
可选 |
需要在页面中展示的资产的 ID，不填则展示指定“类别”下的全部资产。 |
通用数据服务¶
对于通用数据服务类型的数据源，应用构建者可在 图表设置 面板的 数据 标签页中配置以下信息。
Timeseries¶
配置项 |
可选/必需 |
描述 |
|---|---|---|
开始时间 |
必需 |
查询数据的开始时间。 |
结束时间 |
必需 |
查询数据的结束时间。 |
聚合类型 |
可选 |
按指定聚合粒度查询时，聚合粒度内数据的聚合方式。例如若选择“avg”，则会对聚合粒度内的数据取平均值。 |
聚合粒度 |
可选 |
数据聚合的时间粒度。例如，若选择 5 min，则对每 5 分钟内的时序数据进行一次聚合。 |
自动获取资产 |
可选 |
是否自动获取此类别下所有资产的数据。 |
资产 ID |
可选 |
需要在页面中展示的资产的 ID，不填则展示指定“类别”下的全部资产。 |
dimension |
可选 |
用于聚合查询或筛选指标的维度类型。 |
占位 |
可选 |
是否将无数据上送的的点显示为空值。 |
插补 |
可选 |
是否采用空值前的最新数据补齐空值。 |
显示资产数据 |
可选 |
当设备某一数据不存在时，是否仍展示此设备的其他数据。 |
查询类型 |
可选 |
|
Realtime¶
配置项 |
可选/必需 |
描述 |
|---|---|---|
开始时间 |
必需 |
查询数据的开始时间。 |
结束时间 |
必需 |
查询数据的结束时间。 |
累计粒度 |
可选 |
实时数据查询的时间间隔。例如，若选择 Day，则按天查询并聚合实时数据。 |
自动获取资产 |
可选 |
是否自动获取此类别下所有资产的数据。 |
资产 ID |
可选 |
需要在页面中展示的资产的 ID，不填则展示指定“类别”下的全部资产。 |
显示资产数据 |
可选 |
当设备某一数据不存在时，是否仍展示此设备的其他数据。 |
查询类型 |
可选 |
|
Alarm¶
配置项 |
可选/必需 |
描述 |
|---|---|---|
开始时间 |
必需 |
查询数据的开始时间。 |
结束时间 |
必需 |
查询数据的结束时间。 |
数据量 |
可选 |
需要在页面中展示的数据量。 |
起始数据序号 |
可选 |
首个获取的告警信息对应的序号。 |
资产类型 |
可选 |
需要在页面中展示的资产类型。 |
资产 ID |
可选 |
需要在页面中展示的资产的 ID，不填则展示指定“类别”下的全部资产。 |
告警父类型 ID |
可选 |
需要在页面中展示的告警父类型的 ID。 |
告警类型 ID |
可选 |
需要在页面中展示的告警类型的 ID。 |
设备类型 ID |
可选 |
需要在页面中展示的设备类型的 ID。 |
告警 ID |
可选 |
需要在页面中展示的告警 ID。 |
Topology¶
配置项 |
可选/必需 |
描述 |
|---|---|---|
资产 ID |
可选 |
需要在页面中展示的资产的 ID，不填则展示指定“类别”下的全部资产。 |
Topology ID |
可选 |
需要在页面中展示的拓扑规则的标识符。 |
ifCut |
可选 |
是否仅显示与所选类别下的资产相关联的拓扑结构。 |
累计粒度 |
可选 |
数据查询的时间间隔。例如，若选择 Day，则按天查询并聚合数据。 |
显示资产数据 |
可选 |
当设备某一数据不存在时，是否仍展示此设备的其他数据。 |
Record¶
配置项 |
可选/必需 |
描述 |
|---|---|---|
起始数据序号 |
可选 |
首个获取的告警信息对应的序号。 |
数据量 |
可选 |
需要在页面中展示的数据量。 |
指标管理¶
对于指标管理类型的数据源，应用构建者可在 图表设置 面板的 数据 标签页中配置以下信息。
Metric¶
配置项 |
可选/必需 |
描述 |
|---|---|---|
配置项 |
可选/必需 |
描述 |
开始时间 |
必需 |
查询数据的开始时间。 |
结束时间 |
必需 |
查询数据的结束时间。 |
mdmIdNotNull |
可选 |
mdmId 是否为必填。 |
资产 ID |
可选 |
需要在页面中展示的资产的 ID，不填则展示指定“类别”下的全部资产。 |
mdmId |
可选 |
维度表的主键，通常为业务对象标识符，可用于为全局过滤器传递参数。 |
GroupBy |
可选 |
GROUP BY 子句中的维度，基于特定维度按组分类查询数据。 |
Fact Table¶
配置项 |
可选/必需 |
描述 |
|---|---|---|
配置项 |
可选/必需 |
描述 |
开始时间 |
必需 |
查询数据的开始时间。 |
结束时间 |
必需 |
查询数据的结束时间。 |
pageNo |
可选 |
查询数据的起始页码。 |
pageSize |
可选 |
分页查询时单页返回记录的条数。 |
时间字段 |
可选 |
事实表中表示时间的字段。 |
timeGroup |
可选 |
用于聚合数据的时间粒度。 |
对数据项排序¶
可以选择数据项中的数据在图表上的展示顺序。
可用选项为：
默认：按原始数据的相同顺序展示。
升序：按升序展示。
降序：按降序展示。
备注
同一组件的数据项只能有一种顺序，优先级顺序为 维度、对比 和 度量。例如，如果为维度选择排序顺序，将忽略对比和度量的排序顺序。如果 维度 或 度量 中有多个数据项，则添加的第一个数据项将优先排序。
若 X 轴上添加的第一个度量具有零值，将采用具有非零值的下一个度量的排序顺序。
聚合
可以聚合具有 相同 维度和对比数据值的度量数据值。如果没有选择维度和对比数据项，则同一个字段的度量值将仅作为单个值聚合并返回。
例如，月份 7 月具有 5 和 10 这两个记录。选择 聚合 以及函数 求和 后，这两个值将相加并展示为 15。
DTV 支持使用以下函数进行聚合：
函数 |
说明 |
|---|---|
求和 |
返回度量值的未加权总和。 |
平均 |
返回度量值的平均值。 |
去空平均 |
返回非空度量值的平均值。例如，如果有 10 个值，其中 6 个是非空值，则真值平均将返回 6 个非空值的平均值（而平均函数将返回所有 10 个值的平均值）。 |
最大 |
返回最大度量值。 |
最小 |
返回最小度量值。 |
最前 |
返回第一个度量值。 |
最后 |
返回最后一个度量值。 |
计数 |
返回度量值的数量。 |
去重计数 |
返回唯一度量值的数量。 |