Skip to main content

Documentation Portal

PI EF Configuration

Starting from version 2021.R2.1, OSIsoft Event Frames are considered as an external data source and need to be configured in the data source section in confighub. You can add a datasource with asset capabilities (using the PI asset framework provider), or enable the asset capabilities on your current asset data source.

Important

As PI event frames are tightly coupled to PI Asset Framework (i.e. the reference from the “primary element” property of an event frame to an element in PI AF), the integration of TrendMiner with PI event frames is also tightly coupled to the integration of TrendMiner with PI AF, we require both TrendMiner - PI integrations to be active AND share the same configuration. If not, TrendMiner would not be able to correctly represent the component of a context item, cfr. the primary element of an event frame. As a result, you will only be able to access event frames from a PI EF data source if the coupled PI AF data source is configured in TrendMiner for asset framework integration.

Supported versions

To synchronise your OSIsoft PI event framework, TrendMiner needs to have access to the PI AF SDK. The SDK is included in the PI AF Client and the PI OLEDB Enterprise driver.

We recommend using release 2017 R2, 2.9.0 or later of the OSIsoft PI AF Client or PI OLEDB Enterprise packages for compatibility. Syncing older versions is possible but won't achieve optimum performance and might lose events in specific cases as the PI API in the older versions don't support the necessary query parameters TrendMiner needs. Contact TrendMiner support (support@trendminer.com) for more information.

How does the sync work?
  • Live synchronisation

    TrendMiner offers live synchronisation (with a 2 minute interval) of ALL event frames that are modified or created. If a lot of items are edited at the same time (e.g. a bulk action in PI EF), this interval is synced in a separate thread (excessive interval thread) to avoid a delay on the live sync. The live sync can be enabled in the context properties section of the data source.

  • Historical synchronisation

    TrendMiner offers a historical synchronisation of ALL event frames that are edited or creating within a predefined timeframe. The start and end date can be selected in the data source detail panel.

    PI_EF.png