Partager via

Réinitialisation du cache du gestionnaire de fichiers

  • Article

Les gestionnaires 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’expiration de 24 heures, ce qui signifie qu’il peut falloir jusqu’à 48 heures pour que les mises à jour d’un manifeste de gestionnaire de fichiers s’affichent 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 la Administration du locataire

Étant donné que les mises à jour des applications prennent du temps à se propager par le biais du locataire système, les administrateurs peuvent actualiser globalement le cache d’applications stocké, ce qui affecte la visibilité des gestionnaires 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 qui héberge le gestionnaire de fichiers. Pour réinitialiser les données d’application mises en cache pour tous les utilisateurs, un administrateur de locataire peut accéder à 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 les impacts sur les performances, car elle affecte tous les utilisateurs.