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 : Microsoft 365 (anciennement Office 365) : liaison AzureAD - Pingview.
- CrĂ©ez un jeton dâauthentification Ă Microsoft : CrĂ©er un jeton d'authentification / accĂšs Ă Microsoft. Ce dernier sera Ă utiliser dans les paramĂštres dâauthentification de la source de donnĂ©e.
- Votre compte dispose des accĂšs administrateur
Temps nécessaire : 15 min
Niveau de difficulté : 5/5
Sources de données nécessaires : 1 par onglet Excel
Préambule
Avant dâaccĂ©der Ă votre fichier, vous allez avoir besoin de plusieurs identifiants qui se situent dans une requĂȘte.
Etapes
- Allez sur
https://developer.microsoft.com/graph/graph-explorer/
- Authentifiez-vous avec votre compte Microsoft en cliquant sur « vous connecter Ă lâAfficheur Graph »
- Séléctionnez votre compte, puis cliquez sur « Accepter »
1. Saisissez la requĂȘte suivante :
https://graph.microsoft.com/v1.0/sites?search=nom de votre SharePoint
Puis cliquez, sur « ExĂ©cuter la requĂȘte »
Un code OK 200 sur fond vert indique que la requĂȘte a Ă©tĂ© effectuĂ©e avec succĂšs.
Dans lâonglet « Aperçu de la rĂ©ponse », conservez la valeur de « id »
- Saisissez ensuite cette requĂȘte en insĂ©rant la valeur obtenue prĂ©cĂ©demment :
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.
- Nous allons maintenant rechercher lâidentifiant du fichier en se servant de lâidentifiant de notre dossier.
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Ă©.
- 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
Rajoutez /children Ă la fin de la requĂȘte si le fichier ciblĂ© est dans un dossier
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.
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 !