# Signify

## Signify

### Übersicht

Dieses Handbuch enthält Anweisungen zur Konfiguration, Installation und Verwendung der Signify-App zur Verwaltung von Ressourcen und zur Synchronisierung von Daten zwischen BuildingPro Suites und Signify-Diensten.

### Installation

Installieren Sie die Signify-App über den BuildingPro Suites App Store.

### Konfiguration

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

#### Registrierung der App beim Signify-Dienst

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

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

#### Konfigurieren der Signify-App

Konfigurationen können in BuildingPro Suites unter `Apps > Signify > Einstellungen`, wodurch sich [Generic Frontend](https://doc.eliona.io/collection/v/eliona-english/manuals/settings/apps) der App öffnet. 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 BuildingPro Suites-App.                    |
| `app_secret`      | Das App-Geheimnis zur Authentifizierung der BuildingPro Suites-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.                                           |
| `tenantIDs`       | Liste der BuildingPro Suites-Projekt-IDs zur Datenerfassung.                         |

Beispiel-Konfigurations-JSON:

```json
{
  "baseUrl": "[https://api.interact-lighting.com/](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,
  "tenantIDs": [
    "10"
  ]
}
```

### Kontinuierliche Asset-Erstellung

Nach der Konfiguration startet die App die kontinuierliche Asset-Erstellung (CAC). Entdeckte Ressourcen werden automatisch als Assets in BuildingPro Suites erstellt, und Benutzer werden über das Benachrichtigungssystem von BuildingPro Suites 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 > Dashboard kopieren > Aus App > Signify ...` erstellen:

* `Signify Personenzählung`
* `Signify Belegung`
* `Signify Temperatur`
* `Signify Luftfeuchtigkeit`