Compartir a través de

Restablecer la caché del controlador de archivos

  • Artículo

Los controladores de archivos se almacenan en caché de dos maneras: localmente en el explorador y en el servidor. Estas memorias caché tienen un tiempo de espera de 24 horas, lo que significa que las actualizaciones de un manifiesto de controlador de archivos pueden tardar hasta 48 horas en aparecer para los usuarios.

Al desarrollar un controlador de archivos, es útil poder restablecer la caché local de su cuenta para ver los controladores de archivos más recientes.

Para restablecer la caché, debe:

  1. Enviar la siguiente solicitud para actualizar la caché del lado servidor.
  2. Borrar los datos locales del explorador
  3. Cerrar la ventana del explorador de OneDrive.
  4. Abrir la ventana del explorador y volver a OneDrive.

Mediante la API de OneDrive (no Microsoft Graph), puede solicitar que se actualice la lista de controladores de archivos al realizar la siguiente solicitud:

Solicitud HTTP

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

Nota: El valor {access-token} de esta solicitud debe tener el ámbito MyFiles.Write o Sites.Read.All de la aplicación de SharePoint.

Esta solicitud indicará a OneDrive que actualice la caché, pero devolverá los valores actuales de la caché. La caché puede tardar varios segundos en volver a llenarse, en función del número de aplicaciones instaladas en el espacio empresarial del usuario.

Además de la caché del lado servidor de los controladores de archivos instalados, la aplicación web de OneDrive también tiene una caché de sesión de controladores de archivos. Esta caché se borra automáticamente cuando finaliza la sesión del explorador (cuando se cierra la última pestaña de OneDrive).

Llamar al método forceRefresh para los usuarios finales

Para escenarios de consentimiento del usuario (en lugar de la implementación administrativa), puede ser beneficioso para la experiencia del usuario llamar a la solicitud anterior después de que un usuario consienta la aplicación por primera vez. De este modo, se presentará al usuario el controlador de archivos la próxima vez que visite la aplicación web de OneDrive, en lugar de tener que esperar hasta 24 horas para que aparezca el controlador de archivos.

Restablecimiento de Administración de inquilino

Dado que las actualizaciones de las aplicaciones tardan tiempo en propagarse a través de los administradores de inquilinos del sistema, pueden actualizar la caché de aplicaciones almacenada globalmente, lo que afecta a la visibilidad de los controladores de archivos para los usuarios. Esto afecta a los cambios en función de la asignación de usuarios, la marca oculta u otras actualizaciones de la aplicación de AAD que hospeda el controlador de archivos. Para restablecer los datos de la aplicación almacenada en caché para todos los usuarios, un administrador de inquilinos puede visitar la dirección URL:

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

Esta API solo se puede llamar una vez por hora para evitar impactos en el rendimiento, ya que afecta a todos los usuarios.