Dashboards “by objects”

When creating a new dashboard, select the By objects type and click Create. An empty workspace will open. Here, you can add widgets – the main elements of the dashboard.
Workspace
1 – Add new widget: Add a widget to the workspace
2 – Save: Save dashboard changes
3 – Auto-refresh enabled/disabled:
If the indicator is active, auto-refresh is enabled and the widgets on the dashboard are updated in real time when new data packets are received. If the indicator is inactive, auto-refresh is disabled and the data on the widget is updated only after refreshing the page or switching between platform tabs
4 – Data viewing interval: Configure the data viewing period on the dashboard
5 – Settings: Manage auto-refresh and enabling the background for the workspace
6 – Export .json: Export the dashboard to a JSON file
7 – Fullscreen: Open the workspace in full-screen mode

Creating a widget

Widgets are the building blocks of a dashboard. They can be used both to visualize data and to interact with devices by sending commands. To create a widget, click Add new widget. A configuration panel opens on the right.
Add new widget
💡
A dashboard can contain up to 15 widgets.
Select a widget type. The available configuration fields will change depending on the selected type.
Available widget types:
  • Line chart – a chart of data changes over time. This widget can be used to track temperature, energy consumption, and other sensor readings;
  • Pie chart – a circle divided into sectors, where each sector reflects the share (percentage) of the value of one argument relative to the sum of the values of all arguments selected as a data source. This widget allows you to quickly compare a small set of values and evaluate the share of each value compared with other sectors and with the entire pie chart. For example, it can be used to display the duration of equipment operation in different modes, or incident causes by category;
  • Gauge chart – a half-ring chart divided into sectors, where each sector reflects one of the levels set in the model for the argument selected as the data source. This widget allows you to quickly see which interval the value falls into within the specified range. For example, it can be used to display the speed of a vehicle within established limits;
  • Percentage – a ring chart where the percentage fill share for the argument selected as the data source is highlighted in color along the circumference. This widget makes it easy to visualize a value in the range from 0 to 100 percent. For example, it can be used to assess battery charge, task completion progress, or equipment load level;
  • Bar gauge chart – a chart in the form of vertical or horizontal bars, where the height or length of each bar corresponds to the value of the argument selected for it. This widget is convenient for creating a ranking when values need to be compared with each other and attention needs to be focused on the best and worst indicators, or for comparing values across different categories;
  • Counter – the numeric value of an argument with a specified color, which can change according to levels;
  • LED – a virtual LED that signals the state of an argument;
  • Battery, Flask, Thermometer – schematic images of a battery, flask, and thermometer respectively, where the percentage fill share for the argument selected as the data source is highlighted in color;
  • Text – plain text or text in Markdown format. This widget allows you to add contextual information and descriptions. For example, it can be used
    • for important links or useful annotations;
    • for instructions or recommendations on interpreting various widgets, configuring parameters, or performing specific actions based on the displayed data;
    • for an announcement about scheduled maintenance or downtime;
  • Slider is intended for sending a command with a variable numeric value. For example, it can be used to change light intensity, engine operating speed, or to set a specific program number;
  • Switch is a two-position button for turning something on/off;
  • Button is intended for sending any object command;
  • Stepper, like a slider, allows you to send a command with a variable numeric value, but in this case the value can be changed only by a predefined step;
  • The Color widget is well suited for selecting an exact color using the RGB scheme — for example, for setting the color of an LED or lamp.
All widgets
Next, you can specify the widget name and description. The name will be displayed at the top of the widget window, and the description at the bottom.
In the Display settings section, you can manage the widget window border, the format of the data displayed on the widget, the chart style, and the legend. All settings are presented in the table.
SettingWhere usedDescription
Show borderAll widgetsShow or hide the border around the perimeter of the widget
Border colorAll widgetsSet the widget border color
Number of decimal placesLine chart, Bar chart, Pie chart, Gauge chart, Bar gauge chart, Counter, Battery, Flask, ThermometerSelect the number of decimal places for widget data
StyleLine chartSelect the style for displaying widget data on the chart: Default, Only points, Area, Dotted line, Rounded
Line widthLine chartSelect the line width for the widget data chart: 1px, 2px, 4px, 8px
Point radiusLine chartSelect the size of points for the widget data chart: Do not show, 1px, 2px, 4px

Point size on the chart = Line width + 2*Point radius
Show units of measureLine chart, Bar chart, Pie chart, Gauge chart, Bar gauge chart, Counter, Battery, Flask, ThermometerShow or hide units of measurement for widget data
Show legendLine chart, Bar chart, Pie chart, Bar gauge chartShow or hide the widget legend
Legend parametersLine chart, Bar chart, Pie chart, Bar gauge chartSelect the parameters displayed in the widget legend: MIN, MAX, FIRST, LAST, AVG, DIFF, SUM
Legend placementLine chart, Bar chart, Pie chart, Bar gauge chartSet the widget legend position: Top, Right, Bottom, Left
Min, MaxBar gauge chart, Battery, Flask, ThermometerSet boundary values for displaying widget data
Data output orderBar gauge chartSet the sorting order for widget data: Default – the order is fixed and corresponds to the sequence of added data sources; Ascending/Descending – the order is dynamic and depends on data source values
Use "decimal places" value from the modelCounter, Battery, Flask, ThermometerSet the number of decimal places for the argument selected as the widget data source to the same value as defined in the model.
The Widget preview section shows how the widget will look based on your current settings using randomly generated sample data.
💡
Even after you add a data source, the Widget preview still displays randomly generated values. To see actual object data, open the widget on the main dashboard.
Widget preview
Widgets are connected directly to object parameters and commands. Data source selection and configuration are handled in the Data source section and vary depending on the widget type.

Line chart

Select one or more objects of interest. For each object, specify the arguments whose values will be used as data sources. In the list of parameters available for selection, only those that have the Number data type specified in the model are available. In total, across all objects, you can add up to 20 arguments. You can also rename the data source and set your own color for each argument.

Line chart
Click Save. A new widget will appear on the dashboard. By default, argument values on the widget are visually represented as points connected by straight lines.
New widget
💡
To configure the chart style, go to the widget Display settings and use the Style, Line width, and Point radius options. The Widget preview section will show a chart corresponding to your settings. When you finish editing the widget, click Save.
Display settings
When you hover over a chart point, it becomes larger and information is displayed about the time this data packet was received, the data source, and the argument value.
Hover

Pie chart

Select one or more objects of interest. For each object, specify the arguments whose values will be used as data sources. In the list of parameters available for selection, only those that have the Number data type specified in the model are available. In total, across all objects, you can add up to 20 arguments. You can also rename the data source and set your own sector color for each argument.

Pie chart
Click Save. A new widget will appear on the dashboard. The value of each argument on the widget is visually represented as a sector of a circle.
New widget
When you hover over a circle sector, it becomes brighter, and the argument name, its value, and the sum of all arguments in the chart are displayed.
Hover

Gauge chart

Select one object of interest. From the list of this object's parameters, determine the argument whose values will be used as the data source. In the list of parameters available for selection, only those that have the Number data type specified in the model are available. Set the function for calculating the value displayed on the widget:
  • MIN/MAX – the minimum/maximum value for the selected time period;
  • FIRST/LAST – the first/last value for the selected time period;
  • AVG – the average value for the selected time period;
  • DIFF – the last value minus the first value over the selected time period;
  • SUM – the sum of all values received by the object during the selected time period.
    You can enable Show edge intervals mode; then the ring chart will be divided into colored sectors according to the levels set in the model for this argument. If this mode is disabled, the chart is fully colored in the color of the level corresponding to the displayed argument value. If the selected argument does not yet have levels set in the model or the interval boundaries and their color do not suit you, click Go to the model and customize levels. After saving the new levels in the model, the sector colors on the chart will also be updated.
Gauge chart
Click Save. A new widget will appear on the dashboard.

New widget
When you hover over a Gauge chart sector, it becomes brighter and information about the data source and current interval is displayed.

Hover

Percentage

Select one object of interest. From the list of this object's parameters, determine the argument whose current value will be used as the data source. In the list of parameters available for selection, only those that have the Number data type and the Percents unit of measurement specified in the model are available. You can set your own color for the percentage fill scale and select the image displayed above the numeric value of the argument.
Percentage
Click Save. A new widget will appear on the dashboard.

New widget
When you hover over the widget, information about the data source is displayed.

Hover

Bar gauge chart

Select one or more objects of interest. For each object, specify the arguments whose values will be used as data sources. In the list of parameters available for selection, only those that have the Number data type specified in the model are available. In total, across all objects, you can add up to 20 arguments. You can also rename the data source and set your own bar color for each argument.

Bar gauge chart
Click Save. A new widget will appear on the dashboard. The value of each argument on the widget is visually represented as a bar.
New widget
💡
If the chart is used to visualize changes in an argument's value over time, consider setting a maximum value in the display settings. The bars will then be scaled relative to this maximum, making it easier to track progress and evaluate changes at a glance.
Maximum value
Progress
If the maximum is not set, then by default the largest current argument value in the bars is taken as the maximum.
When you hover over the bars, information about the data source is displayed.
Hover

Counter

Select one object of interest. From the list of this object's parameters, determine the argument whose current value will be used as the data source. In the list of parameters available for selection, only those that have the Number data type specified in the model are available. You can set your own color for the value displayed on the widget, or select Use colors from the levels; then the value will be colored in the color corresponding to the interval. If the selected argument does not yet have levels set in the model, or you want to change their color, click Go to the model and customize levels. After saving the new levels in the model, the value color on the widget will also be updated.
Counter
Click Save. A new widget will appear on the dashboard.

New widget
When you hover over the widget, information about the data source is displayed.

Hover

LED

Select one object of interest. From the list of this object's parameters, determine the argument whose current value will be used as the data source. In the list of parameters available for selection, only those that have the Boolean data type specified in the model are available. You can enable Show value; then the Yes/No value will be displayed under the LED image. By default, the green LED color corresponds to Yes, and red to No. If this color solution or text does not suit your task, enable Use colors from the levels. If the selected argument does not yet have levels set in the model, or you want to change their color and the displayed text, click Go to the model and customize levels. After saving the new levels in the model, the color and corresponding LED status text on the widget will also be updated.
LED
Click Save. A new widget will appear on the dashboard.
New widget
When you hover over the widget, information about the data source is displayed.
Hover

Battery, Flask, Thermometer

The configuration of these three widgets is the same. Select one object of interest. From the list of this object's parameters, determine the argument whose current value will be used as the data source. In the list of parameters available for selection, only those that have the Number data type specified in the model are available. You can set your own fill color on the widget, or select Use colors from the levels; then the value will be colored in the color corresponding to the interval. If the selected argument does not yet have levels set in the model, or you want to change their color, click Go to the model and customize levels. After saving the new levels in the model, the value color on the widget will also be updated.
Battery
Click Save. A new widget will appear on the dashboard.
Examples of the three widgets are shown below.
New widgets
💡
By default, the fill on the widget is calculated based on 0 being the minimum value and 100 being the maximum. If the actual boundary values are different, set them in the display settings.
Boundary values
In this case, the percentage of color fill on the widget is calculated from your values.
Fill percentage

Text

This widget is the only one where you do not need to select either an object or an argument. Just write your text in the usual format or use Markdown markup.
Text
Click Save. A new widget will appear on the dashboard.
New widget

Slider

Select one object of interest. From the list of commands for this object, determine the command in whose data the numeric value set by the slider position will be sent. Set the start and end boundary of the slider, as well as the default value. You can also set the step with which the slider will move.
Slider
💡
In the list of commands available for selection, only those are present that have exactly one parameter set in the model, whose value can be specified directly when sending the command. To create such a parameter, when creating the command in the model, it must be declared in curly braces {{param_name}}.
Creating a parameter
The same commands are used as data sources for the Stepper and Color widgets.
Click Save. A new widget will appear on the dashboard.
New widget
When you hover over the slider scale, information about the current slider value and data source is displayed.
Hover
Move the slider to the required position to send the command. Upon successful execution or failure, the corresponding notification will appear.
Notification

Switch

Select one object of interest. From the list of commands for this object, determine the commands that will be sent when the switch is turned on and off. You can specify the names of states that will be displayed next to the switch after the corresponding command is sent.
Switch
💡
The list of commands available for selection does not include commands with parameters that can be specified directly when sending the command. Such commands are used as data sources only for the Slider, Stepper and Color widgets.
Click Save. A new widget will appear on the dashboard.
New widget
When you hover over the switch, information about the data source is displayed.
Hover
Move the switch to the required position to send the command. Upon successful execution or failure, the corresponding notification will appear.
Notification

Button

Select one object of interest. From the list of commands for this object, determine the command that will be sent when the button is clicked. You can specify the command name that will be displayed on the button and select one of three colors for it.
Button
💡
The list of commands available for selection does not include commands with parameters that can be specified directly when sending the command. Such commands are used as data sources only for the Slider, Stepper and Color widgets.
Click Save. A new widget will appear on the dashboard.
New widget
When you hover over the button, information about the data source is displayed.
Hover
Click the button to send the command. Upon successful execution or failure, the corresponding notification will appear.
Notification
💡
Use actions that require confirmation for commands whose accidental triggering may lead to unpleasant consequences. Then, before sending the command, you will be able to confirm or cancel the selected action.
Execution confirmation

Stepper

Select one object of interest. From the list of commands for this object, determine the command in whose data the numeric value set by the stepper position will be sent. Set the start and end boundary of the stepper, as well as the default value. You can also set the step with which the number will change when the stepper buttons are pressed.
Stepper
💡
In the list of commands available for selection, only those are present that have exactly one parameter set in the model, whose value can be specified directly when sending the command. The same commands are used as data sources for the Slider and Color widgets.
Click Save. A new widget will appear on the dashboard.
New widget
When you hover over the stepper, information about the data source is displayed.
Hover
Set the required number to send the command. Upon successful execution or failure, the corresponding notification will appear.
Notification
💡
You can select the required number not only using the control buttons, but also by entering it manually.
Entering a number

Color

Select one object of interest. From the list of commands for this object, determine the command in whose data the hexadecimal color code will be sent.
Color
💡
In the list of commands available for selection, only those are present that have exactly one parameter set in the model, whose value can be specified directly when sending the command. The same commands are used as data sources for the Slider and Stepper widgets.
Click Save. A new widget will appear on the dashboard.
New widget
When you hover over the color, information about the data source is displayed.
Hover
Set the required color to send the command. Upon successful execution or failure, the corresponding notification will appear.
Notification
💡
You can select the required color using the palette, eyedropper, or one of the color models.
Color selection
Regardless of the selected method, the color is sent in hexadecimal format.