Seeq Knowledge Base
Latest R65 R58 Cloud On-Premise
Latest R65 R58 Cloud On-Premise

OPC-HDA Filtering Examples

Suppose you have the following tags (no hierarchy)

OPC-HDA Tags
Area A_Temperature
Area A_Compressor Power
Area B_Temperature
Area B_Compressor Power
Max Power

Only include tags prefixed "Area "

Include "Area *"
Resulting tags
Area A_Temperature
Area A_Compressor Power
Area B_Temperature
Area B_Compressor Power

Only include tags prefixed with "Area " but not tags that include "Temp"

Include "Area *"
Exclude "*Temp*"
Resulting tags
Area A_Compressor Power
Area B_Compressor Power

Broadly exclude tags containing "Power", but make exceptions for certain tags

Exclude "*Power*"
Include "Max Power"
Resulting tags
Area A_Temperature
Area B_Temperature
Max Power

Exclude multiple patterns

Exclude "Area B_*"
Exclude "Area A_*"
Resulting tags
Max Power

Suppose you have the following tags (in a hierarchy)

OPC-HDA Tags
Cooling Tower
  Area A
    Compressor Power
    Wet Bulb
    Temperature
  Area B
    Compressor Power
    Wet Bulb
    Temperature
Max Power

Exclude tags containing "Power"

Exclude "**/*Power*"
Resulting tags
Cooling Tower/Area A/Wet Bulb
Cooling Tower/Area A/Temperature
Cooling Tower/Area B/Wet Bulb
Cooling Tower/Area B/Temperature

Only include tags in Cooling Tower, but exclude tags containing "Bulb"

Include "Cooling Tower"
Include "Cooling Tower/**"
Exclude "**/*Bulb*"
Resulting tags
Cooling Tower/Area A/Compressor Power
Cooling Tower/Area A/Temperature
Cooling Tower/Area B/Compressor Power
Cooling Tower/Area B/Temperature

Include only Area A

Include "Cooling Tower"
Include "Cooling Tower/Area A"
Include "Cooling Tower/Area A/**"
Resulting tags
Cooling Tower/Area A/Compressor Power
Cooling Tower/Area A/Wet Bulb
Cooling Tower/Area A/Temperature

Important Note

The filters are tested at each level of the hierarchy, so with a tag like Cooling Tower/Area A/Temperature then Cooling Tower, Cooling Tower/Area A , and Cooling Tower/Area A/Temperature are all evaluated individually. This can help reduce requests to the OPC-HDA historian when using Exclude filters to exclude a node with many nested children, but when using Include filters all parts of the hierarchy you want to include must be explicitly included. For example, in the above example where we only want to include tags from Area A it isn't sufficient to use just Include Cooling Tower/Area A/** because that would not match Cooling Tower or Cooling Tower/Area A.