Microsoft Shifts

Gateway • REST-API (DDF)

Microsoft
Signierte DDF herunterladen
Device image

With this DDF, you can integrate employee absence data from Microsoft Shifts / Teams into the ROOM CONTROL system. By determining presence times and applying configurable arrival and departure lead times, the system provides predictive room climate control based on actual occupancy.

A DEVICE element named "Info" is used for status displays. The team name is entered there; the associated TeamID is retrieved automatically.

Each person is represented by a DEVICE group "User" . The person's name is entered there, and their regular presence times are specified under Parameters for each weekday. The associated UserID is retrieved automatically when changed. Enter unique abbreviations in the Device Station for the Slave list. Link HVAC NOW to the room control (Buttons/Contacts > Contact of Presence) either directly or using a Memory.

Notes:

  • Maximum of 31 people
  • Manual configuration required — not plug-and-play
  • No overnight shifts and no overnight HVAC/heating intervals are supported
  • All entries , except shared shifts, are interpreted as absences
  • Only one shift entry per day is supported
  • Only one contiguous HVAC interval will be calculated
  • This DDF is provided as-is and may need further improvement
  • Today's shift entries (02:00–22:00) are updated automatically every hour , or can be queried manually via a command in Info

Regular Present: True if the current time is between the start and end of the defined regular presence time.

Present: True if Regular Present AND there is no current absence entry.

Shows absence shifts entered for today for each person (for example: "Vacation from … to …").

The presence range is taken from the shift entry [S] if a shift has a duration between the "Full-day Absence" parameter (e.g., 6 h) and 11 hours.

no HVAC if

  • NO_REG_PRES: No presence interval
  • INV_REG_PRES: Invalid presence interval (P_START >= P_END)
  • ABS_COV_PRES: Absence covers whole presence
  • LEAD_IS_LONGER: Leadtime Error (HVAC_START >= HVAC_END)

Using a dedicated DDF for rooms , the presence states of persons are assigned via IO inputs. The overall presence state of the room is then derived from these inputs. Alternatively, in the System LOGICS, the HVAC signals of persons can be combined using OR blocks to determine the HVAC signal of a room with multiple occupants.

 
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