> 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/de/troubleshooting/reproduce-file-issues-with-graph-explorer.md). # Dateiprobleme mit Graph Explorer reproduzieren Wenn Benutzer langsames Browsing, fehlgeschlagene Dateiöffnungen oder andere Fehler bei Dateioperationen melden und KONNEKT-Debugprotokolle Graph-API-Fehler anzeigen, können Sie mit Microsoft Graph Explorer die fehlgeschlagene Anfrage direkt im Browser reproduzieren. Dadurch lässt sich eingrenzen, ob die Ursache im Microsoft 365-Backend oder in KONNEKT liegt, und es entstehen saubere Nachweise für ein Microsoft-Supportticket. {% hint style="info" %} Microsoft Graph Explorer ist ein kostenloses, browserbasiertes Tool von Microsoft. Es sendet Anfragen an die Microsoft Graph API, dieselbe Schnittstelle, 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 berichten gleichzeitig über dasselbe Problem (oft ein Hinweis auf ein Backend-Problem). * KONNEKT-Debugprotokolle Graph-API-Fehler anzeigen (HTTP 429, 500, 503, 504 oder `UnknownError`). * Sie müssen dem Microsoft-Support nachweisen, dass das Problem nicht durch Software von Drittanbietern verursacht wird. * Intermittierende Langsamkeit bleibt bestehen, nachdem die üblichen KONNEKT-Prüfungen ausgeschlossen wurden. ### Das Debugprotokoll sammeln und prüfen Der normale Weg, KONNEKT-Protokolle an den Support zu übermitteln, besteht darin, `crashguard.exe` von `C:\Program Files\Konnekt`. Dieser Ablauf packt die Protokolle zusammen und lädt sie unbemerkt im Hintergrund hoch – in den meisten Fällen bemerken weder der Benutzer noch der Administrator etwas davon. Siehe [Vorbereitung der Debugprotokolle](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 URL der fehlgeschlagenen Anfrage und `request-id` in Graph Explorer zu kopieren. Die Protokolldateien befinden sich unter: ``` %LOCALAPPDATA%\Konnekt ``` KONNEKT speichert 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 `Fehler` oder nach dem HTTP-Statuscode, den Sie untersuchen (zum Beispiel `504`). Bevor Sie das Problem reproduzieren, setzen Sie die Protokollebene auf **Debug** sodass vollständige Graph-API-Anfrage-URLs und Antworten erfasst werden. Siehe [Protokollierung](https://docs.konnekt.io/configuration/system-settings/logging) für Informationen dazu, wie sich die Protokollebene über die Benutzeroberfläche für Einstellungen, die Registrierung oder eine verwaltete Richtlinie ändern lässt. ### 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 Fehler: Nicht erkannte Antwort(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 zum HTTP-Statuscode, aber nicht einschließlich des HTTP-Statuscodes). * Der HTTP-Statuscode (504 in diesem Beispiel). * Die `request-id` Wert. Der Microsoft-Support kann die fehlgeschlagene Anfrage anhand 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 Dateipfad und Dateiname, den der Benutzer gemeldet hat, oder die Graph-API-URL aus dem Debugprotokoll. * Zugriff als Globaler Administrator auf das Microsoft 365 Admin Center (nur wenn Sie ein Microsoft-Supportticket eröffnen möchten). {% hint style="warning" %} Sie müssen sich als der Benutzer anmelden, der von dem Problem betroffen ist, 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 rufen Sie `https://developer.microsoft.com/graph/graph-explorer`. 2. Klicken Sie **Anmelden** in der oberen linken Ecke auf. 3. Melden Sie sich mit den Anmeldedaten des betroffenen Benutzers an. ## Schritt 2: Erforderliche Berechtigungen erteilen Graph Explorer verwendet delegierte Berechtigungen. Erteilen Sie für dateibezogene Tests die folgenden Scopes: | Berechtigungsumfang | Zweck | | ------------------- | ------------------------------------------------------------------------ | | `User.Read` | 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-Websites lesen, auf die der Benutzer Zugriff hat | Um die Berechtigungen zu erteilen: 1. Klicken Sie in Graph Explorer auf die **Berechtigungen ändern** Registerkarte unterhalb der Abfrageeingabe. 2. Suchen Sie jeden Berechtigungsumfang in der Liste. 3. Klicken Sie **Zustimmung** neben jedem Berechtigungsumfang. 4. Bestätigen Sie die Zustimmungsaufforderung. Die vollständige Berechtigungsreferenz 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 folgenden Abfragen in das Feld für die Anfrage-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/...`. Fügen Sie alles bis zum HTTP-Statuscode, aber nicht den HTTP-Statuscode selbst, in das URL-Feld von Graph Explorer ein. Dies ist die bevorzugte Option, da sie genau die fehlgeschlagene Anfrage 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 über den Pfad auf eine bestimmte Datei zuzugreifen: ``` GET https://graph.microsoft.com/v1.0/me/drive/root:/Documents/Reports/example.pdf ``` Um auf eine Datei auf einer SharePoint-Website zuzugreifen, rufen Sie zuerst die Website-ID ab: ``` GET https://graph.microsoft.com/v1.0/sites/{hostname}:/{site-path} ``` Fragen Sie dann die Datei mit dieser Website-ID ab: ``` GET https://graph.microsoft.com/v1.0/sites/{site-id}/drive/root:/Shared Documents/Folder/example.pdf ``` Klicken Sie **Abfrage ausführen** und prüfen Sie den Antwortbereich. ## Schritt 4: Das Ergebnis interpretieren Der Antwortbereich zeigt einen HTTP-Statuscode und einen JSON-Text an. 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 Aufruf der Graph API war erfolgreich. Die Datei ist auf API-Ebene zugänglich. | Das Problem liegt auf der KONNEKT-Seite oder in der Clientumgebung. Kehren Sie zum [Fehlerbehebungs-Hub](https://docs.konnekt.io/troubleshooting). | | `401 Unauthorized` | Das Token fehlt, ist abgelaufen oder ungültig. | Melden Sie sich von Graph Explorer ab und erneut an. Wenn der Fehler weiterhin besteht, siehe [Probleme mit dem Zugriffstoken](https://docs.konnekt.io/troubleshooting/access-token-issues). | | `403 Forbidden` | Der angemeldete Benutzer hat keine Berechtigung für diese Datei oder Website. | Kein Problem auf Seiten von KONNEKT oder im Microsoft-Backend. Überprüfen Sie die Berechtigungen in der SharePoint-Weboberfläche. | | `404 Not Found` | Die Datei oder der Ordner ist unter dem angegebenen Pfad nicht vorhanden. | Überprüfen Sie den Pfad. Die Datei wurde möglicherweise verschoben, umbenannt oder gelöscht. | | `429 Too Many Requests` | Drosselung durch SharePoint Online. | Drosselung auf Microsoft-Seite. Prüfen Sie den `Retry-After` Header, warten Sie und versuchen Sie es erneut. Einstellungen zur Vermeidung von Drosselung können das erneute Auftreten verringern. | | `500 Interner Serverfehler`, `503 Dienst nicht verfügbar`, `504 Gateway-Timeout` | Fehler im Microsoft-Backend. | Das Problem liegt auf Microsofts Seite. Fahren Sie mit den nächsten Schritten fort. | | `UnknownError` im Antworttext | Fehler im Microsoft-Backend ohne spezifischen Code. | Wie oben. Erfassen Sie die `request-id` und eröffnen Sie ein Microsoft-Supportticket. | ## Schritt 5: Nachweise erfassen Bevor Sie Graph Explorer schließen, dokumentieren Sie den Test. Gute Nachweise helfen dabei, Supporttickets 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 genaue getestete Dateipfad. * Die `request-id` Wert aus dem JSON-Antworttext. * Bei sporadischen Fehlern wiederholen Sie die Abfrage mehrmals und erfassen Sie jedes Ergebnis. ## Schritt 6: Ein Microsoft-Supportticket eröffnen Führen Sie diesen Schritt nur aus, wenn Graph Explorer eine 500-, 503-, 504- oder `UnknownError` Antwort. 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. Auswählen **SharePoint Online** oder **OneDrive for Business** als betroffenen Dienst, passend zum fehlgeschlagenen Endpunkt. 4. Beschreiben Sie das Problem und fügen Sie die Screenshots aus dem vorherigen Schritt bei. 5. Fügen Sie die `request-id` aus dem KONNEKT-Debugprotokoll und der Graph-Explorer-Antwort hinzu. Dadurch kann Microsoft die genauen fehlgeschlagenen Anforderungen nachverfolgen. 6. Geben Sie ausdrücklich an, dass das Problem in Microsoft Graph Explorer reproduziert wurde. {% hint style="info" %} Der Nachweis aus Graph Explorer signalisiert, dass Ursachen von Drittanbietern bereits ausgeschlossen wurden. Der Microsoft-Support bearbeitet diese Tickets in der Regel schneller. {% endhint %} ## Häufig verwendete Graph-API-Endpunkte Schnellreferenz für die Endpunkte, die am häufigsten in KONNEKT-Debugprotokollen zu sehen sind: | Vorgang | Endpunkt | | ------------------------------------------- | ------------------------------------------------ | | Benutzerprofil | `GET /me` | | Auflistung des OneDrive-Stammverzeichnisses | `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}` | | Website nach Hostname und Pfad | `GET /sites/{hostname}:/{site-path}` | | SharePoint-Laufwerke auf einer Website | `GET /sites/{site-id}/drives` | | Download des Dateiinhalts | `GET /drives/{drive-id}/items/{item-id}/content` | | Delta-Abfrage | `GET /drives/{drive-id}/root/delta` | Die vollständige Referenz finden Sie in der [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) - für Fehler im SharePoint-Suche-Backend * [Probleme mit dem Zugriffstoken](https://docs.konnekt.io/troubleshooting/access-token-issues) - für 401 Unauthorized-Antworten * [So gehen Sie mit Fehler(n) um](https://docs.konnekt.io/troubleshooting/how-to-deal-with-error-s) - für Fehler bei bestimmten Dateien * [Vorbereitung der Debugprotokolle](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 der Protokollebene --- # 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/de/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.