Microsoft Shifts

Gateway • REST-API (DDF)

Microsoft
Scarica DDF firmato Versione min. OS: V9615-09
Device image

Con questo DDF è possibile integrare nel sistema ROOM CONTROL i dati relativi alle assenze dei dipendenti provenienti da Microsoft Shifts / Teams . Determinando gli orari di presenza e applicando tempi di anticipo configurabili per l'arrivo e la partenza, il sistema consente un controllo climatico predittivo degli ambienti basato sull'occupazione effettiva.

Per le visualizzazioni di stato viene utilizzato un elemento DEVICE denominato "Info" . Qui viene inserito il nome del team; il TeamID associato viene recuperato automaticamente.

Ogni persona è rappresentata da un gruppo DEVICE "User" . Qui viene inserito il nome della persona e, alla voce Parameters , vengono specificati per ogni giorno della settimana i normali orari di presenza . L'UserID associato viene recuperato automaticamente quando viene modificato. Inserire nella Device Station abbreviazioni univoche per l'elenco Slave. Collegare HVAC NOW al controllo della stanza (Buttons/Contacts > Contact of Presence), direttamente oppure tramite una Memory.

Note:

  • Massimo 31 persone
  • Configurazione manuale necessaria — non plug-and-play
  • Non sono supportati i turni notturni né gli intervalli HVAC/di riscaldamento durante la notte
  • Tutte le voci , ad eccezione dei turni condivisi, vengono interpretate come assenze
  • È supportata una sola voce di turno al giorno
  • Verrà calcolato un solo intervallo HVAC continuo
  • Questo DDF viene fornito così com'è e potrebbe richiedere ulteriori miglioramenti
  • Le voci dei turni odierni (02:00–22:00) vengono aggiornate automaticamente ogni ora oppure possono essere interrogate manualmente tramite un comando in Info

Regular Present: True se l'ora corrente è compresa tra l'inizio e la fine dell'orario di presenza regolare definito.

Present: True se Regular Present E non è presente alcuna voce di assenza corrente.

Mostra i turni di assenza inseriti per oggi per ogni persona (ad esempio: "Ferie dal … al …").

L' intervallo di presenza viene ricavato dalla voce del turno [S] se un turno ha una durata compresa tra il parametro "Full-day Absence" (ad es. 6 h) e 11 ore.

nessun HVAC in caso di

  • NO_REG_PRES: Nessun intervallo di presenza
  • INV_REG_PRES: Intervallo di presenza non valido (P_START >= P_END)
  • ABS_COV_PRES: L'assenza copre l'intero periodo di presenza
  • LEAD_IS_LONGER: Errore nel tempo di anticipo (HVAC_START >= HVAC_END)

Utilizzando un DDF dedicato per gli ambienti , gli stati di presenza delle persone vengono assegnati tramite ingressi IO. Lo stato di presenza complessivo dell'ambiente viene quindi ricavato da questi ingressi. In alternativa, nelle System LOGICS, i segnali HVAC delle singole persone possono essere combinati tramite blocchi OR per determinare il segnale HVAC di un ambiente con più occupanti.

 
Produttore Tipo Protocollo Modello Versione ID
Microsoft Gateway REST-API (DDF) 2 1 0x0D00007700020100
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
*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