Calendar
Beschreibung
Microsoft Calendar
Dieses DDF ermöglicht die Verwendung von bevorstehenden Terminen aus Microsoft 365 als Trigger für die Raumautomation.
Ein typischer Anwendungsfall ist die automatische Vorbereitung eines Besprechungsraums. Beispielsweise kann die Heizung so eingestellt werden, dass der Raum bereits vor Beginn eines Termins auf die gewünschte Temperatur gebracht wird. Ebenso können abhängig von der vorhandenen Raumsteuerung weitere Funktionen wie Lüftung oder Beleuchtung rechtzeitig aktiviert werden.
Der Trigger Event Upcoming wird ausgelöst, wenn für einen konfigurierten Raum ein bevorstehendes Ereignis erkannt wird. Welche Aktion dadurch ausgeführt wird, wird in der Raumsteuerung festgelegt.
Room control > Buttons/Contacts > Contact of presence > Event Upcoming
Voraussetzungen
Für die Verwendung des DDFs werden folgende Voraussetzungen benötigt:
-
Microsoft 365 mit den entsprechenden Raum-/Kalenderinformationen
-
eine in Microsoft Entra ID registrierte Anwendung mit den erforderlichen Berechtigungen für den Zugriff auf Microsoft 365
-
Tenant ID der Microsoft-365-Umgebung
-
Client ID der registrierten Anwendung
-
Client Secret der registrierten Anwendung
-
die E-Mail-Adresse(n) der Microsoft-365-Räume bzw. Kalender, deren Termine berücksichtigt werden sollen
Konfiguration am Controller
Die Konfiguration direkt in der Device Station:
| Parameter | Beschreibung | Beispiel |
|---|---|---|
| SLAVE | E-Mail-Adresse(n) der Microsoft-365-Räume bzw. Kalender, deren Termine überwacht werden sollen. Mehrere Adressen werden durch Kommas getrennt. | meetingroom1@firma.de,meetingroom2@firma.de |
| TENANTID | Eindeutige ID des Microsoft-365-Tenants | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx |
| CLIENTID | ID der in Microsoft Entra ID registrierten Anwendung, über die der Zugriff auf Microsoft 365 erfolgt. | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx |
| SECRET | Client Secret der registrierten Anwendung zur Authentifizierung gegenüber Microsoft 365. | •••••••••••••••• |
Für SLAVE können bis zu 30 E-Mail-Adressen hinterlegt werden, sofern die maximale Zeichenlänge eingehalten wird. Der SLAVE-Eintrag ist auf 250 Zeichen begrenzt.
Mit dem Befehl GETSLAVESROOMS in der Device Station können die verfügbaren Räume automatisch aus Microsoft Places abgerufen werden.
Konfiguration im Element Device
Im Element Device kann die Gruppe Info mit dem entsprechenden Element verknüpft werden, um Termine aufzuzeichnen und eine Übersicht deren zu erhalten.
Verwendung
Nach erfolgreicher Konfiguration überwacht das DDF die Termine der unter SLAVE hinterlegten Räume bzw. Kalender.
Wird ein bevorstehender Termin erkannt, steht der Trigger Event Upcoming für die Raumautomation zur Verfügung. Über die Raumsteuerung kann daraufhin beispielsweise eine Vorheizung, Lüftung oder Beleuchtung aktiviert werden.
Damit kann die Raumautomation bereits vor Beginn eines Termins auf die geplante Nutzung reagieren und gleichzeitig unnötiger Energieverbrauch außerhalb der Nutzungszeiten vermieden werden.
Allgemeine Infos
| Hersteller | Typ | Protokoll | Modell | Version | ID |
|---|---|---|---|---|---|
| Microsoft | Kalender | REST-API (DDF) | 1 | 1 | 0x0D00007700010100 |
Dokumente
DDF-Items
| ID | Name | Einheit | Typ | Richtung |
|---|---|---|---|---|
| 0 | Count | |||
| 1 | Subject | |||
| 2 | Start DateTime | YYYY-MM-DDTHH:MM:SS.sssssss | ||
| 3 | End DateTime | YYYY-MM-DDTHH:MM:SS.sssssss | ||
| 4 | End Time Zone | |||
| 22 | Start DateTime (EU) | DD.MM.YYYY - HH:MM:SS | ||
| 23 | End DateTime (EU) | DD.MM.YYYY - HH:MM:SS | ||
| 50 | Event Now Active | 1 = now active | ||
| 51 | Event Upcoming | 1 = events upcoming | ||
| 52 | Look-Ahead Time | h | ||
| 60 | Event Now Active (Inv) | 0 = now active | ||
| 61 | Event Upcoming (Inv) | 0 = events upcoming | ||
| 160 | Command Token Now | |||
| 161 | Command Verbose | |||
| 162 | Command Event Refresh Now | |||
| 170 | Event Refresh Timer | s | ||
| 180 | Token Refresh Timer | s | ||
| 181 | Event Update Time | HH:MM:SS | ||
| 190 | Message | |||
| 191 | Message Trigger | |||
| 192 | Message Info | |||
| 195 | Station Config Done | 1 = config done | ||
| 200 | Quality Event | |||
| 201 | Quality Token |
Notiz
Last Commit: 21d3c8eb | 2026-02-26 09:46:39