Microsoft Calendar

Calendario • REST-API (DDF)

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

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.

Produttore Tipo Protocollo Modello Versione ID
Microsoft Calendario REST-API (DDF) 1 1 0x0D00007700010100
Nessun documento.
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
*2026-03-18 13:51:50 (hw) ******************************
Last Commit: 21d3c8eb | 2026-02-26 09:46:39