Datapoint Widget
Summary
The datapoint widget is used to show the latest value from a single tag. This widget is often set up using display options to create glanceable red/yellow/green status lights, or to convert a data value into a string of text describing a state or status. See below for some basic examples.
Examples at a glance
Default view displaying the most recent data value with no display options configured.
Common applications
- Create an overview of machine temperatures throughout a factory line, and turn them orange or red if a device starts to overheat.
- Measure the power consumption of a machine to determine if it is currently off, on/idle, or in use.
Configuration options
Hover over a widget and click the Configure Widget button (
) to control which tags to include and how data should be handled, such as defining the amount of data to display or scaling up subtle signals to make them easier to use. Once you have selected the tags to be shown, click ‘Next’ to configure data handling options using the properties below.
| Property | Options | Description |
|---|---|---|
| Metric | Enables data smoothing. Used to remove noise from data. | |
| Snapshot | No smoothing; Shows the most recent value. | |
| Maximum | Average the maximum values over a number of samples. | |
| Minimum | Average the lowest values over a number of samples. | |
| Refresh | Determines the frequency with which the widget will refresh the displayed data. Set longer refresh times for widgets that are not checked often. | |
| Auto | Sets the refresh rate automatically, based on the incoming signal. | |
| Set | Specify a refresh rate in seconds, minutes, or hours. | |
| Scale and Offset | Modify the raw data to either scale up the value by a multiplier, or offset the value by a fixed amount. Used to convert units (eg, watts to kW), or to correlate data streams with drastically different scales (eg, °F vs vibrations per second). | |
| Raw | No adjustment. | |
| Custom | Specify a scale factor and/or offset amount. |
Display options
Hover over a widget and click the Display Options button (
) to define conditions that change the way data is displayed, such as changing colors or showing text based on incoming data. Setting up multiple conditions can create widgets that are very dynamic, elevating critical information as data conditions change. See our tutorial on creating your first dashboard for an interface breakdown.
| Property | Description |
|---|---|
| Tag | Select the tag or tag state to configure from the list of incoming data. States will be shown in the format ‘StackName:TagName.State’ |
| Condition | Define the logic conditions under which your chosen settings will take effect relative to the Trigger Value. |
| Trigger Value | Define the threshold at which your chosen settings will take effect relative to the Condition setting. |
| Color | Select the primary color to be displayed. Affects alphanumeric characters and icons. |
| Display Icon | Replace the data value with an icon. May be used simultaneously with Display Text. |
| Display Text | Replace the data value with a text string. May be used simultaneously with Display Icon. |
| Background Color | Select a background color for the widget. |