# BuildingPro Suites-Module für Niagara

## Funktionalität

Das Modul ermöglicht die Übertragung von Daten von Niagara-Komponenten zu BuildingPro Suites-Objekten. Es sendet den Wert eines konfigurierbaren Slots (Standard: `out`) und, falls verfügbar, dessen Status an BuildingPro Suites. Alarme können ebenfalls direkt an BuildingPro Suites weitergeleitet werden. Optional kann das Modul Objekte in BuildingPro Suites automatisch erstellen und verknüpfen sowie ihnen die entsprechenden Objektarten zuweisen.

Umgekehrt kann das Modul Daten von BuildingPro Suites empfangen und in einen konfigurierbaren Slot (Standard: `set`) einer Niagara-Komponente schreiben. Alarmquittierungen von BuildingPro Suites werden unterstützt, sodass Statusaktualisierungen innerhalb der Niagara-Alarmkonsole synchronisiert werden können.

#### Kommunikation

Die Kommunikation zwischen Niagara und BuildingPro Suites verwendet die BuildingPro Suites REST API und WebSockets, die von BuildingPro Suites bereitgestellt werden, wobei die Daten im JSON-Format übertragen werden. Die gesamte Kommunikation ist über HTTPS verschlüsselt.

***

## Schnellstartanleitung

#### Voraussetzungen

* Zugriff auf eine BuildingPro Suites-Instanz (Benutzername und Passwort)
* Anmeldedaten für die BuildingPro Suites API (URL und Token mit Lese-Schreib-Berechtigung)
* Zugriff auf eine Niagara-Station (siehe Kompatibilität)

#### Installation

Um das BuildingPro Suites-Modul zu installieren, kopieren Sie `eliona-rt.jar` und `eliona-wb.jar` in den `modules` Ordner Ihrer lokalen Niagara-Installation oder verwenden Sie den **Software Manager** unter Platform, um das Modul zu installieren. Schließen Sie die Installation ab, indem Sie das Workplace neu starten. Sie können jetzt Komponenten in der BuildingPro Suites-Palette verwenden.

#### Konfiguration

* Öffnen Sie die **Niagara Workbench** und wählen Sie die **BuildingPro Suites-Palette**.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FkLrOhFiUpVjobcIhAJuu%2Feliona_palette.png?alt=media&#x26;token=9c47bedb-8737-41a4-b394-e45f50d4325d" alt=""><figcaption></figcaption></figure>

* Erstellen Sie ein **BuildingPro Suites Network** mit einem **BuildingPro Suites Device** indem Sie es per Drag-and-Drop aus der Palette unter **Configuration > Drivers** in die Station ziehen.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2Fjb1Q6ZgvYJLtrTg8szi4%2Feliona_network.png?alt=media&#x26;token=4fffacc3-c05d-4115-a58b-65bb28fcaa1b" alt=""><figcaption></figcaption></figure>

* Öffnen Sie die **BuildingPro Suites Device** und konfigurieren Sie die BuildingPro Suites API mit URL und Token. Geben Sie die BuildingPro Suites Tenant ID an, mit der Sie sich verbinden möchten.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F7bvp4uxcFqcfwYvCJcQV%2Feliona_api.png?alt=media&#x26;token=df7363e9-5efe-4b16-a5b3-6c63acdc2d0a" alt=""><figcaption></figcaption></figure>

* Nach der Konfiguration sollte der Status des Geräts `OK`sein. Wenn dies der Fall ist, speichern Sie die Station.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FONKb1ZWLo3qGcgCpsl6J%2Feliona_device_ok.png?alt=media&#x26;token=aac7183a-5f53-4537-b7ec-dc6f1ab2bf4c" alt=""><figcaption></figcaption></figure>

#### Statusinformationen in BuildingPro Suites anzeigen

* Nach der Konfiguration erstellt das Modul einen **Niagara Station Asset**, der standardmäßig alle 5 Minuten automatisch technische Informationen abruft.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2Fl9APSXu0eRqF0sy68Af4%2Fniagara_station_asset.png?alt=media&#x26;token=beb001a1-4274-4e9d-b58f-816c6ba42f17" alt=""><figcaption></figcaption></figure>

* Dieses Objekt überwacht außerdem den Status der Station als Live-Signal: `Aktiv`, wenn die Station normal funktioniert, und `Inaktiv`, wenn nach 10 Minuten keine Aktivität erkannt wird. Dieser Status kann über **Validity Monitoring**.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FawaLlJwQJHfoR07N4pJD%2Fstation_active_state.png?alt=media&#x26;token=fa88c1b2-aed6-42a3-b3e0-ca312be66f84" alt=""><figcaption></figcaption></figure>

#### Daten an BuildingPro Suites senden

* Wählen Sie den Niagara-Datenpunkt aus, den Sie mit BuildingPro Suites synchronisieren möchten, und fügen Sie eine **BuildingPro Suites Extension** hinzu (z. B. `ElionaCovExtension`), indem Sie sie per Drag-and-Drop aus der **BuildingPro Suites-Palette**ziehen. Öffnen Sie die Erweiterung und aktivieren Sie sie.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FZ1sTYBEvD9z2VmsDF8ne%2Feliona_extension.png?alt=media&#x26;token=6a14016a-d1b4-42ca-8214-da1fc86a9d27" alt=""><figcaption></figcaption></figure>

* Sobald die Erweiterung aktiviert ist, erstellt sie automatisch ein Objekt in Niagara und in BuildingPro Suites. Öffnen Sie das **Asset Mapping** in der Erweiterung und klicken Sie auf den **Asset** link. Dadurch gelangen Sie zu dem in Niagara erstellten Objekt.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F6ROie7wQXuXnAiMuMgPX%2Fasset_mapping.png?alt=media&#x26;token=30418249-3db7-428d-af13-be590bc3e0a5" alt=""><figcaption></figcaption></figure>

* Im Niagara-Objekt finden Sie alle Informationen zum Objekt und die **Asset ID** des BuildingPro Suites-Objekts, das erstellt wurde. Sie können den **Asset Hyperlink** verwenden, um das Objekt in BuildingPro Suites zu öffnen.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FEjVRuSOIw5ToIiaFq4Xc%2Fasset.png?alt=media&#x26;token=6162c5cb-be16-496d-a8a2-f797096a2afd" alt=""><figcaption></figcaption></figure>

* Wenn Sie das BuildingPro Suites-Objekt öffnen, wird der aktuelle Wert des Datenpunkts dem **Wert** Attribut in BuildingPro Suites zugewiesen. Von diesem Zeitpunkt an wird jede Änderung des Datenpunkts an dieses Attribut gesendet. Sie können dies überwachen, indem Sie den Zeitstempel **Last Synchronized** im Niagara-Objektansicht prüfen.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F5NJZBzNWOWk9DTrUZWlT%2Feliona_asset.png?alt=media&#x26;token=0df754d3-9be4-4a45-bbdc-8fced8dd15d9" alt=""><figcaption></figcaption></figure>

#### Daten von BuildingPro Suites empfangen

* Nachdem Sie die Objekte in Niagara und BuildingPro Suites erstellt und zugewiesen haben, können Sie Werte von BuildingPro Suites an den Niagara-Datenpunkt senden. Fügen Sie dazu einen neuen Wert zum **Setpoint** Attribut hinzu.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FGGFslA9HKl3Y8LDHsvMT%2Feliona_setpoint.png?alt=media&#x26;token=eff081f0-38f6-4b6e-89fa-c5bc41424f9e" alt=""><figcaption></figcaption></figure>

* Der Wert wird standardmäßig an den `Fallback` Slot in Niagara über die **Set** Aktion gesendet.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F3qxy50ptx6gxutWqBCRf%2Ffallback_slot.png?alt=media&#x26;token=b5baecd6-57c4-45e1-bd12-b13d52b7f825" alt=""><figcaption></figcaption></figure>

#### Alarme an BuildingPro Suites senden

* Um Alarme zu synchronisieren, routen Sie zuerst die gewünschten Alarmklassen. Fügen Sie dazu den **BuildingPro Suites Recipient** in den **Alarm Service** hinzu, indem Sie ihn aus der **BuildingPro Suites-Palette**.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FhXGpy5kGFpE8No1IsHqd%2Feliona_recipient.png?alt=media&#x26;token=99133ac7-86c8-46a7-9875-8c381cb6dd38" alt=""><figcaption></figcaption></figure>

* Jetzt verknüpfen Sie die Alarmklasse mit dem **Route Alarm** Slot.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FfYOwoPhe15X7bBdCo2bJ%2Froute_alarm.png?alt=media&#x26;token=7d50f1c0-4873-402a-9654-de388449ffba" alt=""><figcaption></figcaption></figure>

* Sobald die Verknüpfung hergestellt ist, werden alle Alarme für die angegebene Alarmklasse an BuildingPro Suites gesendet. Sie können dies testen, indem Sie eine **Niagara Alarm Extension** hinzu (z. B. `OutOfRangeAlarmExtension`) aus der Alarm-Palette ziehen und unter dem Niagara-Datenpunkt platzieren, den Sie überwachen möchten.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F61wp86ZI9ZW3fYJzgUdI%2Fniagara_alarm_extension.png?alt=media&#x26;token=ddd79eff-0f8e-4967-b8cc-9bdd57f34f81" alt=""><figcaption></figcaption></figure>

* Konfigurieren Sie die Erweiterung, und wenn der erste Alarm ausgelöst wird, erstellt die **BuildingPro Suites Recipient** ein **Asset Mapping** ähnliches wie das oben unter der Alarm-Erweiterung erwähnte. Wenn das Objekt nicht existiert, wird es automatisch sowohl in Niagara als auch in BuildingPro Suites erstellt.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FmpUhFyYVo7QzSUL673wQ%2Falarm_asset_mapping.png?alt=media&#x26;token=ed98836b-d075-42dc-8080-aa295c571ff5" alt=""><figcaption></figcaption></figure>

* Nun ist der Alarm auch in BuildingPro Suites zu finden. Die Quittierung des Alarms kann entweder in BuildingPro Suites oder in Niagara erfolgen, und der Status wird zwischen beiden synchronisiert.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2Fkfuf2n44xhPYFsZuvq6e%2Falarm_acknowledge.png?alt=media&#x26;token=f40c6cfb-f7c5-4e4c-9fb7-a9df629ff9fd" alt=""><figcaption></figcaption></figure>

#### Objektübersicht

* Alle Objekte, die BuildingPro Suites zugewiesen sind, finden Sie in der **Assets** Komponente des **BuildingPro Suites Device**.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FCY38IBivVtUkrxAiFDoL%2Fassets.png?alt=media&#x26;token=045ae5bb-6a00-46b7-ac7e-9c66d211f018" alt=""><figcaption></figcaption></figure>

* Hier können Sie alle Objektinformationen überwachen, Objekte neu zuweisen und bei Bedarf alle Objekte oder einzelne Objekte mit BuildingPro Suites erneut synchronisieren.

#### Anpassen des n:1-Mappings

Sie können komplexere Beziehungen zwischen Niagara-Datenpunkten und BuildingPro Suites-Objekten einrichten. Ein häufiges Szenario ist die Zuordnung mehrerer Datenpunkte zu einem einzelnen Objekt mit unterschiedlichen Attributen in BuildingPro Suites.

* Wählen Sie einen weiteren Niagara-Datenpunkt aus oder fügen Sie einen hinzu, den Sie mit BuildingPro Suites synchronisieren möchten. Fügen Sie dann eine **BuildingPro Suites extension** hinzu (z. B. `ElionaCovExtension`), indem Sie sie per Drag-and-Drop aus der **BuildingPro Suites-Palette**.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FIamK2zOAY8RVOlyOgMQU%2Fanother_eliona_extension.png?alt=media&#x26;token=365a2717-2239-420c-ba0c-82558be3f395" alt=""><figcaption></figcaption></figure>

* hinzu. Öffnen Sie die Erweiterung und navigieren Sie zu **Asset Mapping**. Hier können Sie die Standard- **Global Asset ID** mit einer bereits vorhandenen ID überschreiben. Auf diese Weise leiten Sie verschiedene Objektzuordnungen in Niagara zum selben Objekt in BuildingPro Suites, zum Beispiel durch die Verwendung des vorhandenen `/BuildingPro Suites/NumericWriteable` als gemeinsamen **Global Asset ID**.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FWIE9JJDj0cXGmz49vYHL%2Fasset_mapping.png?alt=media&#x26;token=f17e17fe-77c5-47f6-9645-f8c871f35d53" alt=""><figcaption></figcaption></figure>

* Konfigurieren Sie unterschiedliche Attributnamen für das Senden und Empfangen von Daten zwischen Niagara und BuildingPro Suites. In diesem Fall wird der Standardname `Wert` zu `Another Value`.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FGZdeMwVQjD6klCkllWW5%2Fanother_data_attributes.png?alt=media&#x26;token=7c145612-57d1-4a16-8ce4-4a82517ab3ef" alt=""><figcaption></figcaption></figure>

* Wenn Sie die Erweiterung aktivieren, erkennt das Mapping automatisch das vorhandene Objekt in Niagara und verknüpft sich mit ihm. Wenn **Enable Upserts** in **BuildingPro Suites Assets**aktiviert ist, werden alle neuen Attribute (z. B. `Another Value`) automatisch im entsprechenden Objekttyp in BuildingPro Suites erstellt.
* Wenn Sie nun das BuildingPro Suites-Objekt öffnen, werden die aktuellen Werte der beiden Datenpunkte ihren jeweiligen Attributen in BuildingPro Suites zugewiesen. Von diesem Zeitpunkt an werden alle Änderungen an den Datenpunkten an diese Attribute gesendet und von ihnen empfangen.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F1dgF2v0EnMAQxlepwsUn%2Fshared_eliona_asset.png?alt=media&#x26;token=28e5c174-2e6d-41d8-80eb-8cf2f65f7ccc" alt=""><figcaption></figcaption></figure>

#### Anpassen des 1:n-Mappings

In diesem Szenario wird ein einzelner Niagara-Datenpunkt mehreren BuildingPro Suites-Objekten zugewiesen, optional mit unterschiedlichen Attributen.

* Für einen vorhandenen Niagara-Datenpunkt fügen Sie ein weiteres **Extension Asset Mapping** zum aktuellen **BuildingPro Suites extension** hinzu (z. B. `ElionaCovExtension`), indem Sie sie per Drag-and-Drop aus der **BuildingPro Suites-Palette**.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F1eWTqGjeLoFOFF8SpXAO%2Fmultiple_asset_mappings.png?alt=media&#x26;token=681826dd-e54f-436b-b12d-f20124878a4d" alt=""><figcaption></figcaption></figure>

* Im neuen Asset Mapping überschreiben Sie den Standard- **Global Asset ID**. Setzen Sie ihn beispielsweise auf `/BuildingPro Suites/NumericWriteableCopy` anstatt auf `/BuildingPro Suites/NumericWriteable`. Sobald Sie das Asset Mapping speichern, wird das neue Objekt automatisch in Niagara und in BuildingPro Suites erstellt (wenn **Enable Upserts** aktiviert ist). Von diesem Zeitpunkt an werden alle Änderungen am Datenpunkt an beide Objekte in BuildingPro Suites gesendet und von ihnen empfangen.
* Für den Empfang von Daten von BuildingPro Suites möchten Sie möglicherweise einen anderen Schreibslot verwenden. Sie könnten beispielsweise den Standard- `Set` (Fallback)-Slot verwenden und zusätzlich den `Override` Slot setzen. Dies erreichen Sie, indem Sie den Schreibslot mit dem Attribut des Objekts im **Asset Mapping**.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FEh0d7pZgEyDEGKKuyP0x%2Foverride_data_attributes.png?alt=media&#x26;token=d3712937-723c-4098-b1af-bba5742d1a7f" alt=""><figcaption></figcaption></figure>

* Nun können Sie in BuildingPro Suites einen Override-Wert setzen, der den entsprechenden Datenpunkt in Niagara aktualisiert.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FkKKETbMTbGFYGNT9sJ8e%2Feliona_asset_override.png?alt=media&#x26;token=bbebc54d-8b9a-461b-9058-3c5ce7bae2b2" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FTMawodv435fkRqvtPNCB%2Fwriteable_overridden.png?alt=media&#x26;token=ac7624bf-148b-4a8b-8267-4f090cf1a247" alt=""><figcaption></figcaption></figure>

***

## Komponentenübersicht

#### BuildingPro Suites Network

Die **BuildingPro Suites Network** ist die Root-Komponente, die alle **BuildingPro Suites Devices** innerhalb einer Niagara-Station gruppiert.

#### BuildingPro Suites Device

Jedes **BuildingPro Suites Device** verbindet eine BuildingPro Suites-Instanz und einen bestimmten Tenant innerhalb dieser Instanz. Dieses Gerät teilt seine BuildingPro Suites-Verbindung mit allen untergeordneten Komponenten, wie dem **BuildingPro Suites Sender**, **BuildingPro Suites Receiver**, **BuildingPro Suites Assets** Container und dem **BuildingPro Suites Alarm Acknowledger**. Der **BuildingPro Suites Device** wird auch vom **BuildingPro Suites Recipient**.

#### BuildingPro Suites Sender

Die **BuildingPro Suites Sender** ist für die Übertragung von Werten von Niagara-Datenpunkten an BuildingPro Suites verantwortlich. Er ist ein untergeordnetes Element des **BuildingPro Suites Device** und verwendet die zugewiesene BuildingPro Suites-Instanz und den Tenant. Der Sender kann mit einem Wertepuffer konfiguriert werden, um Szenarien zu behandeln, in denen die Verbindung zu BuildingPro Suites vorübergehend nicht verfügbar ist.

#### BuildingPro Suites Receiver

Die **BuildingPro Suites Receiver** empfängt Daten von BuildingPro Suites und schreibt sie in Niagara-Datenpunkte. Er ist ein untergeordnetes Element des **BuildingPro Suites Device** und verwendet dieselbe BuildingPro Suites-Instanz und denselben Tenant. Der Receiver ermöglicht die Konfiguration des Schreibslots des Datenpunkts und gibt den Niagara-Benutzernamen für den Vorgang an.

#### BuildingPro Suites Assets

Die **BuildingPro Suites Assets** Container gruppiert und synchronisiert Objekte mit BuildingPro Suites. Er ist ein untergeordnetes Element des **BuildingPro Suites Device** und verwendet die verbundene BuildingPro Suites-Instanz und den Tenant. Dieser Container kann während der Synchronisation automatisch Objekte in BuildingPro Suites erstellen oder aktualisieren. Er organisiert außerdem alle Objektkomponenten, die echten Objekten in BuildingPro Suites entsprechen.

#### BuildingPro Suites Asset

Eine **BuildingPro Suites Asset** Komponente repräsentiert ein einzelnes Objekt in BuildingPro Suites. Diese Komponente ist ein untergeordnetes Element des **BuildingPro Suites Assets** Containers und enthält eine eindeutige Global Asset ID. Während der Synchronisation bestimmen diese Global Asset ID und der BuildingPro Suites Tenant (vom übergeordneten **BuildingPro Suites Device**) die Asset ID in BuildingPro Suites, die dann in der Objektkomponente gespeichert wird. Attribute wie Objekttyp, Name und Beschreibung werden ebenfalls synchronisiert. Wenn die automatische Erstellung oder Aktualisierung im **BuildingPro Suites Assets** Container aktiviert ist, werden Objekte in BuildingPro Suites erstellt oder aktualisiert; andernfalls verweist die Komponente auf ein vorhandenes Objekt anhand seiner ID.

#### BuildingPro Suites Extension

Die **BuildingPro Suites Extension** überwacht Änderungen an den Werten von Niagara-Datenpunkten und löst die Datenübertragung an BuildingPro Suites über die **BuildingPro Suites Sender**aus. Diese Erweiterung wird an einen Niagara-Datenpunkt angehängt und verweist auf ein **BuildingPro Suites Device** und verwendet die verbundene BuildingPro Suites-Instanz und den Tenant.

#### BuildingPro Suites Asset Mapping

Die **BuildingPro Suites Asset Mapping** erstellt eine Verknüpfung zwischen Niagara-Datenpunkten und Attributen eines Objekts in BuildingPro Suites. Es ist ein untergeordnetes Element entweder eines **BuildingPro Suites Extension** oder eines **Alarm Extension** in Niagara, die selbst an Niagara-Datenpunkte angehängt sind. Das Mapping definiert eine Global Asset ID, die es ermöglicht, die entsprechende **BuildingPro Suites Asset** Komponente in Niagara zu referenzieren und zu erstellen. Diese Komponente wiederum verknüpft sich mit dem realen Objekt in BuildingPro Suites, indem sie die Asset ID nach der Synchronisation speichert.

#### BuildingPro Suites Alarm Acknowledger

Die **BuildingPro Suites Alarm Acknowledger** empfängt Alarmquittierungen von BuildingPro Suites und quittiert die entsprechenden Alarme in Niagara. Es ist ein untergeordnetes Element des **BuildingPro Suites Device** und verwendet die verbundene BuildingPro Suites-Instanz und den Tenant. Der Acknowledger ermöglicht die Konfiguration des Niagara-Benutzernamens für den Quittierungsvorgang.

#### BuildingPro Suites Recipient

Die **BuildingPro Suites Recipient** leitet Alarme von Alarmklassen in Niagara an BuildingPro Suites weiter. Es verweist auf ein **BuildingPro Suites Device** und verwendet die verbundene BuildingPro Suites-Instanz und den Tenant. Der Recipient kann mit einem Alarmpuffer konfiguriert werden, um Szenarien zu behandeln, in denen die Verbindung zu BuildingPro Suites vorübergehend nicht verfügbar ist.

#### BuildingPro Suites API Client

Die **BuildingPro Suites API Client** ermöglicht die direkte Kommunikation mit BuildingPro Suites über APIv2 (siehe [api.eliona.io](https://api.eliona.io)). Er wird typischerweise verwendet, um eine Vielzahl von Vorgängen auszuführen, wie das Lesen, Erstellen, Aktualisieren und Löschen von Objekten, Alarmen und Konfigurationen in BuildingPro Suites. Der Client verwaltet die Authentifizierungs- und Verbindungseinstellungen und dient als zentrale Schnittstelle für alle API-gesteuerten Interaktionen, um eine zuverlässige und sichere Integration zwischen Niagara und BuildingPro Suites zu gewährleisten.

***

## Komponentenkonfiguration

#### BuildingPro Suites Network

Sie können den **BuildingPro Suites Network** als Kind des **Drivers** Containers in einer Niagara-Station hinzufügen. Dies kann durch Ziehen aus dem **BuildingPro Suites-Palette** oder durch Öffnen des **Driver Manager** und Klicken auf die **New** Schaltfläche erfolgen. Beachten Sie, dass pro Station nur ein **BuildingPro Suites Network** zulässig ist.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FgMgVSXEmN969iLtEgtKN%2Feliona_network_settings.png?alt=media&#x26;token=b712b899-18f6-4e35-b4d3-5554006d27fa" alt=""><figcaption></figcaption></figure>

#### BuildingPro Suites Device

Die **BuildingPro Suites Device** kann als Kind des **BuildingPro Suites Network**hinzugefügt werden. Sie können es hinzufügen, indem Sie es aus dem **BuildingPro Suites-Palette**ziehen. Mehrere **BuildingPro Suites Devices** können erstellt werden, um verschiedene BuildingPro Suites-Instanzen oder Tenants darzustellen.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FsL0DI3LeNu4BMjVKvIum%2Feliona_device.png?alt=media&#x26;token=11ca115b-029a-4bbe-8487-2e7a1f025b2f" alt=""><figcaption></figcaption></figure>

| Einstellung           | Beschreibung                                                         |
| --------------------- | -------------------------------------------------------------------- |
| `Aktiviert`           | Aktiviert oder deaktiviert das BuildingPro Suites Device             |
| `APIv2-URL`           | URL für die Verbindung zur BuildingPro Suites APIv2-Instanz          |
| `APIv2-Token`         | Autorisierungstoken für den Zugriff auf die BuildingPro Suites APIv2 |
| `Tenant ID`           | Tenant ID für das Asset-Mapping und die Erstellung                   |
| `Verbindungs-Timeout` | Maximale Zeit in Sekunden, bevor ein Verbindungsversuch abläuft      |

**Aktiviert**

> Aktiviert oder deaktiviert das BuildingPro Suites Device. Wenn aktiviert, sind alle zugehörigen Komponenten (z. B. Sender, Receiver) betriebsbereit.

**APIv2-URL**

> Gibt die URL der BuildingPro Suites APIv2-Instanz an, mit der eine Verbindung hergestellt werden soll (z. B., `https://my.eliona.io/api/v2`). Diese sollte von Ihrem BuildingPro Suites-Administrator bereitgestellt werden.

**APIv2-Token**

> Das für den Zugriff auf die BuildingPro Suites APIv2 erforderliche Autorisierungstoken. Stellen Sie sicher, dass dieses Token sowohl Lese- als auch Schreibberechtigungen hat, wie erforderlich. Es sollte von Ihrem BuildingPro Suites-Administrator bereitgestellt werden.

**Tenant ID**

> Definiert die BuildingPro Suites Tenant ID, die für die Referenzierung von Objekten verwendet wird. Diese ID muss mit der Tenant-Konfiguration in BuildingPro Suites übereinstimmen.

**Verbindungs-Timeout**

> Legt die maximale Dauer in Sekunden für einen Verbindungsversuch zu BuildingPro Suites fest. Wenn die Netzwerklatenz hoch ist, sollten Sie dieses Timeout erhöhen. Ein typischer Wert liegt bei etwa 5 Sekunden.

#### BuildingPro Suites Sender

Die **BuildingPro Suites Sender** wird automatisch als Kind des **BuildingPro Suites Device**.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F4bJPob2GBSdw56lBfQyD%2Feliona_sender.png?alt=media&#x26;token=87426d9c-751a-44f2-b652-1a5d817f883a" alt=""><figcaption></figcaption></figure>

| Feld                                       | Beschreibung                                                              |
| ------------------------------------------ | ------------------------------------------------------------------------- |
| `Aktiviert`                                | Aktiviert oder deaktiviert die Datenübertragung                           |
| `Größe des Wertepuffers`                   | Legt die maximale Größe des Nachrichtenpuffers fest                       |
| `Ringpuffer`                               | Bestimmt das Pufferverhalten, wenn er voll ist                            |
| `Datenbankverbindung für den Puffer`       | Konfiguriert eine externe Datenbankverbindung für das Puffern             |
| `Intervall für Sammelsenden`               | Intervall zum Gruppieren von Werten für das Sammelsenden                  |
| `Limit für Sammelsenden`                   | Obergrenze für das Gruppieren von Werten für das Sammelsenden             |
| `Letzter Versand` (Info)                   | Zeitstempel der letzten erfolgreichen Datenübertragung                    |
| `Anzahl der zu sendenden Variablen` (Info) | Anzahl der Datenpunkte, die derzeit an BuildingPro Suites gesendet werden |
| `Prognose Nachrichten pro Stunde` (Info)   | Geschätzte Anzahl der pro Stunde gesendeten Nachrichten                   |
| `Prognose Bytes pro Nachricht` (Info)      | Durchschnittliche Größe jeder Nachricht in Bytes                          |
| `Wertepuffer belegt` (Info)                | Aktuelle Anzahl der im Puffer gespeicherten Nachrichten                   |
| `Letzte Sendemenge`                        | Anzahl der Werte, die im letzten Sammelvorgang gesendet wurden            |
| `Aktuelle Anzahl der Sende-Threads`        | Aktuelle Anzahl gleichzeitiger Threads, die Werte senden                  |
| `Prognose aktualisieren` (Aktion)          | Aktualisiert die Prognosestatistiken manuell                              |
| `Wertepuffer leeren` (Aktion)              | Löscht alle derzeit im Puffer gespeicherten Nachrichten                   |

**Aktiviert**

> Aktiviert oder deaktiviert den BuildingPro Suites Sender. Wenn aktiviert, werden Daten an BuildingPro Suites übertragen; wenn deaktiviert, stoppt die Übertragung.

**Größe des Wertepuffers**

> Gibt die maximale Anzahl von Nachrichten an, die der Puffer aufnehmen kann. Verwenden Sie **Prognose Nachrichten pro Stunde** und **Prognose Bytes pro Nachricht** um anhand des erwarteten Datenvolumens die ideale Puffergröße zu schätzen.

**Ringpuffer**

> Bestimmt, wie der Puffer mit neuen Nachrichten umgeht, wenn er seine Kapazität erreicht:
>
> * **Aktiviert**: Überschreibt die ältesten Nachrichten durch neue, wenn der Puffer voll ist.
> * **Deaktiviert**: Nimmt keine neuen Nachrichten mehr an, sobald der Puffer voll ist.

**Datenbankverbindung für den Puffer**

> Ermöglicht die Verwendung einer externen H2-Datenbank für das Puffern. Wenn dieses Feld leer bleibt, wird standardmäßig ein interner Speicherpuffer verwendet.
>
> * **Eingebetteter Puffer-Modus**: Verwendet eine vom Treiber verwaltete Datendatei (z. B. `jdbc:h2:C:/Users/username/Niagara4.9/stations/eliona/shared/values`). In Niagara ist nur das lokale freigegebene Verzeichnis beschreibbar.
> * **Server-Puffer-Modus**: Verbindet sich mit einer vom Server verwalteten H2-Datenbank (z. B. `jdbc:h2:tcp://localhost/C:/temp/values;user=sa;password=secret`).

#### Intervall für Sammelsenden

> Definiert das Zeitintervall (in Sekunden), in dem Werte vor dem Versand in einem Sammelvorgang gruppiert werden. Das Modul sammelt Werte anhand dieses Intervalls und der eingestellten Obergrenze, bevor es sie in parallelen Threads an BuildingPro Suites sendet. Wenn dieser Wert auf `null`gesetzt ist, wird kein Sammelvorgang verwendet.

#### Limit für Sammelsenden

> Legt die maximale Anzahl von Werten fest, die in einem einzelnen Sammelvorgang gruppiert und gesendet werden können. Sobald entweder das **Bulk Send Interval** erreicht ist oder dieses Limit überschritten wird, werden die gesammelten Werte gesendet. Die korrekte Einstellung dieses Limits in Kombination mit dem Intervall trägt zu einer effizienten Datenübertragung bei minimaler Thread-Nutzung bei.

> **Hinweis:** Um die Leistung zu optimieren und übermäßige parallele Threads zu vermeiden, sollte der Wert für `Prognose Nachrichten pro Stunde` berücksichtigt werden. Das Limit kann mit der folgenden Formel berechnet werden: `Prognose Nachrichten pro Stunde × 2 / 3600 / Intervall` (wobei `×2` als Sicherheitsfaktor dient). Durch eine geeignete Anpassung dieses Limits können Sie verhindern, dass mehr als ein Thread zum Senden verwendet wird.

**Letzter Versand** (Info)

> Zeigt den Zeitstempel der letzten erfolgreichen Datenübertragung an, nützlich zur Überwachung der Aktivität.

**Anzahl der zu sendenden Variablen** (Info)

> Zeigt die aktuelle Anzahl eindeutiger Datenpunkte an, die an BuildingPro Suites übertragen werden.

**Prognose Nachrichten pro Stunde** (Info)

> Schätzt die Anzahl der pro Stunde gesendeten Nachrichten basierend auf der aktuellen Aktivität. Dieser Wert wird alle 10 Sekunden aktualisiert.

**Prognose Bytes pro Nachricht** (Info)

> Zeigt die durchschnittliche Größe jeder Nachricht in Bytes an, aktualisiert alle 10 Sekunden.

**Wertepuffer belegt** (Info)

> Gibt die aktuelle Anzahl der im Puffer gespeicherten Nachrichten an.

#### Letzte Sendemenge (Info)

> Zeigt die Anzahl der Werte an, die im letzten Sammelvorgang gesendet wurden. Dies hilft, die Wirksamkeit der aktuellen Konfiguration für das Sammelsenden zu überwachen.

#### Aktuelle Anzahl der Sende-Threads (Info)

> Zeigt die Anzahl der derzeit verwendeten parallelen Threads zum Senden von Werten an. Idealerweise sollte dieser Wert nicht mehr als einen Thread gleichzeitig überschreiten, um eine optimale Ressourcennutzung und Systemstabilität zu gewährleisten.

**Prognose aktualisieren** (Aktion)

> Aktualisiert die Prognosestatistiken manuell. Diese Statistiken werden automatisch alle 10 Sekunden aktualisiert.

**Wertepuffer leeren** (Aktion)

> Löscht alle derzeit im Puffer gespeicherten Nachrichten.

#### BuildingPro Suites Receiver

Die **BuildingPro Suites Receiver** wird automatisch als Kind des **BuildingPro Suites Device**.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FCKJeKYCCpmfftJzpB1Zx%2Feliona_receiver.png?alt=media&#x26;token=3380cb53-6a0b-43a2-9a24-9c67c9ba3859" alt=""><figcaption></figcaption></figure>

| Feld                                  | Beschreibung                                                            |
| ------------------------------------- | ----------------------------------------------------------------------- |
| `Aktiviert`                           | Aktiviert oder deaktiviert den Receiver                                 |
| `Benutzername`                        | Niagara-Benutzerkonto, das zum Schreiben von Daten verwendet wird       |
| `Standard-Schreibslot`                | Zielslot zum Schreiben, wenn keine Priorität angegeben ist              |
| `Verzögerung auf Null zurücksetzen`   | Setzt den Wert nach der angegebenen Anzahl von Sekunden auf null zurück |
| `Letzter Empfang` (Info)              | Zeitstempel der zuletzt empfangenen Nachricht                           |
| `Zuletzt empfangene Nachricht` (Info) | Details der zuletzt empfangenen Nachricht                               |

**Aktiviert**

> Aktiviert oder deaktiviert den BuildingPro Suites Receiver. Wenn aktiviert, werden die von BuildingPro Suites empfangenen Daten in die angegebenen Niagara-Datenpunkte geschrieben.

**Benutzername**

> Gibt das Niagara-Benutzerkonto an, das zum Schreiben von Werten in Datenpunkte verwendet wird. Falls in der eingehenden Nachricht nicht angegeben, wird dieser Standardbenutzer verwendet. Der Benutzer muss Berechtigungen zum Ausführen von Aktionen oder zum Schreiben in Slots haben. Stellen Sie sicher, dass der Benutzername gültig ist und die erforderlichen Berechtigungen besitzt.

**Standard-Schreibslot**

> Definiert den Slot im Ziel-Datenpunkt, in den der empfangene Wert geschrieben wird, wenn keine Priorität angegeben ist. Dies kann auch ein Aktionsslot sein, der die Aktion mit dem Wert als Argument auslöst.

**Verzögerung auf Null zurücksetzen**

> Legt die Anzahl der Sekunden fest, nach denen der geschriebene Wert auf `null`zurückgesetzt wird. Wenn ein Wert größer als null gesetzt ist, wird der Wert nach der angegebenen Verzögerung zurückgesetzt. Diese Verzögerung wird als Standard verwendet, wenn im Asset Mapping keine Verzögerung definiert ist.

**Letzter Empfang** (Info)

> Zeigt den Zeitstempel des letzten erfolgreichen Datenempfangs von BuildingPro Suites an.

**Zuletzt empfangene Nachricht** (Info)

> Zeigt die zuletzt von BuildingPro Suites empfangene Nachricht an. Dies dient hauptsächlich Debugging-Zwecken und ist standardmäßig ausgeblendet.

#### BuildingPro Suites Assets

Die **BuildingPro Suites Assets** Container wird automatisch als Kind des **BuildingPro Suites Device**erstellt. Er enthält alle **BuildingPro Suites Asset** Komponenten.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FZ2mImwDoFPPWCdYQ9Sq6%2Feliona_assets.png?alt=media&#x26;token=d4f8a1ee-3b25-4c5c-a810-16098631c5e2" alt=""><figcaption></figcaption></figure>

| Feld                                  | Beschreibung                                                                                |
| ------------------------------------- | ------------------------------------------------------------------------------------------- |
| `Upsert aktiviert`                    | Aktiviert die automatische Erstellung und Aktualisierung von Objekten in BuildingPro Suites |
| `Automatisch speichern`               | Speichert die Station automatisch, nachdem Objekte geändert wurden                          |
| `Standard-Global Asset ID`            | Legt ein Standardmuster für die Global Asset ID fest                                        |
| `Standard-Objektname`                 | Legt ein Standardmuster für Objektnamen fest                                                |
| `Standard-Objektbeschreibung`         | Legt ein Standardmuster für Objektbeschreibungen fest                                       |
| `Standard-Sendeattribut`              | Legt das Standardattribut für das Senden von Daten an BuildingPro Suites fest               |
| `Standard-Statusattribut`             | Legt das Standard-Statusattribut für Objekte fest                                           |
| `Standard-Empfangsattribut`           | Legt das Standardattribut für den Empfang von Daten von BuildingPro Suites fest             |
| `Standard-Alarmattribut`              | Gibt das Standardattribut für Alarmdaten an                                                 |
| `Synchronisieren` (Aktion)            | Startet bei Bedarf die Synchronisation der Objekte mit BuildingPro Suites                   |
| `Synchronisierung erzwingen` (Aktion) | Erzwingt die Synchronisation aller Objekte mit BuildingPro Suites                           |

**Upsert aktiviert**

> Aktiviert oder deaktiviert die Upsert-Funktionalität (Update oder Insert) für Objekte in BuildingPro Suites.
>
> * **Aktiviert**: Objekte werden während der Synchronisation automatisch aktualisiert, wenn sie existieren, oder eingefügt, wenn sie neu sind.
> * **Deaktiviert**: Objekte werden nur referenziert, wenn sie in BuildingPro Suites existieren; sie werden nicht erstellt oder aktualisiert.

**Automatisch speichern**

> Speichert die Station automatisch, wenn Objekte im **BuildingPro Suites Assets** Container erstellt oder geändert werden.

**Standard-Global Asset ID**

> Definiert das Muster für die standardmäßige Global Asset ID, die für die eindeutige Referenzierung von Objekten in BuildingPro Suites verwendet wird. Entspricht typischerweise dem Pfad des übergeordneten Slots des Objekts.

**Standard-Objektname**

> Gibt das Muster für den standardmäßigen Objektnamen in BuildingPro Suites an, häufig unter Verwendung des Namens des übergeordneten Elements.

**Standard-Objektbeschreibung**

> Legt das Muster für die standardmäßige Objektbeschreibung fest, möglicherweise einschließlich des Typs und des Anzeigenamens der übergeordneten Komponente.

**Standard-Sendeattribut**

> Legt das Standardattribut fest, das zum Senden von Daten an BuildingPro Suites verwendet wird. Der Standard ist `"value"`.

**Standard-Statusattribut**

> Definiert das Standardattribut für die Meldung des Objektstatus. Der Standard ist `"value_status"`.

**Standard-Empfangsattribut**

> Legt das Standardattribut für den Empfang von Daten von BuildingPro Suites fest. Der Standard ist `"value"`.

**Standard-Alarmattribut**

> Gibt das Standardattribut für Alarmdaten an. Der Standard ist `"alarm"`.

**Synchronisieren** (Aktion)

> Löst die Synchronisation aller Objekte mit BuildingPro Suites aus. Wenn **Upsert** aktiviert ist, werden Objekte automatisch erstellt oder aktualisiert. Andernfalls werden Objekte nur referenziert, wenn sie bereits in BuildingPro Suites anhand ihrer **Tenant ID** und **Global Asset ID**existieren. Bereits synchronisierte Objekte (für die ein **Asset ID** gesetzt ist) werden übersprungen.

#### **Synchronisierung erzwingen** (Aktion)

> Umgeht Synchronisierungsprüfungen und erzwingt das Senden aller Objektdaten an BuildingPro Suites, unabhängig davon, ob das Objekt bereits synchronisiert wurde (ein **Asset ID** gesetzt ist). Dadurch wird sichergestellt, dass das Objekt immer aktualisiert wird, und dies ist besonders nützlich, wenn ein vollständiges Update erforderlich ist.

#### BuildingPro Suites Asset

Eine **BuildingPro Suites Asset** Komponente wird automatisch erstellt, wenn eine **BuildingPro Suites Asset Mapping** Komponente eingerichtet wird. Die **Global Asset ID** dient als eindeutiger Bezeichner.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FZjfCwa5tVJlObzzUXi8p%2Feliona_asset_settings.png?alt=media&#x26;token=294ed4d0-8ad1-490f-b737-dacd0ce0abc5" alt=""><figcaption></figcaption></figure>

| Feld                                  | Beschreibung                                                                |
| ------------------------------------- | --------------------------------------------------------------------------- |
| `Anlagentyp`                          | Definiert den Typ des Objekts in BuildingPro Suites                         |
| `Global Asset ID` (Info)              | Eindeutiger globaler Bezeichner für Referenzierung und Synchronisierung     |
| `Objektname` (Info)                   | Name des Objekts in BuildingPro Suites                                      |
| `Objektbeschreibung` (Info)           | Beschreibung des Objekts in BuildingPro Suites                              |
| `Asset ID` (Info)                     | Referenzierte Asset ID in BuildingPro Suites                                |
| `Alarmregel-ID` (Info)                | Kennung für die entsprechende Alarmregel in BuildingPro Suites              |
| `Zuletzt alarmiert` (Info)            | Zeitstempel des zuletzt ausgelösten Alarms                                  |
| `Asset Hyperlink Ord` (Info)          | Link zum Objekt im BuildingPro Suites-Frontend für eine einfache Navigation |
| `Letzte Synchronisation` (Info)       | Zeitstempel der letzten Synchronisation mit BuildingPro Suites              |
| `Synchronisieren` (Aktion)            | Startet die Synchronisation mit BuildingPro Suites, falls erforderlich      |
| `Synchronisierung erzwingen` (Aktion) | Erzwingt die Synchronisation mit BuildingPro Suites                         |

**Anlagentyp**

> Definiert den Objekttyp in BuildingPro Suites während der Synchronisation.

**Global Asset ID** (Info)

> Eindeutiger Bezeichner, der die Global Asset ID und die Tenant ID aus dem **BuildingPro Suites Device**kombiniert. Wird für die Synchronisation verwendet.

**Objektname** (Info)

> Name des Objekts in BuildingPro Suites. Dieser wird bei Aktualisierungen synchronisiert.

**Objektbeschreibung** (Info)

> Beschreibung des Objekts in BuildingPro Suites, wird bei Aktualisierungen synchronisiert.

**Asset ID** (Info)

> Referenz auf die Asset ID in BuildingPro Suites, basierend auf der Tenant ID und der Global Asset ID.

**Alarmregel-ID** (Info)

> Kennung für die entsprechende Alarmregel in BuildingPro Suites.

**Zuletzt alarmiert** (Info)

> Zeitstempel des zuletzt ausgelösten Alarms für das Objekt.

**Asset Hyperlink Ord** (Info)

> Bietet einen direkten Link zum Objekt im BuildingPro Suites-Frontend.

**Letzte Synchronisation** (Info)

> Zeigt an, wann das Objekt zuletzt mit BuildingPro Suites synchronisiert wurde.

**Synchronisieren** (Aktion)

> Löst die Synchronisation der Objektdaten mit BuildingPro Suites manuell aus. Wenn **Upsert** aktiviert ist, werden Objekte automatisch erstellt oder aktualisiert. Andernfalls werden Objekte nur referenziert, wenn sie bereits in BuildingPro Suites anhand ihrer **Tenant ID** und **Global Asset ID**existieren. Bereits synchronisierte Objekte (für die ein **Asset ID** gesetzt ist) werden übersprungen.

#### **Synchronisierung erzwingen** (Aktion)

> Umgeht Synchronisierungsprüfungen und erzwingt das Senden von Objektdaten an BuildingPro Suites, unabhängig davon, ob das Objekt bereits synchronisiert wurde (ein **Asset ID** gesetzt ist). Dadurch wird sichergestellt, dass das Objekt immer aktualisiert wird, und dies ist besonders nützlich, wenn ein vollständiges Update erforderlich ist.

#### BuildingPro Suites Asset Mapping

Eine **BuildingPro Suites Asset Mapping** Komponente wird als Kind von Niagara-Datenpunkt-Erweiterungen erstellt (entweder **BuildingPro Suites Extension** oder **Alarm Extension**). Sie ist mit einem **BuildingPro Suites Asset** unter Verwendung der Global Asset ID verknüpft.

| Feld                       | Beschreibung                                                |
| -------------------------- | ----------------------------------------------------------- |
| `Global Asset ID`          | Eindeutiger Bezeichner für das Objekt in BuildingPro Suites |
| `Asset Ord` (Info)         | Referenz auf das Objekt in Niagara                          |
| `Objekt zuordnen` (Aktion) | Startet das Objekt-Mapping                                  |

**Global Asset ID**

> Eindeutiger Bezeichner, der eine konsistente Identifizierung in Niagara und BuildingPro Suites sicherstellt.

**Asset Ord** (Info)

> Referenz auf das Objekt innerhalb von Niagara.

**Objekt zuordnen** (Aktion)

> Startet den Zuordnungsprozess für das Objekt.

#### BuildingPro Suites Value Asset Mapping

Die **BuildingPro Suites Value Asset Mapping** Komponente wird automatisch als Kind des **BuildingPro Suites Extension**.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FXFrCVAjDqT7VfQ75rT9Q%2Feliona_value_asset_mapping.png?alt=media&#x26;token=b5b68887-425c-4a56-b1ab-7907b6fedeaf" alt=""><figcaption></figcaption></figure>

| Feld                                | Beschreibung                                                             |
| ----------------------------------- | ------------------------------------------------------------------------ |
| `Sendeuntertyp`                     | Untertyp für das Senden von Werten (z. B., `"input"`)                    |
| `Sendeattribut`                     | Attribut, das beim Senden von Daten an BuildingPro Suites verwendet wird |
| `Statusattribut`                    | Attribut, das den Status des Objekts darstellt                           |
| `Empfangsattribut`                  | Attribut für den Empfang von Daten von BuildingPro Suites                |
| `Write Slot`                        | Slot, in den empfangene Daten geschrieben werden                         |
| `Verzögerung auf Null zurücksetzen` | Setzt den Wert nach der angegebenen Anzahl von Sekunden auf null zurück  |

**Sendeuntertyp**

> Gibt den Untertyp für Wertdaten beim Senden an BuildingPro Suites an. Der Standard ist `"input"`.

**Sendeattribut**

> Attribut, das zum Senden von Daten an BuildingPro Suites verwendet wird. Um es vom Senden auszuschließen, setzen Sie den Attributnamen auf leer.

**Statusattribut**

> Attribut, das den Status des Objekts in BuildingPro Suites darstellt. Um es vom Senden auszuschließen, setzen Sie den Attributnamen auf leer.

**Empfangsattribut**

> Attribut für den Empfang von Daten von BuildingPro Suites. Um es vom Empfang auszuschließen, setzen Sie den Attributnamen auf leer.

**Write Slot**

> Definiert den Slot in Niagara, in den Daten aus BuildingPro Suites geschrieben werden.

#### **Verzögerung auf Null zurücksetzen**

> Legt die Anzahl der Sekunden fest, nach denen der geschriebene Wert auf `null`. Wenn ein Wert größer als null gesetzt wird, wird der Wert nach der angegebenen Verzögerung zurückgesetzt.

#### BuildingPro Suites Alarm-Asset-Mapping

Die **BuildingPro Suites Alarm-Asset-Mapping** Komponente wird als Kind von **Alarm Extension** erstellt, wenn der erste Alarm für den übergeordneten Datenpunkt ausgelöst wird.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FlxzdW9eGfR6EtS5gof5i%2Feliona_alarm_asset_mapping.png?alt=media&#x26;token=7690d0f8-ddd8-4941-bf0e-427464924d4c" alt=""><figcaption></figcaption></figure>

| Feld                   | Beschreibung                                                |
| ---------------------- | ----------------------------------------------------------- |
| `Alarm-Untertyp`       | Untertyp für Alarmdaten (z. B. `"input"`)                   |
| `Alarmattribut`        | Attribut, das beim Übertragen von Alarmdaten verwendet wird |
| `Empfänger-Ord` (Info) | Verweis auf den Alarmempfänger in Niagara                   |

**Alarm-Untertyp**

> Untertyp für Alarmdaten. Der Standard ist `"input"`.

**Alarmattribut**

> Attribut, das zum Übertragen von Alarmdaten an BuildingPro Suites verwendet wird. Um es vom Senden auszuschließen, setzen Sie den Attributnamen auf leer.

**Empfänger-Ord** (Info)

> Verweis auf den Alarmempfänger in Niagara.

#### BuildingPro Suites Station Asset Mapping

Die Komponente **BuildingPro Suites Station Asset Mapping** wird als Kind von **BuildingPro Suites Device** erstellt, wenn dies erstellt wird.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FOljFHbIPvUYqFaird47p%2Feliona_station_asset_mapping.png?alt=media&#x26;token=4174b025-c670-41af-ae4f-6b335cffefcb" alt=""><figcaption></figcaption></figure>

| **Feld**       | **Beschreibung**                                                    |
| -------------- | ------------------------------------------------------------------- |
| **`Attribut`** | Attributnamen, die beim Senden des Stationsstatus verwendet werden. |

**Attribut**

> Definieren Sie die Attributnamen, die beim Senden des Status an BuildingPro Suites verwendet werden sollen. Um bestimmte Informationen vom Senden auszuschließen, setzen Sie den Attributnamen auf leer.

#### BuildingPro Suites Alarm Acknowledger

Die **BuildingPro Suites Alarm Acknowledger** wird automatisch als Kind des **BuildingPro Suites Device**.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2Fr4dcUo27E782azY9bFFA%2Feliona_alarm_acknowledger.png?alt=media&#x26;token=22b6c77a-af29-49ee-8320-4fb2be0d1a24" alt=""><figcaption></figcaption></figure>

| Feld                                                                 | Beschreibung                                                                |
| -------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| `Aktiviert`                                                          | Aktiviert oder deaktiviert den Bestätiger                                   |
| `Alarm aus derselben Quelle bestätigen`                              | Bestätigt alle Alarme aus derselben Quelle                                  |
| `Benutzername`                                                       | Niagara-Benutzerkonto für Bestätigungen                                     |
| `Zuletzt bestätigter Alarm` (Info)                                   | Details des zuletzt bestätigten Alarms                                      |
| `Zeitpunkt des zuletzt bestätigten Alarms` (Info)                    | Zeitstempel der letzten erfolgreichen Bestätigung                           |
| `Zeitpunkt des letzten fehlgeschlagenen Bestätigungsversuchs` (Info) | Zeitstempel des letzten fehlgeschlagenen Bestätigungsversuchs               |
| `Ursache des letzten fehlgeschlagenen Bestätigungsversuchs` (Info)   | Fehlermeldung für den letzten fehlgeschlagenen Bestätigungsversuch          |
| `Heute insgesamt bestätigte Alarme` (Info)                           | Anzahl der heute bestätigten Alarme                                         |
| `Heute insgesamt fehlgeschlagene Bestätigungen` (Info)               | Anzahl der heutigen fehlgeschlagenen Bestätigungen                          |
| `Heute insgesamt empfangene Nachrichten` (Info)                      | Anzahl der heute von BuildingPro Suites empfangenen Bestätigungsnachrichten |
| `Letzter Alarm-Bestätigungsnotiz` (Info)                             | Notiz, die mit der letzten Bestätigung verknüpft ist                        |

**Aktiviert**

> Aktiviert oder deaktiviert den Alarm-Bestätiger.

**Alarm aus derselben Quelle bestätigen**

> Wenn aktiviert, werden alle Alarme, die aus derselben Quelle stammen, bestätigt.

**Benutzername**

> Legt das Niagara-Benutzerkonto fest, das zum Bestätigen von Alarmen verwendet wird. Der Benutzer muss über die erforderlichen Berechtigungen verfügen.

**Zuletzt bestätigter Alarm** (Info)

> Details des zuletzt erfolgreich bestätigten Alarms.

**Zeitpunkt des zuletzt bestätigten Alarms** (Info)

> Zeitstempel der letzten erfolgreichen Bestätigung.

**Zeitpunkt des letzten fehlgeschlagenen Bestätigungsversuchs** (Info)

> Zeitstempel des letzten fehlgeschlagenen Bestätigungsversuchs.

**Ursache des letzten fehlgeschlagenen Bestätigungsversuchs** (Info)

> Fehlermeldung, die die Ursache des letzten fehlgeschlagenen Bestätigungsversuchs erläutert.

**Heute insgesamt bestätigte Alarme** (Info)

> Anzahl der heute bestätigten Alarme.

**Heute insgesamt fehlgeschlagene Bestätigungen** (Info)

> Anzahl der heutigen fehlgeschlagenen Bestätigungsversuche.

**Heute insgesamt empfangene Nachrichten** (Info)

> Anzahl der heute von BuildingPro Suites empfangenen Bestätigungsnachrichten.

**Letzter Alarm-Bestätigungsnotiz** (Info)

> Eine mit der letzten Alarmbestätigung verknüpfte Notiz.

#### BuildingPro Suites Extension

Die **BuildingPro Suites Extension** kann als Kind eines Niagara-Datenpunkts hinzugefügt werden, indem es aus dem **BuildingPro Suites-Palette**. Für einen einzelnen Datenpunkt können mehrere Erweiterungen erstellt werden.

| Feld                     | Beschreibung                                           |
| ------------------------ | ------------------------------------------------------ |
| `Aktiviert`              | Aktiviert die Erweiterung für die Datenübertragung     |
| `Letzter Versand` (Info) | Zeitstempel der letzten erfolgreichen Datenübertragung |

Die Erweiterung überträgt und empfängt den Wert eines konfigurierbaren Slots (Standard: `out` und `set`) und, falls verfügbar, dessen Status.

**Aktiviert**

> Aktiviert oder deaktiviert die Erweiterung.

**Letzter Versand** (Info)

> Zeigt den Zeitstempel der letzten erfolgreichen Datenübertragung an.

#### BuildingPro Suites Intervall-Erweiterung

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2Fa50Dz8xZyP7MPz0LlTvW%2Feliona_interval_extension.png?alt=media&#x26;token=4ea895ec-02d1-40c7-9978-c09c443f7c19" alt=""><figcaption></figcaption></figure>

| Feld        | Beschreibung                                               |
| ----------- | ---------------------------------------------------------- |
| `Intervall` | Intervall für die Datenübertragung (Intervall-Erweiterung) |

**Intervall**

> Definiert das Intervall, in dem der Wert der übergeordneten Variable an BuildingPro Suites gesendet wird.

#### BuildingPro Suites COV-Erweiterung

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F1l8p6Eflctx5jYzLXLXT%2Feliona_cov_extension.png?alt=media&#x26;token=d6f47ec3-7645-4899-ab0a-2f554f126a68" alt=""><figcaption></figcaption></figure>

| Feld                | Beschreibung                                                        |
| ------------------- | ------------------------------------------------------------------- |
| `Änderungstoleranz` | Minimale Änderung, um eine Übertragung auszulösen (COV-Erweiterung) |

**Änderungstoleranz**

> Legt die minimal erforderliche Änderung im Wert der übergeordneten Variable fest, um eine Datenübertragung auszulösen. Wenn gesetzt auf `0`, löst jede Änderung eine Übertragung aus.

#### BuildingPro Suites Recipient

Die **BuildingPro Suites Recipient** kann als Kind des Niagara **Alarm Service**hinzugefügt werden. Es muss mit einem **Alarmklasse** verbunden sein, um Alarme dieser Klasse weiterzuleiten.

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FuQ23c2ZBfSQtJrsLzS73%2Feliona_recipient_settings.png?alt=media&#x26;token=6ab81517-2428-4d94-b5e1-1707ab840a49" alt=""><figcaption></figcaption></figure>

| Feld                                 | Beschreibung                                                  |
| ------------------------------------ | ------------------------------------------------------------- |
| `Zeitbereich`                        | Zeitbereich, in dem Alarme weitergeleitet werden              |
| `Wochentage`                         | Wochentage, an denen Alarme weitergeleitet werden             |
| `Übergang`                           | Alarmübergänge, die weitergeleitet werden                     |
| `Bestätigungen weiterleiten`         | Legt fest, ob Alarmbestätigungen weitergeleitet werden        |
| `Puffergröße für Alarme`             | Legt die Größe des Nachrichtenpuffers fest                    |
| `Ringpuffer`                         | Bestimmt das Verhalten des Puffers, wenn er voll ist          |
| `Datenbankverbindung für den Puffer` | Konfiguriert eine externe Datenbankverbindung für das Puffern |
| `Prognose Alarme pro Stunde` (Info)  | Geschätzte Anzahl der pro Stunde gesendeten Alarme            |
| `Prognose Bytes pro Alarm` (Info)    | Durchschnittliche Größe jeder Alarmnachricht in Bytes         |
| `Verwendeter Alarmpuffer` (Info)     | Aktuelle Anzahl der Alarme im Puffer                          |
| `Letzter Versand` (Info)             | Zeitstempel der letzten erfolgreichen Datenübertragung        |
| `Prognose aktualisieren` (Aktion)    | Aktualisiert die Prognosestatistiken manuell                  |
| `Alarmpuffer leeren` (Aktion)        | Löscht alle Alarme im Puffer                                  |

**Zeitbereich**

> Definiert den Zeitraum, in dem Alarme an BuildingPro Suites weitergeleitet werden.

**Wochentage**

> Legt die Tage fest, an denen Alarme weitergeleitet werden.

**Übergang**

> Bestimmt, welche Alarmübergänge (z. B. Aktivierung, Bestätigung) an BuildingPro Suites weitergeleitet werden.

**Bestätigungen weiterleiten**

> Legt fest, ob Alarmbestätigungen in Niagara an BuildingPro Suites weitergeleitet werden.

**Puffergröße für Alarme**

> Legt die maximale Anzahl von Alarmen fest, die der Puffer aufnehmen kann.

**Ringpuffer**

> Bestimmt, wie der Puffer neue Alarme behandelt, wenn er voll ist:
>
> * **Aktiviert**: Überschreibt die ältesten Alarme durch neue.
> * **Deaktiviert**: Stellt das Akzeptieren neuer Alarme ein, wenn er voll ist.

**Datenbankverbindung für den Puffer**

> Ermöglicht die Verwendung einer externen H2-Datenbank für das Puffern. Wenn dieses Feld leer bleibt, wird standardmäßig ein interner Speicherpuffer verwendet.
>
> * **Eingebetteter Puffer-Modus**: Verwendet eine Datenbankdatei, die vom Treiber verwaltet wird.
> * **Server-Puffer-Modus**: Verbindet sich mit einer serververwalteten H2-Datenbank.

**Prognose Alarme pro Stunde** (Info)

> Schätzt die Anzahl der pro Stunde gesendeten Alarme und wird alle 10 Sekunden aktualisiert.

**Prognose Bytes pro Alarm** (Info)

> Zeigt die durchschnittliche Größe jeder Alarmnachricht in Bytes an.

**Verwendeter Alarmpuffer** (Info)

> Zeigt die aktuelle Anzahl der im Puffer gespeicherten Alarme an.

**Letzter Versand** (Info)

> Zeitstempel der letzten erfolgreichen Datenübertragung.

**Prognose aktualisieren** (Aktion)

> Aktualisiert die Prognosestatistiken manuell.

**Alarmpuffer leeren** (Aktion)

> Löscht alle derzeit im Puffer gespeicherten Alarme.

#### BuildingPro Suites API Client

Die **BuildingPro Suites API Client** kann hinzugefügt werden, indem es aus dem **BuildingPro Suites-Palette**. Es ermöglicht die direkte Kommunikation mit einem BuildingPro Suites-System über APIv2, indem benutzerdefinierte HTTP-Anfragen an bestimmte Endpunkte gesendet werden.

| Feld                    | Beschreibung                                                                                       |
| ----------------------- | -------------------------------------------------------------------------------------------------- |
| `Aktiviert`             | Aktiviert oder deaktiviert den Client                                                              |
| `Anfrage bei Änderung`  | Löst automatisch die `Anfrage` Aktion aus, sobald sich eine relevante Eigenschaft (z. B.           |
| `Methode`               | Verwendete HTTP-Methode für den API-Aufruf (`GET`, `PUT`, `POST`, `DELETE`, `PATCH`)               |
| `In`                    | JSON-Body, der bei Bedarf in die Anfrage eingefügt wird                                            |
| `Pfad`                  | Pfad des API-Endpunkts                                                                             |
| `URL` (Info)            | Resultierende URL basierend auf der Konfiguration von **BuildingPro Suites Device** und dem `Pfad` |
| `Antwortcode` (Info)    | HTTP-Antwortcode nach Ausführung einer `Anfrage`                                                   |
| `Letzte Anfrage` (Info) | Zeitstempel der zuletzt gesendeten Anfrage                                                         |
| `Letzte Antwort` (Info) | Zeitstempel der zuletzt empfangenen Antwort                                                        |
| `Anfrage` (Aktion)      | Startet manuell eine neue Anfrage an BuildingPro Suites                                            |

**Aktiviert**

> Aktiviert oder deaktiviert den BuildingPro Suites API Client. Wenn deaktiviert, werden keine Anfragen gesendet oder empfangen.

**Anfrage bei Änderung**

> Löst automatisch die `Anfrage` Aktion, sobald sich eine relevante Eigenschaft (z. B. `Methode`, `In`, oder `Pfad`) ändert.

**Methode**

> Definiert die für den API-Aufruf verwendete HTTP-Methode. Verfügbare Optionen sind: `GET`, `PUT`, `POST`, `DELETE`, `PATCH`.

**In**

> Legt den JSON-Body fest, der in die Anfrage eingefügt wird. Dies wird verwendet, wenn die HTTP-Methode das Senden einer Nutzlast erfordert (z. B. für `POST`, `PUT`, oder `PATCH`).

**Pfad**

> Definiert den Pfad des API-Endpunkts relativ zur Basis-URL von BuildingPro Suites, die im zugehörigen **BuildingPro Suites Device**.

**URL** (Info)

> Zeigt die vollständige URL an, die sich aus der Konfiguration von **BuildingPro Suites Device** und dem angegebenen `Pfad`.

**Antwortcode** (Info)

> Zeigt den HTTP-Antwortcode der letzten Anfrage an (z. B. `200 OK`, `404 Nicht gefunden`, `500 Interner Serverfehler`).

**Letzte Anfrage** (Info)

> Speichert den Zeitstempel der zuletzt an BuildingPro Suites gesendeten Anfrage.

**Letzte Antwort** (Info)

> Speichert den Zeitstempel der zuletzt von BuildingPro Suites empfangenen Antwort.

**Anfrage** (Aktion)

> Startet manuell eine Anfrage basierend auf der aktuellen Konfiguration des BuildingPro Suites API Client.

***

#### Migrationsleitfaden

Ab Version 5.0 hat das Niagara-Modul erhebliche Änderungen in seinen Arbeitsprinzipien erfahren. Die Kommunikation mit BuildingPro Suites verwendet nun direkt die BuildingPro Suites APIv2. Zuvor erfolgte die Kommunikation über einen TCP-Tunnel zu einer separaten Niagara-App innerhalb von BuildingPro Suites, die das Asset-Mapping und die Asset-Änderungen verwaltete. Die Konfiguration in früheren Versionen umfasste die Definition von Listenern (für den TCP-Tunnel) und Controllern (für das Asset-Mapping und die Attribut-Einstellungen für Werte und Alarme).

#### Kommunikationseinstellungen

In der neuen Version benötigen Sie statt einer IP-Adresse und eines Ports zum Erstellen eines TCP-Tunnels zum Niagara-App-Connector eine APIv2-URL und ein Token. Diese Zugangsdaten sollten von Ihrem BuildingPro Suites-Administrator bereitgestellt werden. Die APIv2-Zugangsdaten müssen im **BuildingPro Suites Device** Komponente innerhalb von Niagara konfiguriert werden.

#### Asset Mapping

In früheren Versionen wurde das Asset-Mapping innerhalb der Niagara-App in BuildingPro Suites definiert. Der Controller in den Einstellungen der Niagara-App enthielt eine Liste von Assets, die über ihre Handles (eindeutige IDs von Datenpunkten innerhalb einer Niagara-Station) mit Niagara-Datenpunkten verknüpft waren. Für jeden Handle (Datenpunkt) wurden die Asset-ID und das Attribut mit Untertyp angegeben. Zusätzlich wurde die Priorität (Name des Slots in Niagara) für Ausgabattribute definiert, die Daten zurück an Niagara senden.

Die neue Version führt einen anderen Ansatz für die Referenzierung von Assets und Attributen ein. Der **BuildingPro Suites Value Asset Mapping**, definiert innerhalb eines **BuildingPro Suites Extension**, legt eine Global Asset ID fest. Diese Global Asset ID identifiziert zusammen mit der Tenant ID aus dem **BuildingPro Suites Device**eindeutig ein Asset in BuildingPro Suites. Für jede Global Asset ID wird ein **BuildingPro Suites Asset** unter dem **BuildingPro Suites Assets** Container in Niagara erstellt. Während der Asset-Synchronisierung wird dieses BuildingPro-Suites-Asset mit dem entsprechenden Asset in BuildingPro Suites verknüpft, indem die Asset-ID in der **BuildingPro Suites Asset** Komponente gesetzt wird.

Das neue **Asset Mapping** definiert außerdem die `Attribut` Einstellungen und Untertypen, die verwendet werden, wenn Werte an BuildingPro Suites gesendet oder von dort empfangen werden. Wenn Sie einen anderen Schreib-Slot als den `Standard-Schreibslot` definieren müssen, der im **BuildingPro Suites Receiver**festgelegt ist, können Sie die `Write Slot` Einstellung in der **Asset Mapping** Komponente gesetzt wird.

Sie können mehreren Asset-Zuordnungen mit unterschiedlichen Attributnamen dieselbe Global Asset ID zuweisen. Dadurch können Sie in BuildingPro Suites ein einzelnes Asset definieren, das mehrere Datenpunkte aus Niagara repräsentiert, die jeweils einem anderen Attribut zugewiesen sind.

#### Alarm-Mapping

In früheren Versionen wurde das Alarm-Mapping innerhalb der Niagara-App in BuildingPro Suites definiert. Der Controller in den Einstellungen der Niagara-App enthielt eine Liste von Alarmregeln und die vollständige Slot-Tafel der entsprechenden Alarm-Erweiterungen. Dieses Setup ermöglichte es der alten Version, Alarme zu senden und Bestätigungen zu synchronisieren.

Die neue Version verfolgt einen anderen Ansatz. Der **BuildingPro Suites Alarm-Asset-Mapping**, der für jedes **Alarm Extension**definiert ist, legt eine Global Asset ID fest. Diese Global Asset ID identifiziert zusammen mit der Tenant ID aus dem **BuildingPro Suites Device**eindeutig das Asset in BuildingPro Suites. Anschließend wird für dieses Asset in BuildingPro Suites eine Alarmregel erstellt. Das Asset-Mapping definiert außerdem einen Attributnamen, der den Alarmzustand repräsentiert: Er ist auf `0` gesetzt, wenn kein Alarm vorhanden ist, und auf `1` wenn sich der übergeordnete Niagara-Datenpunkt in einem Alarmzustand befindet.

#### Asset-Import und -Erstellung

In früheren Versionen wurde ein **BuildingPro Suites-Dienst** Komponente bereitgestellt. Diese Komponente konnte Asset-Definitionen aus Niagara für jeden Datenpunkt exportieren und in einen Controller in der BuildingPro Suites-App importieren, der die Assets und Asset-Zuordnungen für den ausgewählten Controller erstellte.

Die neue Version bietet eine komfortablere und flexiblere Möglichkeit, Assets und Zuordnungen automatisch zu erstellen. Durch Aktivieren des `Enable Upserts` Einstellung in der **BuildingPro Suites Assets** Containers prüft das BuildingPro-Suites-Modul während der Synchronisierung, ob ein Asset mit der angegebenen Global Asset ID und Tenant ID in BuildingPro Suites vorhanden ist. Wenn nicht, wird das Asset erstellt und durch Setzen der neuen Asset-ID in der **BuildingPro Suites Asset** Komponente verknüpft. Beachten Sie, dass Sie den Asset-Typ in der **BuildingPro Suites Asset** Komponente definieren müssen, um das Asset in BuildingPro Suites zu erstellen und zu aktualisieren.