# Wertzuordnung in BuildingPro Suites
Value Mapping ermöglicht es, Rohdaten (z. B. numerische oder boolesche Werte) in aussagekräftige Farben, Texte oder Kategorien zu übersetzen. Diese Funktion wird verwendet, um Informationen klarer darzustellen – zum Beispiel in Widgets, auf Stockwerken oder bei Attributen.
## Value Mapping für Attribute
Value Mapping für Attribute übersetzt numerische Werte automatisch in beschreibende Texte. Diese Texte können an vielen Stellen in BuildingPro Suites angezeigt werden – z. B. in der Smart View, in Widgets oder in der Detailansicht eines Assets – und helfen dabei, technische Messwerte verständlich darzustellen.
### Zweck
Value Mapping in *Eliona* übersetzt numerische Werte eines Attributs automatisch in beschreibende Texte. Diese Darstellung macht technische Messwerte verständlicher und erleichtert ihre Interpretation im Alltag. Die Texte erscheinen beispielsweise:
* in der *Smart View*,
* in Widgets,
* in der Detailansicht eines Assets.
Die Konfiguration erfolgt entweder direkt im Attribut oder zentral über [-> Asset Modeling](https://docs.buildings.ability.abb/collection/german/academy/broken-reference).
### Konfiguration
In **\[A]**können mehrere Mapping-Felder hinzugefügt werden.
Ein Mapping besteht aus Paaren von **Grenzwert → Ergebnistext**:
* **\[B]** Linkes Feld: Der Grenzwert, der als obere Grenze für einen Wertebereich dient
* **\[C]** Rechtes Feld: Der Text, der angezeigt werden soll, wenn der Messwert unter dem entsprechenden Grenzwert liegt
Die Regel lautet:
> Alle Werte, die **kleiner als** der definierte Grenzwert sind, werden dem jeweiligen Text zugeordnet.
**Hinweis zur Reihenfolge** Die Einträge müssen nicht manuell sortiert werden –*Eliona* interpretiert die Mapping-Liste intern korrekt, von den **höchsten bis zu den niedrigsten Grenzwerten**. Die Reihenfolge der Eingabezeilen ist daher **nicht entscheidend** für die Logik, aber für die Übersichtlichkeit bei der Konfiguration schon.
### Beispielauswertung
Gegeben sei die folgende Konfiguration:
| Grenzwert | Ergebnis |
| --------- | ------------- |
| 100 | Kritisch |
| 50 | Warnung |
| 10 | Normalbetrieb |
**Auswertung:**
* Ein Wert von **7** → Normalbetrieb
* Ein Wert von **30** → *Warnung*
* Ein Wert von **75** → Kritisch
* Ein Wert von **99.9** → Kritisch
* Ein Wert von **101 oder mehr** → *Kein Mapping*, der ursprüngliche Wert wird angezeigt (wenn kein höherer Grenzwert definiert ist)
#### Hinweise
* Die Einträge sollten ohne Lücken definiert werden, wenn jeder Wert einem Text zugeordnet werden soll.
* Wenn kein Mapping zutrifft, wird der ursprüngliche Wert angezeigt.
***
## Value Mapping in Widgets
In Widgets kann ein **Value Mapping** verwendet werden, um numerische Daten sowohl **visuell (Farbe)** und **semantisch (Text)**zu interpretieren. Diese Zuordnung verbessert die Lesbarkeit von Werten und unterstützt eine schnellere Einschätzung des Status.
### Zweck
Das Mapping ermöglicht eine klare Einordnung numerischer Werte in Kategorien – etwa „Normalbetrieb“, „Warnung“ oder „Kritisch“. Zusätzlich kann jedem Status eine eigene Farbe zugewiesen werden, die in der Anzeige unmittelbar erkennbar ist (z. B. Fortschrittsbalken oder Zahlenfeld).
### Anwendungsfall
#### Türstatus mit Value Mapping visualisieren
Dieses Mapping weist den Text *Verriegelt* mit brauner Darstellung allen Werten ≤ 0 zu, während Werte bis 1000 mit *Entriegelt* und einer grünen Farbe angezeigt werden. In der Praxis bedeutet das:
* Sensorwerte wie `0` → *Verriegelt*
* Sensorwerte `1` bis `100` → *Entriegelt*
{% hint style="info" %}
Das Mapping kann durch Klicken auf **„Add mapping.“** beliebig erweitert werden. Achten Sie darauf, dass die Wertebereiche ohne Lücken abgedeckt sind, wenn jeder mögliche Wert zugeordnet werden soll.
{% endhint %}
### Anzeige im Widget
In einem Widget, z. B. in der Übersicht eines Gebäudes, ist für jede Tür (Vorder- oder Hintereingang) sofort Folgendes sichtbar:
* **Text**: *Verriegelt* oder *Entriegelt*
* **Farbe**: Visuelle Hervorhebung passend zum Status
***
## Value Mapping auf dem Floor (POIs und Polygone)
Im *Floor* Modul können Bereiche eines digitalen Plans – wie **Polygone** oder **POIs**– abhängig vom aktuellen Attributwert automatisch eingefärbt werden. Dies geschieht über **Value Mapping**wobei numerische Werte bestimmten **Farben**zugewiesen werden. Die Farbvisualisierung hilft dabei, Status direkt im räumlichen Kontext schnell zu erkennen.
### Zweck
Diese Funktion ermöglicht die Darstellung von Status oder Messwerten direkt im Kontext eines Grundrisses oder Gebäudebereichs. Die Farbcodierung hilft dabei, kritische Situationen schneller zu erkennen oder normale Betriebszustände visuell zu bestätigen.
Beispiele:
* Temperaturbereiche in Produktionsanlagen farblich kennzeichnen
* Stromverbrauch einzelner Geräte hervorheben
* Tür- oder Fensterstatus klar darstellen
### Konfiguration
Die Konfiguration erfolgt direkt im POI- oder Polygon-Editor auf dem Floor. Im Bereich *Value Mapping* können Sie Wertgrenzen definieren, denen eine Farbe zugewiesen wird:
* **Grenzwert:** Definiert die obere Grenze eines Wertebereichs
* **Farbe:** Die Farbe, die angewendet wird, wenn der Messwert kleiner oder gleich dem Grenzwert ist
### Beispielkonfiguration
Diese Konfiguration bedeutet:
* Werte kleiner oder gleich 90 → **Grün**
* Werte kleiner oder gleich 93 → **Gelb**
* Werte kleiner oder gleich 10000 → **Rot**
#### Hinweise
* Die Farbzuordnungen gelten ausschließlich für numerische Daten.
* Die Farbdarstellung ersetzt keine numerischen Werte, sondern ergänzt sie visuell.
* Wenn kein passender Grenzwert gefunden wird, wird die ausgewählte **Standardfarbe** angezeigt
.png?alt=media&token=83c1ba6f-5449-4f88-84b0-7f18905e24c4)
