Microsoft Shifts

Gateway • REST-API (DDF)

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

Mit diesem DDF können Sie die Abwesenheitsdaten von Mitarbeitern aus Microsoft Shifts / Teams in das System RAUMREGELUNG integrieren. Durch die Ermittlung der Anwesenheitszeiten und die Anwendung konfigurierbarer Vorlaufzeiten für Ankunft und Abfahrt ermöglicht das System eine vorausschauende Raumklimaregelung auf Grundlage der tatsächlichen Belegung.

Für Statusanzeigen wird ein GERÄTE-Element mit dem Namen "Info" verwendet. Dort wird der Teamname eingetragen; die zugehörige TeamID wird automatisch abgerufen.

Jede Person wird durch eine GERÄTE-Gruppe "User" dargestellt. Der Name der Person wird dort eingetragen, und die regulären Anwesenheitszeiten werden unter Parameter für jeden Wochentag festgelegt. Die zugehörige UserID wird bei einer Änderung automatisch abgerufen. Geben Sie in der Geräte Station eindeutige Abkürzungen für die Slave-Liste ein. Verknüpfen Sie HVAC NOW mit der Raumregelung (Taster/Kontakte > Präsenzkontakt), entweder direkt oder über einen Merker.

Hinweise:

  • Maximal 31 Personen
  • Manuelle Konfiguration erforderlich — kein Plug-and-Play
  • Keine Nachtschichten und keine über Nacht laufenden HVAC-/Heizintervalle werden unterstützt
  • Alle Einträge werden, mit Ausnahme von geteilten Schichten, als Abwesenheiten interpretiert
  • Pro Tag wird nur ein Schichteintrag unterstützt
  • Es wird nur ein zusammenhängendes HVAC-Intervall berechnet
  • Dieses DDF wird wie bereitgestellt zur Verfügung gestellt und muss möglicherweise weiter verbessert werden
  • Die heutigen Schichteinträge (02:00–22:00) werden automatisch jede Stunde aktualisiert oder können manuell über einen Befehl in Info abgefragt werden

Regular Present: Wahr, wenn die aktuelle Uhrzeit zwischen Beginn und Ende der definierten regulären Anwesenheitszeit liegt.

Present: Wahr, wenn Regular Present UND kein aktueller Abwesenheitseintrag vorhanden ist.

Zeigt die für den heutigen Tag eingetragenen Abwesenheitsschichten für jede Person an (zum Beispiel: "Urlaub von … bis …").

Der Anwesenheitszeitraum wird aus dem Schichteintrag [S] übernommen, wenn eine Schicht eine Dauer zwischen dem Parameter "Full-day Absence" (z. B. 6 h) und 11 Stunden hat.

kein HVAC bei

  • NO_REG_PRES: Kein Anwesenheitsintervall
  • INV_REG_PRES: Ungültiges Anwesenheitsintervall (P_START >= P_END)
  • ABS_COV_PRES: Abwesenheit deckt die gesamte Anwesenheit ab
  • LEAD_IS_LONGER: Fehler bei der Vorlaufzeit (HVAC_START >= HVAC_END)

Mit einem speziellen DDF für Räume werden die Anwesenheitszustände der Personen über IO-Eingänge zugewiesen. Aus diesen Eingängen wird anschließend der gesamte Anwesenheitszustand des Raumes abgeleitet. Alternativ können im System LOGIK die HVAC-Signale der Personen über OR -Blöcke zusammengeführt werden, um das HVAC-Signal eines Raumes mit mehreren Personen zu bestimmen.

 
Hersteller Typ Protokoll Modell Version ID
Microsoft Gateway REST-API (DDF) 2 1 0x0D00007700020100
ID Name Einheit Typ Richtung
0 User Name Firstname Lastname
1 User ID xxxxxxxx-xxxx-Uxxx-Vxxx-xxxxxxxxxxxx
2 Team Name
3 Team ID xxxxxxxx-xxxx-Uxxx-Vxxx-xxxxxxxxxxxx
5 Shifts Count
6 Start DateTime YYYY-MM-DDTHH:MM:SS.sssssss
7 End DateTime YYYY-MM-DDTHH:MM:SS.sssssss
8 Theme
9 Notes
10 Absence Shift
20 OUT Regular Present 1 = Regular Present Now
21 OUT Present 1 = Present Now
22 OUT HVAC 1 = HVAC Now
25 OUT State 0 = Away, 1 = Here, 2 = HVAC, 3 = Here and HVAC
28 Full Day Absence h
30 Regular Presence Today HH:MM - HH:MM
31 Regular Presence Mon HH:MM-HH:MM
32 Regular Presence Tue HH:MM-HH:MM
33 Regular Presence Wed HH:MM-HH:MM
34 Regular Presence Thu HH:MM-HH:MM
35 Regular Presence Fri HH:MM-HH:MM
36 Regular Presence Sat HH:MM-HH:MM
37 Regular Presence Sun HH:MM-HH:MM
38 Lead Arrive h
39 Lead Departure h
40 Absence Time Range HH:MM - HH:MM
41 HVAC Time Range HH:MM - HH:MM
160 Command Token Now
161 Command Verbose
162 Command Shift Now
180 Timer Token Refresh s
181 Timer Shift Refresh s
182 Timer ID Refresh s
183 Timer Precence Calc s
195 Station Config Done 1 = config done
200 Quality
201 Quality GETTOKEN
202 Quality GETTEAMID
203 Quality GETSHIFTS
204 Quality GETUSERID
208 No Error User
210 Error Message
220 Regular Present Now Trend
221 Present Now Trend
222 HVAC Now Trend
*2025-12-11 16:06:21 (do) ******************************
several changes
*2025-12-26 15:02:14 (do) ******************************
Last Commit: 829ace3d | 2025-12-26 15:01:23