# CoffeeCloud

## App konfigurieren

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

1. Klicken Sie auf **Einstellungen \[A]**
2. Klicken Sie auf **Apps \[B]**
3. Navigieren Sie zur **CoffeeCloud App \[C]**
4. Klicken Sie auf **\[D]**\
   ▷ Das App-Frontend öffnet sich
5. Fügen Sie das unten stehenden .json-Template in das Fenster **Request \[E]** ein&#x20;
6. ▷ Füllen Sie das .json-Template mit korrekten Daten aus
7. Wählen Sie unter **Endpoint \[F]** die Auswahl */configs* \
   ▷ Die Auswahl *Method* erscheint
8. Wählen Sie unter **Method \[G]** die Auswahl *POST*
9. Klicken Sie auf **Send \[H]**

Unter ↗[ Assets](https://docs.buildings.ability.abb/collection/german-14.2-freezed/dokumentation/assets) werden Assets für alle Geräte angelegt, die in Ihrem CoffeeCloud Account vorhanden sind.

{% hint style="warning" %}
Es werden alle Maschinen innerhalb einer Gruppe dargestellt. Es werden jedoch keine Untergruppen berücksichtigt.

Wenn Sie Kaffeemaschinen in Ihrem CoffeeCloud Account in Unterordnern platziert haben, wird diese Struktur NICHT in Eliona übernommen. Die Maschinen selbst werden jedoch in Eliona erscheinen
{% endhint %}

### .json-Template

```json
{
    "id": 1,
    "username": "Geben Sie hier Ihren Benutzernamen ein",
    "password": "Gegeb Sie hier Ihr Passwort ein",
    "apiKey": "Geben Sie hier Ihren API Key ein",
    "url": "https://coffeecloud.scanomat.com",
    "enable": true,
    "refreshInterval": 113600,
    "requestTimeout": 120,
    "active" false,
    "projectIDs": [
        "10"
    ]
}
```

### API-Key generieren

<div data-full-width="false"><figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/gAVk4n6J5mJDund4Stpj/CoffeeCloud%20API%20generieren.png" alt=""><figcaption></figcaption></figure></div>

Um den API-Key zu generieren, loggen Sie sich mit Ihren Daten in Ihren CoffeeCloud-Account ein. Der API-Key kann unter „Settings“ generiert werden.

## Generierte Asset Typen

Es werden 3 Asset-Typen angelegt:

1. CoffeeCloud
2. CoffeeCloud group
3. CoffeeCloud coffee machine

### CoffeeCloud

Ein root-Verzeichnis für Kaffeemaschinen

### CoffeeCloud group

Eine Gruppe für Kaffeemaschinen.

### CoffeeCloud coffee machine

Ein Asset-Typ für eine einzelne Kaffeemaschine, inklusive verschiedener Attribute.

## CoffeeCloud Dashboard

Die CoffeeCloud App kommt mit einem ↗[ Dashboard Template](https://docs.buildings.ability.abb/collection/german-14.2-freezed/dokumentation/dashboard/dashboard-templates-import-export).

### Beschreibung

<div data-full-width="false"><figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/pS5d1ruwov9T7ZCxGgiP/CoffeeCLoud%20Dashboard.png" alt=""><figcaption></figcaption></figure></div>

Das CoffeeCloud Dashboard zeigt eine Auflist verbundener CoffeeCloud Kaffeemaschinen und dazugehörige Statusmeldungen.

### Dashboard-Template aktivieren

Siehe ↗[ hier](https://docs.buildings.ability.abb/collection/german-14.2-freezed/dokumentation/dashboard/dashboard-templates-import-export)

## Bekannte Einschränkungen

### Maximales Update Intervall

Die API ist limitiert auf ca. 20 bis 30 Requests pro Stunde. Gehen in einem Zeitraum mehr Requests ein, kann es sein dass keine Daten gesendet werden.

Wir empfehlen, etwa 1 Request pro Stunde durchzuführen.

### Nur der Root Ordner wird berücksichtigt

Wenn Sie Kaffeemaschinen in Ihrem CoffeeCloud Account in Unterordnern platziert haben, werden diese Unterordner NICHT in Eliona übernommen!

Die Maschinen selbst werden jedoch in Eliona erscheinen.

Sie können die Maschinen in eliona ↗[ manuell in Ordnern platzieren](https://docs.buildings.ability.abb/collection/german-14.2-freezed/dokumentation/assets/assets-strukturieren), wenn gewünscht.