Assets
Assets are abstract entities in iRis Cloud that represent physical objects, spaces, or organizational units — buildings, rooms, production areas, fields, streetlights, substations, or vehicles. Unlike HMI Devices, assets don't generate telemetry on their own, but they can store attributes and telemetry, maintain relations with HMI Devices and other assets, and participate in alarms and dashboards.
Assets vs. HMI Devices
Section titled “Assets vs. HMI Devices”Use a HMI Device for anything that connects to iRis Cloud and sends its own telemetry — a sensor, a controller, an HMI panel. Use an Asset for something that doesn’t connect directly but still needs to exist as an entity — a building, a room, a vehicle, a production line — so it can group related HMI Devices into a hierarchy or aggregate their data.
A common pattern: model the physical structure with assets (Building → Floor → Room), then relate each room to the HMI Devices physically inside it via Relations. Telemetry from the related HMI Devices is then queried across the whole hierarchy on a dashboard.
Managing Assets
Section titled “Managing Assets”Create an Asset
Section titled “Create an Asset”- Navigate to Entities → Assets.
- Click + and select Add new asset.
- Enter a Name (must be unique within the tenant).
- Optionally select an Asset profile (defaults to “default”), Label, or Description.
- Click Add.
Edit an Asset
Section titled “Edit an Asset”- Click the asset in the list to open its details.
- Click the pencil icon.
- Update the name, label, profile, or description.
- Click Apply changes.
Delete an Asset
Section titled “Delete an Asset”Click the trash icon next to the asset and confirm, or open the asset details page and click Delete asset.
Assign to Customer
Section titled Assign to Customer- Locate the asset in the list.
- Click the Assign to customer icon.
- Select the target customer and click Assign.
Only users associated with that customer can access the asset and its data. You can later unassign or reassign the asset to another customer.
Make Public / Private
Section titled Make Public / PrivateClick the Make asset public icon next to the asset to expose its data publicly, or Make asset private to revoke public access.
Asset Details
Section titled “Asset Details”Opening an asset reveals a details panel with the following tabs:
| Tab | Contents |
|---|---|
| Attributes | Client, server, and shared key-value pairs (location, category, configuration parameters) |
| Latest Telemetry | Telemetry stored on the asset; supports manual entry and deletion |
| Alarm Rules | Conditions, thresholds, and triggers configured for alarm generation |
| Alarms | Active and historical alarms for this asset |
| Events | Lifecycle events, logs, warnings, and errors |
| Relations | Directed connections to other entities |
| Audit Logs | History of user actions: creation, updates, deletions |
Managing Relations
Section titled “Managing Relations”You can create, view, edit, and delete relations between an asset and other entities from the Relations tab of the asset details page.
Add a relation:
- Open the asset details → Relations tab.
- Select the direction: From (outbound) or To (inbound).
- Click +.
- Set the Relation type (e.g., Contains, Manages) and choose the target entity.
- Click Add.
Troubleshooting
Section titled “Troubleshooting”| Symptom | Cause | Fix |
|---|---|---|
| Dashboard widget shows no data for an asset | The widget’s entity alias doesn’t resolve to the asset, or the asset has no related HMI Device sending data | Check the alias in Entity aliases, and confirm the asset has a relation to a HMI Device that’s actively sending telemetry |
| Can’t find a way to share a single asset | Individual assets are made public or assigned to one customer, not “shared” | Assign it to a customer, or make it public — see Assign to Customer |
| Dashboard still references a deleted asset | Deleting an asset breaks its relations but not the dashboard widgets built on them | Update the affected entity aliases or widgets to point at a different asset |
Where Assets Are Used
Section titled “Where Assets Are Used”- Dashboards — visualize aggregated data, attributes, and alarms via widgets
- Relations — model hierarchies (e.g., Building → Contains → Room → Contains → Sensor)
- REST API — query, create, and manage assets programmatically