Notification for Asset Model Changes¶

Overview¶

With subscription-based notification, the 3^rd party applications can now integrate subscriptions to topics related to Asset Model. Such applications would be then able to receive notifications when there's a change in Asset Model. Applications can respond with desired actions upon receiving a notification such as using GET aspect by ID API, GET asset type by ID API or GET asset by ID API to fetch more details about the respective asset model object, if required. This feature enables developers to build optimized interactions in the applications and make them performant. Moreover, this improves the user experience for the developers. This mechanism enables customers when to poll the Asset Model data.

The notification will be received on the following changes to Asset Model objects:

Aspect Type¶

Create Aspect Type
Update Aspect Type
Change description
Add variable on aspect type
Remove variable from aspect type
Rename variable on aspect type
Change unit on aspect variable
Change default value on static aspect variable
Delete Aspect Type

Asset Type¶

Create Asset Type
Update Asset Type
Change description, image on Asset Type
Rename Asset Type
Add Asset Type direct variable
Rename Asset Type direct variable
Change unit on Asset Type direct variable
Change default value on Asset Type direct variable
Change length on Asset Type direct variable of type STRING
Delete Asset Type direct Variable
Create Aspect on Asset Type
Remove Aspect from Asset Type
Rename Aspect on Asset Type
Delete Asset Type

Asset¶

Create Asset
Update Asset
Change asset name, description, and location
Change or override the default value of the direct asset type variable
Change or override the default value of the static aspect variable
Delete Asset
Move Asset

To create and publish App for consuming Asset Model notifications, refer to How to Subscribe to notifications for Asset Model change

Limitation¶

The underlying messaging service may bring nomenclature/version changes in the near term; which may need changes and adaption in the customer application.

References¶

Message Broker API
Provisioning API

FAQs¶

What is the notification level in the Asset Model?
- The notification will be available at the tenant level.
What is the maximum number of asset model resource information per notification?
- The notification will be real-time on an Asset Model change and will be a single message per action.
Can customers get delayed notification?
- Yes, in case any Insights Hub component is non-operational.