# Signify

### Übersicht

Dieses Handbuch bietet Anweisungen zur Konfiguration, Installation und Nutzung der Signify-App zur Verwaltung von Ressourcen und zur Synchronisierung von Daten zwischen Eliona und Signify-Diensten.

### Installation

Installieren Sie die Signify-App über den Eliona App Store.

### Konfiguration

Die Signify-App erfordert eine Konfiguration über die Eliona-Einstellungen. Im Folgenden sind die allgemeinen Schritte und Details aufgeführt, die zur effektiven Konfiguration der App erforderlich sind.

#### Registrierung der App im Signify-Dienst

Erstellen Sie Anmeldeinformationen im Signify-Dienst, um die Signify-Dienste von Eliona aus zu verbinden. Alle erforderlichen Anmeldeinformationen sind unten im Konfigurationsabschnitt aufgeführt.

Gehen Sie zur [Interact Lighting-Website](https://www.developer.interact-lighting.com/) und erstellen Sie einen Eliona-Client, um den Schlüssel und das Geheimnis der App zu erhalten, die zum Zugriff auf die API benötigt werden. Zusätzlich müssen Sie den Dienst identifizieren, den Sie verbinden möchten, da diese Informationen von Interact Lighting bereitgestellt werden.

#### Konfiguration der Signify-App

Konfigurationen können in Eliona unter `Apps > Signify > Settings` erstellt werden, wodurch das [Generic Frontend](https://doc.eliona.io/collection/v/eliona-english/manuals/settings/apps) der App geöffnet wird. Hier können Sie den entsprechenden Endpunkt mit der POST-Methode verwenden. Jede Konfiguration erfordert die folgenden Daten:

| Attribut          | Beschreibung                                                                         |
| ----------------- | ------------------------------------------------------------------------------------ |
| `baseURL`         | URL der Signify [API-Dienste](https://www.developer.interact-lighting.com/api-docs). |
| `app_key`         | Der App-Schlüssel zur Identifizierung der Eliona-App.                                |
| `app_secret`      | Das App-Geheimnis zur Authentifizierung der Eliona-App.                              |
| `service`         | Der Dienstname zur Identifizierung des Interact Lighting-Dienstes.                   |
| `service_id`      | Die Dienst-ID zur Identifizierung des Interact Lighting-Dienstes.                    |
| `service_secret`  | Das Dienstgeheimnis zur Authentifizierung des Interact Lighting-Dienstes.            |
| `assetFilter`     | Filterung von Assets während der kontinuierlichen Asset-Erstellung.                  |
| `enable`          | Flag zum Aktivieren oder Deaktivieren dieser Konfiguration.                          |
| `refreshInterval` | Intervall in Sekunden für die Datensynchronisierung.                                 |
| `requestTimeout`  | API-Abfragezeitüberschreitung in Sekunden.                                           |
| `projectIDs`      | Liste der Eliona-Projekt-IDs zur Datenerfassung.                                     |

Beispiel-Konfigurations-JSON:

```json
{
  "baseUrl": "https://api.interact-lighting.com/",
  "service": "officeCloud",
  "serviceId": "secret@signify.com",
  "serviceSecret": "secret",
  "appKey": "foo",
  "appSecret": "secret",
  "enable": true,
  "refreshInterval": 120,
  "requestTimeout": 120,
  "active": true,
  "projectIDs": [
    "10"
  ]
}
```

### Kontinuierliche Asset-Erstellung

Nach der Konfiguration startet die App die kontinuierliche Asset-Erstellung (CAC). Entdeckte Ressourcen werden automatisch als Assets in Eliona erstellt, und Benutzer werden über das Benachrichtigungssystem von Eliona benachrichtigt.

Die erstellte Asset-Struktur spiegelt die Gruppierung von Spaces in der Interact Lighting-Umgebung wider. Die App unterstützt Signify Space für Luftfeuchtigkeit, Belegung, Personenzählung und Temperatur.

### Zusätzliche Funktionen

#### Dashboard-Vorlagen

Die App bietet vordefinierte Dashboards, die die wichtigsten Informationen übersichtlich anzeigen. Es gibt ein Dashboard für jeden Typ von Signify Spaces, um alle Spaces zu gruppieren. Sie können ein solches Dashboard unter `Dashboards > Copy Dashboard > From App > Signify ...` erstellen:

* `Signify People Count`
* `Signify Occupancy`
* `Signify Temperature`
* `Signify Humidity`