Microsoft Calendar

Kalender • REST-API (DDF)

Microsoft
Signierte DDF herunterladen min. OS-Version: V9615-08
Device image

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.

Hersteller Typ Protokoll Modell Version ID
Microsoft Kalender REST-API (DDF) 1 1 0x0D00007700010100
Keine Dokumente.
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
*2026-03-18 13:51:50 (hw) ******************************
Last Commit: 21d3c8eb | 2026-02-26 09:46:39