Geräte über Webhook verbinden

Ablauf

Mit einer Verbindung über Webhook fungieren BuildingPro Suites als Server. Ein Client, z. B. ein Gateway, an das Geräte angeschlossen sind, überträgt Informationen per HTTP an BuildingPro Suites.

Zu diesem Zweck wird in BuildingPro Suites ein Endpunkt erstellt. Der Client sendet Daten an diesen Endpunkt.

Überblick

Symbol	Beschreibung	Details
[A]	Menü „Connections“	Klicken, um das Menü „Connections“ zu öffnen
[B]	Registerkarte	Zugriff auf die jeweiligen Schnittstellen
[C]	Arbeitsbereich	Zeigt eine Liste der vorhandenen Endpunkte an (falls vorhanden)
[D]	Endpunkt	Vorhandene Endpunkte
[E]	Verbindung pausieren/fortsetzen	Klicken, um eine Verbindung zu pausieren oder fortzusetzen
[F]	Verbindungsstatus	Zeigt den aktuellen Status der Verbindung an
[G]	Name	Name des Endpunkts
[H]	Pfad	Der Pfad, an den die Informationen gesendet werden
[I]	Schutz	Zeigt den Schutzstatus des jeweiligen Endpunkts an
[J]	Format	Zeigt das Format an, das auf die ausgewählten Daten angewendet wird
[K]	Kopieren	Klicken, um den Endpunkt zu duplizieren
[L]	Neuen Endpunkt hinzufügen	Klicken, um einen neuen Endpunkt hinzuzufügen. Öffnet die ↗Endpunktdetails
[M]	Endpunkt löschen	Löscht den jeweiligen Endpunkt. ⚠ Achtung: Wenn die Verbindung auch in anderen Mandanten verwendet wird, wird sie dort ebenfalls gelöscht.
[N]	Endpunktdetails	Klicken, um die Details des jeweiligen Endpunkts zu bearbeiten.

Einen neuen Endpunkt erstellen/einen vorhandenen Endpunkt anpassen

Abb. 3 – Das Menü „Endpunkt konfigurieren“

1. Klicken Sie auf Verbindungen [A]

   ▷ Das Fenster „Connections“ wird geöffnet

2. Klicken Sie auf Webhook [B]

3. Klicken Sie auf [L] um einen neuen Endpunkt zu erstellen ⇄ ODER Klicken Sie auf [N] um einen vorhandenen Endpunkt zu bearbeiten.

   ▷ Das Menü „Endpunkt konfigurieren“ wird geöffnet.

4. In [O], geben Sie dem Endpunkt einen Namen. Der Endpunkt wird unter diesem Namen in [G].

5. In [P], geben Sie einen Pfad ein. Der Client sendet Informationen an diesen Pfad. ♢ Der Pfad besteht aus 2 Teilen: einer nicht bearbeitbaren Basis-URL und einem Teil, den Sie ändern können.

6. Optional: In [Q], geben Sie einen Autorisierungsschlüssel ein. Wenn Sie hier einen Wert eingeben, muss der entsprechende Wert vom Client in der Anfrage gesendet werden. Andernfalls wird die Anfrage nicht akzeptiert. Wenn Sie keinen Autorisierungsschlüssel vergeben möchten: Lassen Sie das Feld leer.

7. In [R], wählen Sie das Format aus, das auf die eingehenden Daten angewendet wird.

8. Optional: Klicken Sie auf [S] bis ↗ neues Format erstellen

9. Klicken Sie auf [T] um die Einstellungen zu speichern.