Value Node

Value Node

The value node displays a single value on a widget. This value can be an integer (numeric) or a string (alphanumeric). It can also contain special characters or symbols such as percentage (%) or kWh.

Adding a Value node to your workflow

1. First, select your desired solution and navigate to Rayven Workflow.
2. Select ‘Visualizations’ from the left-hand panel.
3. Find the Value node and drag it onto the canvas.
4. Connect the Value node to your desired input node.
5. Double click on the Value node to open its configuration window.

Configuring your Value node

1. Give your node a Name. Choose something simple that clearly explains its purpose. You must pick a name that has three or more characters.
2. Under Data Field Name, enter the field name within the incoming JSON payload that contains the data you want to display on the widget.
3. If you want, you can add a Widget Subtitle. This additional text helps explain the data presented by the node to the end-user. It will appear under the Widget Name in a smaller font. 
4. Selecting the Device/Device Label Name checkbox will ensure the widget displays the device or label name. 
5. If you want to include an icon on your widget, clicking ‘Choose icon’ will let you select one to display from the Rayven library.
6. If you choose to display Trend, an up or down arrow will appear on the widget when its value changes to indicate it has gotten larger or smaller.
7. Enter a Symbol to display a special character at the end of the value (for example, °C or °F).
8. Enter the number of decimal places to display under Decimal Precision.
9. Select a dashboard to open when a user clicks on the widget under Dashboard to Link To. Choose from the dropdown options - see Section 3.4 Dashboards for more information.
10. You can choose from a dropdown menu how to Show Last Value:
    • Chronologically: Take the value from the payload with the latest timestamp.
    • Received: Take the value from the last payload received, irrespective of the timestamp.

Grouping by Device Label

You can choose to group the data the widget displays. To group data by device label, you must first create at least one label in the Device Labels section of the Workspace. See Creating Device Labels and Configuring Nodes Using Labels for more information.

If you want to group your data:

1. Select the label you will be using to filter devices from the dropdown list under ‘Device label name’.
2. Select a method for grouping the widget on the dashboard:
   • No Grouping (widget per device): one Value widget will appear for each device.
   • Group by device label value (widget per label value): one Value widget will appear for each unique value label. For example, if the device label is ‘Color’ and the label values are ‘Green’ and ‘Gold’ the dashboard will show two widgets. One will contain data for devices labeled ‘Green’ and the other for devices labeled ‘Gold’.
   • Group by device label name (one widget): only one Value widget will be displayed. It will contain data from all devices with the selected device label.
3. If you have multiple devices sending data to a Value node, you will need to select a Function to be applied. Choose from:
   • Last value received,
   • Sum,
   • Average,
   • Maximum,
   • Minimum,
   • Last value from each device with common device label.

See Also: Creating a dashboard, Creating device labels, Configuring nodes using labels
As of Release: 08.12.2021