Configuring Landing Pages¶

A Landing Page is a container page in Unified Monitoring: its header can provide asset, time, and control filters according to the configuration, and its main area loads the linked page in an iframe. The asset and time selections in the filter headers are passed to the linked page, which refreshes and displays the business data.

Use Landing Pages to maintain existing embedded pages. Existing pages can continue to be used. For a new composite visualization page, use a Digital Twin Visualization (DTV) single-page application instead.

Prerequisites¶

Before you begin, make sure that:

Your account has access to the Landing Page menu, the required asset permissions, and the required operational permissions. Contact the OU administrator if permissions are missing.
To enter configuration mode, your account also needs the related configuration permission. Without it, Function Configurations is not available at run time. Contact the OU administrator if this permission is missing.
You have prepared the internal page URL to embed. A linked page that must refresh with asset or time filters must integrate the Landing Page SDK.
The domain of the linked-page URL is allowed by the deployment environment iframe-domain allowlist. Same-origin pages can load directly; a URL outside the allowlist is not loaded. Contact the system administrator to configure the allowlist.
To link multiple pages by asset attribute, create the matching attribute in the asset model and populate matching values on asset instances first.

Entering Configuration Mode¶

Select Landing Page from the left navigation pane.
Select Function Configurations at the top of the page to enter configuration mode.

Configuration of a Landing Page is a five-step wizard: Basic Settings, Asset Settings, Time Settings, Control Settings, and Linked Page Settings. After publishing, the system saves the container configuration, including the header filters, linked-page mappings, and control settings; it does not save or change the canvas or widgets of the embedded page.

Note

The unified asset tree and the context menu are global adjunct configuration, not asset settings for an individual Landing Page. Their entry paths are #/menu-conf and #/menu-conf/sub-menu-conf. For more information, see Configuring Unified Asset Tree.

Basic Settings¶

Field	Description and run-time effect	Conditions and Limitations
Show Title	Enabled by default. When enabled, the page title is shown at the top of the page; when disabled, it is not shown.	When enabled, Title can be configured.
Title	Sets the page title and supports localized input. Supports the ${nodeName} (current node name) and ${userName} (current user name) variables.	Appears only when Show Title is enabled.
Theme	Sets the container page theme: `Match Application Portal Theme`, `Black`, `Green`, or `White`.	The default is `Match Application Portal Theme`.
Template Management	When enabled, a DTV template-management entry can appear at the top at run time; when disabled, it is not shown.	Disabled by default; applies only when a DTV page is embedded and the user has the corresponding DTV permission.

Asset Settings¶

When Asset Settings is enabled, asset filters compatible with the current dimension appear in the header at run time. When it is disabled, the page has no asset-filter header and the linked page receives only other enabled context.

Field	Description and run-time effect	Conditions and Limitations
Available Dimension	Sets the asset levels that end users can select. `Site and Above` supports group, region, and site; `Site and Device` supports sites and their devices.	Device type and device-related settings appear only after `Site and Device` is selected.
Grouping	Sets the selectable group, region, and site levels for the `Site and Above` dimension.	Available only when Available Dimension is `Site and Above` and the unified asset tree is not used.
Asset Type	Sets the site asset types that can be selected in the filter.	Required; you can select multiple types and adjust their display order.
Asset Type Filter	When enabled, the asset-type filter is shown; when disabled, asset types cannot be switched at the top.	Controlled by the Asset Settings master switch.
Grouping Filter	When enabled, the group, region, or site hierarchy selection entry is shown.	Applies only to `Site and Above` with grouping configured; enabled by default.
Site Filter	When enabled, the site filter is shown.	Enabled by default; the selection method determines whether multiple selections are supported.
Selection Method	Sets whether the asset filter supports single selection, multiple selection, or combined hierarchy single selection.	The selectable scope is still limited by asset permissions, asset types, and grouping.
Device Type	Sets the device types that can be selected in the filter.	Available only for `Site and Device`; up to 100 types can be selected.
Device Type Filter	When enabled, the device-type filter is shown; when disabled, it is not shown.	Applies only to `Site and Device`.
Device Type Name	Customizes the display name of the device-type filter.	Applies only when the device-type filter is enabled.
Device Type Selection Method	Sets whether device types support single or multiple selection.	Applies only when the device-type filter is enabled.
Device Filter	When enabled, the device filter is shown; when disabled, it is not shown.	Applies only to `Site and Device`. When the number of devices exceeds 1,000, the configuration page warns of a potential performance impact.
Device Name	Customizes the display name of the device filter.	Applies only when the device filter is enabled.
Device Tree Style	Sets whether devices are displayed as a flat list or an asset-hierarchy tree.	Applies only when the device filter is enabled.
Device Sorting	Sets whether devices keep the default order or are sorted by attribute.	If sorting by attribute is selected, a sorting attribute must be selected.
Show Site Time	When enabled, the local time of the current site is shown; when disabled, it is not shown.	The current selection must be a site with a resolvable time zone.
Show Data of Associated Resources	When enabled, the asset context can carry the resources associated with organization nodes.	Availability also depends on the unified asset tree and asset-permission configuration.
Synchronize Assets	When enabled, the previously selected assets are remembered within the current Landing Page and an attempt is made to restore them on later visits.	This does not mean synchronization across tool pages, and it is different from the same-named field in the legacy Unified Asset Tree configuration.
Permission Check	When enabled, the system validates the user’s permission on the assets associated with a node.	Available only for combined hierarchy single selection with associated resources enabled.

Time Settings¶

When Time Settings is enabled, time filters can be shown in the header at run time. When it is disabled, no time-filter header is shown and the linked page does not receive the time-selection context from the container page.

Field	Description and run-time effect	Conditions and Limitations
Time Interval Filter	When enabled, the time-interval selector is shown; when disabled, it is not shown.	Controlled by the Time Settings master switch.
Available Intervals	Sets whether end users can select `Day`, `Month`, or `Year`.	Day, Month, and Year are included by default. Applies only when the time-interval filter is enabled.
Selector Style	Sets whether time intervals are displayed as a list or tiled buttons.	Applies only when the time-interval filter is enabled.
Default Interval	Sets the time interval selected when the page is first opened.	Must be included in Available Intervals. Applies only when the time-interval filter is enabled.
Time Range Filter	When enabled, the time-point or time-range selector is shown.	Controlled by the Time Settings master switch.
Time Format	Sets `YYYY-MM-DD` or `YYYY-MM-DD HH:mm:ss`.	Applies only when the time-range filter is enabled.
Selector Type	Sets whether end users select a single time point or a time range.	The selectable bounds are limited by the earliest and latest available times.
Quick Switch	When enabled, end users can quickly switch to adjacent time periods.	Applies only when a time filter is enabled.
Earliest / Latest Available Time	Limits the lower and upper bounds of the selectable time.	Can be configured as an absolute time or relative to the current time.
Time Shortcut	When enabled, preset time-range entries are shown.	Applies only when the time-range selector is enabled. Shortcut ranges can be further configured.
Specified Time Range	Sets the shortcut time range applied when the page is first opened.	Applies only when time shortcuts are enabled.

Control Settings¶

When Control Settings is enabled, the system allows a Control entry to be shown at run time; when disabled, it is not shown. For the Control entry to actually appear, all of the following must also be met:

The current user has asset-control permission.
The currently selected object is a controllable single site or single device.
Usable control capabilities have been configured for the relevant assets.

Linked Page Settings¶

Linked-page settings determine the page loaded by the iframe. The linked URL must match the deployment environment domain allowlist; otherwise, the page is not loaded.

Field	Description and run-time effect	Conditions and Limitations
Link Type	Select `Single Page URL` or `Link by Attribute`.	Linking by attribute requires prepared asset attributes and values.
URL Address	Sets the single-page URL, or the page URL for each attribute condition.	The URL must match the iframe-domain allowlist.
Select an Attribute	Sets the asset attribute used to match a linked page.	Appears only for `Link by Attribute`.
Condition	Sets the mapping conditions between asset-attribute values and linked pages.	Appears only for `Link by Attribute`.
Page Name	Sets the name of a linked page in the run-time switcher.	Applies only to linking by attribute with multiple usable page mappings configured.
Tab Style	Sets whether multiple usable pages are switched as tabs or buttons.	Applies only to linking by attribute; no switcher is shown when the current context has only one usable mapping.

Configuring URL Parameters¶

A menu URL or Application Portal state can preset the asset scope, a default device type, or behavior such as hiding the multi-asset-tree entry. Parameters differ in where they are passed and in their scope of support; see URL Parameters.

Note

When assembling the iframe address, the Landing Page removes the outer url and landingpage parameters to avoid passing them to the embedded page twice. Configure the parameters required by the embedded page according to that page’s own documentation.

Publishing the Page¶

After you complete the configuration, select Publish, enter a remark as prompted (if required), and select OK. After publishing, end users receive the new container configuration the next time they open the page.

Additional Capabilities When Embedding DTV Pages¶

When the linked page is a DTV page and the application has enabled the corresponding entry, DTV editing capabilities also depend on DTV permissions. These capabilities are provided by the DTV page and are not part of the Landing Page container configuration. For details, refer to the target environment and the Digital Twin Visualization documentation.