Asset Summarized Metrics

Prev Next

This page describes how to configure the Asset Summarized Metrics widget. The general description of this widget can be found here: Asset Summarized Metrics Widget Documentation.

This widget is intended for use in Dashboard applications and Report applications.

This widget supports the following datasources :

Configuration

The widget configuration page is composed of three sections:

  • General: Manages pagination and font size configuration.
    image.png

  • App Linked Data Sources: Displays all usable data in the widget.
    image.png

  • Output configuration: Allows to choose which columns the widget will display, configure their content and appearance.
    image.png

General

Configure:

  • Max number of rows (default: 20): Defines the maximum number of rows that will be displayed in the data table at a time, and therefore the number of pages (possibly only one) that will contain all the data

  • Font Size (default: 14): Sets the size of all text in the widget

App Linked Data Sources

For details on Linked app datasource see Widget Configurations.

Output Configuration

The output configuration allows you to choose which points the widget will display and how they will be represented, column by column.

  • Click on the button:
    image.png

  • Configure each element that defines the content and appearance of the column:

    • Output: Select the type of element displayed in the column. An example of each output type is presented at the end of this section. image.png

      • Single Value: a unique value, either the point value over the period considered, an icon, or a static text (see further)

      • Fraction: a fraction of the form "value / total"

      • Progress Bar: a fraction in the form of a progress bar (as above but in a graphical way)

      • Spark Line: a curve giving an overview of the point values ​​over the period

      • Data: Select the data (point, attribute or calculation) to display

    • Type (displayed after data is entered): Aggregated or Realtime

    • Header text: The column title. It is required, and must be unique within the widget.

    • Value Decimals: The number of digits to display after the decimal point

    • Unit: Unit to display

    • Include Summary Value: An extra row will be placed at the bottom of the table, displaying the sum or average of the values ​​displayed in that column. Choose between Sum and Average: image.png

Additional possibilities

Depending on the selected output type, additional elements can be configured. They mainly concern the formatting of the column content.

Single value: Colors

  • Theme default colors:
    image.png

    • Selected by default. Applies a preset color on the column.

  • Custom Color:
    image.png

    • Using a color picker, sets the color to apply on the column, for dark and light modes.

  • Value Ranges:
    image.png
    image.png

    • Allows to apply colors according to value ranges: define a value range, a description, a color for dark and light modes, and an output type defining what will be displayed in the column for values in that range. The possible types are Value, Icon and Textimage.png

      • Value: the value and its unit will be displayed with the choosen color

      • Icon: the entered icon will be displayed with the choosen color. See the reference of usable icon codesimage.png

      • Text: the entered static text will be displayed with the choosen color

Add as many value ranges as necessary. It is possible to remove any previously entered range.

Fraction: Colors, Reference Value Options
For a fraction, 2 complementary parts are to be configured:

  • Colors: defines the formatting of the left side of the fraction, exactly the same way as for a single value

  • Reference Value Options: defines the formatting of the right side of the fraction,  representing a total or target value. Two options are possible:

    • Data: defines the right part of the fraction from a point avaiable in the widget's data sources: image.png

      • Choose the data, type, value decimals and unit as in the General section

      • Choose the formatting in the Colors section, exactly the same way as for a single value

    • Custom:  defines the right part of the fraction as a constant value: image.png

      • Enter the reference value, the value decimals and its unit as in the General section

      • Choose the formatting in the Colors section, exactly the same way as for a single value

Progress bar: Reference Value Options, Progress Bar Style
The progress bar configuration is very similar to the fraction:

  • The Reference Value Options define the maximal value, either by selecting a point in Data, or entering a constant reference value in Customimage.png image.png

  • The Progress Bar Style section sets the colors for the current and total values: image.png

Spark Line: Colors
Set the color to use for the curve, with one of the following options:

  • Theme default colorsimage.png

  • Custom Color: pick the color of your choice, for light and dark mode: image.png

Actions on previously added columns
After a column is added to the widget, it is possible to edit ( button), move (), or remove it ( button).

Example

Here is an example illustrating most of the possibilities:
image.png