# Dateiprobleme mit Graph Explorer reproduzieren Wenn Benutzer langsames Browsen, fehlgeschlagene Dateiöffnungen oder andere Fehler bei Dateivorgängen melden und die KONNEKT-Debugprotokolle Graph-API-Fehler anzeigen, können Sie mit Microsoft Graph Explorer die fehlerhafte Anforderung direkt im Browser reproduzieren. Dadurch lässt sich eingrenzen, ob die Ursache im Microsoft-365-Backend oder in KONNEKT liegt, und es entsteht ein sauberer Nachweis für ein Support-Ticket bei Microsoft. {% hint style="info" %} Microsoft Graph Explorer ist ein kostenloses browserbasiertes Tool von Microsoft. Es sendet Anforderungen an die Microsoft Graph API, die dieselbe Schnittstelle ist, die KONNEKT, die Microsoft OneDrive-Synchronisierungs-App, Microsoft Teams und Microsoft 365 selbst verwenden, um SharePoint Online- und OneDrive-Dateien zu lesen und zu schreiben. Eine Installation ist nicht erforderlich. {% endhint %} ## Wann Sie diese Anleitung verwenden sollten Verwenden Sie dieses Verfahren, wenn: * Mehrere Benutzer melden gleichzeitig dasselbe Problem (oft ein Anzeichen für ein Backend-Problem). * KONNEKT-Debugprotokolle zeigen Graph-API-Fehler (HTTP 429, 500, 503, 504 oder `UnknownError`). * Sie müssen Microsoft Support nachweisen, dass das Problem nicht durch Software von Drittanbietern verursacht wird. * Gelegentliche Verlangsamungen bestehen fort, nachdem die üblichen KONNEKT-Prüfungen ausgeschlossen wurden. ### Debug-Protokoll sammeln und prüfen Der normale Weg, KONNEKT-Protokolle an den Support zu übermitteln, besteht darin, `crashguard.exe` aus `C:\Program Files\Konnekt`auszuführen. Dieser Ablauf verpackt die Protokolle und lädt sie im Hintergrund unbemerkt hoch – in den meisten Fällen bemerken weder der Benutzer noch der Administrator, dass etwas geschieht. Siehe [Vorbereitung des Debug-Protokolls](https://docs.konnekt.io/troubleshooting/debug-log-preparation) für den standardmäßigen Support-Workflow. Der Graph-Explorer-Workflow ist anders: Sie müssen die Protokolldatei selbst lokal öffnen, um die fehlerhafte Anforderungs-URL und die `request-id` in Graph Explorer zu kopieren. Die Protokolldateien befinden sich unter: ``` %LOCALAPPDATA%\Konnekt ``` KONNEKT behält bis zu sechs rotierende Protokolldateien mit jeweils etwa 1 MB. Sortieren Sie nach Änderungszeit und beginnen Sie mit der neuesten Datei. Öffnen Sie sie in einem Texteditor und suchen Sie nach `error` oder nach dem HTTP-Statuscode, den Sie untersuchen (zum Beispiel, `504`). Bevor Sie das Problem reproduzieren, stellen Sie den Protokollierungsgrad auf **Debug** ein, damit vollständige Graph-API-Anforderungs-URLs und -Antworten erfasst werden. Siehe [Protokollierung](https://docs.konnekt.io/configuration/system-settings/logging) dazu, wie Sie den Protokollierungsgrad über die Einstellungen, die Registrierung oder eine verwaltete Richtlinie ändern. ### Wie ein Graph-API-Fehler im KONNEKT-Protokoll aussieht Ein typischer Fehlereintrag: ``` [2026-04-22 14:14:25.281] [22380] [error] [RESTkitClient] Http request (OneDriveClient::GetItemByPath) GET: https://graph.microsoft.com/v1.0/drives/b!YbLv.../root:%2F...%2F03:?$select=remoteItem,id,name,... - 504 error: Unrecognized response(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" }}}" ``` Notieren Sie diese Werte für spätere Schritte: * Die vollständige `GET` URL (kopieren Sie alles bis, aber nicht einschließlich, des HTTP-Statuscodes). * Der HTTP-Statuscode (in diesem Beispiel 504). * Der `request-id` Wert. Microsoft Support kann die fehlgeschlagene Anforderung mithilfe dieser ID nachverfolgen. ## Voraussetzungen * Zugriff auf das Microsoft-365-Konto des betroffenen Benutzers oder der Benutzer ist verfügbar, um sich selbst anzumelden. * Ein moderner Webbrowser (Microsoft Edge, Chrome, Firefox oder Safari). * Der genaue vom Benutzer gemeldete Dateipfad und Dateiname oder die Graph-API-URL aus dem Debugprotokoll. * Globaler Administratorzugriff auf das Microsoft-365-Admin-Center (nur wenn Sie planen, ein Microsoft-Support-Ticket zu eröffnen). {% hint style="warning" %} Sie müssen sich als der Benutzer anmelden, der das Problem hat, nicht als Administrator. Die Verwendung eines anderen Kontos ändert die Berechtigungen und den Dateizugriff, wodurch der Test ungültig wird. {% endhint %} ## Schritt 1: Graph Explorer öffnen 1. Öffnen Sie Ihren Browser und navigieren Sie zu `https://developer.microsoft.com/graph/graph-explorer`. 2. Klicken Sie auf **Anmelden** in der oberen linken Ecke. 3. Melden Sie sich mit den Anmeldedaten des betroffenen Benutzers an. ## Schritt 2: Die erforderlichen Berechtigungen erteilen Graph Explorer verwendet delegierte Berechtigungen. Für dateibezogene Tests erteilen Sie die folgenden Bereiche: | Bereich | Zweck | | ---------------- | --------------------------------------------------------------------- | | `User.Read` | Das Profil des angemeldeten Benutzers lesen | | `Files.Read` | Die OneDrive-Dateien des Benutzers lesen | | `Files.Read.All` | Alle Dateien lesen, auf die der Benutzer Zugriff hat | | `Sites.Read.All` | Elemente von SharePoint-Sites lesen, auf die der Benutzer Zugriff hat | Um die Bereiche zu erteilen: 1. Klicken Sie in Graph Explorer auf die **Berechtigungen ändern** Registerkarte unter dem Abfrageeingabefeld. 2. Suchen Sie jeden Bereich in der Liste. 3. Klicken Sie auf **Zustimmen** neben jedem Bereich. 4. Akzeptieren Sie die Zustimmungsaufforderung. Die vollständige Bereichsreferenz finden Sie unter [Microsofts Berechtigungsreferenz](https://learn.microsoft.com/graph/permissions-reference). ## Schritt 3: Eine Testabfrage ausführen Setzen Sie die HTTP-Methode auf `GET` und geben Sie eine der unten stehenden Abfragen in das Feld für die Anforderungs-URL ein. Ersetzen Sie Platzhalterwerte in geschweiften Klammern durch echte Werte. ### Option A: Die URL aus dem KONNEKT-Debugprotokoll wiederverwenden Kopieren Sie die vollständige URL aus der Protokollzeile, die mit `GET: https://graph.microsoft.com/...`beginnt. Fügen Sie alles bis (aber nicht einschließlich) des HTTP-Statuscodes in das URL-Feld von Graph Explorer ein. Dies ist die bevorzugte Option, da sie genau die fehlgeschlagene Anforderung reproduziert. ### Option B: Die Abfrage manuell erstellen Um den OneDrive-Stammordner des Benutzers aufzulisten: ``` GET https://graph.microsoft.com/v1.0/me/drive/root/children ``` Um auf eine bestimmte Datei über den Pfad zuzugreifen: ``` GET https://graph.microsoft.com/v1.0/me/drive/root:/Documents/Reports/example.pdf ``` Um auf eine Datei auf einer SharePoint-Site zuzugreifen, holen Sie zuerst die Site-ID: ``` GET https://graph.microsoft.com/v1.0/sites/{hostname}:/{site-path} ``` Fragen Sie dann die Datei mit dieser Site-ID ab: ``` GET https://graph.microsoft.com/v1.0/sites/{site-id}/drive/root:/Shared Documents/Folder/example.pdf ``` Klicken Sie auf **Abfrage ausführen** und den Antwortbereich überprüfen. ## Schritt 4: Das Ergebnis interpretieren Der Antwortbereich zeigt einen HTTP-Statuscode und einen JSON-Text. Verwenden Sie die folgende Tabelle, um das Ergebnis zu klassifizieren und den nächsten Schritt zu bestimmen. | Statuscode | Bedeutung | Nächster Schritt | | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `200 OK` | Der Graph-API-Aufruf war erfolgreich. Die Datei ist auf API-Ebene zugänglich. | Das Problem liegt auf der KONNEKT-Seite oder in der Clientumgebung. Kehren Sie zum [Troubleshooting hub](https://docs.konnekt.io/troubleshooting). | | `401 Unauthorized` | Der Token fehlt, ist abgelaufen oder ungültig. | Melden Sie sich bei Graph Explorer ab und erneut an. Wenn der Fehler weiterhin besteht, siehe [Access token issues](https://docs.konnekt.io/troubleshooting/access-token-issues). | | `403 Forbidden` | Der angemeldete Benutzer hat keine Berechtigung für diese Datei oder Site. | Kein Problem auf der KONNEKT- oder Microsoft-Backend-Seite. Überprüfen Sie die Berechtigungen in der SharePoint-Weboberfläche. | | `404 Not Found` | Die Datei oder der Ordner existiert nicht unter dem angegebenen Pfad. | Überprüfen Sie den Pfad. Die Datei wurde möglicherweise verschoben, umbenannt oder gelöscht. | | `429 Too Many Requests` | Drosselung durch SharePoint Online. | Ratenbegrenzung auf Microsoft-Seite. Prüfen Sie den `Retry-After` Header, warten Sie und versuchen Sie es erneut. Einstellungen zur Verhinderung von Drosselung können das erneute Auftreten verringern. | | `500 Internal Server Error`, `503 Service Unavailable`, `504 Gateway Timeout` | Microsoft-Backend-Fehler. | Das Problem liegt auf der Microsoft-Seite. Fahren Sie mit den nächsten Schritten fort. | | `UnknownError` im Antworttext | Microsoft-Backend-Fehler ohne spezifischen Code. | Wie oben. Erfassen Sie den `request-id` und eröffnen Sie ein Microsoft-Support-Ticket. | ## Schritt 5: Beweise erfassen Bevor Sie Graph Explorer schließen, dokumentieren Sie den Test. Gute Beweise helfen, Support-Tickets schneller zu lösen. Sammeln Sie: * Einen Screenshot des Graph-Explorer-Fensters, der die Abfrage-URL, den HTTP-Statuscode und den Antworttext zeigt. * Datum und Uhrzeit des Tests einschließlich Zeitzone. * Die UPN des angemeldeten Benutzers (zum Beispiel, `user@contoso.com`). * Der exakte getestete Dateipfad. * Der `request-id` Wert aus dem JSON-Antworttext. * Wiederholen Sie bei intermittierenden Fehlern die Abfrage mehrmals und erfassen Sie jedes Ergebnis. ## Schritt 6: Ein Microsoft-Support-Ticket eröffnen Führen Sie diesen Schritt nur aus, wenn Graph Explorer eine 500-, 503-, 504- oder `UnknownError` Antwort zurückgegeben hat. 1. Navigieren Sie zu `https://admin.microsoft.com` und melden Sie sich mit einem Global-Administrator-Konto an. 2. Gehen Sie zu **Support** -> **Neue Serviceanfrage**. 3. Wählen Sie **SharePoint Online** oder **OneDrive for Business** als betroffenen Dienst aus und stimmen Sie ihn mit dem fehlgeschlagenen Endpunkt ab. 4. Beschreiben Sie das Problem und hängen Sie die Screenshots aus dem vorherigen Schritt an. 5. Fügen Sie die `request-id` sowohl aus dem KONNEKT-Debugprotokoll als auch aus der Graph-Explorer-Antwort hinzu. Dadurch kann Microsoft die genauen fehlgeschlagenen Anforderungen nachverfolgen. 6. Stellen Sie ausdrücklich fest, dass das Problem in Microsoft Graph Explorer reproduziert wurde. {% hint style="info" %} Das Einfügen von Graph-Explorer-Nachweisen zeigt, dass Ursachen von Drittanbietern bereits ausgeschlossen wurden. Microsoft Support bearbeitet diese Tickets in der Regel schneller. {% endhint %} ## Häufig verwendete Graph-API-Endpunkte Schnellreferenz für die Endpunkte, die in KONNEKT-Debugprotokollen am häufigsten vorkommen: | Vorgang | Endpunkt | | ----------------------------------- | ------------------------------------------------ | | Benutzerprofil | `GET /me` | | OneDrive-Stammauflistung | `GET /me/drive/root/children` | | Datei nach Pfad (OneDrive) | `GET /me/drive/root:/{path}` | | Datei nach Element-ID | `GET /drives/{drive-id}/items/{item-id}` | | Site nach Hostname und Pfad | `GET /sites/{hostname}:/{site-path}` | | SharePoint-Laufwerke auf einer Site | `GET /sites/{site-id}/drives` | | Dateiinhalt herunterladen | `GET /drives/{drive-id}/items/{item-id}/content` | | Delta-Abfrage | `GET /drives/{drive-id}/root/delta` | Die vollständige Referenz finden Sie im [Microsoft Graph Drive API](https://learn.microsoft.com/graph/api/resources/drive). ### Ähnliche Probleme * [Sites fehlen oder Ordner sind leer](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/sites-missing-or-folders-empty) - bei Backend-Fehlern der SharePoint-Suche * [Access token issues](https://docs.konnekt.io/troubleshooting/access-token-issues) - bei 401 Unauthorized-Antworten * [Umgang mit Fehler(n)](https://docs.konnekt.io/troubleshooting/how-to-deal-with-error-s) - bei Fehlern bei bestimmten Dateien * [Vorbereitung des Debug-Protokolls](https://docs.konnekt.io/troubleshooting/debug-log-preparation) - wie Protokolle mit Graph-API-Details gesammelt werden * [Protokollierung](https://docs.konnekt.io/configuration/system-settings/logging) - Konfiguration des Protokollierungsgrads --- # 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/de/troubleshooting/dateiprobleme-mit-graph-explorer-reproduzieren.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.