Percentage visualizations focus on showing a metric as a percentage, illustrating parts of a whole. This can be useful for showing completion rates, progress towards a goal, sales targets, or any other metric.
What is a percentage?
The percentage widget is a versatile tool designed to represent numerical values as percentages within a colored bar. Its primary purpose is to provide a visually engaging and easily understandable way to convey proportions or ratios. By displaying values as percentages, users can quickly grasp the relative significance or contribution of different components within a dataset. Moreover, the ability to adjust the color of the widget based on the displayed value enhances clarity and visual impact, allowing users to intuitively interpret the information at a glance. Whether used for tracking progress, monitoring performance metrics, or visualizing survey responses, the percentage widget offers a convenient and customizable solution for presenting percentage-based data effectively.
Inputs
The percentage 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 Percentage node to the canvas.
- Provide an input to the Percentage node by connecting it to another node.
- Double click on the Percentage node to open the configuration window.
Configuration
|
Section: General |
||
|
This section contains basic configuration elements required for any percentage 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. |
|
Decimal Precision |
Optional |
Enter the number of decimal places to display on the dashboard. |
|
Range |
Mandatory |
It is possible to add as many rows as you would like by clicking on “+ Add Column” at the bottom of the row. Enter a numeric value for minimum and maximum range value. |
|
Hex Color |
Mandatory |
Ability to select various colors for the different range values. |
|
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 |
Mandatory |
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 |
Mandatory |
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. |