Workflows ne sont pas disponibles dans la Essentials solution.
Dans ce tutoriel, vous allez apprendre à récupérer une plage spécifique d’événements depuis votre calendrier en utilisant Microsoft Graph API. Cela implique d’effectuer une requête HTTP GET vers l’endpoint Graph API, en ciblant une plage de dates et d’heures particulière.
Prérequis
- Compte Microsoft 365 : vous devez disposer d’un compte Microsoft 365 ayant accès à un calendrier Outlook.
-
Autorisations : le compte demandeur doit disposer de l’autorisation
Calendars.Read
dans Microsoft Graph. - Jeton d’accès : vous aurez besoin d’un jeton d’accès comportant les autorisations appropriées pour l’authentification. Celui-ci peut être obtenu via OAuth 2.0.
Consultez la documentation Microsoft Graph sur les autorisations pour plus de détails concernant les autorisations et les jetons d’accès.
Entrées d’exécution
Avant de commencer, assurez-vous d’avoir les informations suivantes prêtes :
- StartDateTime : date et heure de début de l’affichage du calendrier.
- EndDateTime : date et heure de fin de l’affichage du calendrier.

Les deux entrées d’exécution doivent être au format DateTime
.
Récupération de la vue du calendrier
Étape 1 : Configurer l’action
Ajoutez une nouvelle action à votre flux de travail. Naviguez dans la catégorie « HTTP Integrations » et sélectionnez l’action « HTTP API GET » afin de commencer à récupérer votre vue calendrier pour l’intervalle de temps spécifié.

Étape 2 : Paramétrer la requête HTTP GET
Configuration de l’URL
Utilisez le format d’URL suivant pour votre requête :
https://graph.microsoft.com/v1.0/me/calendarview?startdatetime={startDateTime}&enddatetime={endDateTime}
Remplacez {startDateTime}
et {endDateTime}
par vos entrées d’exécution réelles. Cette URL comprend des paramètres de requête pour définir la plage temporelle désirée dans la vue du calendrier.

Clé secrète
Incluez la clé secrète pour l’autorisation Microsoft Graph API.

Pour plus d’informations sur la clé secrète, veuillez consulter l’article Envoyer une requête POST.
Actions post-récupération
Une fois votre requête envoyée, vous recevrez une réponse contenant :
- StatusCode : indique si votre requête a bien été reçue et comprise.
- Response : les données réelles renvoyées, généralement au format JSON.
- Headers : informations supplémentaires sur votre réponse.
Les données de réponse peuvent être utilisées comme entrée pour d’autres actions au sein du même flux de travail via des mappages dynamiques.

Pour notre requête de calendrier, la réponse de l’API Graph pourrait ressembler à ceci :
{
"value": [
{
"originalStartTimeZone": "Pacific Standard Time",
"originalEndTimeZone": "Pacific Standard Time",
"responseStatus": {
"response": "accepted",
"time": "2016-10-19T10:37:00Z"
},
"iCalUId": "C3F49BB4B7D7EEE4304DA",
"reminderMinutesBeforeStart": 15,
"isReminderOn": true
}
]
}
Ainsi, le mappage dynamique serait :

Dans le champ « Path name », la réponse doit être saisie avec un “R” majuscule pour garantir une sortie correcte.
Vous pouvez exploiter ces données dans les actions suivantes :

Exécution du flux de travail
Après avoir configuré l’action, enregistrez et publiez votre flux de travail. Lors de l’exécution, il vous sera demandé de renseigner les entrées d’exécution définies précédemment.
