> 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/verpflichtende-basis/assets/asset-data.md).

# Asset-Daten

## Datenansicht

Die *Datenansicht* in BuildingPro Suites bietet einen detaillierten Überblick über die Rohdaten, die in ein *Asset*geschrieben wurden. Dazu gehören unter anderem Messwerte, Ereignisse oder **aggregierte** Daten von Sensoren oder Geräten. Anders als in grafischen Darstellungen (z. B. Linien oder Diagrammen) *Datenansicht* werden die Werte in der Datenansicht tabellarisch dargestellt, sodass die Zahlen direkt sichtbar sind.

Die *Datenansicht* ist besonders nützlich für:

* **Überwachen** des Status eines *Assets* anhand konkreter Messwerte in **Echtzeit**.
* **Präzises Verfolgen und Überprüfen** einzelner **Datenpunkte**.
* Bereitstellen von Daten für Berichte und detaillierte Analysen.

Die chronologische Sortierung der Daten erleichtert es, zeitabhängige Muster zu erkennen und Unregelmäßigkeiten schneller zu identifizieren.

<figure><img src="https://2215908449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOqGnkz52o2zVUsEGEZGk%2Fuploads%2FRucggs1etInFhJp5O7co%2FGroup%20612.png?alt=media&amp;token=6404c8ef-39d9-4259-ab58-c24acf3ba5c9" alt=""><figcaption></figcaption></figure>

<table data-full-width="true"><thead><tr><th width="64.5999755859375"></th><th width="213"></th><th></th></tr></thead><tbody><tr><td><strong>[A]</strong></td><td>Daten</td><td>Nachdem Sie die <a href="https://docs.buildings.ability.abb/collection/german/verpflichtende-basis/assets/asset-details.md">-> Asset-Details</a>geöffnet haben, können Sie die Datenansicht über den Tab „Daten“ öffnen.</td></tr><tr><td><strong>[B]</strong></td><td>Filter</td><td>Hier können Sie auswählen, welche Daten von welchen <em>Asset-</em> Typen Sie anzeigen möchten.</td></tr><tr><td><strong>[C]</strong></td><td>Sortierung</td><td>Hier können Sie auswählen, ob die <em>Unter-Assets</em> geologisch oder funktional sortiert angezeigt werden sollen.</td></tr><tr><td><strong>[D]</strong></td><td>Gehe zu …</td><td>Hier können Sie zur Karte, zu <em>Tickets</em>und <em>Analysen</em> des <em>Assets</em>.</td></tr><tr><td><strong>[E]</strong></td><td>Suche</td><td>Hier können Sie nach <em>Assets</em>suchen, wie in der <em>Asset-Liste</em>.</td></tr><tr><td><strong>[F]</strong></td><td>Aktuelle Daten</td><td>Hier werden die zuletzt in das <em>Asset</em> geschriebenen Daten angezeigt.</td></tr><tr><td><strong>[G]</strong></td><td>Aggregierte Daten anzeigen</td><td>Um die aggregierten Daten anzuzeigen, können Sie auf die kleine Uhr klicken. Die aggregierten Daten werden dann rechts geöffnet <strong>[H]</strong>.</td></tr><tr><td><strong>[H]</strong></td><td>Aggregierte Daten</td><td>Hier sehen Sie die aggregierten Daten und ihre Zeiträume.<a href="https://docs.buildings.ability.abb/collection/german/akademie/aggregations-in-eliona.md"> -> <strong>Aggregierte Daten anzeigen</strong></a></td></tr><tr><td><strong>[I]</strong></td><td>zu den Datendetails</td><td>Um alle Daten nach Datum sortiert anzuzeigen, klicken Sie auf den Namen eines <em>Assets</em>. Die chronologisch sortierte <em>Datenansicht</em> des ausgewählten <em>Assets</em> wird dann geöffnet.</td></tr></tbody></table>

## Datendetails

<figure><img src="https://2215908449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOqGnkz52o2zVUsEGEZGk%2Fuploads%2F4ReO0VUtKo8g2ds5aEUQ%2FGroup%20613.png?alt=media&amp;token=46f74194-9e0e-4245-be8d-4013343b02d8" alt=""><figcaption></figcaption></figure>

<table data-full-width="true"><thead><tr><th width="66.20001220703125"></th><th width="158.39996337890625"></th><th></th></tr></thead><tbody><tr><td><strong>[J]</strong></td><td>Datenfilter</td><td>Ermöglicht das Filtern der angezeigten Daten nach verschiedenen Kategorien wie „Alle“, „Eingabe“, „Ausgabe“ und „Status“.</td></tr><tr><td><strong>[K]</strong></td><td>Datentabelle</td><td>Zeigt die Rohdaten des ausgewählten <em>Assets</em> in Tabellenform an.</td></tr><tr><td><strong>[L]</strong></td><td>Aggregierte Daten</td><td>Schaltfläche zum Anzeigen aggregierter Daten in <strong>[K]</strong>.</td></tr><tr><td><strong>[M]</strong></td><td>Exportieren</td><td>Schaltfläche zum Exportieren der angezeigten Daten als CSV-Datei.</td></tr><tr><td><strong>[O]</strong></td><td>Zeitfilter</td><td>Ermöglicht die detaillierte Suche nach Daten durch Auswahl eines Start- und Enddatums sowie der jeweiligen Uhrzeit. Die Filter können angewendet oder zurückgesetzt werden.</td></tr><tr><td><strong>[P]</strong></td><td>Neuen Eintrag hinzufügen</td><td>Fügen Sie zum aktuellen Zeitpunkt einen neuen Dateneintrag hinzu. <a href="#add-new-data-entry">-> Neuen Dateneintrag hinzufügen</a></td></tr><tr><td><strong>[Q]</strong></td><td>Daten gesammelt bearbeiten</td><td>Öffnen Sie das Fenster, um vergangene Daten in größerem Umfang auf einen Wert zu ändern. <a href="#bulk-editing-of-data">-> Daten gesammelt bearbeiten</a></td></tr><tr><td><strong>[R]</strong></td><td>Einzelne historische Daten bearbeiten</td><td>Klicken Sie auf das Stiftsymbol neben dem Wert, den Sie ändern möchten, um diesen Datenpunkt manuell anzupassen. <a href="#edit-individual-historical-data">-> Einzelne historische Daten bearbeiten</a></td></tr></tbody></table>

***

## Aggregierte Daten anzeigen

In BuildingPro Suites können Messwerte nicht nur als Rohdaten, sondern auch in **aggregierter Form**angezeigt werden. Durch Aggregationen lassen sich große Datenmengen **übersichtlich und in verschiedenen Zeitintervallen darstellen**.

### Aggregierte Daten aktivieren

1. Klicken Sie auf **\[L]** um die **aggregierten Daten**.\
   ▷ Die Ansicht wechselt von den Rohdaten zur Aggregationsansicht.
2. **Zeitraum festlegen**: Unter **\[L1]**&#x6B;önnen Sie den Zeitraum festlegen, für den die Daten aggregiert werden sollen.
3. **Aggregationsintervall auswählen**: Wählen Sie unter **\[L2]**&#x64;ie Zeitintervalle aus, in denen die Daten aggregiert werden sollen (z. B. stündlich, täglich oder wöchentlich).
4. **Attribut auswählen**: In **\[L3]**, können Sie bestimmen, welches Attribut aggregiert werden soll.
5. **Aggregationsmodus festlegen**: In **\[L4]**, stehen verschiedene **Aggregationsmodi** zur Verfügung:
   * Durchschnitt
   * Zähler-Summe
   * Kumulativer Zähler
   * Minimum
   * Maximum\
     ▷ Weitere Informationen dazu finden Sie [-> hier.](https://docs.buildings.ability.abb/collection/german/akademie/aggregations-in-eliona.md)
6. **Einstellungen übernehmen**: Klicken Sie auf **\[L5]** , um die Änderungen zu übernehmen.
7. **Einstellungen zurücksetzen**: Bei Bedarf können Sie die Filter mit **\[L6]**.
8. **Aggregierte Daten anzeigen**: Die berechneten Werte erscheinen **\[L7]** in einer Tabellenansicht.

Aggregierte Daten bieten einen **besseren Überblick über langfristige Entwicklungen** und helfen dabei, **Datenflüsse effizient zu analysieren**.

***

## Neuen Dateneintrag hinzufügen

<figure><img src="https://2215908449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOqGnkz52o2zVUsEGEZGk%2Fuploads%2Fk6qyZyhIAgtD3s1ZZocq%2FGroup%20614.png?alt=media&amp;token=824456a0-0a54-461b-8f10-4b0fe9d39415" alt=""><figcaption></figcaption></figure>

1. **Neuen Eintrag hinzufügen** Klicken Sie auf **Neuen Eintrag hinzufügen** \[P].\
   ▷ Das Fenster „Neuen Dateneintrag hinzufügen“ wird geöffnet.
2. **Attribut auswählen** Wählen Sie das gewünschte **Attribut** aus \[S] aus.
3. **Wert eingeben** Geben Sie den gewünschten Wert in das entsprechende Feld \[T] ein.
4. **Eintrag bestätigen** Klicken Sie erneut auf **Neuen Eintrag hinzufügen** , um den Eintrag zu bestätigen.\
   ▷ Der Eintrag für das Attribut wird mit dem aktuellen Zeitstempel in den Heap geschrieben.

## Einzelne historische Daten bearbeiten

<figure><img src="https://2215908449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOqGnkz52o2zVUsEGEZGk%2Fuploads%2FBwgqcxjuGopwFsvbTejt%2Fimage%2074.png?alt=media&amp;token=98dbe69d-a381-45a6-9ad8-9a14ec3582bf" alt=""><figcaption></figcaption></figure>

1. **Bleistiftsymbol anzeigen** Bewegen Sie den Mauszeiger über den gewünschten Dateneintrag.\
   ▷ Neben dem Eintrag wird ein Bleistiftsymbol angezeigt.
2. **Dateneintrag bearbeiten** Klicken Sie auf das **Bleistiftsymbol** \[R], um den Dateneintrag zu bearbeiten.\
   ▷ Das Fenster „Asset-Dateneintrag bearbeiten“ wird geöffnet.
3. **Neuen Wert eingeben** Geben Sie den **neuer Wert** für den Eintrag.
4. **Änderungen speichern** Klicken Sie auf **Speichern** um die Änderungen zu übernehmen.\
   ▷ Der neue Wert ersetzt den alten Wert im Datensatz.

{% hint style="danger" %}
Achten Sie darauf, welche Daten Sie überschreiben. Änderungen an bestehenden Datensätzen können unumkehrbar sein und wichtige Informationen dauerhaft ersetzen.
{% endhint %}

## Daten massenhaft bearbeiten

Wenn Sie große Datenmengen ändern möchten, zum Beispiel weil ein Gerät an einem bestimmten Tag falsche Daten geliefert hat, können Sie das ganz einfach tun. Mit der Funktion zur Massenbearbeitung lassen sich alle Daten innerhalb eines festgelegten Zeitraums auf einen gewünschten Wert setzen.

<figure><img src="https://2215908449-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOqGnkz52o2zVUsEGEZGk%2Fuploads%2FgeMtfT7GpIfJe7K2XDG0%2Fimage%2075.png?alt=media&amp;token=ba15e99f-cd37-4e93-bef8-21573015134e" alt=""><figcaption></figcaption></figure>

1. **Fenster für die Massenbearbeitung öffnen** Klicken Sie auf **\[Q]** um das Fenster **Daten massenhaft bearbeiten** zu öffnen.
2. **Zeitraum festlegen** Geben Sie das Datum **von** und **bis** sowie die Uhrzeiten ein, um den Zeitraum festzulegen, in dem die Daten geändert werden sollen.
3. **Attribut auswählen** Wählen Sie das Attribut aus, dessen Daten Sie ändern möchten.
4. **Wert festlegen** Geben Sie den neuen Wert ein, der die vorhandenen Daten ersetzen soll.
5. **Änderung speichern** Klicken Sie auf **Speichern** um die Änderungen zu übernehmen.\
   ▷ Alle Daten des ausgewählten Attributs im angegebenen Zeitraum werden auf den neuen Wert gesetzt.

### Timescale zum Speichern zeitbasierter Daten verwenden

Die Verwendung von **TimescaleDB** in *Eliona* ermöglicht die effiziente Speicherung und Verwaltung zeitbasierter Daten, insbesondere bei sich ändernden Werten. Indem nur tatsächlich geänderte Werte gespeichert werden, wird der Speicherplatz optimal genutzt, ohne die Integrität der Daten zu beeinträchtigen.

**Beispiel: Änderungen im Zeitverlauf**

Sehen wir uns Daten an, die in regelmäßigen Zeitabständen erfasst werden:

**Ursprüngliche Daten ohne Timescale**

Jeder Datensatz enthält alle Werte, auch wenn sie sich nicht geändert haben:

```yaml
ts: 2024-07-24T16:20: {cop: 36, jaz: 56, power: 18.83, energy: 461.51}
ts: 2024-07-24T16:21: {cop: 50, jaz: 56, power: 18.83, energy: 461.51}
ts: 2024-07-24T16:22: {cop: 100, jaz: 56, power: 18.83, energy: 461.51}
```

### Datenstruktur mit Timescale

Mit TimescaleDB speichern wir nur die Werte, die sich tatsächlich geändert haben. Dadurch werden redundante Daten reduziert und die Leistung verbessert:

```yaml
ts: 2024-07-24T16:20: {cop: 36, jaz: 56, power: 18.83, energy: 461.51}
ts: 2024-07-24T16:21: {cop: 50}
ts: 2024-07-24T16:22: {cop: 100}
```

{% hint style="info" %}
Gut zu wissen:\
Wenn Ihre Geräte beim Schreiben von Daten „null“-Werte an BuildingPro Suites senden, werden diese herausgefiltert und nicht in den Trend geschrieben.
{% endhint %}


---

# 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/verpflichtende-basis/assets/asset-data.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.
