Asset hierarchy – Hermetry

The asset hierarchy is a tree of the places and equipment in your organisation. Each node is an asset. Devices are placed on assets, and each asset shows the status and alarms of the devices under it. You build the tree on Sites & Assets.

A typical tree:

Istanbul plant (Site)
  Building A (Building)
    Ground floor (Floor)
      Compressor room (Room)
        Compressor 1 (Machine)
  Line 3 (Line)
Ankara depot (Site)

There is no fixed order of kinds: a line can sit directly under a site, a machine under a room. Only the parent-child links matter.

The Sites & Assets page

Open Sites & Assets. The page, Sites & assets (“Where your devices are: sites, buildings, floors, lines and machines.”), has three parts.

Summary. Four counts:

Count	Shows
Sites	Top-level assets, with how many are on the map
Assets	Buildings, floors, lines and machines
Devices	Your devices, with how many are placed on an asset
Active alarms	Open and acknowledged alarms, with how many are critical and unacknowledged

The table. Every asset in one table:

Column	Shows
Asset	The name and code
Kind	Site, Building, Floor, …
Place	The assets above it
Child assets	Its direct children
Devices	Devices placed on it or below it
Alarms	Active alarms of those devices (“No issues” when there are none)

Search with Search by name, code or place. Filter by Site (an asset and everything under it), Kind, or Only with active alarms. Select a column head to sort. Select a row to open the asset’s drawer.

The map. Select Map to open Sites on the map: every site with a location, coloured by its worst active alarm (“Colour: the worst active alarm”: Critical or major, Minor or warning, No issues). Sites without a location are listed as No location. Search sites, select one for its summary, or Fit all.

The header also links to the Device list and Alarms. The Alarms column, the alarm counts and the alarm colours appear only for people who may view alarms.

Create a site

Select New site.
Enter a Name (up to 255 characters).
Kind is Site. Pick another kind if you like, or Another kind and type a Kind name.
Optionally enter a Code. Leave it empty to make it from the name.
Optionally fill Description, Time zone (for example Europe/Istanbul), Latitude and Longitude.
Select Create.

A site’s location puts it on the map, and its time zone and location are used by rules. See Locations and time zones.

Add assets below

Open the parent asset’s drawer.
Select Add child. The form is titled New asset in , and Kind starts at Building.
Fill the form as above and select Create.

Kinds, codes and attributes are explained in Asset kinds, codes and attributes.

The asset drawer

The drawer Asset shows:

Section	Contents
Overview	Kind, code, path, time zone (an inherited one shows as “Europe/Istanbul (from Istanbul plant)”), location, created
Attributes	The asset’s attributes, read only (“No attributes.” when there are none)
Devices	Devices placed here; tick Include devices placed below to see the whole subtree. Place devices and Remove placement
Child assets (n)	Its children, with a search
Relations	Relations to and from the asset, with Remove relation

Actions in the drawer header: Add child, Edit, Move to…, Open dashboard (when the asset has a default dashboard) and, under more actions, Delete. Other modules add their own buttons here, for example Views for the site’s 2D and 3D views (see 2D drawings and 3D scenes on a site).

You can link to a drawer directly: /admin/iot/assets?asset=<asset id>.

Edit an asset

Select Edit, change the fields and select Save. Changing the code rewrites the path of every asset below it.

Move an asset

Select Move to…. The dialog Move ““ lists the possible parents. The asset itself and everything under it are not offered: “an asset cannot go under itself.”
Pick the new parent, or Top level (no parent).
Select Move here.

Everything below the asset moves with it, together with the devices placed there. A path (the codes from the top, joined by /) may be at most 1,024 characters, so a very deep tree is refused.

Delete an asset

Under more actions, select Delete.
Confirm Delete ““?: “Its device placements and relations end. An asset with child assets cannot be deleted.”

Move or delete the children first. The devices that were placed on the asset stay; they simply have no place until you place them again. Deleting is refused while another module still uses the asset, and the message names it.

A Rules card rule whose home asset is deleted is switched off and reported as needing attention (webhook rules.needs_attention).

Limits

Limit	Value
Name	255 characters
Code	32 characters, unique among your assets
Kind	24 characters
Path	1,024 characters
Description	1,000 characters
Assets in one tree read	5,000 (“Only the first part of a very large tree is shown.”)
Devices placed at once	100

Who can do what

Viewing needs View IoT sites and assets (User). Creating, editing, moving and deleting need Create, edit, move and delete IoT sites and assets (Admin). Placing devices and removing relations need Manage relations and device placement (Admin). The buttons appear only for people who may use them.