# Ein neues Template erstellen

{% hint style="info" %}
Für viele Sensoren haben wir bereits fertige Templates für Sie erstellt. Schauen Sie in der [-> Asset-Bibliothek](https://docs.buildings.ability.abb/collection/german-14.2-freezed/dokumentation/assets/die-template-bibliothek), ob Ihr gewünschter Sensor bereits dabei ist.
{% endhint %}

## Schritt für Schritt: Ein Asset-Template erstellen

## Schritt 1: Das Template erstellen

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

* Gehen Sie auf *Engineering -> Asset Modellierung -> **+ Template***

  ▷Ein Fenster erscheint. Geben Sie in diesem Fenster folgende Informationen an:

<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. Klicken Sie auf Engineering **\[A]**
2. Klicken Sie auf Asset-Modellierung **\[B]**

   &#x20;▷ Es öffnet sich die Asset-Modell-Übersicht **\[B1]**. In der Asset-Modell-Übersicht sehen Sie alle verfügbaren Asset-Templates.
3. Klicken Sie auf **\[B2]**&#x20;

   ▷ Das Fenster **\[C]** öffnet sich.
4. Geben Sie dem Asset-Template in **\[C1]** einen Namen.
5. Optional: Aktivieren Sie **\[C2]**, um festzulegen, ob das Asset auf [↗ Inaktivität überwacht](https://docs.buildings.ability.abb/collection/german-14.2-freezed/dokumentation/assets/asset-status-aktive-inaktive-nicht-uberwachte-assets) werden soll.
6. Wenn Sie Schritt 5 ausgeführt haben: Geben Sie in unter **\[C3]** und **\[C4]** die Zeit ein, die verstreichen soll, bis Assets die anhand dieses Templates erschaffen wurden, als Inaktiv angezeigt werden.&#x20;

   **⇄ Sonst:** Fahren Sie fort mit dem nächsten Schritt.
7. Wählen Sie in **\[C5]** das Kartensymbol aus. Diese Auswahl gibt an, mit welchem Symbol Assets, die anhand dieses Templates erstellt wurden, auf der Karte angezeigt werden.
8. Klicken Sie auf **\[C6]**, um das Asset-Template zu erstellen.&#x20;

   ▷ Das Asset-Template wird hinzugefügt und erscheint in der Asset-Modell-Übersicht **\[B1]**
9. Um das Asset-Template zu bearbeiten klicken Sie **\[D].**

   ▷ Es öffnet sich die Asset-Template Konfigurationen Seite

<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" %}
Wenn Sie auf **\[I]** klicken wird das  [↗ Template als JSON exportiert](https://docs.buildings.ability.abb/collection/german-14.2-freezed/dokumentation/assets/die-template-bibliothek/ein-template-exportieren) und kann in anderen Projekten wieder[  ↗ importiert](https://docs.buildings.ability.abb/collection/german-14.2-freezed/dokumentation/assets/die-template-bibliothek/ein-template-importieren) werden.
{% endhint %}

## Schritt 2: Die Template Konfiguration

<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 des Asset Typen</td></tr><tr><td><strong>[E2]</strong></td><td>Kartenicon</td><td>Symbol, mit dem das Asset auf der Karte angezeigt wird.</td></tr><tr><td><strong>[E3]</strong></td><td>Hersteller</td><td>Name des Herstellers des Asset Typen.</td></tr><tr><td><strong>[E4]</strong></td><td>Asset-Typen Übersetzungen</td><td>Übersetzungen des Asset-Typs in verschiedenen Sprachen.</td></tr><tr><td><strong>[E5]</strong></td><td>Zeit bis zur Inaktivität</td><td>Aktivieren, um festzulegen, ob das Asset auf <a href="../../assets/asset-status-aktive-inaktive-nicht-uberwachte-assets">↗ Inaktivität überwacht</a> werden soll.</td></tr><tr><td><strong>[E6]</strong></td><td>Buchbar</td><td>Aktiviert die Buchungsfunktion für das Asset: <a href="#buchbar-aktivieren">-> Buchbar aktivieren</a></td></tr><tr><td><strong>[E7]</strong></td><td>Tracker</td><td>Markiert das Asset als Tracker für die Standortverfolgung: <a href="#tracker-funktion-aktivieren">-> Tracker-Funktion aktivieren</a></td></tr></tbody></table>

{% hint style="danger" %}
Der **Name** **\[1]** eines Asset Templates kann nicht mehr verändert werden, nachdem das Template erstellt wurde!
{% endhint %}

### Buchbar aktivieren

Nachdem Sie ein Asset Template erstellt haben, können Sie es für Buchungen freischalten, um es für die [Buchungs-App](https://docs.buildings.ability.abb/collection/german-14.2-freezed/apps/apps/buchung) verfügbar zu machen. Dieser Prozess ermöglicht es Ihnen, Assets, die auf diesem Template basieren, für Reservierungen und Buchungen zu nutzen.

#### Buchungsfunktion aktivieren

1. **Template-Konfiguration öffnen**: Gehen Sie zu **Engineering -> Asset Modellierung** und wählen Sie das gewünschte Asset Template aus. Klicken Sie dann auf das Stift-Symbol ![](https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/CfbQBoqJaysPXy5tuVX7/image.png)  um die Konfiguration des Templates zu bearbeiten.
2. **Buchungsoption aktivieren**: In den Konfigurationseinstellungen des Templates finden Sie die Option **"Buchbar"**. Aktivieren Sie diese Option, um das Asset Template für Buchungen freizuschalten.                                                                                                                                ![](https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/yFJTEbSN3k19Rx6Cnbkl/image.png)
   * **Automatisch hinzugefügte Attribute**: Sobald die Buchungsoption aktiviert ist, werden zwei spezielle Attribute automatisch zum Template hinzugefügt:
     * **occupancy**: Dieses Attribut zeigt an, wie viele Personen sich aktuell im Asset befinden.
     * **bookable**: Dieses Attribut gibt an, ob das Asset derzeit buchbar ist oder bereits gebucht wurde.
3. **Integration mit der Buchungs-App**: Wenn die Buchungs-App installiert ist, erkennt sie automatisch die `occupancy`- und `bookable`-Attribute. Dadurch wird das Asset, das auf diesem Template basiert, über die Buchungs-App reservierbar.

### Tracker-Funktion aktivieren

Sie können Assets als Tracker im System registrieren, um diese dann mit einem[ Localino Tracker](https://docs.buildings.ability.abb/collection/german-14.2-freezed/apps/apps/localino) zu verbinden und im [Tracking Widget ](https://docs.buildings.ability.abb/collection/german-14.2-freezed/dokumentation/widgets/vordefinierte-widgets/asset-tracking)anzeigen zu lassen.

**Schritt 1: Template-Konfiguration öffnen**

1. **Navigieren Sie zur Konfiguration:**\
   Gehen Sie zu **Engineering** -> **Asset Modellierung** und wählen Sie das gewünschte Asset-Template aus.
2. **Bearbeiten Sie das Template:**\
   Klicken Sie auf das *Stift-Symbol* ![](https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/CfbQBoqJaysPXy5tuVX7/image.png), um die Konfiguration des Templates zu bearbeiten.

**Schritt 2: Tracker-Option aktivieren**

1. **Tracker-Option finden:**\
   In den Konfigurationseinstellungen des Templates finden Sie die Option **Tracker**.                   ![](https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/9Fy8jMQLhzYf6xzCQjgQ/image.png)&#x20;
2. **Option aktivieren:**\
   Aktivieren Sie diese Option, um das Asset als Tracker im System zu registrieren.                  <img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/smMqs4ch1yAU2L3y0Xij/image.png" alt="" data-size="original">

## Schritt 3: Dem Asset-Template Attribute hinzufügen

Sie können einem Asset-Template beliebig viele Attribute hinzufügen.

Attribute geben an, welche Daten das Asset-Template verarbeitet.

{% hint style="info" %}
Beispiel: \
Sie legen ein Asset-Template für einen Temperatur-Sensor an. Sie sollten dem Template also das Attribut "Temperatur" hinzufügen.
{% endhint %}

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

1. Klicken Sie auf Engineering **\[A]**
2. Klicken Sie auf Asset-Modellierung **\[B]**&#x20;

   ▷ Es öffnet sich die Asset-Modell-Übersicht **\[B1]**. In der Asset-Modell-Übersicht sehen Sie alle verfügbaren Asset-Templates.
3. Bei dem Asset, dem Sie Attribute hinzufügen wollen: Klicken Sie auf **\[D]**.&#x20;

   ▷ Es öffnen sich die Asset-Template-Details&#x20;
4. Unter **\[F]** sehen Sie alle Attribute, die bereits für dieses Asset-Template erstellt wurden. Dieses Feld ist also unter Umständen leer.
5. klicken Sie auf **\[F1]**, um ein neues Attribut anzulegen&#x20;

   ▷ Das Fenster **Attribute konfigurieren** öffnet sich.
6. Wählen Sie unter **\[F2]** "Allgemein"  in **\[F3]** aus, ob die eingehenden Werte Analog oder Digital sind. Digitale Werte sind die Werte „0“ und „1“. Analoge Werte sind beliebige Fliesskommazahlen.
7. Aktivieren Sie **\[F3]**, falls es sich um ein Attribut handelt, das aus mehreren [↗ anderen Attributen berechnet wird](https://doc.eliona.io/collection/dokumentation/weitere-funktionen/werte-berechnen-der-calculator).
8. Geben Sie in **\[F5]** einen Attribut-Namen ein.
9. Geben Sie in **\[F6]** den Subtype des Assets an.&#x20;

   ◈ **Eingang** – Daten werden vom Asset an Eliona gesendet.\
   ◈ **Ausgang** – Daten werden von Eliona an das Asset gesendet.\
   ◈ **Status** – Zeigt einen Zustand an (z. B. Batteriestand).\
   ◈ **Informationen** – Statische oder systembezogene Daten.

   ◈ **ACHTUNG!** Der Subtype kann nicht mehr geändert werden, nachdem das Asset-Template gespeichert wurde!
10. Optional: Geben Sie in **\[F7]** die Einheit an, die die in dieses Attribut eingehende Daten haben (z. B. °C, kWh).
11. Optional: Wählen Sie in **\[F8]** die Attribut-Klasse. Diese Einstellung ist optional und bezieht sich nur auf das Logo.
12. Optional: In **\[F9]** können Sie [↗ Berechnungen](https://doc.eliona.io/collection/dokumentation/weitere-funktionen/werte-berechnen-der-calculator) eingeben, die auf in dieses Attribut eingehende Daten angewendet werden.
13. Optional: Geben Sie in **\[F10]** einen JSON Pfad ein. Eliona verwendet JSON-Path Ausdrücke, um Datenelemente in der Datenbank zu identifizieren.
14. Optional: Geben Sie in **\[F9]** einen unteren Grenzwert ein.
15. Optional: Geben Sie in **\[F10]** einen oberen Grenzwert ein.
16. Optional: Legen Sie in **\[F11]** **Grenzwerte** für das Attribut fest:\
    ◈ **Limit low** – Minimalwert\
    ◈ **Limit high** – Maximalwert\
    ◈ **Schrittweite** – Wertintervall für Änderungen
17. Optional: Aktivieren Sie **\[F12] Trending Configuration**, um festzulegen, ob historische Werte gespeichert werden.

    ◈ **On change** – Werte werden nur gespeichert, wenn sich der Wert ändert. Dies reduziert unnötige Datenpunkte und spart Speicherplatz.

    ◈ **Always** – Jeder Wert wird gespeichert, auch wenn er sich nicht ändert. Dies ermöglicht eine lückenlose Datenhistorie.
18. Optional: In **\[F13]** können Sie eine **AR Position** festlegen, an der das Attribut in der Augmented-Reality-Darstellung erscheint:\
    ◈ Keine Position\
    ◈ Oben\
    ◈ Unten Links\
    ◈ Unten Rechts
19. Optional: Klicken Sie auf **\[F14]**, um das **Werte-Mapping** zu aktivieren. Damit können bestimmten Rohwerten (z. B. „0“, „1“, „2“) individuelle Zeichenfolgen (Strings) zugeordnet werden .

    ◈ Mehr Informationen erhalten Sie im Kapitel zu [↗ Werte-Mapping](https://doc.eliona.io/collection/dokumentation/engineering/asset-modellierung-templates#werte-mapping).
20. Optional: Über **\[F15]** können Sie die **Titel-Sprache** des Attributs anpassen.
21. Klicken Sie auf **\[F16] Speichern**, um die Konfiguration abzuschließen.

{% hint style="success" %}
Das Attribut wurde erfolgreich hinzugefügt!
{% endhint %}

***

## Schritt 4: Dem Asset-Template Charakteristiken hinzufügen

Asset-Charakteristiken ermöglichen es, standardisierte Informationen direkt in einem Asset-Template zu hinterlegen. Diese Werte können beim Erstellen eines Assets übernommen und später individuell angepasst werden.

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

1. Klicken Sie auf den **Bearbeitungsstift \[H]**, um die **Asset-Charakteristiken** für das Asset-Template zu konfigurieren.

   ▷ Es öffnet sich die Konfigurationsansicht für Asset-Charakteristiken.
2. Klicken Sie auf **\[H1]**, um eine neue Kategorie für Asset-Charakteristiken zu erstellen.\
   ▷ Es öffnet sich ein Fenster zur Eingabe des Namens der Kategorie.
3. Wählen Sie in **\[H2]** eine der zuvor erstellten [↗ **Charakteristiken-Templates**](https://docs.buildings.ability.abb/collection/german-14.2-freezed/dokumentation/assets/asset-modellierung-templates-erstellen/ein-neues-asset-charakteristik-template-erstellen) aus.\
   ▷ Die vordefinierten Attribute und Einstellungen der ausgewählten Kategorie werden übernommen.
4. In **\[H3]** können Sie Standardwerte für die Asset-Charakteristiken festlegen.\
   ▷ Diese Werte werden automatisch in jedes Asset übernommen, das auf diesem Template basiert.\
   ▷ Die Werte können später in den individuellen Assets angepasst werden.&#x20;
5. Klicken Sie auf **\[H4]**, um das  [↗ Charakteristiken-Template ](https://docs.buildings.ability.abb/collection/german-14.2-freezed/dokumentation/assets/asset-modellierung-templates-erstellen/ein-neues-asset-charakteristik-template-erstellen)weiter anzupassen.\
   ▷ Dies öffnet die gleiche Konfigurationsansicht wie unter **Schritt 4** (siehe G-Elemente).
6. Klicken Sie auf **\[H5]**, um eine Kategorie aus dem Asset-Template zu entfernen.\
   ▷ Die zugehörigen Charakteristiken werden ebenfalls entfernt.
7. Klicken Sie auf **\[H6]** Speichern, um die Konfiguration abzuschließen.

{% hint style="success" %}
Herzlichen Glückwinsch, Sie haben erfolgreich einen Asset Typen mit all seinen Eigenschafften erstellt.
{% endhint %}