Value Node

Value visualizations focus on displaying a single, key metric or data point clearly and prominently. They're used when one particular number is the most important piece of information to monitor, such as current sales figures, temperature, or speed.

What is a value?

A value widget serves as a straightforward and customizable tool for displaying a single alphanumeric value, along with user-configurable units or symbols. Its primary purpose is to present a specific numerical or textual piece of information in a clear and easily readable format. This widget is particularly useful in dashboard or monitoring applications where conveying a single, significant data point is crucial for decision-making or tracking purposes. By allowing users to customize the unit or symbol associated with the displayed value, the widget offers flexibility to adapt to different contexts or preferences. Whether showcasing key performance metrics, real-time sensor readings, or any other singular data point, the value widget provides a concise and visually accessible means of presenting essential information.

Inputs

The value node has a mandatory input:

Input	Requirement	Comments
Input Data Field	Mandatory	This is the field name within the incoming JSON payload that contains the data to be displayed on the widget.

How to Use

Implementation

In the Rayven Workflow Builder:

Select Visualizations.
Drag the value node to the canvas.
Provide an input to the value node by connecting it to another node.
Double click on the value node to open the configuration window.

Configuration

Section: General
This section contains basic configuration elements required for any value node implementation
Field	Requirement	Comments
Widget Name	Mandatory	Enter a name for this node. This provides a handle to which you and others can refer, so it should be simple but meaningful and explain the node’s purpose.
Widget Subtitle	Optional	Additional text that can be used to explain the data presented by the node. This will appear directly under the Widget Name, in a smaller text size.
Input Data Field	Mandatory	This is the field name within the incoming JSON payload that contains the data to be displayed on the widget.
Device/Device Label Name	Optional	Select this checkbox to display the device or label name on the widget.
Background Color	Optional	Ability to select desired colors as the value’s background color.
Icon	Optional	Clicking on the image which will open a library of icons for selection.
Trend	Optional	An up or down arrow will be shown on the widget, indicating the direction of the change in value shown.
Symbol	Optional	Enter a symbol that will be displayed at the end of the value (e.g. °C or °F)
Decimal Precision	Optional	Enter the number of decimal places to display on the dashboard.
Comma Separators at Thousand Mark	Optional	When checked, there will be comma separators at the thousand mark.
Dashboard to link to	Optional	Select a dashboard that will open when a user clicks on the value widget. Select the dashboard from a dropdown menu.
Show Last Value	Optional	Select from a dropdown menu Chronologically - Takes the value from the payload with the latest timestamp Received - Takes the value from the last payload received, irrespective of the timestamp

Section: Tooltip Info
Field	Requirement	Comments
Show Tooltip	Optional	When checked, it allows users to display their tooltip text on the widget.
Tooltip Text	Optional	This section only exists when “Show Tooltip” is checked. Users are able to write any tooltip message they desire which will be displayed on the widget.

Section: Group by Device Label
Field	Requirement	Comments
Device label name	Optional	There are no labels available in this box until you have saved at least one in the Device Labels section of the Workspace. Select a Label to use to filter devices.
Grouped	Optional	Select a method for grouping the widget on the dashboard from the dropdown: No Grouping (widget per device): one widget will appear for each device Group by device label value (Widget per label value): One widget will appear for each value of a label. For example, if the Label is ‘Color’ and there are the values ‘Green’ and ‘Gold’, then two widgets will be displayed, one with devices with Color Label equal to “Green” and one with devices with Color Label equal to “Gold” Group by device label name (One widget): Only one widget will be displayed and this will contain data from all devices.
Function	Optional	Select a function from a dropdown menu Last value received Sum Average Maximum Minimum Last value from each device with common device label This is important when multiple devices are sending data to a value node. In this situation, select the function that you wish to apply.