Daten filtern

Eine Condition dient als Filter. Daher werden hier grundsätzlich alle Eingangssymbole weitergegeben, sofern die Filterbedingung erfüllt ist. Die Filterung kann sowohl eventbasiert als auch zeitbasiert erfolgen. Wie lange die Daten nach Erfüllen der Bedingung weitergegeben werden, steuert das DurationType-Property. Conditions sind Bausteine innerhalb einer Rule. Sie werden über AddCondition<T>() an der Rule erzeugt. Alle Conditions haben folgende Eigenschaften und Methoden:

Eigenschaft

Beschreibung

Properties

Parametrierung der Condition

Methode

Beschreibung

GetOutputSymbol(...)

Liefert das zum Eingangssymbol gehörende Ausgangssymbol der Condition.

Eventbased Condition (IEventbasedCondition)

Erkennt Ereignisse auf einer Variablen, z. B. das Über- oder Unterschreiten eines Grenzwerts. Die Parametrierung erfolgt über das Properties-Objekt.

Eigenschaft

Beschreibung

CompareType

Art des Vergleichs: gegen einen festen Wert, gegen eine andere Variable oder gegen den vorherigen Wert.

SelectedVariable

Überwachte Variable

SelectedOperator

Verwendeter Vergleichsoperator (EventbasedOperator).

CompareValue

Vergleichswert bei Vergleich gegen einen festen Wert.

CompareVariable

Vergleichsvariable bei Vergleich gegen eine andere Variable.

IsCaseSensitive

Gibt an, ob String-Vergleiche zwischen Groß- und Kleinschreibung unterscheiden.

DurationType

Art der Gültigkeitsdauer: einmaliges Flag, Zeitintervall oder solange die Bedingung erfüllt ist.

DurationInterval

Dauer bei Gültigkeitsdauer vom Typ Zeitintervall.

Methode

Beschreibung

SetEventCompareToValue(IConfigSymbol variable, EventbasedOperator edgeOperator, string compareValue)

Vergleicht die überwachte Variable mit einem festen Wert.

SetEventCompareToVariable(IConfigSymbol variable, EventbasedOperator edgeOperator, IConfigSymbol compareVariable)

Vergleicht die überwachte Variable mit einer anderen Variablen.

SetEventCompareToPreviousValue(IConfigSymbol variable, EventbasedOperator edgeOperator)

Vergleicht den aktuellen Wert der Variablen mit ihrem vorherigen Wert.

SetIsCaseSensitive(bool isCaseSensitive)

Legt fest, ob String-Vergleiche zwischen Groß- und Kleinschreibung unterscheiden.

SetDurationType(TcIoTAlySPConditionDuration conditionDuration)

Legt die Art der Gültigkeitsdauer fest.

SetDurationInterval(TimeSpan duration)

Legt die Dauer bei Gültigkeitsdauer vom Typ Zeitintervall fest.

Timebased Condition (ITimebasedCondition)

Filtert Daten zeitgesteuert — zyklisch, wöchentlich oder monatlich. Die Parametrierung erfolgt über das Properties-Objekt.

Eigenschaft

Beschreibung

ConditionType

Art der Zeitsteuerung: Intervall, wöchentlich oder monatlich.

Interval

Zeitintervall bei zyklischer Auslösung.

Weekdays

Ausgewählte Wochentage bei wöchentlicher Auslösung.

TimeOfDay

Uhrzeit, zu der ausgelöst wird.

Months

Ausgewählte Monate bei monatlicher Auslösung.

DayOfMonth

Tag im Monat bei monatlicher Auslösung.

UseLastDay

Gibt an, ob der letzte Tag des Monats verwendet wird.

DurationType

Art der Gültigkeitsdauer: einmaliges Flag, Zeitintervall oder solange die Bedingung erfüllt ist.

DurationInterval

Dauer bei Gültigkeitsdauer vom Typ Zeitintervall.

Methode

Beschreibung

SetEventContinuousInterval(TimeSpan interval)

Löst zyklisch im angegebenen Intervall aus.

SetEventWeekly(Weekday_Values weekdays, TimeSpan timeOfDay)

Löst an den angegebenen Wochentagen zur angegebenen Uhrzeit aus.

SetEventMonthlyDate(Months_Values month, int day, TimeSpan timeOfDay)

Löst in den angegebenen Monaten am angegebenen Tag zur angegebenen Uhrzeit aus.

SetEventMonthlyLastDay(Months_Values month, TimeSpan timeOfDay)

Löst in den angegebenen Monaten am letzten Tag zur angegebenen Uhrzeit aus.

SetDurationType(TcIoTAlySPConditionDuration conditionDuration)

Legt die Art der Gültigkeitsdauer fest.

SetDurationInterval(TimeSpan duration)

Legt die Dauer bei Gültigkeitsdauer vom Typ Zeitintervall fest.

Weekday_Values und Months_Values sind Flags-Enumerationen, sodass mehrere Wochentage bzw. Monate kombiniert werden können.