Evaluationsausdrücke und Eigenschaften

Ausdrücke im Evaluationseditor

Jede Eigenschaftsevaluation stammt aus dem Ergebnis eines Ausdrucks, der dazu genutzt wird, zu bestimmen, wie ein Bild entsprechend der Eigenschaftswerte, Ausdrücke und Bedingungen angezeigt wird. Das Ergebnis einer Evaluation eines Eigenschaftswerts kann beispielsweise abhängig vom Wert der Eigenschaft bestimmen, welches Bild oder welche Symbolinstanz angezeigt wird, oder welche Farbe auf ein Element angewendet wird.

Ausdrücke bestehen zum Beispiel aus einer Datenpunktreferenz, einem Objektnamen oder -wert gefolgt von einem optionalen Operator mit einem weiteren Datenpunkt oder Wert. Der Ausdruck kann eine direkte Referenz auf einen Datenpunktnamen oder literal sein (Boolescher Wert, Zahl oder Zeichenkette). So können Sie einfache Vergleiche oder Berechnungen durchführen, aber auch konstante literale Elemente verwenden.

• Weitere Informationen zu Ersetzungen und Syntax finden Sie unter Objektreferenzen, Ersetzungen und Evaluationen für ein Symbol

HINWEIS:
Wenn Sie einen Wert mit mehr als 15 Stellen im Feld Elementeigenschaft oder Ausdruck eingeben, wird der Wert in wissenschaftlicher Notation angezeigt. Stellen nach den ersten 15 werden nicht angezeigt. Zum Beispiel: 9223372036854775807 wird als 9.22337203685478E+18 im Feld Eigenschaft oder Ausdruck angezeigt.

Ausdrucksart und Ergebnisse

Im Feld Ausdruck des Evaluationseditors können Sie Informationen eingeben, deren Ergebniswert auf die zugehörige Elementeigenschaft angewendet wird. Im Laufzeit-Modus wird das Ergebnis des Werts, der auf die Evaluation des Elements angewendet wird, im Feld Ergebnis angezeigt. Das Ergebnis des Felds Ausdruck wird auch beim Erstellen von Evaluationen mit Bedingungen verwendet.

Die in das Feld Ausdruck eingegebenen Informationen können ein Wert, eine Literalzeichenkette, eine oder mehrere Datenpunktreferenzen oder ein JavaScript-Ausdruck sein, dessen Wert oder Ergebnis auf die Evaluation der Elementeigenschaft angewendet wird.

Informationen oder Objekte, die im Feld Ausdruck akzeptiert werden:

• Literal (Zeichenkette, Analogwert oder true/false)
• eine oder mehrere Datenpunktreferenzen
• Kombination eines Literals und einer Datenpunktreferenz, getrennt durch ein Fragezeichen (?)
• Mehrzeiliger JavaScript-Ausdruck
• Weitere Informationen zu Ersetzungen und Syntax finden Sie unter Objektreferenzen, Ersetzungen und Evaluationen für ein Symbol

Datenpunktreferenzen im Feld Ausdruck

Alle Datenpunkte sind einer Funktion zugewiesen und einige Datenpunkte sind auch Objektmodellen zugewiesen. Wenn die Information im Feld Ausdruck eine Datenpunktreferenz ist, können Sie einen der folgenden Ergebnistypen im Feld Typ wählen, um das gewünschte Ergebnis zu erzielen. Abhängig von Ihrer Auswahl sind folgende Ergebnisse möglich:

• Referenz: Das Ergebnis des Ausdrucks ist die Wertänderung des referenzierten Datenpunkts.
• Funktion: Das Ergebnis des Ausdrucks ist der Funktionsname des referenzierten Datenpunkts.
• Objektmodell: Das Ergebnis des Ausdrucks ist der Name des Objektmodells des referenzierten Datenpunkts.
• Skript: Das Ergebnis des Ausdrucks ist das JavaScript-Ergebnis.

Evaluationen mit dem Wert Ergebnis erstellen

Sie können den Wert Ergebnis zusammen mit dem Feld Bedingung nutzen, um Evaluationen zu erstellen.

Wenn Ihnen beispielsweise ein Element in einem Symbol vorliegt, das standardmässig unsichtbar ist (die Eigenschaft Sichtbar ist deaktiviert), können Sie eine diskrete Evaluation erstellen, mit dem das Element unter bestimmten Umständen sichtbar wird.
In dieser Evaluation enthält das Feld Ausdruck den Datenpunkt und der Filter der Funktion Typ wird angewendet. Die diskrete Evaluation gibt an, dass, wenn die Bedingung des Datenpunkts die Funktion BoilerDigital oder BoilerAnalog ist, der Wert (Eigenschaft) sichtbar ist.

Funktion in Evaluationen

Wenn Sie im Feld Typ Funktion wählen, können Sie den tatsächlichen Funktionsnamen im Feld Bedingung nutzen, um Evaluationen zu erstellen. Alle Zeichenfolgen müssen in Anführungszeichen eingeschlossen werden, zum Beispiel:

Ventilator1ST - "Ventilator1ST"

Die Filter nach Funktion ermöglichen Ihnen, zum Beispiel in einer Grafikvorlage den Funktionsnamen eines Datenpunkts zu erhalten oder Grafikelemente anzuzeigen oder zu verbergen.

Textgruppenreferenzen in Ausdrücken

Zusätzlich zur Verwendung des Pinseleditors oder dem Referenzieren eines Hexadezimal-Farbcodes wie FFFF0000 (rot) zur Bestimmung der Farbe bei einer Eigenschaftsevaluation im Ausdrück können Sie auch eine Farbe aus einer bestehenden Textgruppentabelle referenzieren. Wenn die Farbreferenz durch einen Punkt getrennt ist, d.h. [TextGroupName].[Value], wird die mit diesem Wert verbundene Farbe angezeigt.

Massenbearbeitung von Evaluationen für mehrere Elementeigenschaften

Wenn Sie im Zeichenbereich mehrerer Elemente auswählen, können Sie gleichzeitig Eigenschaftsevaluationen für Elemente mit übereinstimmenden Eigenschaften erstellen oder aktualisieren. Wenn ein Element keine mit den anderen ausgewählten Elementen übereinstimmende Eigenschaft hat, wird es ignoriert, da es die ausgewertete Eigenschaft teilt.

Bedingungssyntax

Für Ausdrücke im Evaluationseditor gilt eine bestimmte Syntax. Sie bestehen aus Datenpunktreferenzen wie einem Objektnamen oder einer Objektadresse oder einem der drei literalen Werttypen: bool, doppelt oder Zeichenkette. Bedingungen werden auf lineare, diskrete und multiple Evaluationen angewendet.

Jede Evaluationsart erfordert bestimmte Eingaben und eine bestimmte Syntax für das Feld Bedingung.

Binäre Codierung für BitString-Datentypen

Kenntnisse über binäre Codierung sind hilfreich, wenn Sie mit Evaluationen und Bedingungen arbeiten, die BitStrings verwenden.

Analoge Datenpunkte verwenden einen Wertebereich, um eine Bedingung zu repräsentieren, die mehr als zwei Zustände hat, zum Beispiel den Datenpunkt Temperatur oder die Klappenposition. Ein Computer verwendet Binärzahlen, bestehend aus Einsen und Nullen, um diese Werte zu lesen und darzustellen. Eine „1“ stellt üblicherweise einen Ein-Zustand dar, eine „0“ einen Aus-Zustand. Um die Binärcodierung für den Nutzer zu vereinfachen und die Lesbarkeit zu verbessern, werden Binärzahlen in Hexadezimalzahlen abgebildet. Siehe folgende Tabelle: Binär-, Dezimal- und Hexadezimalzahlen.

Binäre und hexadezimale Werte

Binärzahlen basieren auf zwei, da sie aus einer Kombination der Ziffern 0 und 1 bestehen. Da in Binärschreibweise die Basis 2 verwendet wird, hat die zweite Stelle von rechts einen Wert von 2, da sie den Wert 2 hoch 1 darstellt. Die Hexadezimalschreibweise basiert auf der Zahl 16, wodurch sie 16 Stellen umfasst.

Info zu Hexadezimalzahlen

Die Hexadezimalschreibweise basiert auf 16 Zeichen und verwendet die Zahlen 0-9 sowie die Buchstaben A-F, die die Zahlen 10-15 darstellen. Hexadezimalzahlen geht oft die Silbe 0x voran, oder hinter ihnen steht ein h.

Eine Hexadezimalzahl besteht aus zwei Werten (Halbbytes). Ein Halbbyte ist die Hälfte eines Bytes (4 Bits), sodass zwei Halbbytes zusammen ein Byte (8 Bits) ergeben.

• Tiefster Wert eines Halbbytes, bei dem jedes Bit ausgeschaltet ist: 0000, was einem Wert von 0 entspricht.
• Höchster Wert eines Halbbytes, bei dem jedes Bit eingeschaltet ist: 1111, was einem Wert von 15⁽¹⁾ entspricht.

Hexadezimalzahl in Binärzahl konvertieren

Mit der Tabelle können Sie eine hexadezimale in eine Binärzahl konvertieren. Um beispielsweise die hexadezimale Zahl 2A in Binärwerte zu konvertieren, tun Sie Folgendes:

• Finden Sie den Hexadezimalwert 2 und notieren Sie die binäre Entsprechung. Der Binärwert für 2 ist 0010.
• Finden Sie den Hexadezimalwert A und notieren Sie die binäre Entsprechung. Der Binärwert für A ist 1010.

Daher lautet der Binärwert für die Hexadezimalzahl 2A: 0010 1010.

Hexadezimalzahl in Dezimalzahl konvertieren

Wir arbeiten mit dem Hexadezimalwert: 2A. Dieser Wert stellt laut der obigen Tabelle die Halbbyte-Werte dar für: 2 und 10. Da die Hexadezimalwerte auf 16 Stellen basieren, sind 2 und 10 mit den Werten ihrer Position zu multiplizieren und zusammenzuzählen, um den Dezimalwert zu erhalten. Der Wert wird berechnet.

Dies wird durch Addieren der Bit-Werte basierend auf den zwei Stellen von rechts nach links berechnet, beginnend mit 16⁰ und weiter bis 16¹: (2 *16¹) + (10*16⁰) = 42.

Analoge Datenpunkttypen

Dies wird durch Multiplikation jeden Bits mit seinem Wert, basierend auf seiner Stelle, berechnet und zu den anderen Werten addiert. Der Wert basierend auf 2 von rechts nach links beginnend mit 2⁰ und weiter mit 2¹, ²2 und schliesslich 2³:: (1 *23) + (1*22) + (1*21) + (1*20) = 15

Eigenschaftsname und Variablennamen

In dieser Tabelle werden die Datenpunkt-Eigenschaftsnamen aufgeführt, wie sie im Register Bedienung erscheinen und auch als Variablen in Ausdrücken angezeigt werden.

Beispiele:

• Um die obere Grenze eines analogen Punkts zu sehen:
• . . . Local_IO.SBT_BLDG_950_AH01_RAH::.High_Limit
• Um die untere Grenze eines analogen Punkts zu sehen:
• . . . Local_IO.SBT_BLDG_950_AH01_RAH::.Low_Limit
• Um die aktuelle BACnet-Befehlspriorität des Datenpunkts zu sehen:
• . . . Local_IO.SBT_BLDG_950_AH01_RAH::.Current_Priority
• Um die Engineering-Einheiten des Datenpunkts zu sehen:

. . . Local_IO.SBT_BLDG_950_AH01_RAH::.Units

Tabelle: Namen der Eigenschaftsvariable

Verwandte Themen

Zugehörige Verfahren finden Sie unter Evaluationen definieren.

Weitere Informationen zum Arbeitsbereich finden Sie unter Evaluationseditor-Ansicht.