> 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/plattform/live-cockpit/widgets/predefined-widgets/ranking.md).

# Rangliste

Verwenden Sie das vordefinierte **Ranking-** Widget, um die neuesten numerischen Werte von Assets desselben Asset-Typs zu vergleichen. Es zeigt bis zu zehn passende Assets an, beginnend mit dem höchsten Wert.

Vergleichen Sie beispielsweise den aktuellen Strombedarf von Wärmepumpen, um die größten Verbraucher zu ermitteln, oder vergleichen Sie Temperaturmesswerte von Geräten desselben Typs.

## Voraussetzungen

* Sie können das Zieldashboard bearbeiten.
* Sie können auf Assets des benötigten Typs zugreifen, bei denen das Attribut, das Sie vergleichen möchten, einen numerischen Wert hat.
* Wenn Sie nach Tags filtern möchten, müssen die relevanten Tags den entsprechenden Assets bereits zugewiesen sein.

## Ranking konfigurieren

1. Öffnen Sie das [Dashboard](https://docs.buildings.ability.abb/collection/german/plattform/live-cockpit/add-widgets-to-the-dashboard.md) im **Live Cockpit** **\[A]**.
2. Wählen Sie **+ Widget**.
3. Wählen Sie **Ranking** unter **Builtin**.\
   ▷ Das Dialogfeld **Widget hinzufügen: Ranking** wird geöffnet.

<figure><img src="https://2215908449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOqGnkz52o2zVUsEGEZGk%2Fuploads%2Fgit-blob-b68b90f5afa760717254dc387220e9b9e676aa7b%2Franking-widget-configuration.png?alt=media" alt="Builtin Ranking configuration for the VIRTUAL Heat Pump asset type and Power attribute, with asset selection, tag filters, and Add Widget marked"><figcaption><p>Wählen Sie den Asset-Typ, das Attribut und optional einen Tag-Filter aus.</p></figcaption></figure>

| Referenz | Steuerung             | Zweck                                                                                                                                                                                                                              |
| -------- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **\[B]** | **Assettyp**          | Beschränkt das Ranking auf Assets eines Typs.                                                                                                                                                                                      |
| **\[C]** | **Attribut**          | Das numerische Attribut, dessen zuletzt gespeicherter Wert die Position des jeweiligen Assets bestimmt.                                                                                                                            |
| **\[D]** | Tag-Abgleichmodus     | **Alle ausgewählten erforderlichen Tags** schließt Assets ein, denen alle ausgewählten Tags zugewiesen sind. **Mindestens eines der ausgewählten Tags** schließt Assets ein, denen mindestens ein ausgewähltes Tag zugewiesen ist. |
| **\[E]** | **Tags**              | Optionale Asset-Tags, mit denen Sie das Ranking eingrenzen können, zum Beispiel auf Geräte an einem Standort. Lassen Sie dieses Feld leer, um passende Assets ohne Tag-Einschränkung einzuschließen.                               |
| **\[F]** | **Widget hinzufügen** | Speichert die Konfiguration und fügt das Ranking zum Dashboard hinzu.                                                                                                                                                              |

4. Wählen Sie einen **Asset-Typ** **\[B]**.
5. Wählen Sie ein **Attribut** **\[C]**, zum Beispiel **Leistung**.
6. Wählen Sie unter **Tags** **\[E]**&#x64;ie erforderlichen Tags aus, wenn Sie die Auswahl eingrenzen möchten.
7. Wählen Sie den Tag-Abgleichmodus **\[D]**, wenn Sie einen Tag-Filter verwenden.
8. Wählen Sie eine **Breite** aus, bei der Asset-Namen und Werte gut lesbar sind.
9. Wählen Sie **Widget hinzufügen** **\[F]**.\
   ▷ Das Dashboard zeigt die Assets in Rangfolge an.

Ändern von **Asset-Typ** löscht **Attribut**. Wählen Sie das Attribut erneut aus, bevor Sie speichern.

Optionale **Primäres Asset (für Titel und Alarme)** liefert die Kopfzeile und den Alarmkontext des Widgets. Die Rangfolge der Assets wird separat bestimmt anhand von **Asset-Typ**, **Attribut**, und **Tags**. Informationen zu Untertiteln, Beschreibungen und späteren Konfigurationsänderungen finden Sie unter [Widgets bedienen](https://docs.buildings.ability.abb/collection/german/plattform/live-cockpit/widgets/operating-widgets.md).

## Ergebnisse lesen

<figure><img src="https://2215908449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOqGnkz52o2zVUsEGEZGk%2Fuploads%2Fgit-blob-c35a087c2ea5d37d718cfc491f09a65b10bddcdc%2Franking-widget-result.png?alt=media" alt="Dashboard Ranking widget showing seven heat-pump assets with Power values in kilowatts, ordered from highest to lowest"><figcaption><p>Eine ausgefüllte Rangliste mit den neuesten Leistungswerten.</p></figcaption></figure>

Die Tabelle **\[G]** enthält zwei Spalten:

* **Assets:** Die Namen der passenden Assets. Die Spaltenüberschrift enthält den ausgewählten Asset-Typ.
* **Werte:** Der zuletzt gespeicherte Wert des ausgewählten Attributs einschließlich der konfigurierten Einheit. Die Spaltenüberschrift enthält den Attributnamen.

In diesem Beispiel **VIRTUAL-Heat-Pump-Assets** bezeichnet die Asset-Gruppe, und **Leistungswerte** zeigt den jeweils neuesten Leistungswert der Assets in kW. Die erste Zeile enthält den höchsten Wert unter den passenden Assets.

Ein höherer Leistungswert bedeutet bei diesem Messwert eine höhere Nachfrage; er weist für sich genommen nicht auf einen Fehler oder eine geringe Effizienz hin. Vergleichen Sie ähnliche Geräte und berücksichtigen Sie deren Betriebslast.

Nur Assets, auf die Sie zugreifen können, werden in die Rangliste aufgenommen. Wenn mehr als zehn Assets passen, zeigt das Widget die zehn höchsten Werte an. Fehlt ein erwartetes Asset, prüfen Sie dessen Asset-Typ, Attributwert und Tags sowie Ihre Zugriffsberechtigung.

Für Vergleiche über einen ausgewählten Tag, eine Woche, einen Monat oder ein Jahr verwenden Sie [Scoreboard: Nutzungsvergleich](https://docs.buildings.ability.abb/collection/german/plattform/insight-analytics/analytics-types/scoreboard-usage-comparison.md).


---

# 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/plattform/live-cockpit/widgets/predefined-widgets/ranking.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.
