# 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 %}
