# Reproduire les problèmes de fichiers avec Graph Explorer Lorsque les utilisateurs signalent une navigation lente, des ouvertures de fichiers échouées ou d’autres erreurs d’opérations sur les fichiers, et que les journaux de débogage KONNEKT montrent des erreurs de l’API Graph, Microsoft Graph Explorer vous permet de reproduire la requête en échec directement dans le navigateur. Cela permet d’isoler si la cause première se situe dans le backend Microsoft 365 ou dans KONNEKT, et fournit des preuves propres pour une demande d’assistance Microsoft. {% hint style="info" %} Microsoft Graph Explorer est un outil gratuit de Microsoft, basé sur le navigateur. Il envoie des requêtes à l’API Microsoft Graph, qui est la même interface que KONNEKT, l’application de synchronisation Microsoft OneDrive, Microsoft Teams et Microsoft 365 utilisent eux-mêmes pour lire et écrire des fichiers SharePoint Online et OneDrive. Aucune installation n’est requise. {% endhint %} ## Quand utiliser ce guide Utilisez cette procédure lorsque : * Plusieurs utilisateurs signalent le même problème en même temps (souvent un signe d’un problème de backend). * Les journaux de débogage KONNEKT montrent des erreurs de l’API Graph (HTTP 429, 500, 503, 504, ou `UnknownError`). * Vous devez prouver au support Microsoft que le problème n’est pas causé par un logiciel tiers. * Un ralentissement intermittent persiste après que les vérifications habituelles de KONNEKT ont été écartées. ### Collecter et examiner le journal de débogage La façon normale d’obtenir les journaux KONNEKT pour le support consiste à exécuter `crashguard.exe` depuis `C:\Program Files\Konnekt`. Ce flux regroupe les journaux et les téléverse discrètement en arrière-plan - dans la plupart des cas, ni l’utilisateur ni l’administrateur ne remarque quoi que ce soit. Voir [Préparation du journal de débogage](https://docs.konnekt.io/troubleshooting/debug-log-preparation) pour le workflow de support standard. Le workflow Graph Explorer est différent : vous devez ouvrir vous-même le fichier journal, localement, pour copier l’URL de la requête en échec et `request-id` dans Graph Explorer. Les fichiers journaux se trouvent à : ``` %LOCALAPPDATA%\Konnekt ``` KONNEKT conserve jusqu’à six fichiers journaux rotatifs d’environ 1 Mo chacun. Triez par heure de modification et commencez par le fichier le plus récent. Ouvrez-le dans un éditeur de texte et recherchez `error` ou le code d’état HTTP que vous examinez (par exemple, `504`). Avant de reproduire le problème, définissez le niveau de journalisation sur **Debug** afin que les URL complètes des requêtes et les réponses de l’API Graph soient capturées. Voir [Journalisation](https://docs.konnekt.io/configuration/system-settings/logging) pour savoir comment modifier le niveau de journalisation via l’interface Préférences, le registre ou une stratégie gérée. ### À quoi ressemble une erreur de l’API Graph dans le journal KONNEKT Une entrée d’erreur typique : ``` [2026-04-22 14:14:25.281] [22380] [error] [RESTkitClient] Requête HTTP (OneDriveClient::GetItemByPath) GET : https://graph.microsoft.com/v1.0/drives/b!YbLv.../root:%2F...%2F03:?$select=remoteItem,id,name,... - 504 error: réponse non reconnue(504) "{"error":{"code":"UnknownError","message":"","innerError":{ "date":"2026-04-22T12:14:25", "request-id":"dc38b1d9-cd9d-4f3d-b75a-5448695fa719", "client-request-id":"dc38b1d9-cd9d-4f3d-b75a-5448695fa719" }}}" ``` Notez ces valeurs pour les étapes ultérieures : * L’intégralité du `GET` URL (copiez tout jusqu’au code d’état HTTP, sans l’inclure). * Le code d’état HTTP (504 dans cet exemple). * La valeur `request-id` . Le support Microsoft peut tracer la requête en échec à l’aide de cet identifiant. ## Prérequis * Accès au compte Microsoft 365 de l’utilisateur concerné, ou l’utilisateur disponible pour se connecter lui-même. * Un navigateur web moderne (Microsoft Edge, Chrome, Firefox ou Safari). * Le chemin complet et le nom de fichier exact signalés par l’utilisateur, ou l’URL de l’API Graph issue du journal de débogage. * Accès Administrateur général au centre d’administration Microsoft 365 (uniquement si vous prévoyez d’ouvrir un ticket d’assistance Microsoft). {% hint style="warning" %} Vous devez vous connecter en tant qu’utilisateur qui rencontre le problème, et non en tant qu’administrateur. L’utilisation d’un autre compte modifie les autorisations et l’accès aux fichiers, ce qui invalide le test. {% endhint %} ## Étape 1 : Ouvrir Graph Explorer 1. Ouvrez votre navigateur et accédez à `https://developer.microsoft.com/graph/graph-explorer`. 2. Cliquez sur **Se connecter** dans le coin supérieur gauche. 3. Connectez-vous avec les identifiants de l’utilisateur concerné. ## Étape 2 : Accorder les autorisations requises Graph Explorer utilise des autorisations déléguées. Pour les tests liés aux fichiers, accordez les étendues suivantes : | Étendue | Objectif | | ---------------- | --------------------------------------------------------------------- | | `User.Read` | Lire le profil de l’utilisateur connecté | | `Files.Read` | Lire les fichiers OneDrive de l’utilisateur | | `Files.Read.All` | Lire tous les fichiers auxquels l’utilisateur a accès | | `Sites.Read.All` | Lire les éléments des sites SharePoint auxquels l’utilisateur a accès | Pour accorder les étendues : 1. Dans Graph Explorer, cliquez sur l’onglet **Modifier les autorisations** sous la zone de saisie de la requête. 2. Localisez chaque étendue dans la liste. 3. Cliquez sur **Consentement** à côté de chaque étendue. 4. Acceptez l’invite de consentement. Pour la référence complète des étendues, voir [Référence des autorisations Microsoft](https://learn.microsoft.com/graph/permissions-reference). ## Étape 3 : Exécuter une requête de test Définissez la méthode HTTP sur `GET` et saisissez l’une des requêtes ci-dessous dans le champ de l’URL de requête. Remplacez les valeurs indicatives entre accolades par des valeurs réelles. ### Option A : Réutiliser l’URL du journal de débogage KONNEKT Copiez l’URL complète à partir de la ligne de journal qui commence par `GET : https://graph.microsoft.com/...`. Collez tout ce qui précède le code d’état HTTP, sans l’inclure, dans le champ URL de Graph Explorer. C’est l’option recommandée car elle reproduit exactement la requête qui a échoué. ### Option B : Construire la requête manuellement Pour lister le dossier racine OneDrive de l’utilisateur : ``` GET https://graph.microsoft.com/v1.0/me/drive/root/children ``` Pour accéder à un fichier spécifique par chemin : ``` GET https://graph.microsoft.com/v1.0/me/drive/root:/Documents/Reports/example.pdf ``` Pour accéder à un fichier sur un site SharePoint, obtenez d’abord l’ID du site : ``` GET https://graph.microsoft.com/v1.0/sites/{hostname}:/{site-path} ``` Interrogez ensuite le fichier à l’aide de cet ID de site : ``` GET https://graph.microsoft.com/v1.0/sites/{site-id}/drive/root:/Shared Documents/Folder/example.pdf ``` Cliquez sur **Exécuter la requête** et examinez le panneau de réponse. ## Étape 4 : Interpréter le résultat Le panneau de réponse affiche un code d’état HTTP et un corps JSON. Utilisez le tableau ci-dessous pour classer le résultat et décider de l’étape suivante. | Code d’état | Signification | Étape suivante | | ----------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `200 OK` | L’appel à l’API Graph a réussi. Le fichier est accessible au niveau de l’API. | Le problème se situe du côté de KONNEKT ou dans l’environnement client. Retournez au [centre de dépannage](https://docs.konnekt.io/troubleshooting). | | `401 Non autorisé` | Le jeton est manquant, expiré ou invalide. | Déconnectez-vous de Graph Explorer puis reconnectez-vous. Si l’erreur persiste, voir [Problèmes liés au jeton d’accès](https://docs.konnekt.io/troubleshooting/access-token-issues). | | `403 Interdit` | L’utilisateur connecté n’a pas l’autorisation d’accéder à ce fichier ou à ce site. | Il ne s’agit pas d’un problème KONNEKT ni d’un problème de backend Microsoft. Vérifiez les autorisations dans l’interface web SharePoint. | | `404 Introuvable` | Le fichier ou le dossier n’existe pas au chemin donné. | Vérifiez le chemin. Le fichier a peut-être été déplacé, renommé ou supprimé. | | `429 Trop de requêtes` | Limitation de débit de SharePoint Online. | Limitation de débit côté Microsoft. Vérifiez l’en-tête `Retry-After` , attendez, puis réessayez. Les paramètres de prévention du throttling peuvent réduire la récurrence. | | `500 Erreur interne du serveur`, `503 Service indisponible`, `504 Délai d’attente de la passerelle dépassé` | Erreur du backend Microsoft. | Le problème se situe du côté de Microsoft. Passez aux étapes suivantes. | | `UnknownError` dans le corps de la réponse | Erreur du backend Microsoft sans code spécifique. | Même chose que ci-dessus. Capturez le `request-id` et ouvrez un ticket d’assistance Microsoft. | ## Étape 5 : Capturer les preuves Avant de fermer Graph Explorer, documentez le test. De bonnes preuves accélèrent la résolution des tickets d’assistance. Collectez : * Une capture d’écran de la fenêtre Graph Explorer montrant l’URL de la requête, le code d’état HTTP et le corps de la réponse. * La date et l’heure du test, avec le fuseau horaire. * Le UPN de l’utilisateur connecté (par exemple, `user@contoso.com`). * Le chemin exact du fichier testé. * La valeur `request-id` valeur du corps de réponse JSON. * Pour les erreurs intermittentes, répétez la requête plusieurs fois et capturez chaque résultat. ## Étape 6 : Ouvrir un ticket d’assistance Microsoft N’effectuez cette étape que si Graph Explorer a renvoyé une réponse 500, 503, 504 ou `UnknownError` . 1. Accédez à `https://admin.microsoft.com` et connectez-vous avec un compte Administrateur général. 2. Allez dans **Support** -> **Nouvelle demande de service**. 3. Sélectionnez **SharePoint Online** ou **OneDrive Entreprise** comme service concerné, en correspondant au point de terminaison ayant échoué. 4. Décrivez le problème et joignez les captures d’écran de l’étape précédente. 5. Incluez le `request-id` provenant à la fois du journal de débogage KONNEKT et de la réponse Graph Explorer. Cela permet à Microsoft de tracer les requêtes exactes qui ont échoué. 6. Indiquez explicitement que le problème a été reproduit dans Microsoft Graph Explorer. {% hint style="info" %} L’inclusion de preuves Graph Explorer indique que les causes tierces ont déjà été écartées. Le support Microsoft traite généralement ces tickets plus rapidement. {% endhint %} ## Points de terminaison courants de l’API Graph Référence rapide des points de terminaison les plus souvent vus dans les journaux de débogage KONNEKT : | Opération | Point de terminaison | | -------------------------------------- | ------------------------------------------------ | | Profil de l’utilisateur | `GET /me` | | Liste de la racine OneDrive | `GET /me/drive/root/children` | | Fichier par chemin (OneDrive) | `GET /me/drive/root:/{path}` | | Fichier par ID d’élément | `GET /drives/{drive-id}/items/{item-id}` | | Site par nom d’hôte et chemin | `GET /sites/{hostname}:/{site-path}` | | Lecteurs SharePoint sur un site | `GET /sites/{site-id}/drives` | | Téléchargement du contenu d’un fichier | `GET /drives/{drive-id}/items/{item-id}/content` | | Requête delta | `GET /drives/{drive-id}/root/delta` | Pour la référence complète, voir le [Microsoft Graph Drive API](https://learn.microsoft.com/graph/api/resources/drive). ### Problèmes similaires * [Sites manquants ou dossiers vides](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/sites-missing-or-folders-empty) - pour les erreurs du backend SharePoint Search * [Problèmes liés au jeton d’accès](https://docs.konnekt.io/troubleshooting/access-token-issues) - pour les réponses 401 Non autorisé * [Comment gérer les erreurs](https://docs.konnekt.io/troubleshooting/how-to-deal-with-error-s) - pour les erreurs sur des fichiers spécifiques * [Préparation du journal de débogage](https://docs.konnekt.io/troubleshooting/debug-log-preparation) - comment collecter des journaux avec les détails de l’API Graph * [Journalisation](https://docs.konnekt.io/configuration/system-settings/logging) - configuration du niveau de journalisation --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.konnekt.io/fr/troubleshooting/reproduire-les-problemes-de-fichiers-avec-graph-explorer.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.