Signify

The Signify app provides integration and synchronization between BuildingPro Suites and Signify services.

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

{
  "baseUrl": "[https://api.interact-lighting.com/](https://api.interact-lighting.com/)",
  "service": "officeCloud",
  "serviceId": "[e-mail]",
  "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