Multi Value Node

Multi Value Node

The multi-value node displays multiple values (each from a different field name) on a single widget. It is similar to the value node but can contain as many values as required.

You can adjust the display order of the values during configuration by dragging the arrow handles on the left of each row.

Adding a Multi 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 Multi Value node and drag it onto the canvas.
4. Connect the Multi Value node to your desired input node.
5. Double click on the Multi Value node to open its configuration window.

Configuring your Multi 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. 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. 
3. Selecting the 'Device/Device Label Name' checkbox will ensure the widget displays the device or device label name.
4. Choose a Name for the data you want to display. Under 'Data Field Name', enter the corresponding field name exactly as it appears in the incoming JSON payload.
   • For example, if multi-value node has  this configuration:
     • Name: Daily Temperature
     • Input Data Field: daily_temp
   • The multi-value widget will display the following, where 25 is a value taken from the daily_temp field.
     • Daily Temperature: 25 °C
5. If you want to display a special character at the end of the value, enter a Symbol (for example, °C or °F).
6. Enter the number of decimal places to display under Decimal Precision.

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 Multi Value widget will appear for each device.
   • Group by device label value (widget per label value): one Multi 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 Multi Value widget will be displayed. It will contain data from all devices with the selected device label.

See Also: Creating a dashboard, Creating device labels, Configuring nodes using labels

As of Release: 08.12.2021