Algorius Net Viewer Manual | Widgets
General information
Widgets allow you to display up-to-date information on the map. The following types of widgets are available:
- Number of devices — displays the number of devices on the specified map. The total number of devices and the number of active and inactive devices are displayed.
- Number of events — displays the number of current events on the specified map according to the notification settings. Shows the number of current events for each severity level: information, warnings, errors, and alarms.
- Sensor Status — displays the value and status of a specific device sensor.
The number of devices and events for a given map is counted, taking into account all its branch maps. See Hierarchy section for more information.
Adding to Map
To add a widget to a map, press the Add Widget button on the toolbar or in the context menu of the map editor. Choose widget type. The cursor arrow in the editor will become a cross cursor, showing the widget adding mode is activated. Clicking on the map will set the upper-left position of the widget. The Widget window will appear. Specify the required attributes, and click OK. The new widget will be added to the map.
Editing
All basic widget operations, such as deleting, moving, etc. comply with the general rules. See the relevant chapters in the Map Objects section.
To edit a widget, select it on the map and press Alt+Enter, or choose Edit from its context menu. The widget editing window will appear:
Depending on the widget type, the following attributes are available:
- Map — the map from which data is taken for display in the widget.
- Device — the device referenced by the widget. Available only for Sensor Status widgets. Only devices from the specified map that have sensors are available for selection.
- Sensor — the sensor referenced by the widget. Available only for Sensor Status widgets. Only sensors belonging to the selected device are available for selection.
- Total, Active, Inactive — selection of which device count to display in the widget. Available only for the Device Count widget.
- Information, Warning, Error, Alert — selection of which event count to display in the widget on the map. Available only for the Event Count widget.
- Style — the display style for the sensor. Available only for Sensor Status widgets.
- Scale — the minimum and maximum values for the widget's scale. The scale is filled according to this range and the widget's current value. You can specify a custom range based on the minimum and maximum values the specified sensor can output. Available only for Sensor Status widgets.
- Text — the format for displaying the value within the widget. Available only for Sensor Status widgets.
- Label — the text label displayed next to the widget.
Macros for substituting various values are available for text and labels. To insert a macro, enter the % symbol in the text or label editor. A list of macros for substitution will be displayed. Select the macro you need using the Up and Down arrow keys and press Enter, or double-click it with the mouse. The selected macro will be inserted into the editor. Pressing ESC closes the macro list.
The following macros are provided:
| %MAP_NAME% | The name of the map the widget references |
| %MAP_ACTIVE_COUNT% | Number of active devices on the map |
| %MAP_INACTIVE_COUNT% | Number of inactive devices on the map |
| %MAP_DEVICE_COUNT% | Total number of devices on the map |
| %MAP_INFO_COUNT% | Number of sensors on the map with severity level Information |
| %MAP_WARNING_COUNT% | Number of sensors on the map with severity level Warning |
| %MAP_ERROR_COUNT% | Number of sensors on the map with severity level Error |
| %MAP_ALARM_COUNT% | Number of sensors on the map with severity level Alarm |
The following macros are additionally provided for the Sensor Status widgets:
| %DEVICE_ADDRESS% | Device address |
| %DEVICE_NAME% | Device name |
| %DEVICE_HOST% | Hostname from device address |
| %DEVICE_IP% | Device IP address |
| %DEVICE_IPV4% | Device IPv4 address |
| %DEVICE_IPV6% | Device IPv6 address |
| %DEVICE_MAC% | Device MAC address |
| %DEVICE_TYPE% | Device type |
| %MAX_VALUE% | The maximum value of the widget scale |
| %MAX_UNIT% | The measurement unit for the maximum value of the widget scale |
| %PERCENT% | The current value of the device sensor as a percentage between the minimum and maximum values of the widget scale |
| %SENSOR_ID% | Sensor ID |
| %SENSOR_NAME% | Sensor name |
| %SEVERITY% | The current severity level of the device sensor |
| %STATE% | Current state of the device sensor |
| %VALUE% | Current value of the device sensor |
| %UNIT% | The measurement unit of the current value of the device sensor |
For Sensor Status widgets, macros for substituting additional device attributes are available.
Additionally, all widget attributes are also available for editing in the properties panel.
Properties
Widget properties are displayed in the Properties panel when one or more widgets are selected on the map. See Properties for additional information.