Informazioni di riferimento sul calendario IQ aziendale (anteprima)

Panoramica

Strumenti disponibili

mcp_CalendarTools_graph_acceptEvent

Accetta l'invito all'evento specificato nel calendario di un utente.

Parametri obbligatori:

• eventId: ID dell'evento da accettare

Parametri facoltativi:

• userId: ID utente o nomeprincipaleutente
• comment: testo facoltativo incluso nella risposta
• sendResponse: indica se inviare una risposta all'organizzatore

mcp_CalendarTools_grafico_annullaEvento

Annulla un evento nel calendario di un utente specificato e invia una notifica ai partecipanti.

Parametri obbligatori:

• eventId: identificatore univoco dell'evento da annullare

Parametri facoltativi:

• userId: ID utente o userPrincipalName
• comment: messaggio di annullamento facoltativo

mcp_CalendarTools_graph_createEvent

Crea un nuovo evento di calendario nel calendario di un utente specificato. Supporta eventi ricorrenti e riunioni online.

Parametri obbligatori:

• Oggetto: Oggetto/titolo dell'evento (non vuoto)
• Inizio: Inizio del timestamp con dateTime e timeZone
• Conclusione: Fine timestamp con dateTime e timeZone
• attendees_addresses: matrice di indirizzi e-mail dei partecipanti

Parametri facoltativi:

• userId: ID utente o userPrincipalName
• body: corpo dell'evento con contentType (Testo/HTML) e contenuto
• Posizione: Posizione con displayName
• attendees_types: ruoli dei partecipanti (obbligatorio, facoltativo, risorsa)
• attendees_names: nomi visualizzati dei partecipanti
• recurrence: criterio di ricorrenza e intervallo
• isOnlineMeeting: impostare su true per la riunione online
• ProviderRiunioneOnline:teamsForBusiness, skypeForBusiness, skypeForConsumer
• allowNewTimeProposals: consenti proposte di orario (impostazione predefinita: vero)
• transactionId:Idempotence Identificatore

mcp_CalendarTools_graph_rifiutaEvento

Rifiuta l'invito all'evento specificato nel calendario di un utente.

Parametri obbligatori:

• eventId: l'ID dell'evento da rifiutare

Parametri facoltativi:

• userId: ID utente o userPrincipalName

• comment: testo facoltativo incluso nella risposta

• sendResponse: indica se inviare la risposta

mcp_CalendarTools_graph_deleteEvent

Elimina un evento dal calendario di un utente specificato.

Parametri obbligatori:

• eventId: identificatore univoco dell'evento da eliminare

Parametri facoltativi:

• userId: ID utente o userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

Suggerisci orari e posizioni delle riunioni in base alla disponibilità degli organizzatori e dei partecipanti.

Parametri obbligatori:

• meetingDuration: durata della riunione (ad esempio, "PT1H")

Parametri facoltativi:

• userId: ID organizzatore o userPrincipalName
• attendees_addresses: indirizzi e-mail dei partecipanti
• attendees_types: tipi di partecipanti
• attendees_names: nomi visualizzati dei partecipanti
• Vincolo temporale: Disponibilità oraria con fasce orarie e activityDomain
• locationConstraint: opzioni per la posizione
• maxCandidates: numero massimo di suggerimenti
• isOrganizerOptional: flag organizzatore facoltativo
• returnSuggestionReasons: includi motivi
• minimumAttendeePercentage: soglia minima di partecipazione

mcp_CalendarTools_graph_getEvent

Recupera un singolo evento di calendario dal calendario di un utente specificato.

Parametri obbligatori:

• eventId: l'identificatore univoco dell'evento

Parametri facoltativi:

• userId: ID utente o userPrincipalName
• seleziona: parametro di query OData \$select
• Espandi: OData \$expand per le proprietà di navigazione

mcp_CalendarTools_graph_getSchedule

Recupera il calendario di disponibilità per un utente, una lista di distribuzione o una risorsa.

Parametri obbligatori:

• schedules: indirizzi SMTP di utenti o risorse
• Inizio: Ora di inizio con dateTime e timeZone
• EndTime: Fine del tempo con dateTime e timeZone

Parametri facoltativi:

• userId: ID utente o userPrincipalName
• availabilityViewInterval: intervallo di tempo espresso in minuti

mcp_CalendarTools_graph_listCalendarView

Recupera le occorrenze del calendario all'interno di un intervallo di tempo specificato per un utente.

Parametri obbligatori:

• startDateTime: inizio dell'intervallo di tempo (ISO 8601)
• endDateTime: fine dell'intervallo di tempo (ISO 8601)

Parametri facoltativi:

• userId: ID utente o userPrincipalName
• top: numero massimo di eventi
• orderby: clausola di ordinamento

mcp_CalendarTools_graph_listEvents

Recupera un elenco di eventi dal calendario di un utente specificato.

Parametri facoltativi:

• userId: ID utente o userPrincipalName
• startDateTime: inizio dell'intervallo di tempo (ISO 8601)
• endDateTime: fine dell'intervallo di tempo (ISO 8601)
• top: numero massimo di eventi
• filter: query di filtro OData
• orderby: query di ordinamento di OData

mcp_CalendarTools_graph_aggiornaEvento

Aggiorna un evento di calendario esistente nel calendario di un utente specificato.

Parametri obbligatori:

• eventId: l'identificatore univoco dell'evento

Parametri facoltativi:

• userId: ID utente o userPrincipalName
• subject: oggetto aggiornato
• corpo: contenuto del corpo aggiornato
• start: ora di inizio aggiornata
• end: ora di fine aggiornata
• location: posizione aggiornata
• attendees_addresses: indirizzi e-mail dei partecipanti aggiornati
• attendees_types: tipi di partecipanti aggiornati
• attendees_names: nomi dei partecipanti aggiornati
• isCancelled: imposta su vero per annullare
• recurrence: criterio di ricorrenza aggiornato

Funzionalità chiave

Gestione eventi

• Creazione, lettura, aggiornamento ed eliminazione di eventi
• Accettazione, rifiuto e annullamento di inviti
• Supporto per eventi ricorrenti
• Integrazione con le riunioni online (Teams, Skype)

Disponibilità e pianificazione

• Ottieni orari di disponibilità
• Ricerca degli orari di riunione con il controllo della disponibilità
• Visualizzazione Calendario con filtro dell'intervallo di tempo
• Analisi della disponibilità dei partecipanti

Gestione dei partecipanti

• Gestisci partecipanti obbligatori, facoltativi e previsti come risorse
• Supporto per le proposte di orario
• Traccia delle risposte
• Supporto per le liste di distribuzione

Criteri di ricorrenza

• Criteri giornalieri, settimanali, mensili e annuali
• Ricorrenza assoluta e relativa
• Data di fine o conteggio delle occorrenze
• Specifiche del giorno della settimana e del mese

Riunioni online

• Integrazione con Teams for Business
• Supporto per Skype for Business
• Supporto per Skype (per uso personale)
• Generazione automatica dei collegamenti alle riunioni

Note

• Tutti i timestamp usano il formato UTC/ISO 8601 con fuso orario
• Il calendario MCP si basa su UserprofileMCP per trovare gli utenti all'interno dell'organizzazione
• Il formato degli indirizzi e-mail deve essere valido
• Le matrici di partecipanti (indirizzi, tipi, nomi) devono essere nello stesso ordine
• Le riunioni online richiedono isOnlineMeeting=true e onlineMeetingProvider
• La ricorrenza richiede sia oggetti modello che oggetti intervallo
• I fusi orari devono essere coerenti tra le ore di inizio e di fine
• TransactionId Abilita idempotent la creazione di eventi