Skip to main content

3. Designing a dashboard

Once you have defined the connection to a sensor via a Visamic Input, you can use that as a building block to setup monitors for the data that it produces. There are three key stages to that; the creation of a Thing that defines how to connect to the Input, whether to save incoming data and whether to apply filters and functions to it. One the Thing is defined you can create a Dashboard and Datapanels to define what format to visualise the data in.

Thing#

A Thing is Visamic's core definition holder, linking the connected sensor via an Input, defining Triggers, Functions and Filters. You should setup a Thing for your connected sensor.

The Thing offers the means to:

  • connect to an Input
  • define a filter
  • define a Function

When you create a new Thing via the Visamic menu you will be presented with the folliwng screen:

image

Name your Thing and mark the "Connected" checkbox if you require the Thing to be active. Mark "Retain Data" if you require that the Thing save data arriving from the sensor. Note that the saving of data is not required if you simply require to monitor data and trigger on certain data conditions.

Filter Editor#

image

Types of filter

Fixed date

Setting datetime values for the fields in row 1. defines a start and end date taken fom the Thing's retain data table if available. It sets a filter on a fixed range of data points. Use this date format:

yyyy-MM-ddTHH:mm Example: 2021-04-16T10:46

If you leave the second field empty, the filter won't close, it'll run up to current data. Remember that other properties that you have setup for the Thing could override this data range, suxh as the Value-Display setting that limits the number of visible points in a panel at any one time.

Moving window

Setting values in row 2 of the filter editor sets a filter to a range of points relative to the timestamp of the first value in the Thing's retain data table.

value format: Start offset/End offset

HH:mm:ss.ffffff. Exemple: '00:00:00.000000'

Point range

Setting values in the third row of the Filter editor sets the filter according to the number of points you enter, relative to the first value of the retain table.

More on Filters: Web/Reference/Filters

Function Editor#

Name the function and select the type of function you wish to apply. You can set the function to calculate over a number of points.

image

Datapanel

The DataPanel unites the input data definition of the Thing with a visualisation and layout option for the Dashboard.

Create a dashboard#

To create a new Datapanel you first need to create a dashboard or open an existing dashboard to which you wish to add the Datapanel.

To create a new dashboard click on the "Dashboard" item on the main menu and clieck on the "new" button to the right of the screen. Once it has been added you can select it, opening it to add a DataPanel.

Add the datapanel#

Click on the "Add panel" button on the top-right of the Dashboard.

image

This example shows that the Thing we created in the earlier step has been selected for the Datapanel and that the list of attributes, filters and functions become available for the Datapanel. Choose those elements that you wish to display.

image