Zurücksetzen des Dateihandlercaches

  • Artikel

Dateihandler werden auf zwei Arten zwischengespeichert: lokal im Browser und auf dem Server. Für diese Caches gilt ein Timeout von 24 Stunden. Das bedeutet, dass es bis zu 48 Stunden dauern kann, bis Updates eines Dateihandlermanifests für Benutzer angezeigt werden.

Bei der Entwicklung eines Dateihandlers ist es sinnvoll, den lokalen Cache für Ihr Konto zurückzusetzen, um die neuesten Dateihandler anzuzeigen.

Den Cache zurückzusetzen:

  1. Versenden Sie die Anfrage unten, um den serverseitigen Cache zu aktualisieren.
  2. Löschen der lokalen Daten des Browsers
  3. Schließen Sie das OneDrive-Browserfenster.
  4. Öffnen Sie das Browserfenster und navigieren Sie zurück zu OneDrive.

Über die OneDrive-API (nicht Microsoft Graph) können Sie mit der folgenden Anforderung eine Aktualisierung der Liste der Dateihandler anfordern:

HTTP-Anforderung

GET https://{tenant}-my.sharepoint.com/_api/v2.0/drive/apps?$forceRefresh=1
Authorization: Bearer {access-token}

Hinweis: Das {access-token} für diese Anforderung muss entweder den Bereich MyFiles.Write oder Sites.Read.All für die SharePoint-Anwendung besitzen.

Diese Anforderung fordert OneDrive auf, den Cache zu aktualisieren, gibt aber die aktuellen Werte aus dem Cache zurück. Das Auffüllen des Cache dauert einige Sekunden, abhängig von der Anzahl der installierten Anwendungen im Mandanten des Benutzers.

Zusätzlich zum serverseitigen Cache des installierten Dateihandlers verfügt die OneDrive-Web-App auch über einen Sitzungscache des Dateihandlers. Dieser Cache wird automatisch gelöscht, wenn die Browsersitzung beendet wird (wenn die letzte OneDrive-Registerkarte geschlossen ist).

Aufrufen der ForceRefresh-Methode für Endbenutzer

Für Szenarien mit Benutzerzustimmung (anstelle einer Admin-Bereitstellung) ist es möglicherweise vorteilhaft für Ihr Benutzererlebnis, die Anforderung oben auszuführen, nachdem ein Benutzer zum ersten Mal Ihrer Anwendung zugestimmt hat. Auf diese Weise wird dem Benutzer beim nächsten Besuch der OneDrive-Web-App der Dateihandler nicht erst nach 24 Stunden, sondern sofort angezeigt.

Mandanten Admin Zurücksetzen

Da die Weitergabe von Updates an Apps durch die Systemmandantenadministratoren einige Zeit in Anspruch nimmt, kann der gespeicherte App-Cache global aktualisiert werden, was sich auf die Sichtbarkeit von Dateihandlern für Benutzer auswirkt. Dies wirkt sich auf Änderungen aus, die auf der Benutzerzuweisung, dem ausgeblendeten Flag oder anderen Updates der AAD-App basieren, die den Dateihandler hosten. Um die zwischengespeicherten App-Daten für alle Benutzer zurückzusetzen, kann ein Mandantenadministrator die URL aufrufen:

GET https://{tenant}.sharepoint.com/_api/v2.0/drive/apps?$adminForceRefresh=1
Authorization: Bearer {access-token}

Diese API kann nur einmal pro Stunde aufgerufen werden, um Leistungseinbußen zu vermeiden, da sie alle Benutzer betrifft.