Calendar
Descrizione
Microsoft Calendar
Questo DDF consente di utilizzare gli eventi imminenti di Microsoft 365 come trigger per l'automazione degli ambienti.
Un tipico caso d'uso è la preparazione automatica di una sala riunioni. Ad esempio, il riscaldamento può essere configurato in modo da portare l'ambiente alla temperatura desiderata prima dell'inizio di un evento programmato. In base al sistema di controllo dell'ambiente disponibile, è inoltre possibile attivare in anticipo altre funzioni, come la ventilazione o l'illuminazione.
Il trigger Event Upcoming viene attivato quando viene rilevato un evento imminente per un ambiente configurato. L'azione che viene eseguita in seguito a questo evento viene definita nel sistema di controllo dell'ambiente.
Room control > Buttons/Contacts > Contact of presence > Event Upcoming
Requisiti
Per utilizzare questo DDF devono essere soddisfatti i seguenti requisiti:
- Microsoft 365 con le relative informazioni sulle sale e sui calendari
- un'applicazione registrata in Microsoft Entra ID con le autorizzazioni necessarie per accedere a Microsoft 365
- Tenant ID dell'ambiente Microsoft 365
- Client ID dell'applicazione registrata
- Client Secret dell'applicazione registrata
- l'indirizzo e-mail della/e sala/e o del/i calendario/i Microsoft 365 i cui eventi devono essere considerati
Configurazione del Controller
La configurazione viene effettuata direttamente nella Device Station:
| Parametro | Descrizione | Esempio |
|---|---|---|
| SLAVE | Indirizzo e-mail della/e sala/e o del/i calendario/i Microsoft 365 i cui eventi devono essere monitorati. Più indirizzi devono essere separati da virgole. | meetingroom1@azienda.it,meetingroom2@azienda.it |
| TENANTID | ID univoco del tenant Microsoft 365. | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx |
| CLIENTID | ID dell'applicazione registrata in Microsoft Entra ID utilizzata per accedere a Microsoft 365. | xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx |
| SECRET | Client Secret dell'applicazione registrata utilizzato per l'autenticazione con Microsoft 365. | •••••••••••••••• |
Per SLAVE è possibile inserire fino a 30 indirizzi e-mail, purché non venga superato il limite massimo di caratteri. Il campo SLAVE è limitato a 250 caratteri.
Con il comando GETSLAVESROOMS nella Device Station è possibile recuperare automaticamente le sale disponibili da Microsoft Places.
Configurazione nell'Element Device
Nell'Element Device è possibile collegare il gruppo Info all'elemento corrispondente.
Utilizzo
Dopo una configurazione corretta, il DDF monitora gli eventi delle sale o dei calendari configurati in SLAVE.
Quando viene rilevato un evento imminente, il trigger Event Upcoming è disponibile per l'automazione dell'ambiente. Il sistema di controllo dell'ambiente può quindi essere utilizzato per attivare funzioni come il preriscaldamento, la ventilazione o l'illuminazione.
In questo modo, l'automazione dell'ambiente può reagire all'utilizzo programmato della sala già prima dell'inizio di un evento, evitando al contempo un consumo energetico non necessario al di fuori degli orari di utilizzo.
Informazioni generali
| Produttore | Tipo | Protocollo | Modello | Versione | ID |
|---|---|---|---|---|---|
| Microsoft | Calendario | REST-API (DDF) | 1 | 1 | 0x0D00007700010100 |
Documenti
Elementi DDF
| ID | Nome | Unita | Tipo | Direzione |
|---|---|---|---|---|
| 0 | Count | |||
| 1 | Subject | |||
| 2 | Start DateTime | YYYY-MM-DDTHH:MM:SS.sssssss | ||
| 3 | End DateTime | YYYY-MM-DDTHH:MM:SS.sssssss | ||
| 4 | End Time Zone | |||
| 22 | Start DateTime (EU) | DD.MM.YYYY - HH:MM:SS | ||
| 23 | End DateTime (EU) | DD.MM.YYYY - HH:MM:SS | ||
| 50 | Event Now Active | 1 = now active | ||
| 51 | Event Upcoming | 1 = events upcoming | ||
| 52 | Look-Ahead Time | h | ||
| 60 | Event Now Active (Inv) | 0 = now active | ||
| 61 | Event Upcoming (Inv) | 0 = events upcoming | ||
| 160 | Command Token Now | |||
| 161 | Command Verbose | |||
| 162 | Command Event Refresh Now | |||
| 170 | Event Refresh Timer | s | ||
| 180 | Token Refresh Timer | s | ||
| 181 | Event Update Time | HH:MM:SS | ||
| 190 | Message | |||
| 191 | Message Trigger | |||
| 192 | Message Info | |||
| 195 | Station Config Done | 1 = config done | ||
| 200 | Quality Event | |||
| 201 | Quality Token |
Nota
Last Commit: 21d3c8eb | 2026-02-26 09:46:39