# Create a new template

{% hint style="info" %}
For many sensors, we have already created ready-made templates for you. Check in the [-> Asset library](https://docs.buildings.ability.abb/collection/english-v14/documentation/assets/the-template-library), whether your desired sensor is already included.
{% endhint %}

## Step by step: Create an asset template

## Step 1: Create the template

{% @supademo/embed demoId="Dvy\_BUURL8qam9Wg\_AUkN" url="<https://app.supademo.com/demo/Dvy_BUURL8qam9Wg_AUkN>" fullWidth="true" %}

* Go to *Engineering -> Asset Modeling -> **+ Template***

  ▷ A window appears. In this window, enter the following information:

<div data-full-width="true"><figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/9NGJcX28vsO69EdQtye6/Docs_Asset_Template%201.png" alt=""><figcaption></figcaption></figure></div>

1. Click on Engineering **\[A]**
2. Click on Asset Modeling **\[B]**

   &#x20;▷ The asset model overview opens **\[B1]**. In the asset model overview, you can see all available asset templates.
3. Click on **\[B2]**&#x20;

   ▷ The window **\[C]** opens.
4. Give the asset template in **\[C1]** .
5. Optional: Activate **\[C2]**, to specify whether the asset on [↗ inactivity monitored](https://docs.buildings.ability.abb/collection/english-v14/documentation/assets/asset-status-active-inactive-unmonitored-assets) should be.
6. If you carried out step 5: Enter under **\[C3]** and **\[C4]** the time that should pass until assets created based on this template are displayed as inactive.&#x20;

   **⇄ Otherwise:** Continue with the next step.
7. Select in **\[C5]** select the map symbol. This selection indicates with which symbol assets created based on this template are displayed on the map.
8. Click on **\[C6]**, to create the asset template.&#x20;

   ▷ The asset template is added and appears in the asset model overview **\[B1]**
9. To edit the asset template, click **\[D].**

   ▷ The asset template configuration page opens

<div data-full-width="true"><figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/Qrox9uFjXz2ZiPizfY0S/Asset%20Template%20(5).png" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
If you click on **\[I]** the  [↗ template is exported as JSON](https://docs.buildings.ability.abb/collection/english-v14/documentation/assets/the-template-library/export-a-template) and can be[  ↗ imported](https://docs.buildings.ability.abb/collection/english-v14/documentation/assets/the-template-library/import-a-template) in the app.
{% endhint %}

## Step 2: The template configuration

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/9L2weax30bhjzSIDefvp/Asset%20Template%20Konfiguration%20(2).png" alt="" width="563"><figcaption></figcaption></figure>

<table data-header-hidden data-full-width="false"><thead><tr><th width="85"></th><th width="202"></th><th></th></tr></thead><tbody><tr><td><strong>[E1]</strong></td><td>Host</td><td>Name of the asset type</td></tr><tr><td><strong>[E2]</strong></td><td>Map icon</td><td>Symbol used to display the asset on the map.</td></tr><tr><td><strong>[E3]</strong></td><td>Manufacturer</td><td>Name of the manufacturer of the asset type.</td></tr><tr><td><strong>[E4]</strong></td><td>Asset type translations</td><td>Translations of the asset type in different languages.</td></tr><tr><td><strong>[E5]</strong></td><td>Time until inactivity</td><td>Enable to define whether the asset on <a href="../../assets/asset-status-active-inactive-unmonitored-assets">↗ inactivity monitored</a> should be.</td></tr><tr><td><strong>[E6]</strong></td><td>Bookable</td><td>Enables the booking function for the asset: <a href="#buchbar-aktivieren">-> Enable bookable</a></td></tr><tr><td><strong>[E7]</strong></td><td>Tracker</td><td>Marks the asset as a tracker for location tracking: <a href="#tracker-funktion-aktivieren">-> Enable tracker function</a></td></tr></tbody></table>

{% hint style="danger" %}
The **Name** **\[1]** of an asset template can no longer be changed after the template has been created!
{% endhint %}

### Enable bookable

After you have created an asset template, you can enable it for bookings to make it available for the [booking app](https://docs.buildings.ability.abb/collection/english-v14/apps/apps/booking) . This process allows you to use assets based on this template for reservations and bookings.

#### Enable booking function

1. **Open template configuration**: Go to **Engineering -> Asset Modeling** and select the desired asset template. Then click the pencil icon ![](https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/CfbQBoqJaysPXy5tuVX7/image.png)  to edit the template configuration.
2. **Enable booking option**: In the template configuration settings, you will find the option **"Bookable"**. Enable this option to unlock the asset template for bookings.                                                                                                                                ![](https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/yFJTEbSN3k19Rx6Cnbkl/image.png)
   * **Automatically added attributes**: Once the booking option is enabled, two special attributes are automatically added to the template:
     * **occupancy**: This attribute shows how many people are currently in the asset.
     * **bookable**: This attribute indicates whether the asset is currently bookable or has already been booked.
3. **Integration with the booking app**: If the booking app is installed, it automatically recognizes the `occupancy`- and `bookable`-attributes. This makes the asset based on this template reservable via the booking app.

### Activate tracker function

You can register assets as trackers in the system in order to connect them with a[ Localino Tracker](https://docs.buildings.ability.abb/collection/english-v14/apps/apps/localino) and have them displayed in the [Tracking widget ](https://docs.buildings.ability.abb/collection/english-v14/documentation/widgets/predefined-widgets/asset-tracking).

**Step 1: Open template configuration**

1. **Navigate to the configuration:**\
   Go to **Engineering** -> **Asset modelling** and select the desired asset template.
2. **Edit the template:**\
   Click on the *Pencil icon* ![](https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/CfbQBoqJaysPXy5tuVX7/image.png), to edit the template configuration.

**Step 2: Activate tracker option**

1. **Find tracker option:**\
   In the template configuration settings, you will find the option **Tracker**.                   ![](https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/9Fy8jMQLhzYf6xzCQjgQ/image.png)&#x20;
2. **Enable option:**\
   Enable this option to register the asset as a tracker in the system.                  <img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/smMqs4ch1yAU2L3y0Xij/image.png" alt="" data-size="original">

## Step 3: Add attributes to the asset template

You can add as many attributes as you like to an asset template.

Attributes specify which data the asset template processes.

{% hint style="info" %}
Example: \
You create an asset template for a temperature sensor. You should therefore add the attribute "Temperature" to the template.
{% endhint %}

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/6SPha18Urs8QKAqnEtjq/Asset%20Template%20Attributes%20(2).png" alt=""><figcaption><p>Configure attributes</p></figcaption></figure>

1. Click on Engineering **\[A]**
2. Click on Asset Modeling **\[B]**&#x20;

   ▷ The asset model overview opens **\[B1]**. In the asset model overview, you can see all available asset templates.
3. For the asset to which you want to add attributes: Click on **\[D]**.&#x20;

   ▷ The asset template details will open&#x20;
4. Under **\[F]** you can see all attributes that have already been created for this asset template. This field may therefore be empty.
5. click on **\[F1]**&#x74;o create a new attribute&#x20;

   ▷ The window **Configure attributes** opens.
6. Select under **\[F2]** "General" in **\[F3]** to indicate whether the incoming values are analog or digital. Digital values are the values "0" and "1". Analog values are any floating-point numbers.
7. Activate **\[F3]**, if it is an attribute that is calculated from several [↗ other attributes](https://doc.eliona.io/collection/dokumentation/weitere-funktionen/werte-berechnen-der-calculator).
8. Enter in **\[F5]** enter an attribute name.
9. Enter in **\[F6]** the sub-type of the asset.&#x20;

   ◈ **Input** – Data are sent from the asset to Eliona.\
   ◈ **Output** – Data are sent from Eliona to the asset.\
   ◈ **Status** – Displays a state (e.g. battery level).\
   ◈ **Information** – Static or system-related data.

   ◈ **ATTENTION!** The sub-type can no longer be changed after the asset template has been saved!
10. Optional: Enter in **\[F7]** the unit that the data entering this attribute has (e.g. °C, kWh).
11. Optional: Select **\[F8]** the attribute class. This setting is optional and only relates to the logo.
12. Optional: In **\[F9]** you can [↗ calculations](https://doc.eliona.io/collection/dokumentation/weitere-funktionen/werte-berechnen-der-calculator) enter to apply to data entering this attribute.
13. Optional: Enter in **\[F10]** enter a JSON path. Eliona uses JSONPath expressions to identify data elements in the database.
14. Optional: Enter in **\[F9]** enter a lower limit value.
15. Optional: Enter in **\[F10]** enter an upper limit value.
16. Optional: Define in **\[F11]** **Limits** for the attribute:\
    ◈ **Limit low** – Minimum value\
    ◈ **Limit high** – Maximum value\
    ◈ **Step size** – Value interval for changes
17. Optional: Activate **\[F12] Trending Configuration**, to define whether historical values are stored.

    ◈ **On change** – Values are stored only when the value changes. This reduces unnecessary data points and saves storage space.

    ◈ **Always** – Every value is stored, even if it does not change. This enables a complete data history.
18. Optional: In **\[F13]** you can set a **AR position** where the attribute appears in the augmented reality view:\
    ◈ No position\
    ◈ Top\
    ◈ Bottom left\
    ◈ Bottom right
19. Optional: Click on **\[F14]**, to enable the **Value mapping** This allows individual strings (texts) to be assigned to certain raw values (e.g. "0", "1", "2").

    ◈ You can find more information in the chapter on [↗ value mapping](https://doc.eliona.io/collection/dokumentation/engineering/asset-modellierung-templates#werte-mapping).
20. Optional: Through **\[F15]** you can **title language** of the attribute.
21. Click on **\[F16] Save**, to complete the configuration.

{% hint style="success" %}
The attribute has been added successfully!
{% endhint %}

***

## Step 4: Add characteristics to the asset template

Asset characteristics make it possible to store standardized information directly in an asset template. These values can be adopted when creating an asset and later customized individually.

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/a5lPcXtGPQhIABklbHXj/Asset%20Categories%202.png" alt=""><figcaption></figcaption></figure>

1. Click on the **edit pencil \[H]**, to display the **asset characteristics** to configure the asset template.

   ▷ The configuration view for asset characteristics opens.
2. Click on **\[H1]**, to create a new category for asset characteristics.\
   ▷ A window opens for entering the name of the category.
3. Select in **\[H2]** one of the previously created [↗ **characteristic templates**](https://docs.buildings.ability.abb/collection/english-v14/documentation/assets/asset-modeling-create-templates/create-a-new-asset-characteristic-template) .\
   ▷ The predefined attributes and settings of the selected category are adopted.
4. In **\[H3]** you can define default values for the asset characteristics.\
   ▷ These values are automatically adopted into every asset based on this template.\
   ▷ The values can later be adjusted in the individual assets.&#x20;
5. Click on **\[H4]**, to enable the  [↗ characteristic template ](https://docs.buildings.ability.abb/collection/english-v14/documentation/assets/asset-modeling-create-templates/create-a-new-asset-characteristic-template)to further customize.\
   ▷ This opens the same configuration view as under **Step 4** (see G elements).
6. Click on **\[H5]**, to remove a category from the asset template.\
   ▷ The associated characteristics are also removed.
7. Click on **\[H6]** Save to complete the configuration.

{% hint style="success" %}
Congratulations, you have successfully created an asset type with all its properties.
{% endhint %}