Filter-Formel-Übersicht

Eine Funktion ist eine ungeordnete Menge von Funktionen, Parametern, Operatoren und Wertepaaren. Eine Funktion beginnt mit und endet mit Klammern (). Jede Funktion, Parameter, Operator und Wertepaar werden von einem Semikolon gefolgt.

AND-Funktion

Die UND-Funktion dient zum Filtern von Symbolen, deren Bedingungen mit einem Wahr erfüllt sind. Nachfolgend zwei Beispiele für die Verwendung von der UND-Funktion und in Verbindung mit der ODER-Funktion.

AND ( Type  = BOOL;
      Name  = 'bEnabled';
      Value = True )

Die Funktion filtert nach Symbolen mit dem Typ BOOL, deren Name bEnabled und deren Wert TRUE ist.

AND ( Name  = nCounter;
OR  ( Value = 10;
      Value = 50 ))

Die Funktion filtert nach Symbolen deren Name nCounter ist und deren Wert ‚10‘ oder ‚50‘ ist.

OR-Funktion

Die ODER-Funktion dient zum Filtern von Symbolen, bei denen eine Bedingung mit einem Wahr erfüllt ist. Nachfolgend zwei Beispiele für die Verwendung von der ODER-Funktion und in Verbindung mit der UND-Funktion.

OR ( Value = 150;
     Value = -150 )

Die Funktion filtert nach Symbolen deren Wert ‚150‘ oder ‚-150‘ ist.

AND ( Name = 'nCounter';
      OR ( Value = 10;
           Value = 50 ))

Die Funktion filtert nach Symbolen deren Name ‚nCounter‘ ist und deren Wert ‚10‘ oder ‚50‘ ist.

PARENT-Funktion

Die PARENT-Funktion dient zum Filtern von Symbolen deren direktes Eltern-Symbol (Übergeordnetes Symbol) einer gleichen Bedingung unterliegen. Die in der PARENT-Funktion angegebenen Bedingungen werden Logisch-UND ausgewertet.

	Die PARENT-Funktion kann nur in einer AND-Funktion oder einer ODER-Funktion verwendet werden.

Hier ein allgemeines Beispiel für die Verwendung der PARENT-Funktion:

AND (    Name = 'sObjectName';
PARENT ( Name = 'Plant';
         Value = TRUE ))

Die Funktion filtert nach Symbolen mit dem Namen ‚sSobjectName‘ und nach deren Eltern-Symbol mit dem Namen ‚Plant‘. Weiterhin muss der Wert dieses Symbols TRUE sein.

ANCESTOR-Funktion

Die ANCESTOR-Funktion dient zum Filtern von Symbolen, dessen Vorfahren in der Elternkette von Symbolen einer Bedingung unterliegen, z. B. ein spezieller Name oder Typ. Die in der ANCESTOR-Funktion angegebene Bedingung wird Logisch-AND ausgewertet.

	Die ANCESTOR-Funktion kann nur in einer AND- Funktion oder einer ODER-Funktion verwendet werden.

Hier einige allgemeine Beispiele für die Verwendung der ANCESTOR-Funktion:

AND (      Name = 'sObjectName';
ANCESTOR ( Type = 'FB_BAC_AI'))

Die Funktion filtert nach Symbolen mit dem Namen ‚sObjectName‘. Die Vorfahren dieser Symbole kommen aus der Elternkette von Symbolen mit dem Typ ‚FB_BAC_AI‘.

AND (      Name = 'sObjectName';
ANCESTOR ( Name = 'Plant01'))

Die Funktion filtert nach Symbolen mit dem Namen ‚sObjectName‘. Innerhalb der Elternkette dieser Symbole trägt einer der Vorfahren den Namen ‚Plant01‘.

CHILD-Funktion

Die CHILD-Funktion dient zum Filtern von Symbolen deren Kinder-Symbole einer Bedingung unterliegen. Die in der CHILD-Funktion angegebenen Bedingungen werden logisch UND ausgewertet.

	Die CHILD-Funktion kann nur in einer AND- Funktion oder einer ODER-Funktion verwendet werden.

Hier ein allgemeines Beispiel für die Verwendung der CHILD-Funktion:

AND (   Name = 'Plant';
Child ( Name = 'sObjectName';
        Value = 'P001' )

Value Parameter

Die Funktion sucht nach Symbolen deren Wert eine Bedingung mit einem bestimmten Wert erfüllt.

Beispiele:

Value = '100'

Suche nach Symbolen deren Wert ‚100‘ ist.

Value > '100'

Suche nach Symbolen deren Wert größer ‚100‘ ist.

Value < '100'

Suche nach Symbolen deren Wert kleiner ‚100‘ ist.

Value != '100'

Suche nach Symbolen deren Wert ungleich ‚100‘ ist.

Value = ''

Suche nach Symbolen deren Wert leer ‚ ‘ ist.

Comment Parameter

Die Funktion sucht nach Symbolen deren Wert eine Bedingung mit einem bestimmten Kommentar erfüllt.

Beispiele:

Comment = 'Signal to detect'

Suche nach Symbolen deren Kommentar ‚Signal to detect‘ ist.

Comment != 'Signal to detect'

Suche nach Symbolen deren Kommentar nicht ‚Signal to detect‘ ist.

Comment >'Signal'

Suche nach Symbolen deren Kommentar mit ‚Signal‘ beginnt.

Comment < 'detect'

Suche nach Symbolen deren Kommentar mit ‚detect‘ endet.

Name Parameter

Die Funktion sucht nach Symbolen deren Wert eine Bedingung mit einem bestimmten Namen erfüllt.

Beispiele:

Name = 'bEnable'

Suche nach Symbolen deren Name ‚bEnable‘ ist.

Name != 'bEnable'

Suche nach Symbolen deren Name nicht ‚bEnable‘ ist.

Name > 'bEn'

Suche nach Symbolen deren Name mit ‚bEn‘ beginnt.

Name < 'le'

Suche nach Symbolen deren Name mit ‚le‘ endet.

Type Parameter

Die Funktion sucht nach Symbolen deren Wert eine Bedingung von einem bestimmten Typ entspricht.

Beispiele:

Type = 'FB_BACnet_Pump'

Suche nach Symbolen deren Typ ‚FB_BACnet_Pump‘ ist.

Type != 'FB_BACnet_Pump'

Suche nach Symbolen deren Name nicht ‚FB_BACnet_Pump ‘ ist.

Type > 'FB_BACnet'

Suche nach Symbolen deren Name mit ‚FB_BACnet‘ beginnt.

Type < 'BACnet_Pump'

Suche nach Symbolen deren Name mit ‚BACnet_Pump‘ endet.

Attribut Parameter

Die Funktion sucht nach Symbolen, die ein Attribut haben dessen Name eine Bedingung mit einem bestimmten Wert erfüllt.

Beispiele:

Attribute = 'IsPersistent'

Suche nach Symbolen, die ein Attribut mit dem Namen ‚IsPersistent‘ haben.

Attribute != 'IsPersistent'

Suche nach Symbolen, die nicht ein Attribut mit dem Namen ‚IsPersistent‘ haben.