• Documentation
  • URL Parameter Reference

URL Parameter Reference


When configuring the menus of Unified Monitoring pages, application creators can configure the functions or styles of the page by configuring the parameters in menu URL addresses. The page describes the parameters of the URL addresses for each Unified Monitoring module.

URL Parameter Format


URL parameters appear in URLs by the following formats:

  • For Portfolio, Asset List, Charting Tool, and Common KPI Inquiry, the format of URL parameters is ?parameter1=value1&parameter2=value2.
  • For Landing Page, the format of URL parameters contains the following parts:
    • For the parameter referring to Digital Twin Visualization (DTV) page: ?dt={URL generated by publishing DTV page}. This parameter is required in Landing Page URL.
    • For other Landing Page URL parameters: "parameter1":"value1","parameter2":[{"subparameter1":"subvalue1","subparameter2":"subvalue2"}, {"subparameter3":"subvalue3","subparameter4":"subvalue4"}].

Portfolio Parameter


The URL of a Portfolio page is /encompass-monitor-hmi/#/portfolio/runtime by default. You can add supported parameters before the #. For example, add solarSiteEnlightIframe and set the valuye as true, and the configured URL will be /encompass-monitor-hmi/?solarSiteEnlightIframe=true#/portfolio/runtime. Portfolio supports the following URL parameters.


Parameter Required/Optional Description
disablePageJump Optional
  • The function to open specified URLs by selecting asset icons in asset maps.
  • Enter true to enable this function, or false to disable this function.
defaultNodeId Optional
  • The asset of which the information displayed on the Portfolio page by default.
  • Enter an asset ID as the parameter value. To acquire asset IDs, contact the system administrators.
assetSticky Optional
  • The function to display the last visited asset information when opening the Portfolio page.
  • Enter solar to enable this function, or leave the value blank to disable this function.

Asset List Parameter


The URL of an Asset List URL is /encompass-monitor-hmi/#/asset-list by default. You can add supported parameters before the #. For example, add timeTypes and siteTypes, then set realtime and EnOS_Solar_Site as the parameter values, and the configured URL will be /encompass-monitor-hmi/?timeTypes=realtime&siteTypes=EnOS_Wind_Farm,EnOS_Solar_Site#/asset-list. Asset List supports the following URL parameters.


Parameter Required/Optional Description
assetScope Optional
  • The type of Asset List.
  • Enter device for device list, site for site list, or region for region list.
timeTypes Optional
  • The supported data type of Asset List.
  • Enter history for historical data, realtime for real-time data, or realtime_history for both historical and real-time data.
layoutTypes Optional
  • The supported layout style of Asset List.
  • Enter table for list style, block for card style, and table,block for both list and card styles.
siteTypes Optional
  • The asset type and order displayed in Asset List.
  • Enter the IDs of asset types separated by commas(,). To acquire asset type IDs, contact the system administrators.
enableBlockChart Optional
  • The function to display data charts in the card style of Asset List.
  • Enter true to enable this function, or false to disable this function.
siteTypes Optional
  • The supported site type of a site list. All site types in the current OU are supported by default.
  • Enter the IDs of site types separated by commas(,). To acquire site type IDs, contact the system administrators.
deviceTypes Optional
  • The supported device type of a device list. All device types are supported by default.
  • Enter the IDs of device types separated by commas(,). To acquire device type IDs, contact the system administrators.
filterByDomain Optional
  • The function to display domain or type name on the site type filter.
  • Enter true to enable this function, or false to disable this function.
srTypes Optional
  • The device types that support sending Service Request (SR). No device type supports this function by default.
  • Enter the IDs of device types separated by commas(,). To acquire device type IDs, contact the system administrator.
controlTypes Optional
  • The device types that supports batch control. No device type supports this function by default.
  • Enter the IDs of device types separated by commas(,). To acquire device type IDs, contact the system administrator.
controlMaxNum Optional
  • The maximum number of devices that can be controlled at a single time.
  • Enter an integer as the parameter value.
showDeviceHierarchy Optional
  • The function to display hierarchical asset filter.
  • Enter true to enable this function, or false to disable this function.
showTime Optional
  • The function to display the current time and last updated time on the bottom of the Asset List pages.
  • Enter true to enable this function, or false to disable this function.
assetSticky Optional
  • The function to display the last visited asset information when opening the Portfolio page.
  • Enter solar to enable this function, or leave the value blank to disable this function.
filterByDomain Optional
  • The function to filter sites by domain or by asset tree nodes in site filters.
  • Enter true to filter by domain, or false to filter by asset tree nodes.
summaryPosition Optional
  • The position of the summary row.
  • Enter bottom to display the summary row at the bottom of the list, top to display the summary row at the top of the list, or false to hide the summary row.
showSummaryTitle Optional
  • The function to display the title of the summary row, such as sum or formula.
  • Enter true to enable this function, or false to disable this function.
state Optional
  • The default view displayed when application users opens the Asset List page.
  • Including the following sub-parameters defaultSiteTypes, defaultDeviceType, nodeIds, deviceNodeIds, cardFilter, showFilter. Each sub-parameter appears as a key-value pair, and is separated by &. For example: state=defaultSiteTypes%3D{mdmType}%26nodeIds%3D{nodeId}%26cardFilter%3DGenSiteState*2.
defaultSiteTypes Optional
  • A sub-parameter of state. The displayed site types by default.
  • Enter the IDs of site types separated by commas(,). To acquire site type IDs, contact the system administrators.
defaultDeviceType Optional
  • A sub-parameter of state. The displayed device types by default.
  • Enter the IDs of device types separated by commas(,). To acquire device type IDs, contact the system administrators.
nodeIds Optional
  • A sub-parameter of state. The displayed assets by default.
  • Enter the IDs of assets separated by commas(,). To acquire asset IDs, contact the system administrators.
deviceNodeIds Optional
  • A sub-parameter of state. The displayed device by default, only affective when showDeviceHierarchy is true.
  • Enter the IDs of devices separated by commas(,). To acquire device IDs, contact the system administrators.
cardFilter Optional
  • A sub-parameter of state, appearing as key-value pairs. The filter conditions applied be default.
  • Enter key for the ID of a data field, value for the data, and separated the key and value by an asterisk “*”. For example, GenActivePower*<2 represents selecting sites with less than 2KW active power by default.
showFilter Optional
  • A sub-parameter of state. The filters supported by the Asset List page.
  • Enter siteType for site type filter, site for site filter, deviceType for device type filter, deviceTopology for device filter by hierarchy, timeRange for time range filter none for no filters supported and leave the value blank for all filters.

Charting Tool Parameter


The URL of a Charting Tool URL is /encompass-monitor-hmi/#/charting-tool by default. You can add supported parameters before the #. For example, add openRaw as true, and the configured URL will be /encompass-monitor-hmi/?openRaw=true#/charting-tool. Charting Tool supports the following URL parameters.


Parameter Required/Optional Description
openRaw Optional
  • The function to set the time interval as raw, which is the interval specified in Common Data Service when registering data fields.
  • Enter true to enable this function, or false to disable this function.
deviceTreeTypes Optional
  • The asset tree styles supported by Charting Tool.
  • Enter flat to display asset trees by list, hierarchy to display asset trees by hierarchy, or enter both flat and hierarchy and separate by a comma (,) to support both styles and display the first style by default.
siteTypes Optional
  • The asset type and order displayed in Charting Tool.
  • Enter the IDs of asset types separated by commas(,). To acquire asset type IDs, contact the system administrators.

Common KPI Inquiry Parameter


The URL of a Common KPI Inquiry URL is /encompass-monitor-hmi/#/metric-tool by default. You can add supported parameters before the #. For example, add subjects as site, and the configured URL will be /encompass-monitor-hmi/?subjects=site#/metric-tool. Common KPI Inquiry supports the following URL parameters.


Parameter Required/Optional Description
subjects Optional
  • The asset types supported by the Common KPI Inquiry page, which affects the items in the Asset Granular dropdown list.
  • Enter device, site, deviceGroup or multiple items separated by commas (,). If you enter multiple items, the first item displays on the page by default.
checkableSiteTypes Optional
  • The domains supporting comparison on devices in multiple sites.
  • Enter the IDs of asset types separated by commas(,). To acquire asset type IDs, contact the system administrators.
siteTypes Optional
  • The asset type and order displayed in Common KPI Inquiry.
  • Enter the IDs of asset types separated by commas(,). To acquire asset type IDs, contact the system administrators.
orderType Optional
  • Specify the display order of assets on the Common KPI Inquiry.
  • Enter default to display sites in order of asset tree nodes and device groups or devices in alphabetical order, or input to display in custom order. To customize the order for input, contact the system administrators.
deviceTreeTypes Optional
  • The asset tree styles supported by Common KPI Inquiry.
  • Enter flat to display asset trees by list, hierarchy to display asset trees by hierarchy, or enter both flat and hierarchy and separate by a comma (,) to support both styles and display the first style by default.
bigDataMdmTypes Optional
  • The device types supporting “Select All” function when querying relevant data, suitable for scenarios with massive devices.
  • Enter the IDs of device types separated by commas(,). To acquire device type IDs, contact the system administrators.
groupKey Optional
  • The function to enable configured business object groups. To configure business object groups, contact the system administrator.
  • Enter Metric_Tool to enable this function, or leave the value blank to disable this function.

Landing Page Parameter


The URL of a Common KPI Inquiry URL is /encom-landing-page/?url=&landingpage={} by default.

A typical Landing Page URL is shown as below.


/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}]}


The url parameter is required, and the parameter value in the example above is /dt/encompass/page/2c3e40eb-821d-4224-bae2. Landing Page supports the following URL parameters.


Parameter Required/Optional Description
url Required The URL generated when you publish Digital Twin Visualization pages.
welcome Optional
  • The function to display greetings on Landing Page.
  • Enter true to enable this function, or false to disable this function.
theme Optional
  • The theme of Landing Page
  • Enter dark for dark theme, or workbench to follow the current theme of Application Portal.
title Optional
  • The title of Landing Page.
  • Enter texts or the ${nodeName} parameter to represent the current site or region.
dtvOptions Optional
  • The tag of Digital Twin Visualization widget templates. Landing Page synchronize the widget templates with the tags specified here from Digital Twin Visualization.
  • Enter the tag of Digital Twin Visualization widgets or leave the value blank if you don’t want to synchronize widget templates from Digital Twin Visualization.
controlOptions Optional
  • The function to integrate control panel of Fleet Control.
  • Enter “show”: false to disable this function, or {} to enable this function.
filters Required The filters in Landing Page, in the form of an array containing multiple sub-parameters.
type Required
  • A sub-parameter of filters. The type of filters.
  • Enter asset for asset filter, or time for time filter.
navModel Optional
  • A sub-parameter of filters. The display style of asset filter.
  • Enter unifiedAssetTree to display asset filter on the left side of the page, or leave the value blank to display asset filter on the top side of the page.
siteTypes Optional
  • A sub-parameter of filters. The types of sites displayed in the dropdown list of an asset filter.
  • Enter the IDs of site types separated by commas(,), supporting all types in the current OU by default. To acquire site type IDs, contact the system administrators.
checkable Optional
  • A sub-parameter of filters. The function to enable multi selection for items in the dropdown list of filters.
  • Enter true to enable this function, or false to disable this function.
aggTypes Optional
  • A sub-parameter of filters. The asset hierarchy of the current asset tree.
  • Enter site for site scope, or region for region scope.
deviceTypes Optional
  • A sub-parameter of filters. The types of devices displayed in the dropdown list of an asset filter.
  • Enter the IDs of device types separated by commas(,), supporting all types in the current OU by default. To acquire device type IDs, contact the system administrators.
deviceCheckable Optional
  • A sub-parameter of filters. The function to select multiple devices.
  • Enter true to enable this function, or false to disable this function.
deviceTreeType Optional
  • A sub-parameter of filters. The display style of asset tree.
  • Enter flat to display asset trees by list, hierarchy to display asset trees by hierarchy.
assetSticky Optional
  • The function to display the last visited asset information when opening the Landing Page.
  • Enter solar to enable this function, or leave the value blank to disable this function.
show Optional
  • A sub-parameter of filters. The function to display filters.
  • Enter true to enable this function, or false to disable this function.
defaultNodeIds Optional
  • A sub-parameter of filters. The asset selected by default.
  • Enter an asset ID to select a specific asset, _first_ to select the first asset in the current asset tree, or leave the value blank to select all assets in the current asset tree.
format Optional
  • A sub-parameter of filters. The format of time.
  • Enter YYYY-MM-DD HH:mm:ss or YYYY-MM-DD.
showRange Optional
  • A sub-parameter of filters. The method of time selection, supporting selecting by time periods or time points.
  • Enter true for selecting by time periods, or false for selecting by time points.
showShortcut Optional
  • A sub-parameter of filters. The function to display shortcut buttons for time selection.
  • Enter true to enable this function, or false to disable this function.
showInterval Optional
  • A sub-parameter of filters. The function to display time interval filter.
  • Enter true to enable this function, or false to disable this function.
defaultShortcut Optional
  • A sub-parameter of filters. The shortcut buttons for time period selected by default.
  • Enter YDA for yesterday, WTD for this week, 7d for the last 7 days, MTD for this month, 30d for the last 30 days, QTD for this quarter, 6m for the last 6 months, 12m for the last 12 months, YTD for this year, 3y for the last 3 years.
minStartTime Optional
  • A sub-parameter of filters, the earliest time displayed in time filters by days.
  • For example, enter “-90d” to set the earliest time supported as 90 days before.
maxEndTime Optional
  • A sub-parameter of filters, the latest time displayed in time filters by days.
  • For example, enter “+0d” to set the latest time supported as today.