• 文档
• URL 参数说明

URL 参数说明

统一监测页面支持直接 URL query、应用门户 SDK state 和页面内部 params。不同模块协议不同，错误的放置位置或编码方式会导致参数不生效。

通用规则

1. query 应放在 # 之前，例如 /encompass-monitor-hmi/?assetScope=device#/asset-list。

2. 页面形态类参数应固化在菜单 URL；应用门户 SDK 不能任意追加 query。

3. 同名参数同时出现在直接 query 和 state 时，页面通常优先读取直接 query。

4. state 协议因模块而异：

模块	state 格式	说明
资产列表	query-string	例如 nodeIds=SITE001&defaultDeviceType=WTG，整体进行 URL 编码。
通用指标查询	query-string	其中 params 的值是 JSON 字符串。
曲线工具	整个 state 为 JSON	结构通常为 {params, target}。
资产概览	建议使用直接 query	页面形态和初始行为预先配置在目标菜单 URL。

跨模块参数

参数	作用	条件与限制
appId / menuCode	指定应用和菜单上下文。	通常由 应用门户 提供。
disableMultipleAssetTree	设为 true 时隐藏多资产树切换。	仅影响入口，不改变资产权限。
useAssociatedResource	设为 true 时启用关联资源。	目标环境和页面需支持关联资源。
filterParentNodes	设为 true 时过滤无权限父节点。	与节点可见但不可选的权限校验不同。
locale	指定页面语言。	需为目标环境支持的语言。

资产概览参数

默认路由：/encompass-monitor-hmi/#/portfolio/runtime。

参数	作用	说明
disablePageJump	设为 true 时禁用页面下钻和部分详情跳转。	不是“启用跳转”。
defaultNodeId / nodeIds	尝试预选资产树节点。	节点必须存在于当前资产树并满足页面维度。
assetSticky	设为 solar 时尝试恢复上次选择的资产。	按页面记录范围恢复。
windSiteRotatingIconColors	指定触发风电场图标旋转的颜色，多个值用逗号分隔。	仅相应图标样式生效。
solarSiteIcon	设为 yellow 时启用对应光伏动态图标。	其它历史值不支持。
tiandiKey	传入天地图密钥。	仅使用天地图且环境未提供密钥时需要。
disableMultipleAssetTree / useAssociatedResource / filterParentNodes	控制资产树相关行为。	参见跨模块参数。

历史参数 solarSiteEnlightIframe、CDSCacheControl 和 filterByDomainsolarSiteIcon 不应再用于新菜单。

资产列表参数

默认路由：/encompass-monitor-hmi/#/asset-list。

页面形态参数（直接 query）

参数	取值/示例	作用
assetScope	site / region / device	指定场站、区域或设备维度。
timeTypes	realtime / history / realtime,history	指定实时、历史或两种数据类型；默认实时。
layoutTypes	table / block / piece，可逗号组合	指定表格、卡片或精简卡片视图。
enableBlockChart	true / false	控制卡片趋势图。
siteTypes / deviceTypes	mdmType，逗号分隔	限制场站或设备类型及顺序。
summaryPosition	top / bottom / false	指定汇总行位置或关闭汇总。
showSummaryTitle / showTime	true / false	控制汇总前缀和页面时间信息。
showDeviceHierarchy	true / false	控制设备层级筛选能力。
filterByDomain	true / false	控制资产类型筛选按领域展示。
srTypes / controlTypes / batchControlTypes	mdmType，逗号分隔	限制服务请求、单点控制或批量控制适用类型。
controlMaxNum	正整数	限制单次批量控制数量。
assetSticky / useAssociatedResource / disableMultipleAssetTree	见跨模块规则	控制资产记忆、关联资源和多树入口。

可通过直接 query 或 query-string state 传递

参数	作用	注意事项
defaultSiteTypes	默认选中的场站类型。	多个值用逗号分隔。
defaultDeviceType	默认选中的设备类型。	多选模式可保留多个，单选模式通常取首个有效值。
nodeIds	预选组织结构/场站节点。	多个 ID 用逗号分隔。
deviceNodeIds	预选设备节点。	需当前页面支持设备选择。
cardFilter	预选指标卡片筛选。	例如 GenSiteState*2 或 GenActivePower<*2000。
showFilter	限制可用筛选器和操作项。	none 隐藏全部；其它值按页面白名单组合。
filterParentNodes	过滤无权限父节点。	默认关闭。

曲线工具参数

默认路由：/encompass-monitor-hmi/#/charting-tool。

顶层参数

参数	作用	说明
disableDataFilter	隐藏或限制数据筛选入口。	页面仍按传入查询条件显示数据。
disableMultipleAssetTree	隐藏多资产树切换。	—
useAssociatedResource / filterParentNodes	控制关联资源和父节点过滤。	仅直接 query。
params	URL 编码后的查询 JSON。	直接 URL 模式使用。
target	modal / blank 等目标形态。	可与 params 一起放在 URL 或 JSON state 中。

曲线工具的参数来源优先级为：应用门户 JSON state → 直接 URL params/target → 当前标签页 sessionStorage。命中第一个有效 params 后忽略后续来源。

params 常用字段

字段	作用	说明
objType	分析对象。	siteGroup / site / device。
metas[]	资产与数据项集合。	每项可含 mdmIds、keys、name、packNames。
startTime / endTime / rangeType	查询时间。	应使用页面支持的时间格式。
interval / timeAggMethod	时间粒度和聚合方法。	可用值取决于数据项。
stackType / isInterpolator	堆叠和插补。	按图表类型生效。
useUTCTime	使用 UTC 时间。	布尔值。
openRaw	允许/使用原始间隔。	属于 params，不是独立顶层 query。
enableAssetSelect	控制资产选择器。	默认 true。
editable	控制结果是否可编辑。	嵌入或跳转场景使用。
theme / bgColor / title	控制展示主题和标题。	—
metaGroups	预置数据分组。	结构需与页面分组协议一致。

deviceTreeTypes、siteTypes、openQuality 属于页面配置或历史参数，不作为当前顶层跳转参数。

通用指标查询参数

默认路由：/encompass-monitor-hmi/#/metric-tool。

页面形态参数（直接 query）

参数	作用	说明
subjects	指定场站、设备组或设备分析对象。	多个值用逗号分隔。
siteTypes / checkableSiteTypes	限制资产类型和可跨场站选择的类型。	—
deviceTreeTypes	指定平铺/层级设备树。	注意正确拼写，不使用历史错误 devciceTreeTypes。
groupKey	指定数据分类字段组。	默认值由页面配置决定。
orderType	按资产树顺序或选择顺序展示。	常用 default / input。
bigDataMdmTypes	指定设备大数据类型。	大数据模式不逐台枚举设备。
openFilter	控制查询筛选入口。	—
regionResourceRegardAsSite	将区域关联资源作为场站选项。	需同时启用关联资源。
exportDetailUrl	指定明细导出地址。	通常要求同源。
disableMultipleAssetTree / useAssociatedResource	控制多树和关联资源。	仅直接 query。

params 与 state

state 为 query-string，其中 params 的值是 JSON。params=useStorage 时，页面从当前标签页 sessionStorage 读取查询配置；该方式仅适合同源同标签页。

params 字段	作用	说明
subject	查询对象。	场站、设备组或设备。
mdmTypes / mdmIds / siteIds	资产类型和资产 ID。	必填组合取决于 subject。
deviceMdmTypes	设备类型。	设备/设备组查询使用。
fields[]	查询的数据列。	每项包含标识符、名称、单位、格式等。
dimensions[]	查询维度。	每项包含维度类型和选中值等。
interval / rangeType	时间粒度和范围类型。	可用值取决于指标和页面配置。
startTime / endTime	查询起止时间。	—
statisticsType	明细或汇总统计。	与维度、小计配置联动。

siteIds、deviceIds、mdmTypes、deviceTypes 不应作为 params 同级的普通顶层 URL 参数。

可配置页面参数

参数	作用	说明
appId / menuCode / accessToken	提供门户上下文。	通常由 应用门户 提供。
url	直接指定 iframe 页面。	目标域名必须满足白名单。
landingpage	传入旧式内联容器配置。	仅存量兼容，不建议新菜单使用。
defaultDeviceType	默认设备类型。	仅直接 query。
disableMultipleAssetTree	隐藏多资产树入口。	默认不隐藏。
pageId	指定页面配置 ID。	—
multiLevelRegion	控制多层区域行为。	目标版本需支持。
state	业务 state。	当前主要使用 query-string 形式的资产上下文。

crumbs 和 autoFirstAsset 不属于当前支持参数。容器构造 iframe 地址时会移除外层 url 和 landingpage，避免向子页面重复传递。

存量 DTV 筛选输出参数

存量 DTV 页面使用全局过滤器接收可配置页面上下文时，常用键如下。具体接入方式以 DTV 版本为准。

键	上下文	说明
nodeName	资产	当前节点名称。
siteIds	资产	当前场站 ID 集合。
allGroupMdmIds / groupMdmIds	资产	全部资产汇总或分组资产 ID。
mdmIdsByRegion / mdmIdsByType	资产	按区域或资产类型分组的 ID。
deviceIds / mdmId	设备	当前设备或场站标识。
startTime / endTime	时间	当前时间范围。
startOfMonth / endOfMonth	时间	当前月份边界。
startOfYear / endOfYear	时间	当前年份边界。
interval	时间	当前日/月/年间隔。
appId / menuCode	应用门户	当前应用和菜单上下文。

历史或不支持参数

模块	参数	处理建议
资产概览	solarSiteEnlightIframe	改用 disablePageJump。
资产概览	CDSCacheControl	缓存策略不属于页面 URL 参数。
资产概览	filterByDomainsolarSiteIcon	改用 solarSiteIcon=yellow。
曲线工具	openQuality / 顶层 deviceTreeTypes / siteTypes	使用页面配置或 params 支持字段。
通用指标查询	devciceTreeTypes	改用正确拼写 deviceTreeTypes。
可配置页面	crumbs / autoFirstAsset	当前不支持。

排查参数不生效

1. 确认 query 位于 # 前并已正确 URL 编码。

2. 确认参数属于当前路由和目标版本。

3. 确认 state 使用了当前模块要求的 query-string 或 JSON 格式。

4. 检查直接 query 是否覆盖了 state 中的同名值。

5. 检查资产 ID、mdmType、菜单和权限是否有效。

6. 对 sessionStorage 方案，确认同源、同标签页并检查读取后是否被清除。