- Impression
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
- Créer un compte sur Microsoft 365 et configurer les informations d'identification OAuth 2.0 dans Microsoft Entra ID.
- 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.
- Exécuté sur : Cloud Connector Host
- Hôte : graph.microsoft.com
- Port : 443
- 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
- eventID : Identifiant unique de l'événement qui sera utilisé pour effectuer les autres tâches.
- eventSubject : Sujet de l'événement.
- eventContent : Contenu de l'événement.
- eventStartDate : Date et heure de début de l'événement.
- eventEndDate : Date et heure de fin de l'événement.
- eventLocation : Lieu de l'événement.
- eventAttendees : Participants à l'événement.
- eventOrganizer : Organisateur de l'événement.
- 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
- 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.
- Schedule Start Date Time : Date, heure et fuseau horaire de début de la période.
- Schedule End Date Time : Date, heure et fuseau horaire de fin de la période.
- Fuseau horaire : Fuseau horaire de l'événement.
Extracteur de sortie
- scheduleUserId : Adresse électronique de l'utilisateur de la programmation.
- startTime : Date, heure et fuseau horaire de début de la période.
- endTime : Date, heure et fuseau horaire de fin de la période.
- timeZone : Fuseau horaire.
- scheduleStatus : État de la réponse des planifications de l'utilisateur.
- scheduleSubject : Sujet de l'événement programmé.
- scheduleLocation : Lieu de l'événement programmé.
- scheduleStartDateTime : Heure de début de l'événement programmé.
- scheduleEndDateTime : Heure de fin de l'événement programmé.
3) Créer un événement
Objectif
- 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.
- 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.
- 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
- Sujet de l'événement : Sujet de l'événement
- Contenu de l'événement : Contenu de l'événement
- Date et heure de début de l'événement : Date et heure de début de l'événement
- Fuseau horaire de l'événement : Fuseau horaire de l'événement
- Date de fin de l'événement Heure : Date de fin de l'événement
- Lieu de l'événement : Lieu de l'événement
- Adresse électronique du participant : Adresse électronique du participant
Extracteur de sortie
- eventId : ID de l'événement créé
- eventTimezone : TimeZone de l'événement
- eventSubject : Sujet de l'événement
- eventBody : Contenu de l'événement
- eventStartDateTime : Date de début de l'événement
- eventEndDateTime : Date de fin de l'événement
- eventLocation : Lieu de l'événement
- 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
- 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.
- 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.
- 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
- Sujet de l'événement : Sujet de l'événement
- Contenu de l'événement : Contenu de l'événement
- Date et heure de début de l'événement : Date et heure de début de l'événement
- Fuseau horaire de l'événement : Fuseau horaire de l'événement
- Date de fin de l'événement Heure : Date de fin de l'événement
- Lieu de l'événement : Lieu de l'événement
- Adresse électronique du participant : Adresse électronique du participant
- Type d'événement récurrent : Type d'événement récurrent
- Jours de la semaine de récurrence : Jour de l'événement de récurrence
- Date de début de la récurrence : Date de début de l'événement de récurrence
- Date de fin de la récurrence : Date de fin de l'événement de récurrence
Extracteur de sortie
- eventId : ID de l'événement créé
- eventTimezone : TimeZone de l'événement
- eventSubject : Sujet de l'événement
- eventBody : Contenu de l'événement
- eventStartDateTime : Date et heure de début de l'événement
- eventEndDateTime : Date et heure de fin de l'événement
- eventLocation : Lieu de l'événement
- eventRecurrenceRangeStartDate : Date de début de l'événement de récurrence.
- eventRecurrenceRangeEndDate : Date de fin de l'événement récurrent.
- eventAttendees : Participants à l'événement.
- eventOrganizer : Organisateur de l'événement.
- 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
- 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.
- 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
- Sujet de l'événement : Objet de l'événement
- Contenu de l'événement : Contenu de l'événement
- Date de début de l'événement : Heure de début de l'événement
- TimeZone de l'événement : fuseau horaire de l'événement
- Event End Date Time : Heure de fin de l'événement
- Event Location (Lieu de l'événement) : Lieu de l'événement
- Adresse électronique du participant : Adresse électronique du participant
Extracteur de sortie
- eventId : ID de l'événement créé
- eventTimezone : TimeZone de l'événement
- eventSubject : Sujet de l'événement
- eventBody : Contenu de l'événement
- eventStartDateTime : Date de début de l'événement
- eventEndDateTime : Date de fin de l'événement
- eventLocation : Lieu de l'événement
- 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
- 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
- ID de l'événement - L'ID de l'événement
Pour en savoir plus
Pour plus d'informations sur les connecteurs Microsoft