PI Vision Custom Symbol : VALUE CHANGE DETECTOR

Description

The PI Vision custom symbol Value Change Detector is a quite useful symbol which helps monitoring the changes of real-time values. It works with PI tags and PI AF attributes.

This single datasource symbol keeps tracking the difference between the previous value and the current one, and shows a warning icon when the change is significant enough (see configuration options below).

Icon when no change is detected :

Icon when a change is detected :

Note :

• the icon can be resized at any scale
• the unactive icon can be hidden (see configuration options)

At any time, the user can click on the icon, to display a popup with detailed information about the previous value and the new one

Example :

When the change is acknowledged, the symbol gets back to the unactive icon, and logs information of the aknowledgment (user name + time)

Example :

Configuration options

• Behavior
  • Show the active warning icon when 2 consecutive values are different
    OR
    Show the active warning icon when the delta between 2 consecutive values is greater or equal to a specific value (user-defined threshold)
  • Depending on the choosen configuration option, the active warning icon will remain until the change is acknowledged, or until the same value is recorded.
    
    Default values :

    

• Options
  • Hide the unactive icon (grayed warning icon) until a change is detected
  • Blink the active warning icon when a change is detected
    
    Default values :

    

• Colors
  • Background color
    
    Default value : transparent

    

Technical considerations

Compatibility

This custom symbol is compatible with PI Vision 2017 R2 or later.

Tested with :

• PI Vision 2017 R2 SP1 (build 3.3.1.0)
• PI Vision 2019 Patch 1 (build 3.4.1.0)
• PI Vision 2020 Patch 1 (build 3.5.1.0)
• PI Vision 2021 Patch 1 (build 3.6.1.0)
• PI Vision 2022 (build 3.7.0.0)
• PI Vision 2022 Patch 1 (build 3.7.1.0)
• PI Vision 2023 (build 3.8.0.0)
• PI Vision 2023 SP1 Patch 1 (build 3.9.1.0)

Asset switching

This custom symbol is fully compatible with the asset switching feature.

Data retrieval

Fully based on Data Services (like core PI Vision symbols).

Do NOT require PI Web API.

Dependencies

No dependency required :

• No external third-party library
• No polyfill