> 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 de fichiers et que les journaux de débogage KONNEKT montrent des erreurs d’API Graph, Microsoft Graph Explorer vous permet de reproduire directement dans le navigateur la requête qui échoue. 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, accessible via le navigateur. Il envoie des requêtes à l’API Microsoft Graph, qui est la même interface utilisée par KONNEKT, l’application de synchronisation Microsoft OneDrive, Microsoft Teams et Microsoft 365 lui-même 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 au même moment (souvent le signe d’un problème de backend). * Les journaux de débogage KONNEKT montrent des erreurs d’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. * Une lenteur intermittente persiste après que les vérifications habituelles de KONNEKT ont été écartées. ### Collecter et examiner le journal de débogage La manière 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 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, afin de 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-les par heure de modification et commencez par le fichier 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, réglez le niveau de journalisation sur **Débogage** afin que les URL complètes des requêtes API Graph 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 d’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 suivantes : * L’intégralité de l’ `GET` URL (copiez tout jusqu’au code d’état HTTP, sans l’inclure). * Le code d’état HTTP (504 dans cet exemple). * Le `request-id` valeur. Le support Microsoft peut retracer 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 pour qu’il puisse se connecter lui-même. * Un navigateur web moderne (Microsoft Edge, Chrome, Firefox ou Safari). * Le chemin exact du fichier et le nom de fichier signalés par l’utilisateur, ou l’URL de l’API Graph à partir 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 de support 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 le champ de 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 [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 de l’URL de requête. Remplacez les valeurs de l’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 ce qui précède le code d’état HTTP, sans l’inclure, dans le champ d’URL de Graph Explorer. C’est l’option recommandée, car elle reproduit la requête exacte 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} ``` Puis interrogez 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 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. Retournez au [centre de dépannage](https://docs.konnekt.io/troubleshooting). | | `401 Unauthorized` | Le jeton est manquant, expiré ou invalide. | Déconnectez-vous de Graph Explorer, puis reconnectez-vous. Si l’erreur persiste, voir [Problèmes de jeton d'accès](https://docs.konnekt.io/troubleshooting/access-token-issues). | | `403 Forbidden` | L’utilisateur connecté n’a pas l’autorisation pour 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 Not Found` | 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 Too Many Requests` | Limitation de débit SharePoint Online. | Limitation de débit côté Microsoft. Vérifiez l’ `Retry-After` en-tête, attendez, puis réessayez. Les paramètres de prévention de la limitation de débit peuvent réduire les récurrences. | | `500 Internal Server Error`, `503 Service Unavailable`, `504 Gateway Timeout` | 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 les preuves Avant de fermer Graph Explorer, documentez le test. De bonnes preuves permettent de résoudre les tickets de support plus rapidement. 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, y compris le fuseau horaire. * L’UPN de l’utilisateur connecté (par exemple, `user@contoso.com`). * Le chemin exact du fichier qui a été testé. * Le `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 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 Administrateur général. 2. Accédez à **Support** -> **Nouvelle demande de service**. 3. Sélectionnez **SharePoint Online** ou **OneDrive pour les entreprises** comme service concerné, en faisant correspondre l’endpoint qui a échoué. 4. Décrivez le problème et joignez les captures d’écran de l’étape précédente. 5. Incluez le `request-id` à la fois du journal de débogage KONNEKT et de la réponse Graph Explorer. Cela permet à Microsoft de retracer les requêtes exactes en échec. 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 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, 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 de recherche SharePoint * [Problèmes de jeton d'accès](https://docs.konnekt.io/troubleshooting/access-token-issues) - pour les réponses 401 Unauthorized * [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) - comment collecter les 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 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` 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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.