# Thingdust

Thingdust ist ein Unternehmen, das eine sensorbasierte Lösung zur Messung der Auslastung von Büroflächen anbietet. Die Sensoren messen Temperatur, Luftfeuchtigkeit und Belegung von Räumen (z. B. Arbeitsplätze, Räume) in Echtzeit. Die BuildingPro Suites App für Thingdust Spaces ermöglicht den Zugriff auf diese Daten und deren Anzeige innerhalb von BuildingPro Suites.

### Installation

Die Thingdust-App wird über den App Store in BuildingPro Suites installiert.

### Assets

Die Thingdust-App erstellt automatisch alle erforderlichen Asset-Vorlagen und Assets (CAC), die über die konfigurierten Endpunkte erreichbar sind. Die folgenden Asset-Vorlagen werden erstellt:

* **Thingdust Space**: Ein Thingdust-Raum.

Die folgenden Attribute sind definiert:

|                    |                  |
| ------------------ | ---------------- |
| `Belegung`         | Belegung         |
| `Temperatur`       | Temperatur       |
| `Luftfeuchtigkeit` | Luftfeuchtigkeit |

### Dashboards

Die Thingdust-App bietet ein Dashboard mit allen automatisch erstellten Räumen. Dieses kann automatisch über das Frontend von BuildingPro Suites erstellt werden, indem `Dashboard kopieren > Thingdust` und dann nach Wunsch angepasst werden.

### Konfiguration

{% hint style="info" %}
Weitere Informationen zur Konfiguration von Apps finden Sie [↗ hier](https://doc.eliona.io/collection/dokumentation/einstellungen/apps).
{% endhint %}

Die Thingdust-App wird durch die Definition eines oder mehrerer API-Endpunkte konfiguriert. Jeder Endpunkt erfordert die folgenden Daten.

| Attributname      | Beschreibung                                                                                       |
| ----------------- | -------------------------------------------------------------------------------------------------- |
| `apiEndpoint`     | Adresse des Endpunkts                                                                              |
| `apiKey`          | Schlüssel für den Endpunkt                                                                         |
| `enable`          | Kennzeichen zum Aktivieren oder Deaktivieren des Endpunkts                                         |
| `refreshInterval` | Intervall in Sekunden für die Datenerfassung vom Endpunkt                                          |
| `requestTimeout`  | Zeitüberschreitung in Sekunden für den Endpunkt                                                    |
| `active`          | Wird gesetzt auf `wahr` durch die App, wenn sie läuft, und auf `falsch` wenn die App gestoppt wird |
| `projIds`         | Liste der Mandanten-IDs, für die Assets automatisch erstellt werden sollen (CAC)                   |

Die Konfiguration erfolgt mithilfe einer entsprechenden JSON-Struktur. Die folgende JSON-Struktur kann als Beispiel verwendet werden, um einen Endpunkt zu definieren.

```json
{
  "configId": 12345,
  "apiEndpoint": "[https://foo.bar.thingdust.io/api/](https://foo.bar.thingdust.io/api/)",
  "apiKey": "FOOBARFOOBAR",
  "enable": true,
  "refreshInterval": 60,
  "requestTimeout": 120,
  "projIds": ["99"]
}
```

Endpunkte können in BuildingPro Suites unter `Apps > Thingdust > Einstellung` mithilfe dieser Struktur erstellt werden. Wählen Sie dazu den `/configs` Endpunkt mit der `PUT` Methode.