Statistic

Displays a numeric statistic on a page.

Numeric statistics can return data from scripts and APIs and display values with some amount of formatting options.

Display a statistic from an API

APIs should return a single value to display as a statistic. An example API could look something like this.

Get-Random -Min 100 -Max 1000

You can then select the API under the data source tab.

Each time the page is loaded, the API is called and the random value is shown.

Display a statistic from a Script

Statistics shown from scripts will display the value return by the last job run for the script. Loading the page will not run the script again.

We will use this script as an example.

Get-Random -Min 100 -Max 1000

Select the script on the data source tab.

The statistic will be shown on the page based on the output of the script. You'll notice that refreshing the page does not change the value of the statistic unless the job is run again.

Customizing the Statistic

You can customize features such as the prefix, suffix, precision and whether to auto-reload the statistic on an interval.

Properties

Property	Description	Available Since
ID	The ID of this component	2.2.0
Title	The text to display within the statistic.	2.2.0
Data Source	The script or API to call to return the statistic's value.	2.2.0
Prefix	The string to display before the value.	2.2.0
Suffix	The string to display after the value.	2.2.0
Auto Reload	Whether to auto-reload the statistic on an interval.	2.2.0
Auto Reload Interval	The number of seconds between auto-reloads.	2.2.0
Precision	The number of decimal places to display in the value.	2.2.0