Shifts
Beschreibung
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.
Allgemeine Infos
| Hersteller | Typ | Protokoll | Modell | Version | ID |
|---|---|---|---|---|---|
| Microsoft | Gateway | REST-API (DDF) | 2 | 1 | 0x0D00007700020100 |
Dokumente
DDF-Items
| 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 |
Notiz
several changes
*2025-12-26 15:02:14 (do) ******************************
Last Commit: 829ace3d | 2025-12-26 15:01:23