> For the complete documentation index, see [llms.txt](https://docs.buildings.ability.abb/collection/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buildings.ability.abb/collection/german/akademie/value-mapping-in-eliona.md).

# Wertzuordnung in BuildingPro Suites

Die Wertzuordnung 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 – beispielsweise in Widgets, Etagen oder Attributen.

## Wertzuordnung für Attribute

Die Wertzuordnung 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

Wertzuordnung 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 die [-> Asset Modeling](/collection/german/verpflichtende-basis/assets/asset-modeling-create-templates.md).

### Konfiguration

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FjcChWuwrUYFedpgrzKu5%2FWerte%20mapping%20(1).png?alt=media&#x26;token=83c1ba6f-5449-4f88-84b0-7f18905e24c4" alt=""><figcaption></figcaption></figure>

In **\[A]**, können mehrere Zuordnungsfelder hinzugefügt werden.

Eine Zuordnung besteht aus Paaren von **Grenzwert → Ergebnistext**:

* **\[B]** Linkes Feld: Der Grenzwert, der als Obergrenze 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 Zuordnungsliste intern korrekt, von der **höchsten bis zur niedrigsten Grenzwert**. Die Reihenfolge der Eingabezeilen ist daher **nicht entscheidend** für die Logik, aber für die Übersichtlichkeit bei der Konfiguration.

### Beispielauswertung

Gegeben ist 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** → *Keine Zuordnung*, wird der ursprüngliche Wert angezeigt (wenn kein höherer Grenzwert definiert ist)

#### Hinweise

* Die Einträge sollten ohne Lücken definiert werden, wenn jedem Wert ein Text zugeordnet werden soll.
* Wenn keine Zuordnung greift, wird der ursprüngliche Wert angezeigt.

***

## Wertzuordnung in Widgets

In Widgets kann eine **Wertzuordnung** verwendet werden, um numerische Daten sowohl **visuell (Farbe)** als auch **semantisch (Text)**&#x7A;u interpretieren. Diese Zuordnung verbessert die Lesbarkeit von Werten und unterstützt eine schnellere Einschätzung des Status.

### Zweck

Die Zuordnung 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 sofort erkennbar ist (z. B. Fortschrittsbalken oder Zahlenfeld).

### Anwendungsfall

#### Türstatus mit Wertzuordnung visualisieren

<div align="left"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FG7UqmumVdwl0u2pU8T3P%2Fimage.png?alt=media&#x26;token=e66e421f-55c0-4266-8627-9a5d13c2ecc3" alt="" width="239"><figcaption></figcaption></figure></div>

Diese Zuordnung weist den Text *Locked* mit brauner Darstellung allen Werten ≤ 0 zu, während Werte bis 1000 mit *Unlocked* und grüner Farbe angezeigt werden. In der Praxis bedeutet das:

* Sensorwerte wie `0` → *Locked*
* Sensorwerte `1` bis `100` → *Unlocked*

{% hint style="info" %}
Die Zuordnung kann beliebig erweitert werden, indem Sie auf **"Zuordnung hinzufügen."** Achten Sie darauf, dass die Wertebereiche lückenlos abgedeckt sind, wenn jedem möglichen Wert eine Zuordnung zugewiesen werden soll.
{% endhint %}

### Anzeige im Widget

<div align="left"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FH9aPXUgJ8KBlrn0UwySv%2Fimage.png?alt=media&#x26;token=27651452-5551-407b-bcd7-48bc12c0b342" alt=""><figcaption></figcaption></figure></div>

In einem Widget, z. B. in der Übersicht eines Gebäudes, wird für jede Tür (Haupteingang oder Hintereingang) sofort sichtbar angezeigt:

* **Text**: *Locked* oder *Unlocked*
* **Farbe**: Visuelle Hervorhebung passend zum Status

***

## Wertzuordnung auf der Etage (POIs und Polygone)

Im *Etagen* modul können Bereiche eines digitalen Plans – wie **Polygone** oder **POIs**– abhängig vom aktuellen Attributwert automatisch eingefärbt werden. Dies geschieht über **Wertzuordnung**, wobei numerische Werte bestimmten **Farben**zugeordnet werden. Die Farbdarstellung hilft, 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 deutlich anzeigen

### Konfiguration

Die Konfiguration erfolgt direkt im POI- oder Polygon-Editor auf der Etage. Im *Wertzuordnung* Abschnitt können Sie Wertgrenzen definieren, denen eine Farbe zugewiesen wird:

* **Grenzwert:** Definiert die Obergrenze eines Wertebereichs
* **Farbe:** Die Farbe, die angewendet wird, wenn der Messwert kleiner oder gleich dem Grenzwert ist

### Beispielkonfiguration

<div align="left"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FOwAJAnjud8RAZe9JIaB9%2Fimage.png?alt=media&#x26;token=313a7147-3126-4db6-bf29-d7caae0edf79" alt="" width="359"><figcaption></figcaption></figure></div>

Diese Konfiguration bedeutet:

* Werte kleiner oder gleich 90 → **Grün**
* Werte kleiner oder gleich 93 → **Gelb**
* Werte kleiner oder gleich 10000 → **Rot**

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FSQX0yF9sDMIpuxvpmBBa%2Fimage.png?alt=media&#x26;token=fa6ffcea-dcb8-40c1-b3ab-15438fb07e5c" alt=""><figcaption></figcaption></figure>

#### Hinweise

* Die Farbzuordnungen gelten ausschließlich für numerische Daten.
* Die Farbdarstellung ersetzt numerische Werte nicht, sondern ergänzt sie visuell.
* Wenn kein passender Grenzwert gefunden wird, wird die ausgewählte **Standardfarbe** angezeigt![](https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FLV5OFhHqw0W73RmllInB%2Fimage.png?alt=media\&token=6581d6c1-33cc-4d12-bc46-9190416e7b17)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.buildings.ability.abb/collection/german/akademie/value-mapping-in-eliona.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
