• 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.