# CoffeeCloud

## Configure app

<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. Click on **Settings \[A]**
2. Click on **Apps \[B]**
3. Navigate to the **CoffeeCloud app \[C]**
4. Click on **\[D]**\
   ▷ The app front end opens
5. Insert the .json template below into the window **Request \[E]** a&#x20;
6. ▷ Fill the .json template with the correct data
7. Select under **Endpoint \[F]** the selection */configs* \
   ▷ The selection *Method* appears
8. Select under **Method \[G]** the selection *POST*
9. Click on **Send \[H]**

Under ↗[ Assets](https://docs.buildings.ability.abb/collection/english-v14/documentation/assets) assets are created for all devices that exist in your CoffeeCloud account.

{% hint style="warning" %}
All machines within a group are displayed. However, no subgroups are taken into account.

If you have placed coffee machines in your CoffeeCloud account in subfolders, this structure will NOT be transferred to Eliona. The machines themselves will, however, appear in Eliona
{% endhint %}

### .json template

```json
{
    "id": 1,
    "username": "Enter your username here",
    "password": "Enter your password here",
    "apiKey": "Enter your API key here",
    "url": "https://coffeecloud.scanomat.com",
    "enable": true,
    "refreshInterval": 113600,
    "requestTimeout": 120,
    "active" false,
    "projectIDs": [
        "10"
    ]
}
```

### Generate API key

<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>

To generate the API key, log in to your CoffeeCloud account with your credentials. The API key can be generated under “Settings”.

## Generated asset types

3 asset types are created:

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

### CoffeeCloud

A root directory for coffee machines

### CoffeeCloud group

A group for coffee machines.

### CoffeeCloud coffee machine

An asset type for a single coffee machine, including various attributes.

## CoffeeCloud dashboard

The CoffeeCloud app comes with a ↗[ dashboard template](https://docs.buildings.ability.abb/collection/english-v14/documentation/dashboard/import-export-dashboard-templates).

### Description

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

The CoffeeCloud dashboard shows a list of connected CoffeeCloud coffee machines and associated status messages.

### Enable dashboard template

See ↗[ here](https://docs.buildings.ability.abb/collection/english-v14/documentation/dashboard/import-export-dashboard-templates)

## Known limitations

### Maximum update interval

The API is limited to around 20 to 30 requests per hour. If more requests are made within a period of time, it may happen that no data is sent.

We recommend making about 1 request per hour.

### Only the root folder is taken into account

If you have placed coffee machines in your CoffeeCloud account in subfolders, these subfolders will NOT be transferred to Eliona!

The machines themselves will, however, appear in Eliona.

You can place the machines in Eliona ↗[ manually in folders](https://docs.buildings.ability.abb/collection/english-v14/documentation/assets/structure-assets)if desired.