Connettore calendario Microsoft

::: (info) () Per scaricare l'applicazione, visitare: Biblioteca:::

Integrazione con l'API Graph di Microsoft per il calendario

Introduzione

Microsoft Calendar API consente agli utenti di creare, leggere e modificare gli eventi del calendario Microsoft con il giusto accesso impostato sui loro account M365. L'obiettivo di questo connettore è integrare Tulip con Microsoft utilizzando la Graph API di Microsoft (v1.0) tramite i connettori HTTP e fornire ai nostri clienti un connettore pronto all'uso che possa essere importato nella loro istanza.

Scopo

Verranno evidenziate diverse funzioni del connettore che possono essere costruite effettuando chiamate HTTP alla Graph Api (v1.0) di Microsoft per interagire con gli eventi del calendario di Microsoft, per mostrare varie azioni di lettura e scrittura sul calendario che potrebbero essere sfruttate per vari casi d'uso.

Documentazione API

Documentazione dell'API Graph di Microsoft

Prerequisiti

1. Creare un account su Microsoft 365 e configurare le credenziali OAuth 2.0 in Microsoft Entra ID.
2. Registrare l'API con gli ambiti richiesti nel portale Microsoft. Azure - Entra ID

Video di impostazione del connettore per Excel:

È possibile seguire gli stessi passaggi per configurare anche il connettore per il calendario.

Dettagli della connessione Tulip

Le seguenti informazioni devono essere configurate su Tulip.

Connettori.

1. In esecuzione su: Host del connettore cloud
2. Host: graph.microsoft.com
3. Porta: 443
4. TLS: Sì

OAuth 2: l'autenticazione sarà trasferita a tutte le funzioni del connettore.

Funzioni del connettore

1) Ottenere tutti gli eventi del calendario

Scopo

Questo connettore recupera tutti gli eventi del calendario da M365 Calendar.

Punto finale

Chiamata HTTP GET all'endpoint: https://graph.micrsoft.com:443/v1.0/me/events

Input richiesti

Nessun ingresso richiesto

Estrattore di output

1. eventID: identificatore univoco dell'evento che verrà utilizzato per eseguire le altre operazioni.
2. eventSubject: Oggetto dell'evento.
3. eventContent: Contenuto dell'evento.
4. eventStartDate: Data e ora di inizio dell'evento.
5. eventEndDate: Data e ora di fine dell'evento.
6. eventLocation: Luogo dell'evento.
7. eventAttendees: Partecipanti dell'evento.
8. eventOrganizer: Organizzatore dell'evento.
9. I parametri aggiuntivi restituiti con la risposta sono inclusi nei parametri di output.

2) Ottenere il calendario delle riunioni degli utenti

Scopo

Questo connettore ottiene le informazioni sulla disponibilità libera/occupata di un insieme di utenti, liste di distribuzione o risorse (sale o attrezzature) per un periodo di tempo specificato.

Punto finale

Chiamata HTTP GET all'endpoint -https://graph.microsoft.com:443/v1.0/me/calendar/getSchedule

Input richiesti

I parametri da inserire nel corpo della richiesta sono i seguenti

1. Indirizzo e-mail: Un insieme di indirizzi SMTP di utenti, liste di distribuzione o risorse per cui ottenere informazioni sulla disponibilità.
2. Data inizio pianificazione Ora: la data, l'ora e il fuso orario di inizio del periodo.
3. Data di fine pianificazione Ora: la data, l'ora e il fuso orario in cui termina il periodo.
4. Fuso orario: Fuso orario dell'evento.

Estrattore di output

1. scheduleUserId: Indirizzo e-mail dell'utente della pianificazione.
2. startTime: data, ora e fuso orario di inizio del periodo.
3. endTime: data, ora e fuso orario in cui termina il periodo.
4. timeZone: Fuso orario.
5. scheduleStatus: Stato di risposta delle pianificazioni dell'utente.
6. scheduleSubject: Oggetto dell'evento pianificato.
7. scheduleLocation: Luogo dell'evento programmato.
8. scheduleStartDateTime: ora della data di inizio dell'evento pianificato.
9. scheduleEndDateTime: ora della data di fine dell'evento pianificato.

3) Creare un evento

Scopo

1. Gli utenti possono passare un Oggetto dell'evento, un Contenuto, una Data di inizio, una Data di fine e altri parametri come input e Tulip creerà un nuovo evento di calendario con gli input forniti. La risposta dell'API sarà costituita dai metadati e dalle varie proprietà dell'evento di calendario. Questo può essere ulteriormente utilizzato per recuperare e aggiornare gli eventi.
2. Questo connettore può creare un evento nel calendario predefinito dell'utente o nel calendario specificato per un utente specifico, un gruppo di utenti o più utenti.
3. Le informazioni estratte da Microsoft Graph V1.0 API possono essere ulteriormente utilizzate all'interno delle applicazioni Tulip, delle tabelle Tulip o delle variabili Tulip che vengono convogliate in altre funzioni del connettore.

Punto finale

Chiamata HTTP POST all'endpoint: https://graph.microsoft.com:443/v1.0/me/events

Input richiesti

I parametri da inserire nel corpo della richiesta sono i seguenti

1. Oggetto dell'evento: Oggetto dell'evento
2. Contenuto dell'evento: Contenuto dell'evento
3. Data e ora di inizio dell'evento: data e ora di inizio dell'evento
4. Fuso orario dell'evento: Fuso orario dell'evento
5. Data di fine dell'evento Ora: data e ora di fine dell'evento
6. Luogo dell'evento: Luogo dell'evento
7. Indirizzo e-mail del partecipante: Indirizzo e-mail del partecipante

Estrattore di output

1. eventId: ID evento creato
2. eventTimezone: Fuso orario dell'evento
3. eventSubject: Oggetto dell'evento
4. eventBody: Contenuto dell'evento
5. eventStartDateTime: data e ora di inizio dell'evento
6. eventEndDateTime: data e ora di fine dell'evento
7. eventLocation: Luogo dell'evento
8. I parametri aggiuntivi che vengono restituiti con la risposta sono inclusi nei parametri di output.

4) Creare eventi ricorrenti

Scopo

1. Gli utenti possono passare un Oggetto dell'evento, un Contenuto, una Data di inizio, una Data di fine e altri parametri come input e Tulip creerà un nuovo evento di calendario ricorrente con gli input forniti. La risposta dell'API sarà costituita dai metadati e dalle varie proprietà dell'evento di calendario. Questo può essere ulteriormente utilizzato per recuperare e aggiornare gli eventi.
2. Questo connettore creerà un evento ricorrente nel calendario predefinito dell'utente e nel calendario specificato per un utente o un gruppo di utenti.
3. Le informazioni estratte dall'API Microsoft Graph V1.0 possono essere ulteriormente utilizzate all'interno delle applicazioni Tulip, delle tabelle Tulip o delle variabili Tulip che vengono convogliate in altre funzioni del connettore.

Punto finale

Chiamata HTTP POST all'endpoint https://graph.microsoft.com:443/v1.0/me/events

Input richiesti

I parametri da inserire nel corpo della richiesta sono i seguenti

1. Oggetto dell'evento: Oggetto dell'evento
2. Contenuto dell'evento: Contenuto dell'evento
3. Data e ora di inizio dell'evento: data e ora di inizio dell'evento
4. Fuso orario dell'evento: Fuso orario dell'evento
5. Data di fine dell'evento Ora: data e ora di fine dell'evento
6. Luogo dell'evento: Luogo dell'evento
7. Indirizzo e-mail del partecipante: Indirizzo e-mail del partecipante
8. Tipo di evento ricorrente: Tipo di evento di ricorrenza
9. Giorni della settimana di ricorrenza: Giorno dell'evento di ricorrenza
10. Data di inizio ricorrenza: Data di inizio dell'evento di ricorrenza
11. Data di fine ricorrenza: Data di fine dell'evento di ricorrenza

Estrattore di output

1. eventId: ID evento creato
2. eventTimezone: Fuso orario dell'evento
3. eventSubject: Oggetto dell'evento
4. eventBody: Contenuto dell'evento
5. eventStartDateTime: data e ora di inizio dell'evento
6. eventEndDateTime: data e ora di fine dell'evento
7. eventLocation: Luogo dell'evento
8. eventRecurrenceRangeStartDate: Data di inizio dell'evento di ricorrenza.
9. eventRecurrenceRangeEndDate: Data di fine dell'evento di ricorrenza.
10. eventAttendees: Partecipanti all'evento.
11. eventOrganizer: Organizzatore dell'evento.
12. I parametri aggiuntivi restituiti con la risposta sono inclusi nei parametri di output.

5) Aggiornare un evento

Scopo

1. Gli utenti possono passare un ID evento, un Oggetto, un Contenuto e altri parametri come input e Tulip aggiornerà gli eventi nel calendario. La risposta dell'API sarà costituita dai metadati e dalle varie proprietà degli eventi del calendario.
2. Le informazioni estratte dall'API Microsoft Graph V1.0 possono essere utilizzate all'interno delle applicazioni Tulip, delle tabelle Tulip o delle variabili Tulip che vengono convogliate in altre funzioni del connettore.

Punto finale

Chiamata HTTP PATCH all'endpoint https://graph.microsoft.com:443/v1.0/me/events/{eventID}

Input richiesti

I parametri che vengono inviati come corpo della richiesta sono i seguenti

1. Oggetto dell'evento: Oggetto dell'evento
2. Contenuto dell'evento: Contenuto dell'evento
3. Data di inizio dell'evento Ora: data di inizio dell'evento
4. TimeZone dell'evento: fuso orario dell'evento
5. Data di fine dell'evento Ora: data di fine dell'evento
6. Luogo dell'evento: Luogo dell'evento
7. Indirizzo e-mail del partecipante: Indirizzo e-mail del partecipante

Estrattore di output

1. eventId: ID evento creato
2. eventTimezone: Fuso orario dell'evento
3. eventSubject: Oggetto dell'evento
4. eventBody: Contenuto dell'evento
5. eventStartDateTime: data e ora di inizio dell'evento
6. eventEndDateTime: data e ora di fine dell'evento
7. eventLocation: Luogo dell'evento
8. I parametri aggiuntivi che vengono restituiti con la risposta sono inclusi nei parametri di output.

6) Cancellare un evento

Scopo

1. Gli utenti possono inserire l'ID di un evento e Tulip cancellerà l'evento dal calendario.

Punto finale

Chiamata HTTP DELETE all'endpoint - https://graph.microsoft.com:443/v1.0/me/events/{eventID}

Input richiesti

I parametri che vengono inviati come corpo della richiesta sono i seguenti

1. ID evento - L'ID dell'evento

Ulteriori informazioni

Ulteriori informazioni sui connettori Microsoft

• Connettore Microsoft Outlook
• Connettore Microsoft Teams
• Connettore Microsoft Excel