Connecteur de calendrier Microsoft

:: : (info) () Pour télécharger l'application, visitez : Bibliothèque::: :

Intégrer l'API graphique de Microsoft pour le calendrier

Introduction

L'API Microsoft Calendar permet aux utilisateurs de créer, lire et modifier les événements du calendrier Microsoft avec l'accès approprié à leurs comptes M365. L'objectif de ce connecteur est d'intégrer Tulip avec Microsoft en utilisant l'API Graphique de Microsoft (v1.0) en utilisant des connecteurs HTTP et de fournir à nos clients un connecteur prêt à l'emploi qui peut être importé dans leur instance.

Objectif

Nous allons mettre en évidence les différentes fonctions du connecteur qui peuvent être construites en faisant des appels HTTP à l'API Graphique de Microsoft (v1.0) pour interagir avec les événements du calendrier Microsoft afin de présenter diverses actions de lecture et d'écriture sur le calendrier qui pourraient être exploitées pour divers cas d'utilisation.

Doc de l'API

Documentation de l'API Microsoft Graph

Pré-requis

1. Créer un compte sur Microsoft 365 et configurer les informations d'identification OAuth 2.0 dans Microsoft Entra ID.
2. Enregistrer l'API avec les champs d'application requis dans le portail Microsoft. Azure - Entra ID

Vidéo de configuration du connecteur pour Excel :

Vous pouvez suivre les mêmes étapes pour configurer le connecteur de calendrier.

Détails de la connexion Tulip

Les informations suivantes doivent être configurées sur le site Tulip's

Connecteurs.

1. Exécuté sur : Cloud Connector Host
2. Hôte : graph.microsoft.com
3. Port : 443
4. TLS : Oui

OAuth 2 : L'authentification sera transférée à toutes les fonctions du connecteur.

Fonctions du connecteur

1) Obtenir tous les événements du calendrier

Objectif

Ce connecteur récupère tous les événements du calendrier M365.

Point d'arrivée

Appel HTTP GET au point de terminaison : https://graph.micrsoft.com:443/v1.0/me/events

Données requises

Aucune entrée requise

Extracteur de sortie

1. eventID : Identifiant unique de l'événement qui sera utilisé pour effectuer les autres tâches.
2. eventSubject : Sujet de l'événement.
3. eventContent : Contenu de l'événement.
4. eventStartDate : Date et heure de début de l'événement.
5. eventEndDate : Date et heure de fin de l'événement.
6. eventLocation : Lieu de l'événement.
7. eventAttendees : Participants à l'événement.
8. eventOrganizer : Organisateur de l'événement.
9. Les paramètres supplémentaires renvoyés avec la réponse sont inclus dans les paramètres de sortie.

2) Obtenir le calendrier des réunions d'utilisateurs

Objectif

Ce connecteur permet d'obtenir les informations de disponibilité libre/occupée pour un ensemble d'utilisateurs, de listes de distribution ou de ressources (salles ou équipements) pour une période donnée.

Point d'arrivée

Appel HTTP GET au point de terminaison -https://graph.microsoft.com:443/v1.0/me/calendar/getSchedule

Données requises

Les paramètres suivants doivent être transmis dans le corps de la requête

1. Adresse électronique : Une collection d'adresses SMTP d'utilisateurs, de listes de distribution ou de ressources pour lesquelles des informations sur la disponibilité doivent être obtenues.
2. Schedule Start Date Time : Date, heure et fuseau horaire de début de la période.
3. Schedule End Date Time : Date, heure et fuseau horaire de fin de la période.
4. Fuseau horaire : Fuseau horaire de l'événement.

Extracteur de sortie

1. scheduleUserId : Adresse électronique de l'utilisateur de la programmation.
2. startTime : Date, heure et fuseau horaire de début de la période.
3. endTime : Date, heure et fuseau horaire de fin de la période.
4. timeZone : Fuseau horaire.
5. scheduleStatus : État de la réponse des planifications de l'utilisateur.
6. scheduleSubject : Sujet de l'événement programmé.
7. scheduleLocation : Lieu de l'événement programmé.
8. scheduleStartDateTime : Heure de début de l'événement programmé.
9. scheduleEndDateTime : Heure de fin de l'événement programmé.

3) Créer un événement

Objectif

1. Les utilisateurs peuvent passer un sujet d'événement, un contenu, une date et heure de début, une date et heure de fin, et d'autres paramètres en entrée et Tulip créera un nouvel événement de calendrier avec les entrées fournies. La réponse de l'API sera constituée des métadonnées et des diverses propriétés de l'événement du calendrier. Ceci peut être utilisé pour récupérer et mettre à jour des événements.
2. Ce connecteur peut créer un événement dans le calendrier par défaut de l'utilisateur ou dans le calendrier spécifié pour un utilisateur spécifique, un groupe d'utilisateurs ou plusieurs utilisateurs.
3. Les informations sont extraites de l'API Microsoft Graph V1.0 et peuvent ensuite être utilisées dans les applications Tulip, les tables Tulip ou les variables Tulip qui seront acheminées vers d'autres fonctions du connecteur.

Point d'arrivée

Appel HTTP POST au point de terminaison : https://graph.microsoft.com:443/v1.0/me/events

Données requises

Les paramètres suivants doivent être transmis dans le corps de la requête

1. Sujet de l'événement : Sujet de l'événement
2. Contenu de l'événement : Contenu de l'événement
3. Date et heure de début de l'événement : Date et heure de début de l'événement
4. Fuseau horaire de l'événement : Fuseau horaire de l'événement
5. Date de fin de l'événement Heure : Date de fin de l'événement
6. Lieu de l'événement : Lieu de l'événement
7. Adresse électronique du participant : Adresse électronique du participant

Extracteur de sortie

1. eventId : ID de l'événement créé
2. eventTimezone : TimeZone de l'événement
3. eventSubject : Sujet de l'événement
4. eventBody : Contenu de l'événement
5. eventStartDateTime : Date de début de l'événement
6. eventEndDateTime : Date de fin de l'événement
7. eventLocation : Lieu de l'événement
8. Les paramètres supplémentaires renvoyés avec la réponse sont inclus dans les paramètres de sortie.

4) Créer des événements récurrents

Objectif

1. Les utilisateurs peuvent passer un sujet d'événement, un contenu, une date de début, une date de fin et d'autres paramètres en entrée et Tulip créera un nouvel événement de calendrier récurrent avec les entrées fournies. La réponse de l'API sera constituée des métadonnées et des diverses propriétés de l'événement du calendrier. Celles-ci peuvent être utilisées pour récupérer et mettre à jour des événements.
2. Ce connecteur créera un événement récurrent dans le calendrier par défaut de l'utilisateur et dans le calendrier spécifié pour un utilisateur ou un groupe d'utilisateurs.
3. Les informations sont extraites de l'API Microsoft Graph V1.0 et peuvent ensuite être utilisées dans les applications Tulip, les tables Tulip ou les variables Tulip qui seront acheminées vers d'autres fonctions du connecteur.

Point d'arrivée

Appel HTTP POST au point de terminaison https://graph.microsoft.com:443/v1.0/me/events

Données requises

Les paramètres suivants doivent être transmis dans le corps de la requête

1. Sujet de l'événement : Sujet de l'événement
2. Contenu de l'événement : Contenu de l'événement
3. Date et heure de début de l'événement : Date et heure de début de l'événement
4. Fuseau horaire de l'événement : Fuseau horaire de l'événement
5. Date de fin de l'événement Heure : Date de fin de l'événement
6. Lieu de l'événement : Lieu de l'événement
7. Adresse électronique du participant : Adresse électronique du participant
8. Type d'événement récurrent : Type d'événement récurrent
9. Jours de la semaine de récurrence : Jour de l'événement de récurrence
10. Date de début de la récurrence : Date de début de l'événement de récurrence
11. Date de fin de la récurrence : Date de fin de l'événement de récurrence

Extracteur de sortie

1. eventId : ID de l'événement créé
2. eventTimezone : TimeZone de l'événement
3. eventSubject : Sujet de l'événement
4. eventBody : Contenu de l'événement
5. eventStartDateTime : Date et heure de début de l'événement
6. eventEndDateTime : Date et heure de fin de l'événement
7. eventLocation : Lieu de l'événement
8. eventRecurrenceRangeStartDate : Date de début de l'événement de récurrence.
9. eventRecurrenceRangeEndDate : Date de fin de l'événement récurrent.
10. eventAttendees : Participants à l'événement.
11. eventOrganizer : Organisateur de l'événement.
12. Les paramètres supplémentaires renvoyés avec la réponse sont inclus dans les paramètres de sortie.

5) Mise à jour d'un événement

Objectif

1. Les utilisateurs peuvent transmettre un ID d'événement, un sujet, un contenu et d'autres paramètres en entrée et Tulip mettra à jour les événements dans le calendrier. La réponse de l'API sera constituée des métadonnées et des diverses propriétés des événements du calendrier.
2. Les informations sont extraites de l'API Microsoft Graph V1.0 et peuvent ensuite être utilisées dans les applications Tulip, les tables Tulip, ou les variables Tulip qui seront acheminées vers d'autres fonctions du connecteur.

Point final

Appel HTTP PATCH au point de terminaison https://graph.microsoft.com:443/v1.0/me/events/{eventID}

Données requises

Les paramètres suivants sont envoyés dans le corps de la requête

1. Sujet de l'événement : Objet de l'événement
2. Contenu de l'événement : Contenu de l'événement
3. Date de début de l'événement : Heure de début de l'événement
4. TimeZone de l'événement : fuseau horaire de l'événement
5. Event End Date Time : Heure de fin de l'événement
6. Event Location (Lieu de l'événement) : Lieu de l'événement
7. Adresse électronique du participant : Adresse électronique du participant

Extracteur de sortie

1. eventId : ID de l'événement créé
2. eventTimezone : TimeZone de l'événement
3. eventSubject : Sujet de l'événement
4. eventBody : Contenu de l'événement
5. eventStartDateTime : Date de début de l'événement
6. eventEndDateTime : Date de fin de l'événement
7. eventLocation : Lieu de l'événement
8. Les paramètres supplémentaires renvoyés avec la réponse sont inclus dans les paramètres de sortie.

6) Supprimer un événement

Objectif

1. Les utilisateurs peuvent transmettre un identifiant d'événement en entrée et Tulip supprimera l'événement dans le calendrier.

Point final

HTTP DELETE appel au point de terminaison - https://graph.microsoft.com:443/v1.0/me/events/{eventID}

Données requises

Les paramètres suivants sont envoyés dans le corps de la requête

1. ID de l'événement - L'ID de l'événement

Pour en savoir plus

Pour plus d'informations sur les connecteurs Microsoft

• Connecteur Microsoft Outlook
• Connecteur Microsoft Teams
• Connecteur Microsoft Excel