> 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 umzuwandeln. Diese Funktion dient dazu, Informationen klarer darzustellen – zum Beispiel in Widgets, Grundrissen oder Attributen.

## Wertzuordnung für Attribute

Die Wertzuordnung für Attribute wandelt numerische Werte automatisch in beschreibende Texte um. 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

Die Wertzuordnung in *Eliona* wandelt numerische Attributwerte automatisch in beschreibende Texte um. Dadurch werden technische Messwerte verständlicher und lassen sich im Alltag leichter interpretieren. Die Texte erscheinen zum Beispiel:

* in der *Smart View*,
* in Widgets,
* in der Detailansicht eines Assets.

Die Konfiguration erfolgt entweder direkt im Attribut oder zentral über [-> Asset-Modellierung](https://docs.buildings.ability.abb/collection/german/verpflichtende-basis/platform-core/asset-core.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]**&#x6B;önnen mehrere Zuordnungsfelder hinzugefügt werden.

Eine Zuordnung besteht aus Paaren aus **Grenzwert → Ergebnistekst**:

* **\[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

Es gilt folgende Regel:

> Alle Werte, die **unter** dem festgelegten Grenzwert liegen, werden dem jeweiligen Text zugeordnet.

**Hinweis zur Reihenfolge** Die Einträge müssen nicht manuell sortiert werden –*Eliona* interpretiert die Zuordnungsliste intern korrekt, von **dem höchsten bis zum niedrigsten Grenzwert**. Die Reihenfolge der Eingabezeilen ist daher **für die Logik nicht entscheidend** , wohl aber für die Übersichtlichkeit bei der Konfiguration.

### Beispielauswertung

Gegeben ist 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 (sofern kein höherer Grenzwert definiert ist)

#### Hinweise

* Die Einträge sollten lückenlos definiert sein, wenn jedem Wert ein Text zugewiesen werden soll.
* Wenn keine Zuordnung zutrifft, 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 der Werte und ermöglicht eine schnellere Einschätzung des Status.

### Zweck

Die Zuordnung ermöglicht eine eindeutige Einteilung numerischer Werte in Kategorien wie „Normalbetrieb“, „Warnung“ oder „Kritisch“. Außerdem kann jedem Status eine eigene Farbe zugewiesen werden, die in der Anzeige (z. B. Fortschrittsbalken oder Zahlenfeld) sofort erkennbar ist.

### Anwendungsfall

#### Türstatus mithilfe einer 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 allen Werten ≤ 0 den Text *Verriegelt* mit einer braunen Anzeige zu, während Werte bis 1000 mit *Entriegelt* und in grüner Farbe angezeigt werden. In der Praxis bedeutet das:

* Sensorwerte wie `0` → *Verriegelt*
* Sensorwerte von `1` bis `100` → *Entriegelt*

{% hint style="info" %}
Die Zuordnung kann bei Bedarf durch Klicken 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 Gebäudeübersicht, ist für jede Tür (Vorder- oder Hintereingang) Folgendes sofort sichtbar:

* **Text**: *Verriegelt* oder *Entriegelt*
* **Farbe**: Visuelle Hervorhebung passend zum Status

***

## Wertzuordnung auf dem Grundriss (POIs und Polygone)

Im *Grundriss* Modul können Bereiche eines digitalen Plans – wie **Polygone** oder **POIs**– abhängig vom aktuellen Attributwert automatisch eingefärbt werden. Dies erfolgt über eine **Wertzuordnung**, bei der numerischen Werten bestimmte **Farben**. Die Farbdarstellung hilft dabei, Status direkt im räumlichen Kontext schnell zu erkennen.

### Zweck

Mit dieser Funktion lassen sich Status oder Messwerte direkt im Kontext eines Grundrisses oder Gebäudebereichs anzeigen. 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 Abschnitt *Wertzuordnung* können Sie Wertgrenzen festlegen, denen jeweils eine Farbe zugewiesen wird:

* **Grenzwert:** Legt die Obergrenze eines Wertebereichs fest
* **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 keine Zahlenwerte, 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
