Use the OEE KPI control
- Last UpdatedNov 26, 2024
- 2 minute read
When configuring the OEE KPI control, the designer will typically set a default Control Style (dial or bar graph) and Filter Defaults (TypeFilter, FilterDuration, OEEKPIFilter.FilterTime, OEEKPIFilter.FilterStartOffset, OEEKPIFilter.FilterEndOffset). It is also possible to specify that various property values will be configured by the operator at run time and 'saved to' or 'retrieved from' the MES database on a per user basis. If this is the case, configuring these properties will be disabled at design time. See the FilterDefaultsFromDB property for more on this.
At design time or run time, when configuring filters, a Filter dialog box exists to help coordinate the setting of several properties at once. This Filter dialog box can be invoked at design time by selecting the ellipsis button next to the TypeFilter property. At run time, it is invoked by calling the Filter() method or using the button bar.

At run time, the control is refreshed whenever an OEEChanged event is detected from the MES database. This event is handled internally by the control. The control is also refreshed when various properties are set (such as ControlStyle, TypeFilter, and so on). To prevent a refresh from occurring in the middle of setting the filters, the control supports the common IgnoreRefreshEvents property and RefreshData() method scheme. For more information on this method, see RefreshData() method.
The OEE KPI control has a context menu that allows a user with the proper permissions to save the configuration of the control to the database for either a specific entity, all the logged on entities, or as a default. Only the button bar setup and the current filter settings will be saved as configuration data.
To use the OEE KPI control, the operator must log on to a session and select one or more entities, or set the DisplayEntity property which will use the display entity as the source of the data.