Configuring Portfolio


The page describes how application creators configure Portfolio pages.

Prerequisites


Before you start, make sure that:

  • You have the required asset permissions, operational permissions, and access permissions for Portfolio pages. Contact the application administrator to get the required permissions.

  • You have registered the attributes, measurement points, and metrics of target assets in Common Data Service (CDS). For more information, see About EnOS Common Data Service.

Configuring Asset Dimensions


Asset Dimension refers to the scope displayed on the asset map of the Portfolio page, containing Global, Region and Site, where

  • Global displays the asset information of sites in multiple regions.

  • Region displays the asset information of sites in a specified region.

  • Site displays the asset information in a specified region.

To configure the details of each dimension, contact the system administrator.


Build a Portfolio page for a specified dimension or covering multiple dimensions by the following steps:

  1. Select Portfolio from the left navigation pane.

    Note

    The menu name in your applications might be different from the name in this article, because of the customization on menu names for Unified Monitoring pages. Contact the application administrator for more information.

  2. Select the configuration icon i_edit to configure the Portfolio page.

  3. In the Asset Dimension section, you can select the following dimensions.


    Asset Dimension

    Description

    Global

    the asset map for multiple regions and sites

    Region

    the asset map for multiple sites in a single region

    Site

    the asset map for a single site


  4. In the Site Type section, select the site types displayed on the Portfolio page. If you need to select types that are not listed from the dropdown list, contact the system administrator.

Configuring Page Layouts


The layout of the Portfolio page determines the placement of canvases and filters on the Portfolio page. You can select the most suitable layout from multiple layout styles to meet the needs on visualized monitoring pages. Configure the layout of the Portfolio page by the following steps:

  1. Select Portfolio from the left navigation pane.

  2. Select the configuration icon i_edit to configure the Portfolio page.

  3. Select the Layout Settings tab.

  4. Hover of the layout you want to choose and select Apply to apply the layout. You can select the following Portfolio layouts.


    Layout

    Description

    Left & Right - Regular

    A narrow canvas on the left and a wide canvas on the right, with the filter above the left canvas.

    Left & Right - Floating

    Wide canvases on both left and right, with the filter above the left canvas

    Top, Left, Right - Floating

    Wide canvases on both left and right, and a narrow canvas on top, with the filter above the left canvas

    Top & Right - Floating

    A wide canvas on the right and a narrow canvas on top, with the filter below the top canvas

    Right & Bottom - Floating

    A wide canvas on the right and a narrow canvas on bottom, with the filter in the top left corner.

    All Borders - Floating

    Wide canvases on both the left and right and narrow canvases on both top and bottom, with the filter above the left canvas


  5. Configure the following information in the Layouts section.


    Field

    Description

    Show Title Bar

    Enable this function to display the page title in the top left corner of the Portfolio page.

    Auto Fullscreen

    Enable this function to display the Portfolio page in full screen when application users open the page.


Configuring Asset Maps


You can select multiple map types and sources and configure a rich set of functions for the asset map in the Portfolio page to display the distribution and data of assets within a specified geographical range. Configure the asset map in the Portfolio page by the following steps:

  1. Select Portfolio from the left navigation pane.

  2. Select the configuration icon i_edit to configure the Portfolio page.

  3. Select the Map Settings tab.

  4. Enter the following information to configure the asset map.

    Note

    You can only configure the map type, asset aggregation, and default view for a site map.

    • Show Map: enabled by default. If you disable this function, you cannot configure or view asset maps on the Portfolio page.

    • Map Types: select the following types and sources.


      Map Type

      Description

      Administrative Map

      Supporting Global, Region, and Site dimensions.

      Geographical Map

      Supporting Global, Region, and Site dimensions.

      Road Map

      Supporting Global, Region, and Site dimensions.

      Electronic Chart

      Supporting Global, Region, and Site dimensions.

      3D Map

      Supporting Site dimension.


    • Max Zoom in Level: specify the max zoom-in level for geographical maps, road maps, electronic charts, and 3D maps.

  5. Configure the following information in the Global (for the Global dimension) or the Region (for the region dimension) section.

    • Map Types: select the map types for the current asset dimension.

    • Default Map Type: select the map type displayed on the Portfolio page by default for the current asset dimension.

    • For an administrative map, enter the following information.


      Field

      Description

      Default View

      Select the administrative scope displayed on the administrative map by default, supporting World and China.

      Show Minimap

      Display the global administrative minimap in the bottom right corner of the asset map.

      Background Color

      Select the background color of the administrative map.

      Show Heat Map

      Display certain data for each administrative region by color blocks. If you want to customize the data displayed on heap maps, contact the system administrator.

      Show Headline of Heat Map

      Display the headline of the heat map.

      Enable Asset Aggregation

      Display the total data of all assets within the certain range specified in Aggregate By.

      Aggregate By

      After enabling Enable Asset Aggregation, select the method to aggregate assets, currently supporting region to aggregate assets by region.
      For example, selecting Region and all assets in a region will be aggregated as 1 asset icon on the map.

      Looping Display by Regions

      After enabling Enable Asset Aggregation, display the heat map data of each administrative region by a floating card.

      Sorting Rule

      After enabling Looping Display by Regions, specify the rule on which the order of looping display is based, currently supporting By Heat Map Data to sort the order by heat map data.

      Display Order

      After enabling Looping Display by Regions, select the order of looping display, supporting Largest to Smallest and Smallest to Largest.

      Looping Interval

      After enabling Looping Display by Regions, specify the display duration of each floating card.

      Enlarge Font

      Display the text in the administrative map with a larger font size.


    • For a geographical map, road map, electronic chart or 3D map, enter the following information.


      Field

      Description

      Zoom Granularity

      Specify the zoom scale of the map when adjusting the zoom level by one unit.
      The default value is 1, you can choose between 0 - 1 with the accuracy of 0.1. The smaller the value is, the more accurately you can zoom in and out of the map.

      Auto-Center Default View

      Automatically select the center of the map and the minimum zoom-in level.
      If you need to specify a certain coordinate as the map center, disable this function and enter the coordinates of the map center and the default zoom-in level.

      Enable Asset Aggregation

      Display asset data based on specified methods which can be configured in the Aggregate By section.

      Aggregate By

      After enabling Enable Asset Aggregation, select the method to aggregate assets, currently supporting Region to aggregate assets by region and province to aggregate assets by province.
      For example, selecting Region and all assets in a region will be aggregated as 1 asset icon on the map.

      Aggregation Zoom Level

      After enabling Enable Asset Aggregation, select the scale of the asset aggregation between 1-18 with the accuracy of 1.

      Looping Display by Provinces

      After enabling Enable Asset Aggregation, display the heat map data of each province-level administrative region by a floating card.

      Data to Loop

      After enabling Looping Display by Provinces,select the data fields displayed on the floating cards and the display order and duration.

      Display Data on Aggregation Icons

      After selecting Region in Aggregate By, select the data displayed on the aggregation icon and configure the data name, unit, format and aggregation rule.

      Donut Chart

      After selecting Region in Aggregate By, display the aggregation icons as donut charts, select the data displayed on the donut charts and configure the data name and color.
      If you want to display the progress towards a goal or metrics in percentage on aggregated site icons, you can enable this function and configure corresponding data information.


Configuring Assets


You can view details of multiple assets such as basic information, geographical information, and running status in the Portfolio page with asset filter and map links. Configure the assets in the Portfolio page by the following steps:

  1. Select Portfolio from the left navigation pane.

  2. Select the configuration icon i_edit to configure the Portfolio page.

  3. Select the Asset Settings tab.

  4. Select Asset Filter to enable the filter for quickly locating the target assets and viewing the details of the assets.

  5. Configure the following information in the Global (for the Global dimension) or the Region (for the region dimension) section.


    Field

    Description

    Site Type

    Select the types of sites displayed on asset maps.
    You have to select at least 1 site type to enable Link to a Site Map function and configure asset information for site-dimension maps. If you need to select the site types that are not on the list, contact the system administrator.

    Site Style

    Select the style of sites displayed on asset maps.
    If you want to display each site separately, select Analog. If you want to display all sites in a certain range by one icon, select Aggregation.

    Show Site Status

    After selecting Analog as the site style, display color blocks indicating the connection status of the sites under site icons. If you want to modify status names and responding colors, contact the system administrator.

    Display Data on Aggregation Icons

    After selecting Aggregation as the site style, display specified data on the aggregation icon by selecting Add Data Fields to add a data field and configure the details of the data field such as name, unit, and format.
    For example, if you want to display the total electricity generation of the sites in each aggregated area by MWh, select Add Data Fields to add the data field indicating electricity generation from the popup window, and set Name as Electricity Generation, Unit as MWh.

    Donut Chart

    After selecting Aggregation as the site style, set the aggregated site icons as donut charts and configure the details of data fields displayed on the donut charts.
    If you want to display the progress towards a goal or metrics in percentage on aggregated site icons, you can enable this function and configure corresponding data information.

    Reset Map When Switching Asset Types

    Display the default view of the current map when application users switch the asset types of asset maps. You can configure the default view of each map in Configuring Asset Maps.

    Link to a Site Map

    Open the corresponding site map by selecting the site icon on the global or region map.
    For example, after enabling Link to a Site Map for wind sites, application users can open the target wind site map by selecting the icon of the wind site on the global or region map.


  6. Configure the following information in the Site section.


    Field

    Description

    Site Link

    Enter the URL address of the specified site type.
    After enabling Object to Link, application users can open the URL address by selecting the site icon on the asset map.

    Object to Link

    Enable this function, and application users can open the link you entered in the Site Link field by selecting the site icon on the asset map.

    Show Object Status

    Display color blocks indicating the connection status of the objects in site maps under object icons.

    Object Type

    Configure the types of objects displayed on site maps. Select Add Object Type and select objects from the dropdown list. If you need to add the objects that are not on the list, contact the system administrator.

    More Layers

    Add layers to site maps from the dropdown list to display more information about site maps. For more information about the supported layers in each site type, contact the system administrator.


Configuring Canvases and widgets


You can add rich visualized widgets to the Portfolio canvases for the statistics and analysis of asset data to configure customized and visualized monitoring pages.

Configuring Canvases


  1. Select Portfolio from the left navigation pane.

  2. Select the configuration icon i_edit to configure the Portfolio page.

  3. Select Canvas Settings tab.

  4. (Optional) In the preview area of the Canvas Settings page, select Add Page to add a new page for the current canvas.

  5. On the left side of the Canvas Settings page, configure the canvases in each asset dimension and for each site type. You can also copy canvas configuration to the current canvas by selecting the format printer button i_format_printer and select OK from the popup window.

Adding a Widget


  1. Select Portfolio from the left navigation pane.

  2. Select the configuration icon i_edit to configure the Portfolio page.

  3. Select Canvas Settings tab.

  4. In the Widget Library section, hover over the widget you want to add and select Add to add the widget to the current canvas displayed on the preview area.

  5. In the preview area, hovering over the target widget to configure the following information.


    Field

    Description

    Move

    Drag the widgets to configure the location of the widget on the canvas.

    Change Size

    Drag the right bottom corner of the widget to change the widget size.

    Edit

    Select the edit button i_edit_w to open the Edit Widget popup window and edit widget information such as data field and chart style. For more information about editing widgets, see Managing Widgets.

    Delect

    Select the delete button i_delete to delete the widget from the current canvas.

Managing Widgets


  1. Select Portfolio from the left navigation pane.

  2. Select the configuration icon i_edit to configure the Portfolio page.

  3. Select Canvas Settings, hover over the target widget on the canvas from the preview area and select the edit button i_edit_w.

  4. Enter the following information in the Basic Information Section.


    Field

    Description

    Title

    Enter the title of the widget.

    Description

    Enter the description of the widget.

    Show Title

    Display the widget title in the top left corner of the widget.

    Trend Analysis

    Enable this function, and application users can analyze the trend of widget data in a popup window by hovering over the widget data and selecting Trend Analysis.

    Pop-up Color

    After enabling Trend Analysis, select the color of the popup window for trend analysis as Bluish Green or Dark.


  5. Select Add Data Fields in the Data Field section, select the data fields you want to add to the widget from the popup window and select OK.

  6. Select the tags of the added data fields to expand the configuration section and enter the following information.


    Field

    Description

    Name

    Enter the name of the data field displayed on the widget.

    Unit

    Enter the unit of the data field.

    Convert Unit

    Automatically adjust the unit of data fields based on data value, supporting units such as KW, MW, and KWh. For more information, contact the system administrator.

    Decimal Places

    Select the decimal places of data fields displayed on the widget.

    Show Thousands Separator

    Separate every 3 digits by commas (,).

    Asset Dimension Aggregation

    Select the calculation method to aggregate the asset data under the same dimension, supporting methods such as sum and average.


  7. (Optional) Repeat step 3 and 4 to add multiple data fields. You can sort the order of data fields by drag the sort icon on the left of each data field tag.

  8. Configure the style and time settings of widgets in the Chart Style and Time Settings sections. For more information about the style and time settings of each widget, see Widget Reference.

Publishing a Portfolio Page


After finishing the configuration of the Portfolio page, you need to publish the page by the following steps to enable application users to view the pages and use the functions you configured:

  1. Select Portfolio from the left navigation pane.

  2. Select the configuration icon i_edit to configure the Portfolio page.

  3. (Optional) Select Preview to open a preview page of the Portfolio to check the functions and configuration of the page.

  4. Select the Publish tab and select the Publish button.

  5. In the popup window, enter the description on the Remark text box.

  6. Select OK.

Restoring History Versions


You can view the information of previous versions such as the version number, the application creator who published the version, and the publishing time of the version. If you want to use the previous version of the Portfolio page, restore a history version of the Portfolio page by the following steps:

  1. Select Portfolio from the left navigation pane.

  2. Select the configuration icon i_edit to configure the Portfolio page.

  3. Select History Version to open the history version list.


    ../../_images/portfolio_history.png


  4. Locate the target history version and select Restore.

  5. Select OK in the popup window.

Note

You can view or restore the last 100 history versions on the history version list.

Exporting and Importing Page Configuration


You can export the current configuration of the Portfolio page in JSON format and import the JSON file to reuse the configured Portfolio page.

Exporting Page Configuration


  1. Select Portfolio from the left navigation pane.

  2. Select the configuration icon i_edit to configure the Portfolio page.

  3. Select Import/Export > Export, and the configuration file will be downloaded automatically.

Importing Page Configuration


  1. Select Portfolio from the left navigation pane.

  2. Select the configuration icon i_edit to configure the Portfolio page.

  3. Select Import/Export > Import.

  4. In the popup window, select Upload to upload the exported JSON file.

  5. Select OK.

Configuring URL Parameters


Besides the configuration above, application creators can enable or disable more functions by configuring the parameters of the URL. For more information, see URL Parameters.