# Asset Data

## Data View

The *Data View* in BuildingPro Suites offers a detailed overview of the raw data written to an *asset*. This includes, among other things, measured values, events, or **aggregated** data from sensors or devices. Unlike in graphical representations (e.g., lines or graphs), the *Data View* displays the values in a tabular form, so that the numbers are directly visible.

The *Data View* is particularly useful for:

* **Monitoring** the status of an *asset* with concrete measured values in **real time**.
* **Tracking and checking** individual **data points precisely**.
* Providing data for reports and detailed analyses.

The chronological sorting of the data makes it easier to recognize time-based patterns and to identify irregularities more quickly.

<div data-full-width="true"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FvVSUku49zttnRpBmRqN0%2FAsset%20Daten.png?alt=media&#x26;token=92a1526e-ae19-45fd-909f-22ed641549d4" alt=""><figcaption></figcaption></figure></div>

<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>Data</td><td>After opening the <a href="asset-details">-> Asset Details</a>, the data view can be opened via the "Data" tab.</td></tr><tr><td><strong>[B]</strong></td><td>Filter</td><td>Here you can select which data from which <em>asset</em> types you want to see.</td></tr><tr><td><strong>[C]</strong></td><td>Sorting</td><td>Here you can select whether the <em>sub-assets</em> should be displayed in geological or functional sorting.</td></tr><tr><td><strong>[D]</strong></td><td>Go to...</td><td>Here you can jump to the map, <em>tickets</em>, and <em>analytics</em> of the <em>asset</em>.</td></tr><tr><td><strong>[E]</strong></td><td>Search</td><td>Here you can search for <em>assets</em>, as in the <em>asset list</em>.</td></tr><tr><td><strong>[F]</strong></td><td>Current data</td><td>This is where the data most recently written to the <em>asset</em> is displayed.</td></tr><tr><td><strong>[G]</strong></td><td>Display aggregated data</td><td>To see the aggregated data, you can click on the small clock. Then the aggregated data opens on the right <strong>[H]</strong>.</td></tr><tr><td><strong>[H]</strong></td><td>Aggregated data</td><td>Here you can see the aggregated data and its time periods.<a href="../../academy/aggregations-in-eliona"> -> <strong>Display Aggregated Data</strong></a></td></tr><tr><td><strong>[I]</strong></td><td>to the data details</td><td>To see all data sorted by date, click on the name of an <em>asset</em>. The chronologically sorted <em>data view</em> of the selected <em>asset</em> will then open.</td></tr></tbody></table>

## Data Details

<div data-full-width="true"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FQI5fuKIMXPXSjpoWujz6%2FAsset%20Daten%20(1).png?alt=media&#x26;token=a95bbe03-a80c-46df-8630-d04d6ac1c423" alt=""><figcaption></figcaption></figure></div>

<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>Data filter</td><td>Allows filtering the displayed data by different categories such as "All," "Input," "Output," and "Status."</td></tr><tr><td><strong>[K]</strong></td><td>Data table</td><td>Displays the raw data of the selected <em>asset</em> in tabular form.</td></tr><tr><td><strong>[L]</strong></td><td>Aggregated data</td><td>Button to display aggregated data in <strong>[K]</strong>.</td></tr><tr><td><strong>[M]</strong></td><td>Export</td><td>Button to export the displayed data as a CSV.</td></tr><tr><td><strong>[O]</strong></td><td>Time filter</td><td>Allows for detailed searching for data by selecting a start and end date as well as the respective time. The filters can be applied or reset.</td></tr><tr><td><strong>[P]</strong></td><td>Add new entry</td><td>Add a new data entry at the current time. <a href="#add-new-data-entry">-> Add a new data entry</a></td></tr><tr><td><strong>[Q]</strong></td><td>Bulk editing of data</td><td>Open the window to change past data to a value on a larger scale. <a href="#bulk-editing-of-data">-> Bulk editing of data</a></td></tr><tr><td><strong>[R]</strong></td><td>Edit individual historical data</td><td>Click on the pencil icon next to the value you want to change to manually change this data point. <a href="#edit-individual-historical-data">-> Edit individual historical data</a></td></tr></tbody></table>

***

## Display Aggregated Data

In BuildingPro Suites, measured values can be displayed not only as raw data but also in an **aggregated form**. Aggregations make it possible to display large amounts of data in a **clear manner and in different time intervals**.

### Activate Aggregated Data

1. Click on **\[L]** to display the **aggregated data**.

   ▷ The view switches from raw data to the aggregation view.
2. **Set time period**: In **\[L1]**, you can define the period for which the data should be aggregated.
3. **Select aggregation interval**: In **\[L2]**, select the time steps in which the data should be aggregated (e.g., hourly, daily, weekly).
4. **Select attribute**: In **\[L3]**, you can determine which attribute should be aggregated.
5. **Set aggregation mode**: In **\[L4]**, various **aggregation modes** are available:

   * Average
   * Sum Counter
   * Cumulative Counter
   * Minimum
   * Maximum

   ▷ You can find out more about this [-> here.](https://docs.buildings.ability.abb/collection/academy/aggregations-in-eliona)
6. **Apply settings**: Click on **\[L5]** to apply the changes.
7. **Reset settings**: If necessary, you can reset the filters with **\[L6]**.
8. **Display aggregated data**: The calculated values appear in **\[L7]** in a tabular view.

Aggregated data allows for a **better overview of long-term developments** and helps to **analyze data flows efficiently**.

***

## Add New Data Entry

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F3f7CGAv9erPUuY75gR12%2FAsset%20Daten%20(5).png?alt=media&#x26;token=95b52c99-12a3-4f45-9f0e-887e8779467f" alt=""><figcaption></figcaption></figure>

1. **Add new entry** Click on **Add new entry** \[P].

   ▷ The "Add new data entry" window opens.
2. **Select attribute** Select the desired **attribute** from \[S].
3. **Enter value** Enter the desired value in the corresponding field \[T].
4. **Confirm entry** Click on **Add new entry** again to confirm the entry.

   ▷ The entry for the attribute is written to the heap with the current timestamp.

## Edit Individual Historical Data

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FSvMBo2jBNPGwKmdXgEIp%2Fimage.png?alt=media&#x26;token=d2b7710e-ce7c-45ae-808b-b7dcfb666648" alt=""><figcaption></figcaption></figure>

1. **Display pencil icon** Move the mouse over the desired data entry.

   ▷ A pencil icon appears next to the entry.
2. **Edit data entry** Click on the **pencil icon** \[R] to edit the data entry.

   ▷ The "Edit asset data entry" window opens.
3. **Enter new value** Enter the **new value** for the entry.
4. **Save changes** Click on **Save** to apply the changes.

   ▷ The new value replaces the old value in the data set.

{% hint style="danger" %}
Pay attention to which data you are overwriting. Changes to existing data sets can be irreversible and permanently replace important information.
{% endhint %}

## Bulk Editing of Data

If you want to change data in large quantities, for example, because a device supplied incorrect data on a certain day, you can easily do so. With the bulk editing function, all data within a defined time period can be set to a desired value.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FQYsc9YRYf6YU4Ol9lLC7%2Fimage.png?alt=media&#x26;token=1c943a6b-e88b-4f45-8cdf-97b5d73f0cf5" alt=""><figcaption></figcaption></figure>

1. **Open bulk editing window** Click on **\[Q]** to open the **Bulk Editing of Data** window.
2. **Set time period** Enter the **from** and **to** date as well as the times to set the period in which the data should be changed.
3. **Select attribute** Select the attribute whose data you want to change.
4. **Set value** Enter the new value that should replace the existing data.
5. **Save change** Click on **Save** to apply the changes.

   ▷ All data of the selected attribute in the specified period is set to the new value.

### Using Timescale for Storing Time-based Data

The use of **TimescaleDB** in *Eliona* enables efficient storage and management of time-based data, especially with changing values. By storing only actually changed values, storage space is optimized without affecting the integrity of the data.

**Example: Changes over time**

Let's look at the data that is recorded at regular time intervals:

**Original data without Timescale**

Every time record contains all values, even if they have not changed:

```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}
```

### Data structure with Timescale

With TimescaleDB, we only store the values that have actually changed. This reduces redundant data and improves performance:

```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" %}
Good to know:\
If your devices write "null" values to BuildingPro Suites as data, they are filtered out and not written to the trend.
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://docs.buildings.ability.abb/collection/mandatory-base/assets/asset-data.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
