A dashboard can be used to inspect and/or interact with one or more devices in the Ardexa cloud that share common characteristics. They allow users of a workgroup to configure useful views for every device.
The top-level dashboard in a workgroup is called the Workgroup Overview. This lists all devices in the workgroup, and allows the user to drill down to each device.
While viewing a dashboard, other devices in the workgroup can be viewed by selecting them in the device dropdown in the dashboard's header.
Creating Dashboard Templates
To create a new dashboard template, click 'New dashboard' in the Dashboards menu. This will give you the option of selecting a default device for the template. Selecting a default device is recommended in Workgroups containing devices with different configurations to ensure that relevant fields are populated. A dashboard's default device can be changed later through the Settings dialog.
Dashboards are composed of one or more rows. Each row can have one to three equal-width columns, with each column containing one or more cards. Columns within the same row will be given the same height.
Clicking the "Edit Layout" button will put the dashboard into Edit Layout mode. Thick, dark dashed-grey lines indicate a dashboard row, while thin, light dashed-grey lines indicate a column.
Figure: a dashboard in "Edit layout" mode
If you want to stack multiple full-width cards vertically, we recommend creating multiple rows containing a single card, rather than stacking multiple cards within the same column.
Cards can be dragged and dropped between rows and columns.
Rows & columns can not be deleted if they contain cards; move or delete cards to enable deletion.
Changes made to a dashboard need to be explicitly saved by clicking the 'Save' button. Clicking 'Discard' will reset the dashboard to the last saved state. When a new dashboard is saved, you will be prompted to enter a name for the dashboard, if you haven't set one already.
Additionally, if the current device doesn't have a default dashboard, you will be given the option to make it the default dashboard for the device.
Sensor cards allow the user to view the latest state from a device, represented by one or more units arranged on a canvas. To add a unit to a card, choose an option from the "Add Sensors" menu. This will create a blank unit, which can be configured via the unit's context menu.
Sensor Units display the most recent value from a specific input stream on the current device. Visualisation options are determined by the expected type of the selected input stream. For example, decimal or float input streams can be visualised using 'single number', 'animated gauge', 'cylinder', 'speedometer' or 'last 10 lines'.
Figure: A Sensor Card with numeric Sensor Units.
Action units can interact with a device by running commands via the Ardexa Cloud. Commands can be specified directly on the card or reference pre-defined commands configured on the device.
Formula units display the results of custom calculations using the latest device values.
Add Multiple Sensor Units
Sensor units for multiple input streams can be added in bulk via this menu option. Added sensor units will be arranged across the canvas from left to right, wrapping to a new row when horizontal space runs out.
Graph cards chart the recent history of one or more device variables over a configurable time period. At the moment, only data from scenarios with a type of CSV can be graphed within a graph card.
The graph card's configuration dialog will display a list of available input streams. Streams with retrievable values will display a preview of the latest value in the list.
Photo cards display the latest image captured by a Watch source on a device. If a device is configured to upload images to the Ardexa Cloud, the Photo Card will initially display the most recent image uploaded today.
Once saved, newly created dashboards are visible to all users in the workgroup by default. To make a dashboard private to you, click on the 'eye' button in the dashboard's header. To re-share a private dashboard, click on the closed eye button.
To delete a dashboard, open the dashboard and select the 'Delete' option from the settings menu:
If the dashboard is the default dashboard for any devices in the workgroup, these dashboards will revert to having no default dashboard.
The workgroup overview is an automatically generated dashboard that provides a summary of devices in the current workgroup. Users can click on each plant's name to drill down and view the default dashboard for each device.
Energy workgroups with reporting enabled will display additional information in the workgroup overview. This includes a summary of actual vs. expected energy produced across the workgroup, and the following fields for each device:
- Actual energy produced per device, last 30 days
- Performance ratio %, last 30 days
- Inverter performance
- Days with energy
Clicking on a device's name in the Workgroup Overview dashboard will display the default dashboard for that device. To make a dashboard the default for a given device:
- Open the dashboard, either via the Dashboards menu, or by browsing to another plant that uses the same dashboard
- Select the device using the device selector dropdown
- In the Settings dropdown menu, click 'Make default for device'.
Workgroups with labelled devices will display a read-only dashboard generated from the labelled sources on the device. This can be overridden by a setting a default dashboard on the device.