# Signify

## Signify

### Overview

This manual provides instructions for the configuration, installation, and use of the Signify app for managing resources and synchronizing data between BuildingPro Suites and Signify services.

### Installation

Install the Signify app via the BuildingPro Suites App Store.

### Konfiguration

The Signify app requires configuration via the BuildingPro Suites settings. The following are the general steps and details required to effectively configure the app.

#### Registering the App with the Signify Service

Create credentials in the Signify service to connect the Signify services from BuildingPro Suites. All required credentials are listed below in the configuration section.

Go to the [Interact Lighting website](https://www.developer.interact-lighting.com/) and create an BuildingPro Suites client to obtain the app's key and secret, which are needed to access the API. In addition, you must identify the service you want to connect, as this information is provided by Interact Lighting.

#### Configuring the Signify App

Configurations can be created in BuildingPro Suites under `Apps > Signify > Settings`, which opens the [Generic Frontend](https://doc.eliona.io/collection/v/eliona-english/manuals/settings/apps) of the app. Here you can use the corresponding endpoint with the POST method. Each configuration requires the following data:

| 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"
  ]
}
```

### Continuous Asset Creation

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.

### Additional Functions

#### Dashboard Templates

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`