URL 参数说明¶
在配置统一监测的菜单时,应用构建者可以在 URL 中填写参数来实现特定效果。本文介绍统一监测各个功能支持的 URL 参数。
URL 参数格式¶
在 URL 中添加参数时需要遵循特定格式,其中:
- 资产概览、资产列表、曲线工具以及通用指标查询的 URL 参数格式为
?参数名1=参数值1&参数名2=参数值2
。 - 可配置页面的 URL 参数格式分为以下组成部分:
- DTV 页面 URL 参数格式:
?dt=DTV页面发布时生成的URL
。此参数为可配置页面菜单的必填参数。 - 其他参数格式:
"参数名1":"参数值1","参数名2":[{"子参数名1":"子参数值1","子参数名2":"子参数值2"}, {"子参数名3":"子参数值3","子参数名4":"子参数值4"}]
。
- DTV 页面 URL 参数格式:
资产概览参数¶
资产概览的默认 URL 为:/encompass-monitor-hmi/#/portfolio/runtime
。你可以在 #
前添加 URL 参数。例如: 添加 solarSiteEnlightIframe
参数并输入 true
作为其参数值后资产概览的 URL 地址变为 /encompass-monitor-hmi/?solarSiteEnlightIframe=true#/portfolio/runtime
。资产概览菜单 URL 支持的参数如下所示。
参数名 | 必填/可选 | 描述 |
---|---|---|
disablePageJump | 可选 |
|
defaultNodeId | 可选 |
|
assetSticky | 可选 |
|
资产列表参数¶
资产列表的默认 URL 为:/encompass-monitor-hmi/#/asset-list
。你可以在 #
前添加 URL 参数。例如: 添加 timeTypes
与 siteTypes
参数并分别输入 realtime
与 EnOS_Solar_Site
作为其参数值后资产列表的 URL 地址变为 /encompass-monitor-hmi/?timeTypes=realtime&siteTypes=EnOS_Wind_Farm,EnOS_Solar_Site#/asset-list
。资产列表菜单 URL 支持的参数如下所示。
参数名 | 必填/可选 | 描述 |
---|---|---|
assetScope | 可选 |
|
timeTypes | 可选 |
|
layoutTypes | 可选 |
|
siteTypes | 可选 |
|
enableBlockChart | 可选 |
|
siteTypes | 可选 |
|
deviceTypes | 可选 |
|
filterByDomain | 可选 |
|
srTypes | 可选 |
|
controlTypes | 可选 |
|
controlMaxNum | 可选 |
|
showDeviceHierarchy | 可选 |
|
showTime | 可选 |
|
assetSticky | 可选 |
|
filterByDomain | 可选 |
|
summaryPosition | 可选 |
|
showSummaryTitle | 可选 |
|
state | 可选 |
|
defaultSiteTypes | 可选 |
|
defaultDeviceType | 可选 |
|
nodeIds | 可选 |
|
deviceNodeIds | 可选 |
|
cardFilter | 可选 |
|
showFilter | 可选 |
|
曲线工具参数¶
曲线工具的默认 URL 为:/encompass-monitor-hmi/#/charting-tool
。你可以在 #
前添加 URL 参数。例如: 添加 openRaw
参数并输入 true
作为其参数值后曲线工具的 URL 地址变为 /encompass-monitor-hmi/?openRaw=true#/charting-tool
。曲线工具菜单 URL 支持的参数如下所示。
参数名 | 必填/可选 | 描述 |
---|---|---|
openRaw | 可选 |
|
devciceTreeTypes | 可选 |
|
siteTypes | 可选 |
|
通用指标查询参数¶
通用指标查询的默认 URL 为:/encompass-monitor-hmi/#/metric-tool
。你可以在 #
前添加 URL 参数。例如: 添加 subjects
参数并输入 site
作为其参数值后通用指标查询的 URL 地址变为 /encompass-monitor-hmi/?subjects=site#/metric-tool
。通用指标查询菜单 URL 支持的参数如下所示。
参数名 | 必填/可选 | 描述 |
---|---|---|
subjects | 可选 |
|
checkableSiteTypes | 可选 |
|
siteTypes | 可选 |
|
orderType | 可选 |
|
devciceTreeTypes | 可选 |
|
bigDataMdmTypes | 可选 |
|
groupKey | 可选 |
|
可配置页面参数¶
可配置页面的默认 URL 为:/encom-landing-page/?url=&landingpage={}
。一个典型的可配置页面 URL 示例如下。
/encom-landing-page/?url=/dt/encompass/page/2c3e40eb-821d-4224-bae2&landingpage={"theme": "dark","welcome":true, "dtvOptions":{},"filters":[{"type":"asset","siteTypes":"EnOS_Wind_Farm,EnOS_Solar_Site","checkable":true,"aggTypes": "region","show":false}, {"type":"time","format": "YYYY-MM-DD HH:mm:ss","range":true,"showRange":true,"showInterval":true,"showShortcut":true}]}
其中,url
参数的值为 /dt/encompass/page/2c3e40eb-821d-4224-bae2
。可配置页面菜单 URL 支持的参数如下所示。
参数名 | 必填/可选 | 描述 |
---|---|---|
url | 可选 | 发布数字孪生可视化页面时生成的 URL。 |
welcome | 可选 |
|
theme | 可选 |
|
title | 可选 |
|
dtvOptions | 可选 |
|
controlOptions | 可选 |
|
filters | 必填 | 设置可配置页面筛选器的参数。其形式为包含多个子参数的数组。 |
type | 必填 |
资产筛选器参数 ¶
当 filters
参数中 "type":"asset"
时,可为 filters
参数配置以下子参数。
参数名 | 必填/可选 | 描述 |
---|---|---|
siteTypes | 可选 |
|
checkable | 可选 |
|
aggTypes | 可选 |
|
groupLevelVisible | 可选 |
|
deviceTypes | 可选 |
|
deviceCheckable | 可选 |
|
deviceTreeType | 可选 |
|
assetSticky | 可选 |
|
show | 可选 |
|
deviceShow | 可选 |
|
defaultNodeIds | 可选 |
|
deviceSortAttribute | 可选 | 设备筛选器上展示的设备属性及其顺序。默认不展示。 |
assetTypeVisible | 可选 |
|
deviceTypeVisible | 可选 |
|
时间筛选器参数 ¶
当 filters
参数中 "type":"time"
时,可为 filters
参数配置以下子参数。
参数名 | 必填/可选 | 描述 |
---|---|---|
format | 必填 |
|
showRange | 可选 |
|
showShortcut | 可选 |
|
showInterval | 可选 |
|
defaultInterval | 可选 |
|
intervalSelect | 可选 |
|
timeRange | 可选 |
|
defaultShortcut | 可选 |
|
minStartTime | 可选 |
|
maxEndTime | 可选 |
|
可配置页面输出参数¶
为了确保可配置页面中的筛选器可正常使用,需要在数字孪生可视化指标页面中添加全局过滤器,并将全局过滤器的键值设置为以下值。有关全局过滤器的更多信息,参见 添加全局过滤器。
键值 | 条件 | 说明 |
---|---|---|
nodeName | 资产筛选器已启用。 | 当前选中的节点名称。 |
siteIds | 资产筛选器已启用。 | 当前选中的组织结构节点对应的场站 ID。 |
allGroupMdmIds | 场站或区域资产筛选器已启用。 | 汇总显示所选场站或区域的数据。 |
groupMdmIds | 场站或区域资产筛选器已启用。 | 分别显示每个场站或区域的数据。 |
mdmIdsByRegion | 场站或区域资产筛选器已启用。 | 按区域显示所选场站的数据。 |
mdmIdsByType | 场站或区域资产筛选器已启用。 | 按场站类型显示所选场站的数据。 |
{type}GroupMdmIds | 场站或区域资产筛选器已启用。 |
|
deviceIds | 设备资产筛选器已启用。 | 当前选中的设备。 |
mdmId | 设备资产筛选器已启用。 | 当前选中的设备或场站。 |
startTime | 时间筛选器已启用。 | 时间范围选择器中的开始时间。 |
endTime | 时间筛选器已启用。 | 时间范围选择器中的结束时间。 |
startOfMonth | 时间筛选器已启用。 | 开始时间当月的第一秒。 |
endOfMonth | 时间筛选器已启用。 | 结束时间当月的最后一秒。 |
startOfYear | 时间筛选器已启用。 | 开始时间当年的第一秒。 |
endOfYear | 时间筛选器已启用。 | 结束时间当年的最后一秒。 |
interval | 时间筛选器已启用。 | 当前选中时间范围的时间间隔,支持日(D)、月(M)以及年(Y)。 |
appId | / | 当前页面在应用门户中的 appId。 |
menuCode | / | 当前页面在应用门户中的 menuCode。 |