Site views

A site view is a dashboard about your sites rather than about single devices. Hermetry ships two templates for it, and the same data source lets you build drill-down boards of your own. Each place’s colour comes from the status of the devices under it; see Site status and the status key.

Before you start

• Your sites exist on Sites & Assets as top-level assets of kind Site, with a latitude and longitude if you want them on the map. See Asset hierarchy.
• Your devices are placed on the sites or below them. See Placing devices.
• Your devices send a status key, or a flow derives one. A place’s status also takes open alarms and the devices’ connection into account; see Site status and the status key.

Create a Sites board

1. Open Dashboards and select New dashboard (or Start from a template on an empty board).
2. Pick Sites (“Your sites in a table and on a map, each in its status colour; a click opens the site with its view, live values, open alarms and a trend.”), or Sites with process diagrams to show each site’s 2D drawing instead of its 3D view.
3. Answer Which sites?:
   • All sites,
   • The sites of one type,
   • The sites under one parent.
4. Select Apply.

The template makes no sites and places no devices: it shows what is on Sites & Assets. More on templates in Board templates and board files.

Page 1: Sites

Card	Shows	Refresh
Sites	A table of the sites: name, status (a coloured badge), devices, open alarms, last seen. Search, 10 rows a page.	30 s
Sites on the map	Each site with a location as a marker in its status colour; the tooltip shows status, devices and open alarms	60 s
Devices with a place but no site	How many devices have a latitude and longitude but are placed in no site, with Place devices, which opens Sites & Assets	5 min

Select a row or a marker to open that site’s page. “Last seen” is the newest activity of the site’s devices.

A device counts as “with a place” when it has a lat and lng number in its additional info, in an attribute or in its latest telemetry.

Page 2: one site

Card	Shows	Refresh
Site	Name, place (the assets above it, else its address, else its coordinates) and status	30 s
View of the site	The site’s 3D view, or its 2D drawing where the 3D card cannot be shown (the Sites with process diagrams template always shows the drawing)	5 s
Open alarms	Every open alarm of the site’s devices, however old, newest first, up to 8 shown (“No open alarms” when there are none)	10 s
Live values	Each device of the site with its status, running state, values and last update; searchable	10 s
Trend	A line chart of the numeric keys of one device of the site	60 s

The page’s title is the site’s name. The filter bar has a Device picker for the trend: it lists the site’s devices at any depth (up to 10 levels down) and starts with the first by name.

Pages and cards can be changed like any board: move cards, add a column, change a title. See Create and organise boards.

Drill down through a site

For larger sites, build one page per level: site, building, floor, room. Each page shows the children of the next level as a status table, the view of the current level, and the equipment of the last level. On a 3D view, selecting a coloured room opens that room’s page.

The status table uses the data source IoT sites and assets and its query Status under an asset (“a row per child: worst status, devices, alarms”):

Setting	Meaning
Asset	The asset whose children are listed (usually the page’s parameter)
Assets	Instead, a row for each of these assets (for a first page that lists sites)
Rows for	The direct children, or Every node below (of the kinds)
Only nodes of these kinds	A comma list, for example ROOM,FLOOR (at most 10)
Only nodes with a node of these kinds below	For example KITCHEN: only nodes that contain a kitchen
Status key of the devices	Default status

Each row has the node’s id, code, name, kind, status, device count, open alarm count, latitude, longitude and last seen. Rows are sorted worst status first, then by name. To go one level down, give the table a When a row is clicked action Show a page of this board that sets the next page’s asset parameter to the clicked row’s id. See Actions and drill-down.

The same source has other queries: Sites and assets (the tree as rows), Assets of an alias, Devices under an asset (up to 500 rows), One site for a page header and One asset (name, kind, counts, attributes).

Limits

• A status table shows at most 200 rows over at most 5,000 devices. Larger results are marked as cut, and their counts may be partial.
• Devices you may not read are left out. Values need the telemetry read permission; alarm counts need the alarm read permission (without it they are empty).
• Status, column heads and status words are shown in the viewer’s language.

Troubleshooting

Problem	Cause and fix
A site is Unknown	No device under it sends a status key, has an open alarm or was active in the last 10 minutes; or no device is placed under it. Check a device’s Telemetry tab.
A site is missing from the map	It has no latitude and longitude. Edit the site.
A site shows 0 devices	The devices are not placed on it or below it.
Devices with a place but no site is high	Devices report coordinates but are not placed. Select Place devices.
A site’s page shows no view	The site has no 2D or 3D view. Attach one: 2D drawings and 3D scenes on a site.
The trend is empty	The chosen device sends no numbers in the window. Pick another device in Device.