Datenpunkteigenschaft inkrementieren oder dekrementieren

Die Aktion Datenpunkteigenschaft inkrementieren oder dekrementieren ermöglicht es Ihnen, eine beliebige Eigenschaft des Datenpunkts, der dem Verhalten zugewiesen ist, zu inkrementieren oder dekrementieren.

Diese Aktion ist nur für den Auslöser „Beim Anklicken“ verfügbar und kann verwendet werden, um einfache Schaltflächen zu implementieren, die einen Wert auf dem zugewiesenen Datenpunkt erhöhen oder verringern, wenn der Benutzer darauf klickt.

Zuerst wählen Sie im Dropdown-Menü Auslöser den Eintrag Beim Anklicken aus. Als Nächstes wählen Sie das Element aus, das auf das Klick-Ereignis reagieren soll, in der Auswahlliste Auslöser-Element aus. Anschließend wählen Sie die Eigenschaft aus, die auf dem Datenpunkt in der Auswahlliste Eigenschaft inkrementiert oder dekrementiert werden soll (zum Beispiel <LiveValue>, das ein Alias für Present_Value von BACnet-Datenpunkten ist).

In das Feld Versatzwert geben Sie den Wert ein, um den der aktuelle Wert der Eigenschaft erhöht oder verringert werden soll, wenn auf das Element geklickt wird. Verwenden Sie einen positiven Wert, um die Eigenschaft zu inkrementieren, und einen negativen Wert, um sie zu dekrementieren. Wenn Sie den Wert begrenzen möchten, können Sie die obere bzw. untere Grenze im Feld Grenzwert eingeben. Beachten Sie, dass eine De- oder Inkrementierung nur dann ausgeführt wird, wenn der resultierende Wert innerhalb der angegebenen Grenzen liegt. Andernfalls wird dem Benutzer ein Fehler angezeigt. Mit der Aktion Objekt bedingt anzeigen können Sie dies verhindern, indem Sie das Auslöseelement ausblenden, wenn sich der Wert außerhalb der Grenzen befindet.

Um im gleichen Shape jeweils eine separate Aktion zum Inkrementieren sowie Dekrementieren des Werts des gleichen Datenpunkts einzurichten, erstellen Sie einfach zwei Aktionen in derselben Verhaltensregel, wie im folgenden Beispiel gezeigt.

Beispiel

Dekrementier-Schaltfläche

Aktion

Aktionstyp

Datenpunkteigenschaft inkrementieren oder dekrementieren

Element

Beliebiges Element, vorzugsweise rect oder circle

Eigenschaft

<LiveValue>

Versatzwert

-1 (um den Wert um eins zu verringern)

Grenzwert

0 (um ein Unterschreiten unter 0 zu verhindern)

Inkrementier-Schaltfläche

Aktion

Aktionstyp

Datenpunkteigenschaft inkrementieren oder dekrementieren

Element

Beliebiges Element, vorzugsweise rect oder circle

Eigenschaft

<LiveValue>

Versatzwert

1 (um den Wert um eins zu erhöhen)

Grenzwert

100 (um ein Überschreiten über 100 zu verhindern)

../../../../_images/increment-decrement.de.webp

Grenzwerte und Live-Wert-Profile

Wenn Sie diesem Verhalten auf dem Anlagebild einen Datenpunkt zuweisen, dem ein Live-Wert-Profil zugeordnet ist, gelten einige besondere Regeln:

  • Die Inkrementierung oder Dekrementierung wird nur ausgelöst, wenn der resultierende Wert innerhalb der folgenden Grenzen liegt:

    • Bei einer Dekrementier-Aktion (d.h. wenn Versatzwert kleiner als 0 ist) wird die untere Grenze berechnet als der größere Wert von Grenzwert aus der Shape-Konfiguration und Minimalwert aus dem Live-Wert-Profil (falls gesetzt).

    • Bei einer Inkrementier-Aktion (d.h. wenn Versatzwert größer als 0 ist) wird die obere Grenze berechnet als der kleinere Wert von Grenzwert aus der Shape-Konfiguration bzw. Maximalwert aus dem Live-Wert-Profil (falls gesetzt).

  • Wenn der resultierende Bereich ungültig ist (z. B. wenn der Minimalwert größer als der Maximalwert ist), oder wenn der inkrementierte oder dekrementierte Wert außerhalb des gültigen Bereichs liegt, schlägt die Inkrementierung bzw. Dekrementierung fehl, und es wird ein Fehler angezeigt. In diesem Fall sollten Sie die Konfiguration überprüfen, um sicherzustellen, dass der Grenzwert aus der Shape-Konfiguration mit den im Live-Wert-Profil des Datenpunkts definierten Grenzen übereinstimmt. Wir empfehlen, für jedes verwendete Live-Wert-Profil ein separates Shape zu erstellen, um solche Probleme zu vermeiden.

Die Schrittweite aus dem Live-Wert-Profil wird bei Verwendung dieser Aktion nicht berücksichtigt. Stattdessen wird der oben definierte Versatzwert verwendet, um den Ausgabewert zu bestimmen.