Multi Value Node

Multi-value visualizations display several key data points or metrics at once, offering a snapshot of various aspects of the data or system being monitored. This can include a combination of numbers, icons, or short text indicators.

What is a multi-value?

A multi-value widget serves the purpose of displaying multiple values within a single interface element. Rather than showing each value separately, which can clutter the interface, the multi-value widget condenses them into a unified display. This feature is particularly useful when dealing with datasets or selections where presenting multiple values at once enhances clarity and efficiency. For example, in data visualization tools or form interfaces, a multi-value widget can streamline the presentation of various parameters or selections, allowing users to grasp information quickly and make informed decisions. By consolidating multiple values into one widget, it promotes a more organized and intuitive user experience, facilitating effective interaction with the displayed data or options.

Inputs

The multi-value node has mandatory inputs. These are:

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. The multi-value node can have multiple fields configured in the same node.

How to Use

Implementation

In the Rayven Workflow Builder:

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

Configuration

Section: General
This section contains basic configuration elements required for any multi-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.
Device/Device Label Name	Mandatory	Select this checkbox to display the device or label name on the widget.
Widget Header	Mandatory	Ability to hide or show the widget’s header.
Calculation Interval	Mandatory	Enter an integer to represent the interval for the calculation time frame.
Units of Measurement	Mandatory	Select the units of measurement from the dropdown menu to be used for the interval calculations: Seconds Minutes Hours Days Weeks (Start from Monday) Weeks (Start from Sunday) Months Years For example, if the following is configured: X-axis time interval = 1 Units of measurement = Hour Then the node will aggregate data points received for the hour.
Comma separators at thousand mark	Optional	When checked, there will be comma separators at the thousand mark.
Rule	Mandatory	To add a new data point to display on the multi-value node, click on “+ Add Rule” at the bottom of the General section.
Name	Mandatory	Enter a name for this rule that will be displayed on the widget.
Input Data Field	Mandatory	This is the field name within the incoming JSON payload that contains the data to be displayed on the widget.
Function	Mandatory	Select one of the functions from the dropdown menu: Last Value Received First Value Received Sum Average Min Max
Link To	Optional	Drop down list to select a configured dashboard to link to from this column.
Symbol	Optional	Enter a symbol that will be displayed at the end of the value.
Decimal Precision	Optional	Enter the number of decimal places to display on the dashboard.
Type	Mandatory	Select one of the type from the dropdown menu: Alphanumeric Numeric
Icon	Optional	Select the "ICON" button which will open a library of icons to choose to display on the widget.
⊕	Optional	Add data range rules to determine the color of the cell holding the value
Range	Optional	At the end of the “Rule” row, select the ⊕ symbol to add a range which allows users to input range values that can be color coded.
From	Mandatory (Only when a range is added to the rule)	Enter the minimum value (inclusive) of the range that takes the color configured in the conditional rule. Workflow values can be used with the following format: [[range1]]. This allows custom ranges to be set for specific use cases.
To	Mandatory (Only when a range is added to the rule)	Enter the maximum value (exclusive) of the range that takes the color configured in the conditional rule. Workflow values can be used with the following format: [[range1]]. This allows custom ranges to be set for specific use cases.
Hex Color	Mandatory (Only when a range is added to the rule)	Select a desired color you wish to see when the value received falls under the from-to range or the value set.

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 display 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.