> For the complete documentation index, see [llms.txt](https://docs.konnekt.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.konnekt.io/fr/troubleshooting/reproduce-file-issues-with-graph-explorer.md). # 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ération sur les fichiers, et que les journaux de débogage KONNEKT affichent des erreurs de l’API Graph, Microsoft Graph Explorer vous permet de reproduire directement dans le navigateur la requête en échec. Cela permet d’isoler si la cause racine se situe dans le backend Microsoft 365 ou dans KONNEKT, et fournit des preuves propres pour un ticket de support 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 lui-même utilisent 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 le signe d’un problème de backend). * Les journaux de débogage KONNEKT affichent 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. * Des lenteurs intermittentes persistent après que les vérifications KONNEKT habituelles ont été écartées. ### Collecter et examiner le journal de débogage La méthode habituelle pour transmettre les journaux KONNEKT au support consiste à exécuter `crashguard.exe` depuis `C:\Program Files\Konnekt`. Ce processus regroupe les journaux et les téléverse silencieusement en arrière-plan — dans la plupart des cas, ni l’utilisateur ni l’administrateur ne remarquent quoi que ce soit. Voir [Préparation des journaux de débogage](https://docs.konnekt.io/troubleshooting/debug-log-preparation) pour le flux de support standard. Le flux 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 tournants d’environ 1 Mo chacun. Triez-les par date de modification et commencez par le plus récent. Ouvrez-le dans un éditeur de texte et recherchez `erreur` 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 **Débogage** afin que les URL complètes des requêtes Graph API et les réponses 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 erreur : 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 suivantes : * L’URL complète `GET` URL (copiez tout jusqu’au code d’état HTTP, sans l’inclure). * Le code d’état HTTP (504 dans cet exemple). * Les `request-id` valeur. Le support Microsoft peut retracer la requête ayant échoué à l’aide de cet ID. ## Prérequis * Accès au compte Microsoft 365 de l’utilisateur concerné, ou disponibilité de l’utilisateur pour se connecter lui-même. * Un navigateur Web moderne (Microsoft Edge, Chrome, Firefox ou Safari). * Le chemin et le nom de fichier exacts signalés par l’utilisateur, ou l’URL de l’API Graph provenant du journal de débogage. * Accès administrateur général au centre d’administration Microsoft 365 (uniquement si vous envisagez d’ouvrir un ticket de support Microsoft). {% hint style="warning" %} Vous devez vous connecter en tant qu’utilisateur rencontrant 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 **Se connecter** dans le coin supérieur gauche. 3. Connectez-vous avec les identifiants de l’utilisateur concerné. ## Étape 2 : Accordez les autorisations requises Graph Explorer utilise des autorisations déléguées. Pour les tests liés aux fichiers, accordez les périmètres suivants : | Périmètre | 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 périmètres : 1. Dans Graph Explorer, cliquez sur l’onglet **Modifier les autorisations** sous le champ de requête. 2. Repérez chaque périmètre dans la liste. 3. Cliquez **Consentement** à côté de chaque périmètre. 4. Acceptez l’invite de consentement. Pour la référence complète des périmètres, consultez [la référence des autorisations de 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 URL de requête. Remplacez les valeurs d’espace réservé entre accolades par de vraies valeurs. ### Option A : réutiliser l’URL du journal de débogage KONNEKT Copiez l’URL complète de la ligne du journal qui commence par `GET: https://graph.microsoft.com/...`. Collez tout jusqu’au code d’état HTTP, sans l’inclure, dans le champ URL de Graph Explorer. C’est l’option privilégié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 son chemin : ``` GET https://graph.microsoft.com/v1.0/me/drive/root:/Documents/Reports/example.pdf ``` Pour accéder à un fichier sur un site SharePoint, récupérez d’abord l’ID du site : ``` GET https://graph.microsoft.com/v1.0/sites/{hostname}:/{site-path} ``` Puis interrogez le fichier en utilisant cet ID de site : ``` GET https://graph.microsoft.com/v1.0/sites/{site-id}/drive/root:/Shared Documents/Folder/example.pdf ``` Cliquez **Exécuter la requête** et examinez le volet de réponse. ## Étape 4 : Interpréter le résultat Le volet 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. Revenez au [hub 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, consultez [Problèmes de 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. | Ce n’est pas un problème de KONNEKT ni du backend Microsoft. Vérifiez les autorisations dans l’interface web SharePoint. | | `404 Introuvable` | Le fichier ou le dossier n’existe pas au chemin indiqué. | Vérifiez le chemin. Le fichier a peut-être été déplacé, renommé ou supprimé. | | `429 Trop de requêtes` | Limitation du débit SharePoint Online. | Limitation du débit côté Microsoft. Vérifiez l’en-tête `Retry-After` , attendez puis réessayez. Les paramètres de prévention de la limitation du débit 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. Poursuivez avec les étapes suivantes. | | `UnknownError` dans le corps de la réponse | Erreur du backend Microsoft sans code spécifique. | Idem ci-dessus. Capturez le `request-id` et ouvrez un ticket de support Microsoft. | ## Étape 5 : Capturer des preuves Avant de fermer Graph Explorer, documentez le test. De bonnes preuves accélèrent la résolution des tickets de support. Recueillez : * 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, fuseau horaire compris. * Le UPN de l’utilisateur connecté (par exemple, `user@contoso.com`). * Le chemin exact du fichier qui a été testé. * Les `request-id` valeur du corps de la 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 de support Microsoft Ne suivez cette étape que si Graph Explorer a renvoyé une réponse 500, 503, 504 ou `UnknownError` réponse. 1. Accédez à `https://admin.microsoft.com` et connectez-vous avec un compte d’administrateur général. 2. Accédez à **Support** -> **Nouvelle demande de service**. 3. Sélectionnez **SharePoint Online** ou **OneDrive for Business** comme service concerné, en faisant correspondre le 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 de Graph Explorer. Cela permet à Microsoft de suivre précisément les requêtes ayant échoué. 6. Indiquez explicitement que le problème a été reproduit dans Microsoft Graph Explorer. {% hint style="info" %} L’inclusion de preuves issues de Graph Explorer indique que les causes tierces ont déjà été écartées. Le support Microsoft a généralement traité ces tickets plus rapidement. {% endhint %} ## Points de terminaison courants de l’API Graph Référence rapide des points de terminaison les plus souvent observés 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 du 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, consultez la [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 de 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 des journaux de débogage](https://docs.konnekt.io/troubleshooting/debug-log-preparation) - pour collecter des journaux avec des détails de l’API Graph * [Journalisation](https://docs.konnekt.io/configuration/system-settings/logging) - configuration du niveau de journalisation --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.konnekt.io/fr/troubleshooting/reproduce-file-issues-with-graph-explorer.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.