Shifts
Descrizione
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.
Informazioni generali
| Produttore | Tipo | Protocollo | Modello | Versione | ID |
|---|---|---|---|---|---|
| Microsoft | Gateway | REST-API (DDF) | 2 | 1 | 0x0D00007700020100 |
Documenti
Elementi DDF
| ID | Nome | Unita | Tipo | Direzione |
|---|---|---|---|---|
| 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 |
Nota
several changes
*2025-12-26 15:02:14 (do) ******************************
Last Commit: 829ace3d | 2025-12-26 15:01:23