Réinitialisation du cache du gestionnaire de fichiers

  • Article
  • 2 minutes de lecture

Les serveurs de fichiers sont mis en cache de deux manières : localement dans le navigateur et sur le serveur. Ces caches ont un délai d’erreur de 24 heures, ce qui signifie qu’il faut jusqu’à 48 heures pour que les mises à jour d’un manifeste du responsable de fichiers apparaissent pour les utilisateurs.

Durant le développement d’un gestionnaire de fichiers, il peut s’avérer utile de réinitialiser le cache local de votre compte pour afficher les derniers gestionnaires de fichiers.

Pour réinitialiser le cache :

  1. envoyez la demande ci-dessous pour actualiser le cache côté serveur ;
  2. Effacer les données locales du navigateur
  3. fermez la fenêtre du navigateur OneDrive ; et
  4. ouvrez la fenêtre du navigateur et revenez dans OneDrive.

Dans l’API OneDrive (et non dans l’API Microsoft Graph), vous pouvez demander l’actualisation de la liste des gestionnaires de fichiers en effectuant la demande suivante :

Requête HTTP

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

Remarque : le jeton {access-token} doit fournir l’étendue MyFiles.Write ou Sites.Read.All pour l’application SharePoint.

Cette demande indique à OneDrive d’actualiser le cache. Par contre, elle renvoie les valeurs actuelles du cache. Le cache se remplit en quelques secondes, en fonction du nombre d’applications installées dans le client de l’utilisateur.

En plus du cache côté serveur des gestionnaires de fichiers installés, l’application web OneDrive a également un cache de session des gestionnaires de fichiers. Ce cache est automatiquement effacé à la fin de la session du navigateur (c’est-à-dire à la fermeture du dernier onglet OneDrive).

Appel de la méthode forceRefresh pour les utilisateurs finaux

Pour les scénarios nécessitant le consentement de l’utilisateur (au lieu du déploiement de l’administrateur), il peut être bénéfique pour votre expérience utilisateur d’appeler la requête ci-dessus quand un utilisateur accepte pour la première fois les autorisations requises par votre application. Ainsi, le gestionnaire de fichiers s’affichera quand l’utilisateur se reconnectera à l’application web OneDrive, au lieu d’attendre 24 heures avant que le gestionnaire de fichiers ne s’affiche.

Réinitialisation de l’administrateur client

Étant donné que la propagation des mises à jour des applications par le biais des administrateurs du client système prend du temps, les administrateurs clients système peuvent actualiser le cache d’application stocké globalement, ce qui a une incidence sur la visibilité des handlers de fichiers pour les utilisateurs. Cela a un impact sur les modifications en fonction de l’affectation de l’utilisateur, de l’indicateur masqué ou d’autres mises à jour de l’application AAD hébergeant le handler de fichiers. Pour réinitialiser les données d’application mises en cache pour tous les utilisateurs, un administrateur client peut consulter l’URL :

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

Cette API ne peut être appelée qu’une seule fois par heure pour éviter tout impact sur les performances, car elle affecte tous les utilisateurs.