Point Datasource

A Point datasource is a type of datasource used to configure and manage points.

The concept of a point is explained in detail in Point Templates.

If you are novice to the concept of Datasources, you can have more information in Data Sources & Create Data Source

Let’s now go through each section of the datasource step by step.

Use app time period: When enabled, the datasource retrieves data (Points, Numeric Attributes, and Calculations) based on the date range selected in the application’s date picker linked to this datasource.
(For more details on the date picker, see Create Dashboard Application).
The user can create To Date datasource (Month to Date, Year to Date …ect) by toggling off “Use app time period” and use the * syntax in From & To fields. MTD would be * M to *
From / To: If Use app time period is disabled, you can define a fixed date range by entering start and end dates. In this case, the datasource always queries data for this specific timeframe, regardless of the user’s date selection in the application.
Default aggregate interval: Defines the default aggregation interval for the selected points and calculations. Users can still override this interval directly when configuring widgets. This is used for widget that display aggregated timeseries data
Polling: Determines how often real-time data points are refreshed. This setting controls the refresh rate of the data.

When you click Add Point, a Point Configuration popup opens.

Points: Select the points available for the asset type defined in the datasource.
Time Period Aggregate: Defines how the data is aggregated over the Time period aggregate .
Data Name: Acts as an alias that combines your selections for Point, Time Period Aggregate, and Multi Asset Aggregation. This is the label displayed in widgets during configuration.
Multi Asset Aggregation: By default, this is set to None. It is only used in specific widget scenarios where the widget output is a single value (e.g., KPI Widget, Report Writer Widget). This setting allows the user to decide how data is aggregated when multiple assets are selected.
- Example: A user configures a KPI widget with a datasource that includes an Active Power point. If Multi Asset Aggregation is set to SUM, then when multiple assets are selected in the dashboard, the widget will display the total Active Power across all selected assets.

When you click Add Attribute, an Attribute Configuration popup opens.

Attribute: Select any numerical object attributes.
(For non numerical attributes, see Asset Attribute).
Data Name: Acts as an alias. This is the label displayed in widgets during configuration.

Calculations are based on already configured points or attributes.

When you click on Add Calculation a Calculation Configuration popup opens.

Name: Define a name for the calculation.
Multi Asset Aggregation: By default, this is set to None. It is only used in specific widget scenarios where the widget output is a single value (e.g., KPI Widget, Report Writer Widget). This setting allows the user to decide how data is aggregated when multiple assets are selected.
Expressions : Edit the expression of your calculation based on available Points & Attributes.

The compatible widgets with this datasource are :