Unit 4: Configuring Page Features¶

Operator	Location
Application builder	EnOS Application Portal

Using a multi-domain monitoring page as an example, this unit explains the detailed steps for application builders to configure a Unified Monitoring Landing Page. The sample completed page is shown below.

Application builders can download the Landing Page sample and import it into the Multi-domain Dashboard page of the Smart Monitoring application to quickly reuse the preceding page or view the detailed configuration of the page.

Note

Before importing the sample configuration file, make sure that the version of the Unified Monitoring Landing Page is 2.4.0 or later.

Prerequisites¶

Before you begin, make sure that:

The current account has been assigned the required asset permissions, the configure page permission points, and a menu group containing Smart Monitoring > Multi-domain Dashboard. If it has not, contact the OU administrator.
To associate multiple DTV pages on a Landing Page, make sure that:
- The appropriate attributes have been added to the models that contain the assets in the Model Management menu of Application Portal > Developer Console. For more information about model attributes, see Add Attributes.
- Attribute enumeration values have been added for the assets to be displayed on the page in the Asset Tree > Attributes menu of Application Portal > Developer Console. For more information about the asset tree, see Manage the Asset Tree.
The data of the relevant assets has been retrieved through Common Data Service.
The relevant site types have been configured for the current OU. For example, to monitor the data of wind farms and solar sites, add the following site types.

Name	Identifier	Abbreviation
Wind farm	WindFarm	Wind power
Solar site	SolarSite	Solar

Step 1: Configuring Page Features¶

When application builders access Smart Monitoring > Multi-domain Dashboard for the first time, they see the following page.

Configuring Basic Page Information¶

Configure the title, theme, and other basic information of the Landing Page through the following steps:

Sign in to EnOS Application Portal and select Smart Monitoring > Multi-domain Dashboard from the left navigation pane.
Select the configuration icon in the upper-right corner of the page or the Function Configurations button in the center of the page to open the feature configuration page.
On the feature configuration page, select Basic Settings.
Select Show Title and enter ${nodeName} Overview in the Title box. ${nodeName} is a dynamic parameter that represents the currently selected organizational-structure node, that is, a region or site. In addition, application builders can enter ${userName} to display the user name of the current account in the title.

Select any of the following themes from the Theme drop-down list.

Theme

Description

Example

Follow Application Portal theme

The page theme stays consistent with the current Application Portal theme.

The Dark Application Portal theme corresponds to the Black page theme, the Blue-Green Application Portal theme corresponds to the Green page theme, and the Black-and-White Application Portal theme corresponds to the White page theme.

Black

Black navigation with a dark background.

Select Template Management. Users with the Manage Components and Templates permission can save the page as a template and manage templates in the template panel.

Configuring Asset Features¶

Configure the asset types supported by the page and the asset-related filters and other features through the following steps:

On the feature configuration page, select Asset Settings.
Enable the Asset Settings switch. Other features on the Asset Settings tab can be configured by application builders only after this switch is enabled.
In the Available Dimension drop-down list, select the asset dimension applicable to the monitoring page.
- To display data at the site, region, or group level, select Site and Above and select Group, Region, and Site in the Grouping drop-down list.
- To display data of specific devices at a site, select Site and Device.
In the Asset Type drop-down list, select the asset types to be displayed on the page in order. For example, for a wind farm and solar site monitoring scenario, select Overall, Wind Farm, and Solar. Among them, Overall contains all the other selected asset types.

Note

The entries in the asset type drop-down list come from the site types registered in Common Data Service.
Enable Asset Type Filter, Grouping Filter, and Site Filter, and set the Selection Method of the site filter to Multiple Selection. Among them:
- The asset type filter is located in the top toolbar of the Landing Page and is used to switch the asset types displayed on the current page. Each tab corresponds to an asset type selected by application builders in the Asset Type drop-down list.
- The grouping method filter is located in the top toolbar of the Landing Page and is used to switch the asset level of the current page. Each option is a grouping method selected by application builders in the Grouping drop-down list. For example, when the grouping method is Region, the page displays the data of different regions and end users can only select nodes representing regions in the site filter; when the grouping method is Site, the page displays the data of one or more sites and end users can select one or more nodes representing sites in the site filter.
- The site filter is located in the top toolbar of the Landing Page and is used to filter the groups, regions, or sites displayed on the current page (the available types are determined by the grouping method). Each option is a node in the organizational structure associated with the current application by the OU administrator.
Disable the Synchronize Assets switch. This feature takes effect only when the Selection Method of the site filter is Single Selection. It is used to automatically display the assets selected by end users on the original page and the related data on the new page when end users jump from the current page to a new page.

Configuring Time Features¶

Configure the start and end times of the assets on the page and the time-related filters and other features through the following steps:

On the feature configuration page, select Time Settings.
Enable the Time Settings switch. Other features on the Time Settings tab can be configured by application builders only after this switch is enabled.
Enable Time Interval Filter, select Day, Month, and Year in the Available Intervals drop-down list, and set Default Interval to Day. The time interval filter is used to determine the adjacent time intervals in the time range filter, as shown on the page.
Enable Time Range Filter, set the time format to YYYY-MM-DD (year-month-day), and set Selector Type to Time Range.
After selecting Time Range as the Selector Type, set Earliest Available Time and Latest Available Time to Unlimited and enable Time Shortcut. The time range filter is used to filter the asset data within a specific time range, as shown on the page.

Configuring Control Features¶

Configure the asset control features through the following steps:

On the feature configuration page, select Control Settings.
Disable the Control Settings switch. In this tutorial, end users do not need to control assets.

To control assets on a Landing Page, make sure that:

The Fleet Control component has been acquired and a control panel has been configured for the assets.
The Control Devices permission point has been acquired and the Control Settings switch is enabled.

Configuring Associated Pages¶

Associate the published DTV dashboard pages with Smart Monitoring > Multi-domain Dashboard through the following steps:

On the feature configuration page, select Linked Page Settings.
Set Link Type to Link by Attribute to associate multiple DTV pages with this Landing Page.
Select the Select an Attribute box and select the model attribute used to associate multiple DTV pages in the pop-up window. For example, to associate a different page with each asset type, select the Type attribute.

Note

The attributes here come from the attributes in the models of the current OU. You can quickly view the basic information of an attribute and the model it belongs to in the Select an Attribute pop-up window, or select View (public models) or Edit (private models) of the target model in the Model Management menu of EnOS Application Portal > Developer Console to open the model details page and view or edit the attribute list of the target model on the Feature Definition tab.
In the URL Address list, select Add Condition, enter the enumeration value of the attribute selected in Select an Attribute in the Condition column, and enter the URL of the DTV page in the URL column. Among them:
- If the data type of the attribute is array, a condition, a display name, and a URL need to be configured for each page. For example, to associate wind farm and solar site monitoring by the Monthly_CO2_Emission_Limit (monthly CO2 emission) attribute, enter the following information.

Condition

Tab Name

URL Address

Enter the Monthly_CO2_Emission_Limit attribute value of the wind farm asset, for example, 100.

Enter the name of this tab, for example, Wind Power.

Enter the URL of the wind-domain monitoring metric page, that is, the URL of the Wind page published in Unit 3: Prepare Visualization Pages.

Enter the Monthly_CO2_Emission_Limit attribute value of the solar site asset, for example, 200.

Enter the name of this tab, for example, Solar.

Enter the URL of the solar-domain monitoring metric page, that is, the URL of the Solar page published in Unit 3: Prepare Visualization Pages.

If the data type of the attribute is another data type, a condition and a URL need to be configured for each page. In this case, the display name of the tab is the attribute value in the Condition column. For example, to associate wind farm and solar site monitoring pages by the tags attribute, enter the following information.

Condition

URL Address

Enter the tags attribute value of the wind farm asset, for example, wind.

Enter the URL of the wind-domain monitoring metric page, that is, the URL of the Wind page published in Unit 3: Prepare Visualization Pages.

Enter the tags attribute value of the solar site asset, for example, solar.

Enter the URL of the solar-domain monitoring metric page, that is, the URL of the Solar page published in Unit 3: Prepare Visualization Pages.

To associate wind farm and solar site monitoring pages by the Type (mdmType) attribute, enter the following information.

Note

You do not need to configure the attribute value of the asset’s Type attribute. EnOS automatically reads the model identifier of the model that contains the asset as the attribute value of Type, but make sure that the corresponding asset types have been selected in Asset Settings > Asset Type and the asset type filter is enabled.

Condition

URL Address

Default (that is, Overall in the asset type filter).

Enter the URL of the multi-domain overview monitoring metric page, that is, the URL of the Overview page published in Unit 3: Prepare Visualization Pages.

Enter the model identifier of the model that contains the wind farm asset, for example, EnOS_Wind_Farm.

Enter the URL of the wind-domain monitoring metric page, that is, the URL of the Wind page published in Unit 3: Prepare Visualization Pages.

Enter the model identifier of the model that contains the solar site asset, for example, EnOS_Solar_Site.

Enter the URL of the solar-domain monitoring metric page, that is, the URL of the Solar page published in Unit 3: Prepare Visualization Pages.

After the preceding configuration is completed, end users can switch among the associated pages by selecting tabs in the top toolbar of the Landing Page. Among them:

For a Landing Page associated by the Type attribute, end users can select the asset type tabs in the asset type filter to view the different pages associated with the different asset types.
For a Landing Page associated by another attribute, end users can switch monitoring pages by selecting the tab at the far right of the top toolbar.

Step 2: Publishing the Page¶

After the Multi-domain Dashboard page is configured, publish the page through the following steps so that end users can access the Multi-domain Dashboard page:

On the feature configuration page, select the Publish button in the upper-right corner.
In the pop-up window, enter a note for this release, such as First DTV page association, and select OK.

(Optional) Step 3: Exporting the Page Configuration¶

After completing the preceding operations, application builders can export the current configuration file through the following steps to reuse the page quickly:

On the feature configuration page, hover over Import/Export in the upper-right corner.
Select Export from the drop-down list.

After the page configuration is exported, when the page configuration needs to be reused, application builders can select Import/Export > Import on the feature configuration page to import the original page configuration into a new page.

Step 4: Verifying the Page¶

After completing the preceding configuration, application builders can verify the completed page through the following steps:

On the feature configuration page, select the back icon in the upper-left corner to return to the Multi-domain Dashboard page.
Switch tabs in the top toolbar to view the data of each asset type or each associated DTV page.
Configure the filter conditions of the different filters in the top toolbar to filter the assets and asset data displayed on the page.

If a page or feature is not displayed or cannot be used normally, check the application configuration by following the steps in each unit of this tutorial, or modify it with reference to the common issues listed in Unified Monitoring FAQ.

Next Steps¶

After the application configuration is complete and verified, application builders can contact the OU administrator to assign the required permissions to the users who need to use the application, ensuring that the users can access the menus in the Smart Monitoring application and view the relevant assets, asset data, and the organizational structure information of the assets.

Theme	Description	Example
Follow Application Portal theme	The page theme stays consistent with the current Application Portal theme.	The Dark Application Portal theme corresponds to the Black page theme, the Blue-Green Application Portal theme corresponds to the Green page theme, and the Black-and-White Application Portal theme corresponds to the White page theme.
Black	Black navigation with a dark background.

Condition	Tab Name	URL Address
Enter the Monthly_CO2_Emission_Limit attribute value of the wind farm asset, for example, 100.	Enter the name of this tab, for example, Wind Power.	Enter the URL of the wind-domain monitoring metric page, that is, the URL of the Wind page published in Unit 3: Prepare Visualization Pages.
Enter the Monthly_CO2_Emission_Limit attribute value of the solar site asset, for example, 200.	Enter the name of this tab, for example, Solar.	Enter the URL of the solar-domain monitoring metric page, that is, the URL of the Solar page published in Unit 3: Prepare Visualization Pages.

Condition	URL Address
Enter the tags attribute value of the wind farm asset, for example, wind.	Enter the URL of the wind-domain monitoring metric page, that is, the URL of the Wind page published in Unit 3: Prepare Visualization Pages.
Enter the tags attribute value of the solar site asset, for example, solar.	Enter the URL of the solar-domain monitoring metric page, that is, the URL of the Solar page published in Unit 3: Prepare Visualization Pages.

Condition	URL Address
Default (that is, Overall in the asset type filter).	Enter the URL of the multi-domain overview monitoring metric page, that is, the URL of the Overview page published in Unit 3: Prepare Visualization Pages.
Enter the model identifier of the model that contains the wind farm asset, for example, EnOS_Wind_Farm.	Enter the URL of the wind-domain monitoring metric page, that is, the URL of the Wind page published in Unit 3: Prepare Visualization Pages.
Enter the model identifier of the model that contains the solar site asset, for example, EnOS_Solar_Site.	Enter the URL of the solar-domain monitoring metric page, that is, the URL of the Solar page published in Unit 3: Prepare Visualization Pages.