Percentage Node

Percentage Node

The percentage node can display a value as a percentage of a total using a colored bar. You can configure this node to alter the color of the widget depending on the data on display.

You must configure this node with numeric values.

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

Configuring your Percentage 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. Next, enter your Input Data Field: the field within the incoming JSON payload containing the data the widget will display.
3. If you want, 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 display the device or label name on the widget.
5. Enter the number of decimal places to display under Decimal Precision.
6. Set the conditions for displaying particular colors by entering at least one Range. You can add extra rows and enter the same definition (for example, normal, minor, or critical) multiple times.

Grouping by Device Label

You will need to select how data should be grouped and displayed on the widget. 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.

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 Percentage widget will appear for each device.
   • Group by device label value (widget per label value): one Percentage 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 Percentage 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: 10.02.2022