Microsoft 365 : requêter les contenus SharePoint / Teams / OneDrive


:hourglass: Temps nécessaire : 15 min
:thermometer: Niveau de difficulté : 5/5
:penguin: Sources de données nécessaires : 1


Pré-requis

Comprendre la requête finale

Voici la requête finale qui permettra de récupérer les contenus d’un fichier d’un SharePoint ou d’un Teams :

https://graph.microsoft.com/v1.0/drives/.../items/___/children

Nous allons donc rechercher :

  • l’identifiant du drive (DriveID), que l’on viendra insérer à la place des « … »
  • l’identifiant du dossier (FolderID), que l’on viendra insérer à la place des « ___ ».

Pour cela, nous ferons plusieurs requêtes détaillées dans la procédure ci-dessous.

Conseil : Faîtes autant de sources que de requêtes pour plus de simplicité si c’est la première fois que vous faites cette opération. Une fois que vous avez le résultat escompté dans la requête finale, vous pouvez ne conserver que celle-ci.

Étapes

Accédez au concepteur sur Pingview puis aux sources de données du wallboard et créez une source de type « Webservice », en pensant à ajouter le jeton Microsoft dans les paramètres d’authentification.

Première requête

Cette première requête sert à identifier le site SharePoint ou le canal Teams

  1. Ajoutez l’une des 3 URL suivantes selon votre cas (ou vos préférences) :
  • https://graph.microsoft.com/v1.0/sites?search=
    dans le cas où le site SharePoint n’est pas suivi ou dans le cas d’un canal Teams : il faudra en connaitre le nom afin de le renseigner à la fin de cette seconde requête :

:warning: À la place des « … » indiquez un terme contenu dans le nom du site ou du canal

  1. Testez et déroulez, avec la flèche, les résultats apparaissant sur la droite jusqu’à trouver le champ id qui contient l’identifiant du site / canal et conservez cet identifiant.

Capture d’écran 2022-02-04 à 10.35.38

Deuxième requête

Cette deuxième requête sert à identifier le DriveID

  1. Ajoutez-l’identifiant obtenu dans la première requête à l’URL suivante, à la place des « … », puis testez

https://graph.microsoft.com/v1.0/sites/.../drives

  1. Récupérez la valeur de l’id du dossier « Documents » : elle correspond au DriveID

Troisième requête

Cette troisième requête sert à identifier le dossier (FolderID) dans lequel vous souhaitez récupérer vos fichiers

  1. Ajoutez le DriveID dans la deuxième requête à l’URL suivante, à la place des « … », puis testez

https://graph.microsoft.com/v1.0/drives/.../items/root/children

  1. Récupérez maintenant la valeur de l’id du dossier dans lequel se trouvent vos fichiers.

Quatrième requête

Cette quatrième requête permet d’arriver à l’endroit souhaité pour récupérer vos fichiers. Si vos fichiers sont dans des dossiers de dossiers, il faudra réitérer cette requête pour avancer d’un niveau

Ajoutez à nouveau le DriveID obtenu dans la deuxième requête à l’URL suivante, à la place des « … », et ajoutez le FolderID (l’identifiant du dossier) à la place des ___

https://graph.microsoft.com/v1.0/drives/.../items/___/children


Vous souhaitez aller plus loin et récupérer un graphique Excel directement dans Pingview ?


Vous souhaitez aller plus loin et décoder un fichier Excel directement dans Pingview ?