Récupérer vos fichiers à travers un sharepoint

Pré-requis

Assurez-vous que notre application PingView a bien été autorisée à communiquer avec vos SharePoint. Les autorisations sont à créer par votre service informatique au niveau d’azure AD, les ID applications et secret sont nécessaires pour établir la communication, voir : Office 365 : liaison AzureAD - PingView.


image

Créer un jeton d’accès Office

La première chose à faire est de vous créer un jeton d’accès Office. Pour cela, rendez-vous dans le dossier souhaité, puis cliquer sur la catégorie « Connecteurs ». (Notez que si vous créez votre jeton à la racine de votre société, tous les dossiers et sous dossiers pourront l’utiliser dans leurs wallboards).
Ensuite, cliquez sur l’onglet « Jetons OAuth ».

Cliquez sur la seconde icone image afin de renseigner vos identifiants.

Une fois votre jeton créé, vous pouvez le renommer si souhaitez le retrouver plus facilement par la suite. C’est ce même jeton qui vous permettra de récupérer les données de tous vos outils Office 365.


Utiliser l’API SharePoint afin de récupérer vos données

Avant d’accéder à votre fichier, vous allez avoir besoin de plusieurs identifiants. Chacun de ces identifiants est à récupérer dans une requête.

Effectuez vos requêtes directement sur https://developer.microsoft.com/graph/graph-explorer/ en vous authentifiant avec votre compte Office.

1. Récupérez l’identifiant de votre sharepoint. Pour se faire, vous pouvez effectuer la requête suivante :

https://graph.microsoft.com/v1.0/sites?search={{nom de votre sharepoint}}.

NB : Les {{ }} ne sont pas à conserver, elles délimitent ici les informations que vous devez renseigner manuellement

  1. Récupérez ensuite l’identifiant du drive (ou dossier) dans lequel se trouve votre fichier.

https://graph.microsoft.com/v1.0/sites/{{id de votre sharepoint}}/drives

Cette requête vous renvoie donc une liste de dossiers. Trouvez celui que vous recherchez et mettez de côté son identifiant.

  1. Nous allons maintenant rechercher l’identifiant du fichier en se servant de l’identifiant de notre dossier ( oui, ça fait beaucoup d’identifiants ).

https://graph.microsoft.com/v1.0/drives/{{id de votre dossier}}/search(q=’{{nom de votre fichier}}’)

A nouveau, récupérez l’ID de votre fichier et mettez le de côté.

  1. On y est presque. La requête suivante va vous permettre de cibler directement le fichier afin de récupérer LE lien qu’il nous faut.

https://graph.microsoft.com/v1.0/drives/{{id de votre dossier}}/items/{{id du fichier}}

Cette requête vous renvoie un champ « @microsoft.graph.downloadUrl » Dans ce dernier se trouve l’URL pour accéder directement à votre fichier. Elle est en général très longue.


image

Effectuer la requête HTTP dans PingView

Dans PingView maintenant, créez une source de donnée « Services HTTP ».
Dans le champ URL, copiez-collez celle que vous venez de récupérer dans « @microsoft.graph.downloadUrl : »

Choisissez bien le format de votre fichier en dessous, selon s’il s’agit d’un fichier XML ou xlsx par exemple.

Testez, sauvegardez, vos données sont connectées !