---
title: "Variablen und Konstanten"
description: "Variablen der TapHome-Skripte: Geräteabkürzungen, Gruppenwerte, Modulvariablen zwischen Durchläufen, VAR und typisierte Deklarationen, := und +=, Eigenschaften, TriggerName, LastState, RECEIVEDMSG."
url: "https://taphome.com/de/docs/script/variables/"
language: de
lastmod: 2026-11-06
generator: hugo
ai:
  topics: ["scripting-language","variables","constants","properties"]
  questions: ["Wie lese ich in einem TapHome-Skript einen Gerätewert?","Wie deklariere ich eine Variable in einem TapHome-Skript?","Wie behalte ich einen Wert zwischen zwei Durchläufen eines Skripts?","Was enthält die Variable einer Gerätegruppe in einem Skript?","Welche Konstanten hat ein Benachrichtigungsskript?"]
---

# Variablen und Konstanten

Variablen in TapHome-Skripten: Gerätewerte über die Abkürzung, Gruppenwerte, Modul- und Gerätevariablen, VAR und typisierte Deklarationen, Zuweisung, Eigenschaften und Kontextkonstanten.

Zuletzt aktualisiert: 2026-11-06

Ein TapHome-Skript liest Gerätewerte über ihre Abkürzung, zum Beispiel `Se`, und speichert eigene Daten in lokalen Variablen, die mit `VAR` oder einem Typ deklariert und mit `:=` zugewiesen werden. Es arbeitet außerdem mit Gruppenwerten, mit Modul- und Gerätevariablen, die ihren Wert zwischen den Durchläufen behalten, und mit schreibgeschützten Kontextkonstanten wie `TriggerName`. Die Gerätewerte müssen zuerst im Skripteditor ausgewählt werden. Diese Seite zeigt, wie man sie liest, deklariert, zuweist und verwendet.

## Gerätevariablen

Gerätewerte, die im Skripteditor ausgewählt wurden, stehen unter ihrer Abkürzung zur Verfügung, zum Beispiel `Se`, `Mu` oder `Te`. Ein Gerät, das nicht mehr existiert, wird als `Null` gelesen.

```taphome
Se + 2;
```

Die meisten Skripte lesen Gerätewerte nur. An zwei Stellen kann ein Skript einen Gerätewert ändern:

- In der [smart rule Skript](https://taphome.com/de/docs/script/smart-rules/#script) kann einer Lese-/Schreibvariablen ein Wert zugewiesen werden. Jede Zuweisung wird zu einer Geräteaktion.
- In einem Listener-Skript des Packet Parsers setzt die Zuweisung an die Abkürzung eines Gerätewerts diesen Wert.

```taphome
IF Se > 25
    Mu := 1;
END
```

An jeder anderen Stelle bricht eine Zuweisung das Skript mit `Can not directly set value to device variable` ab.

Ein Gerätewert kann auch als Statistik des Geräts ausgewählt werden oder als Wertinfo mit dem Zeitpunkt seiner letzten Änderung, seinem vorherigen Wert und den Werten abgeschlossener Zeiträume — siehe [Statistiken und Wertinfo](https://taphome.com/de/docs/script/value-info/).

## Gruppenwerte

Eine an eine Gerätegruppe gebundene Variable enthält einen `groupvalue`:

| Eigenschaft | Inhalt |
|---|---|
| `Calculated` | Der für die Gruppe mit der an der Gruppe eingestellten Berechnungsfunktion berechnete Wert — `Min`, `Max`, `Avg`, `Sum`, `Or` oder `And`. Mitglieder mit dem Wert `NaN` werden ausgelassen. `Or` und `And` behandeln einen Wert über 0,5 als eingeschaltet und liefern `1` oder `0`. Hat kein Mitglied einen gültigen Wert, ist das Ergebnis `0`. |
| `Values` | Die Werte der Mitglieder in der Reihenfolge der Mitglieder in der Gruppe. Ein noch nicht gestartetes Mitglied ist `Null`, ein unbekannter Wert `NaN`. |

In der Arithmetik und in Vergleichen verhält sich ein Gruppenwert wie sein Wert `Calculated`:

```taphome
# Se = Gerätegruppe der Raumtemperaturen (Berechnungsfunktion Avg)
IF Se > 22
    RETURN(1);
END
0;
```

Nachdem der Gruppenwert von einer smart rule oder durch manuelle Steuerung geändert wurde, kann die Variable eine Zeit lang eine einfache Zahl statt eines `groupvalue` enthalten. Prüfen Sie `.Type`, bevor Sie `Values` lesen; `MIN` und `MAX` überspringen die Mitglieder, die `Null` oder `NaN` sind:

```taphome
# Se = Gerätegruppe der Raumtemperaturen
IF Se.Type = "GroupValue"
    RETURN(MAX(Se.Values) - MIN(Se.Values));
END
NaN;
```

## Modul- und Gerätevariablen

Variablen, die an einem Modul oder Gerät von Modbus oder Packet Parser definiert sind, stehen über ihren Namen zur Verfügung und behalten ihren Wert zwischen Skriptdurchläufen. Sie geben Daten aus einem Leseskript an Service-Attribute weiter oder aus einem Listener-Skript an die Leseskripte der Geräte.

```taphome
# Leseskript des Moduls Packet Parser: eine Anfrage, die Antwort bleibt für die Leseskripte der Geräte erhalten
VAR response := SENDHTTPREQUEST("/status", "GET");
StatusJson := response.Content;
```

**Verfügbar** — Modulvariablen eines Sammlungstyps: TapHome Next 2026.1.39507+.

## Lokale Variablen

Eine lokale Variable lebt für einen Durchlauf des Skripts. Sie wird mit `VAR` deklariert, das den Typ des Anfangswerts übernimmt, oder mit einem expliziten Typ. In beiden Fällen ist der Typ für das ganze Skript festgelegt, und jede spätere Zuweisung wird in ihn umgewandelt.

```taphome
# Deklarationen: VAR übernimmt den Typ seines Werts
VAR    a := 5;
int    b := 5;
string s := 5;
# Zuweisung wird in den Typ von b umgewandelt
b := 2.6;
# Result: b = 3, converted to int, halves are rounded away from zero
# VAR behält den Typ des ersten Werts
VAR    t := "a";
t := 5;
# Result: t = "5", VAR keeps the type of its first value
# Wert außerhalb des Bereichs des Typs
uint16 r := 70000;
# Result: r = 4464, a value out of range wraps around silently
```

Eine typisierte Deklaration darf den Anfangswert weglassen; die Variable erhält dann den Standardwert ihres Typs (`0`, `FALSE`, leerer Text, eine leere Sammlung). `VAR` braucht immer einen Wert, `VAR y;` schlägt mit `Variable must have initial value provided` fehl.

```taphome
datetime timestamp;
collection<uint16> block;
double ratio := 0.5;
```

Regeln:

- Ein Name beginnt mit einem Buchstaben und enthält nur Buchstaben und Ziffern; `_` schlägt mit `Only letters or numbers are allowed in variable name` fehl.
- Ein Name darf keine Konstante, Variable oder Geräteabkürzung wiederholen.
- Eine Variable muss oberhalb ihrer ersten Verwendung deklariert sein. Es gibt keinen Gültigkeitsbereich pro Block: Eine innerhalb von `IF` deklarierte Variable ist auch nach `END` sichtbar.

Die Typ-Schlüsselwörter sind auf [Datentypen](https://taphome.com/de/docs/script/data-types/) aufgeführt.

## Zuweisung

`:=` weist zu und `=` vergleicht. Die zusammengesetzten Operatoren `+=`, `-=`, `*=`, `/=`, `<<=`, `>>=`, `&=`, `|=` und `^=` verbinden eine Operation mit der Zuweisung.

```taphome
# Startwert
VAR x := 5;
# zusammengesetzte Operatoren ändern x direkt
x += 1;
x *= 2;
x <<= 1;
# der letzte Ausdruck ist das Ergebnis
x;
# Result: 24
```

> [!WARNING]
> Ein zusammengesetzter Operator hat die Rangfolge seiner Operation, daher wird `x -= a - b` als `(x -= a) - b` ausgewertet. Setzen Sie die rechte Seite in Klammern: `x -= (a - b);`. Siehe [Rangfolge](https://taphome.com/de/docs/script/operators/#precedence).

## Eigenschaften

Eine Eigenschaft wird mit `.` gelesen. Eine Ebene lässt sich schreiben, verschachtelte Eigenschaften lassen sich nur lesen (`Unable to assign a value to a nested property`), und nur lesbare Eigenschaften lassen sich nicht schreiben.

```taphome
VAR t := NOW();
t.Minute := 0;
t.Hour;
Se.Current.LastKnownValue;
```

Eigenschaften lassen sich nur aus einer benannten Variablen, Konstante oder Gerätevariablen lesen. `NOW().Hour` ist ein Parse-Fehler; speichern Sie den Wert zuerst.

## Kontextkonstanten

Kontextkonstanten sind nur lesbare Werte, die eine smart rule oder ein Listener-Skript an sein Skript übergibt:

| Konstante | Verfügbar in | Inhalt |
|---|---|---|
| `TriggerName` | smart rules Gleichung, Formel und Skript | Die Abkürzung der Variablen, deren Änderung die smart rule gestartet hat, oder der Name des ausgelösten Triggers. In der smart rule Gleichung erfordert es TapHome Next 2026.1.36599+. |
| `LastState` | smart rules Gleichung und Formel | Das vorherige Ergebnis; siehe [Skripte in smart rules](https://taphome.com/de/docs/script/smart-rules/#overview). |
| `RECEIVEDMSG` | Listener-Skript des Packet Parsers | Die eingehende Nachricht (`receivedmessage`). |
| `RECEIVEDBYTES` | Listener-Skript des Packet Parsers | Ältere Form der Nutzdaten als Bytesammlung; bevorzugen Sie `RECEIVEDMSG`. |

Die Skripte für Titel und Nachricht einer Benachrichtigung haben diese nur lesbaren Konstanten:

| Konstante | In einer Benachrichtigung, gesendet von |
|---|---|
| `SmartRuleName`, `LocationName` | Jeder smart rule |
| `TriggerName` | Den Aktionen für „wahr“ oder „falsch“ einer smart rule Gleichung |
| `CardName`, `DeviceName` | Einem Zutrittsereignis; `CardName` ist `Null` bei einer unbekannten Karte |
| `DeviceName` | Einer Trigger-Aktion |
| `SensorNames` | Einem Alarm |
| `SensorNames`, `AlarmPhaseName` | Einer Alarmphase |
| `SensorNames`, `NumberOfSensors` | Einer Sensorenaktion, zum Beispiel offene Fenster |
