Compartilhar via

Redefinir o cache do manipulador de arquivos

  • Artigo

Os manipuladores de arquivos são armazenados em cache de duas maneiras : localmente no navegador e no servidor. Esses caches têm um tempo limite de 24 horas, o que significa que pode levar até 48 horas para que as atualizações em um manifesto do Manipulador de Arquivos apareçam para os usuários.

Ao desenvolver um manipulador de arquivos, é útil poder redefinir o cache local de sua conta para visualizar os manipuladores de arquivos mais recentes.

Para redefinir o cache, faça o seguinte:

  1. Envie a solicitação abaixo para atualizar o cache no lado do servidor.
  2. Limpar os dados locais do navegador
  3. Feche a janela do navegador do OneDrive.
  4. Abra a janela do navegador e volte até o OneDrive.

Pela API do OneDrive (não pelo Microsoft Graph) você pode solicitar que a lista de manipuladores de arquivos seja atualizada com a seguinte solicitação:

Solicitação HTTP

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

Observação: O {access-token} desta solicitação deve ter o escopo MyFiles.Write ou Sites.Read.All do aplicativo SharePoint.

Esta solicitação informará ao OneDrive para atualizar o cache, mas retornará os valores atuais do cache. O cache pode levar vários segundos até ser preenchido novamente, dependendo do número de aplicativos instalados no locatário do usuário.

Além do cache de servidor dos manipuladores de arquivos instalados, o Web app do OneDrive também tem um cache de sessão de manipuladores de arquivos. Esse cache é limpo automaticamente quando a sessão do navegador termina (quando a última guia do OneDrive é fechada).

Chamar o método forceRefresh para usuários finais

Em cenários de consentimento de usuários (em vez de implementação de administrador), poderá ser útil para sua experiência de usuário chamar a solicitação acima depois que um usuário consentir em seu aplicativo pela primeira vez. Dessa forma, o usuário verá o manipulador de arquivos da próxima vez que visitar o Web app do OneDrive, em vez de precisar aguardar até 24 para que o manipulador de arquivos seja exibido.

Redefinição de Administração de locatário

Como as atualizações nos aplicativos levam tempo para propagar por meio dos administradores de locatários do sistema podem atualizar o cache de aplicativo armazenado globalmente, o que afeta a visibilidade dos manipuladores de arquivos para os usuários. Isso afeta as alterações com base na atribuição do usuário, no sinalizador oculto ou em outras atualizações no aplicativo AAD que hospeda o manipulador de arquivos. Para redefinir os dados do aplicativo armazenado em cache para todos os usuários, um administrador de locatário pode visitar a url:

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

Essa API pode ser chamada apenas uma vez por hora para evitar impactos de desempenho, pois afeta todos os usuários.