# CoffeeCloud

## App konfigurieren

<div data-full-width="false"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F1YJa3SkpZiKXxOVpNA7o%2FDocs%20-%20CoffeeCloud%20aktivieren.png?alt=media&#x26;token=45ec615f-3574-43a0-bd78-22cb868b2af4" alt=""><figcaption></figcaption></figure></div>

1. Klicken Sie auf **Einstellungen \[A]**
2. Klicken Sie auf **Apps \[B]**
3. Navigieren Sie zu den **CoffeeCloud App \[C]**
4. Klicken Sie auf **\[D]** ▷ Die App-Frontend wird geöffnet
5. Fügen Sie die untenstehende .json-Vorlage in das **Anfrage \[E]** Fenster
6. ▷ Füllen Sie die .json-Vorlage mit den korrekten Daten aus
7. Unter **Endpunkt \[F]**&#x77;ählen Sie die */configs* Option ▷ Die *Methode* Option erscheint
8. Unter **Methode \[G]**&#x77;ählen Sie die *POST* Option
9. Klicken Sie auf **Senden \[H]**

Unter ↗ Assets werden Assets für alle Geräte erstellt, die in Ihrem CoffeeCloud-Konto vorhanden sind.

{% hint style="warning" %}
Alle Maschinen innerhalb einer Gruppe werden angezeigt. Untergruppen werden jedoch nicht berücksichtigt.

Wenn Sie in Ihrem CoffeeCloud-Konto Kaffeemaschinen in Untergruppen abgelegt haben, wird diese Struktur in BuildingPro Suites NICHT übernommen. Die Maschinen selbst werden jedoch in BuildingPro Suites angezeigt.
{% endhint %}

### .json-Vorlage

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

### API-Schlüssel generieren

<div data-full-width="false"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F3hB4fPTXGKEyveuTQ7Yz%2FCoffeeCloud%20API%20generieren.png?alt=media&#x26;token=9bf0ebd4-e972-48ed-a8dc-6afdbc40ca16" alt=""><figcaption></figcaption></figure></div>

Um den API-Schlüssel zu generieren, melden Sie sich mit Ihren Daten in Ihrem CoffeeCloud-Konto an. Der API-Schlüssel kann unter "Einstellungen" generiert werden.

## Generierte Asset-Typen

Es werden 3 Asset-Typen erstellt:

1. CoffeeCloud
2. CoffeeCloud-Gruppe
3. CoffeeCloud-Kaffeemaschine

### CoffeeCloud

Ein Stammverzeichnis für Kaffeemaschinen

### CoffeeCloud-Gruppe

Eine Gruppe für Kaffeemaschinen.

### CoffeeCloud-Kaffeemaschine

Ein Asset-Typ für eine einzelne Kaffeemaschine, einschließlich verschiedener Attribute.

## CoffeeCloud-Dashboard

Die CoffeeCloud App enthält eine ↗ Dashboard-Vorlage.

### Beschreibung

<div data-full-width="false"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2Fq3J2G2GCaOTKZsaDjKyc%2FCoffeeCLoud%20Dashboard.png?alt=media&#x26;token=f76935c7-2fd4-408a-b25b-69e39e3018da" alt=""><figcaption></figcaption></figure></div>

Das CoffeeCloud-Dashboard zeigt eine Liste der verbundenen CoffeeCloud-Kaffeemaschinen und zugehörige Statusmeldungen an.

### Dashboard-Vorlage aktivieren

Siehe ↗ hier

## Bekannte Einschränkungen

### Maximales Aktualisierungsintervall

Die API ist auf etwa 20 bis 30 Anfragen pro Stunde begrenzt. Wenn in einem Zeitraum mehr Anfragen gestellt werden, werden möglicherweise keine Daten gesendet.

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

### Nur der Stammordner wird berücksichtigt

Wenn Sie in Ihrem CoffeeCloud-Konto Kaffeemaschinen in Unterordnern abgelegt haben, werden diese Unterordner in BuildingPro Suites NICHT übernommen!

Die Maschinen selbst werden jedoch in BuildingPro Suites angezeigt.

Sie können [↗ die Maschinen manuell platzieren](https://docs.buildings.ability.abb/collection/german/pflichtbasis/assets/structuring-assets) in Ordnern, falls gewünscht.