Skip to content

Overview

You can synchronize attributes of the model with Insights Hub. All entities and attributes are created automatically in Insights Hub and the real-time data of the time series data is synchronized. Find more information on the use of asynchronous Insights Hub APIs here:

Consider the following aspects about synchronization from IIH Essentials to Insights Hub:

  • For every entity of type anchor.asset-base (or inherited children) an asset with its own asset type is created in Insights Hub.
  • For every entity of type anchor.aspect-base an aspect type is created in Insights Hub and added as an aspect to its according asset-type.
  • For every attribute a dynamic variable is created and added to its according aspect type in Insights Hub.
  • Attributes with the data type composition or aggregation are not created in Insights Hub, as there is no according object, but their aspect value is created as aspect type (see entity of type anchor.aspect-base)
  • If no attribute has been linked with an entity in the hierarchy, no asset or according types are created in Insights Hub.
  • If an attribute has been linked directly with an entity of type anchor.asset-base, an implicit aspect type is created in Insights Hub.
  • If an entity has a child entity, but no attribute, an empty asset type and asset is created in Insights Hub.
  • An entity of type anchor.aspect-base which is a child of an entity of type anchor.aspect-base cannot be synced to Insights Hub as this hierarchy is not possible in Insights Hub.
  • An entity of type anchor.asset-base which is connected via composition is not synced to Insights Hub.

Possible hierarchy

This tables shows different hierarchy structures and if they are able to sync with Insights Hub:

Top element Link to parent Subelement
(with attribute)
Link to parent Allowed in IIH Sync with Insights Hub
Asset Relation
Asset Relation Yes Yes
Asset Composition Yes No
Aspect Relation/Composition Yes Yes
Asset/Aspect Aggregation Yes Yes *
Asset Composition
Asset/Aspect Relation No
Asset/Aspect Composition Yes No
Asset/Aspect Aggregation Yes Yes *
Aspect Relation
Asset Relation/Composition No
Aspect Relation/Composition Yes No
Asset/Aspect Aggregation Yes Yes *
Aspect Composition
Asset Relation/Composition No
Aspect Relation No
Aspect Composition Yes No
Asset/Aspect Aggregation Yes Yes *

*: The subelement will be synced via the Relation/Composition hierarchy.

Firewall settings

The firewall must be opened for two ports

  • 443 – Standard HTTPS port for communication with the Insights Hub REST interface
  • 8883 – MQTT port of Insights Hub