# Apps

## Was sind Apps?

{% hint style="warning" %}
Dieses Kapitel richtet sich an erfahrene Benutzer und Administratoren.

Falsche Einstellungen in diesem Kapitel könnten das System beschädigen oder Kosten verursachen.
{% endhint %}

Apps sind ein integraler Bestandteil von eliona. Mit Apps kann der Funktionsumfang von eliona erweitert und eliona mit anderen Systemen integriert werden.

Apps sind aber auch anspruchsvoll und erfordern teils Programmierkenntnisse. Falsch gehandhabt, können Sie mit Apps sogar das System beschädigen.

Eliona bietet *Interne Apps,* welche standardmässig zu Eliona gehören (Systemanwendungen). Bei projektspezifischen Anforderungen können *Externe Apps* geschrieben werden, um diese zu erfüllen. Gehen Sie für die App-Entwicklung auf die Eliona [GitHub-Seite](https://github.com/eliona-smart-building-assistant). 

## App-Übersicht aufrufen

<div data-full-width="false"><figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/N01FtvW9ZuNF9rXQceGU/Docs%20-%20Apps%201.png" alt=""><figcaption></figcaption></figure></div>

In der App-Übersicht sehen Sie alle verfügbaren Apps. Über die App-Übersicht können Sie Apps installieren und deinstallieren.

1. Klicken Sie auf **Einstellungen \[A]**
2. Klicken Sie auf **Apps \[B]** \
   ▷ Die App-Übersicht öffnet sich

<table data-full-width="false"><thead><tr><th width="142.33333333333331">Element</th><th>Titel</th><th>Details</th></tr></thead><tbody><tr><td><strong>[C]</strong></td><td>App-Übersicht</td><td>Hier werden alle vorhandenen Apps angezeigt</td></tr><tr><td><strong>[D]</strong></td><td>Filter „Typ“</td><td>Filtern Sie ↗ Apps nach Typ. Verfügbar sind:</td></tr><tr><td><strong>[E]</strong></td><td>App-Filter</td><td>Wählen Sie, ob alle oder nur installierte oder nur nicht installierte Apps in der App-Übersicht angezeigt werden sollen.</td></tr><tr><td><strong>[F]</strong></td><td>Suchen</td><td>klicken, um die Such-Maske aufzurufen</td></tr></tbody></table>

## Apps installieren

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/gV58H0IerpmXw5Vv9DOv/Docs%20-%20Apps%202.png" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Die genauen Informationen für die Installation von Apps finden Sie in der Dokumentation der einzelnen Apps
{% endhint %}

1. Öffnen Sie die [↗ App-Übersicht](#app-uebersicht-aufrufen)
2. Bei der App, die Sie installieren wollen: Klicken Sie auf **Installieren \[F]** \
   ▷Das „Installieren-Pop-Up“ öffnet sich
3. Konfigurieren Sie die App.

<table data-full-width="false"><thead><tr><th width="111.33333333333331" align="center">Element</th><th width="255">Titel</th><th>Details</th></tr></thead><tbody><tr><td align="center"><strong>[K]</strong></td><td>App Installieren Fenster</td><td></td></tr><tr><td align="center"><strong>[L]</strong></td><td>Allgemein</td><td>Allgemeine Einstellungen</td></tr><tr><td align="center"><strong>[L1]</strong></td><td>API-Key</td><td>Geben Sie den API-Key ein.</td></tr><tr><td align="center"><strong>[L2]</strong></td><td>Image Link</td><td>Optional: Fügen Sie einen Link zu einem Image an</td></tr><tr><td align="center"><strong>[M]</strong></td><td>Externer Port</td><td></td></tr><tr><td align="center"><strong>[M1]</strong></td><td>Port hinzufügen</td><td>Klicken, um einen Port hinzuzufügen</td></tr><tr><td align="center"><strong>[M2]</strong></td><td>Zielport</td><td>Einen Zielport angeben</td></tr><tr><td align="center"><strong>[M3]</strong></td><td>Port Typ</td><td>Einen Port-Typ auswählen</td></tr><tr><td align="center"><strong>[M4]</strong></td><td>Externer Port</td><td>Einen externen Port angeben</td></tr><tr><td align="center"><strong>[M5]</strong></td><td>Bemerkung hinzufügen</td><td>Öffnet die Optionen <strong>[M6]</strong> und <strong>[M7]</strong>. Informationen zu diesen Optionen finden Sie in den Dokumentation zu den jeweiligen Apps.</td></tr><tr><td align="center"><strong>[M6]</strong></td><td>Wert eingeben</td><td>Einen Wert eingeben.</td></tr><tr><td align="center"><strong>[M7]</strong></td><td>Key eingeben</td><td>Einen Key eingeben.</td></tr><tr><td align="center"><strong>[M8]</strong></td><td>Label hinzufügen</td><td>Öffnet die Optionen <strong>[M9]</strong> und <strong>[M10]</strong>. Informationen zu diesen Optionen finden Sie in den Dokumentation zu den jeweiligen Apps.</td></tr><tr><td align="center"><strong>[M9]</strong></td><td>Wert</td><td>Einen Wert eingeben</td></tr><tr><td align="center"><strong>[M10]</strong></td><td>Key</td><td>Einen Key eingeben</td></tr><tr><td align="center"><strong>[N]</strong></td><td>Environment Variablen</td><td></td></tr><tr><td align="center"><strong>[N1]</strong></td><td>Variable hinzufügen</td><td></td></tr><tr><td align="center"><strong>[N2]</strong></td><td>Wert eingeben</td><td>Einen Wert eingeben</td></tr><tr><td align="center"><strong>[N3]</strong></td><td>Key eingeben</td><td>Einen Key eingeben</td></tr></tbody></table>

## App deinstallieren

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/yQKY4yNChSvn9gWpTFbw/Docs%20-%20Apps%203.png" alt=""><figcaption></figcaption></figure>

1. Öffnen Sie die [↗ App-Übersicht](#app-uebersicht-aufrufen)
2. Bei der App, die Sie deinstallieren wollen: Klicken Sie auf **Deinstallieren \[H]** ▷Das „Installieren“-Pop-Up **\[O]** öffnet sich
3. Klicken Sie auf **\[O1]**, um die App zu deinstallieren.

## App aktualisieren

Wenn für Apps eine neue Version zur Verfügung steht, erscheint die Option **Aktualisierung \[I]**

## App-Typen

### Core Apps

{% hint style="warning" %}
Änderungen an den Core Apps können die Funktionsfähigkeit von Eliona beeinträchtigen. In diesem Bereich sollten sich nur sehr erfahrene Nutzer und Administratoren aufhalten.
{% endhint %}

Core Apps sind integrale Bestandteile von Eliona und für wichtige Grundfunktionen zuständig.

### System Apps

System Apps werden standardmässig mit Eliona ausgeliefert und erlauben die Anbindung an weitere Dienste

### Apps

Gewöhnliche Apps erweitern den Funktionsumfang von Eliona. Wenn in diesem Kapitel von Apps die Rede ist, sind meistens diese Apps gemeint.

### Agents

Agents sind für die Kommunikation mit externen Geräten zuständig. Die meisten Funktionen von Agents werden mittlerweile von Core-Apps übernommen.

## App Neu starten

{% hint style="danger" %}
**Achtung** Beim Neustarten einer App können Informationen der App verloren gehen.&#x20;
{% endhint %}

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/bbTX0eYJWnThEfzM1WRy/Docs_Apps%20Restart.png" alt=""><figcaption></figcaption></figure>

1. Klicken Sie auf **\[J]** \
   ▷ Die App-Einstellungen **\[P]** öffnen sich
2. Klicken Sie auf **\[P1]**, um die App neu zu starten \
   ▷ Das Fenster **\[P2]** öffnet sich
3. Klicken Sie auf **\[P3]**, um das Neustarten zu bestätigen

### App Konfiguration

Detaillierte Anleitungen zur Konfiguration von Apps finden Sie auf der Dokumentationsseite für Apps. Jede App hat auch ihre eigene Dokumentationsseite, die spezifische Konfigurationsanweisungen für die App enthält.

{% embed url="<https://drive.google.com/file/d/1JBRLqjZxhVZ8O_USArE3mRxrBuRk1DOE/view>" %}
App Konfiguration
{% endembed %}