Quando você atualiza a navegação global em um site hub do SharePoint, as alterações devem aparecer automaticamente em todos os sites associados. Muitos proprietários relatam que a navegação não atualiza, exibindo links antigos ou itens novos ausentes. Esse problema geralmente ocorre porque o sistema de cache da navegação do hub ou as configurações de sincronização não estão sendo atualizados conforme o esperado. Este artigo explica por que a navegação do hub pode falhar ao atualizar e fornece as verificações e correções específicas que os proprietários podem aplicar.
Principais Conclusões: Problemas de Sincronização da Navegação do Hub
- Cache da navegação do site hub: Os caches do navegador e do SharePoint podem atrasar ou bloquear as atualizações de navegação nos sites associados.
- Permissões do site hub: O proprietário do site hub deve ter permissões de edição nos sites associados para que as alterações de navegação sejam propagadas.
- Limite de nós de navegação: O SharePoint impõe um máximo de 500 nós de navegação por hub; exceder esse limite impede as atualizações.
Por que a Navegação do Hub Não Atualiza Automaticamente
A navegação do hub do SharePoint é armazenada em um local central no site hub. Quando você adiciona, remove ou reordena um link de navegação, a alteração é salva no banco de dados do site hub. Os sites associados leem esses dados de navegação do site hub, não de suas próprias configurações locais. O sistema usa um cache para reduzir a carga no site hub. Esse cache é atualizado a cada 15 a 30 minutos por padrão. Se você verificar um site associado imediatamente após fazer uma alteração, o cache ainda pode conter os dados antigos de navegação.
Outra causa raiz é a incompatibilidade de permissões. O usuário que edita a navegação do hub deve ser proprietário do site hub, mas a navegação do hub só aparecerá nos sites associados se esses sites tiverem a associação correta. Se um site associado foi desassociado manualmente ou se a associação ao site hub foi removida, a navegação não será atualizada. O próprio site hub também deve estar ativo e acessível. Se o site hub for excluído ou seu conjunto de sites estiver bloqueado, nenhum site associado poderá ler a navegação.
Mecanismo de Atualização do Cache
O cache da navegação do hub é um cache do lado do servidor que armazena a última estrutura de navegação conhecida. Esse cache é atualizado quando um usuário visita o site hub diretamente ou quando um trabalho do temporizador é executado. O trabalho do temporizador é executado a cada 15 minutos. Você não pode acionar manualmente essa atualização de cache pelo centro de administração do SharePoint. A única maneira de forçar uma atualização é fazer uma alteração subsequente na navegação do hub, o que redefine o temporizador de 15 minutos.
Requisitos de Permissão e Associação
Para que a navegação do hub apareça em um site, esse site deve estar associado ao hub. Os proprietários do site podem verificar isso em Configurações do Site, em Configurações do site hub. O usuário que atualiza a navegação do hub deve ter pelo menos direitos de edição no site hub. A navegação será então visível para todos os usuários que têm acesso aos sites associados. Se um usuário não tiver permissão para visualizar o próprio site hub, ele ainda verá a navegação no site associado, pois a navegação é lida do banco de dados do site hub, não do conteúdo do site.
Passos para Forçar a Atualização da Navegação do Hub
- Limpe o cache do navegador no site associado
Abra o site associado em uma janela de navegação privada ou anônima. Se a navegação aparecer corretamente nesse modo, o cache do navegador estava mantendo a versão antiga. Instrua todos os visitantes do site a limpar o cache do navegador ou usar Ctrl+F5 para forçar uma atualização completa da página. - Faça uma alteração fictícia na navegação do hub
Vá para o site hub. Selecione Configurações > Navegação. Adicione um link temporário e salve. Aguarde 15 minutos. Remova o link temporário e salve novamente. Isso redefine o temporizador do cache e força uma atualização nos próximos 15 minutos. - Reassocie o site ao hub
No site associado, vá para Configurações do Site > Configurações do site hub. Anote a URL atual do hub. Remova a associação selecionando Remover do hub. Aguarde 5 minutos. Reassocie o site com a mesma URL do hub. Isso limpa os dados de associação local e força o site a buscar a navegação do hub. - Verifique o número de nós de navegação do site hub
O SharePoint permite no máximo 500 nós de navegação por hub. Conte todos os nós na navegação do hub, incluindo subnós. Se exceder 500, exclua alguns nós. Em seguida, repita o passo da alteração fictícia. A navegação não será atualizada se o limite for excedido. - Verifique se o site hub está ativo
Vá para o centro de administração do SharePoint > Sites ativos. Encontre o site hub. Confirme se o status está como Ativo e se o conjunto de sites não está bloqueado. Se o site estiver bloqueado ou excluído, a navegação do hub não será propagada. Você deve designar um novo site hub e reassociar todos os sites.
Se a Navegação Ainda Não Atualizar
Usuários veem navegação antiga em um site associado específico
Isso geralmente indica um problema de associação local. Remova o site do hub e reassocie-o usando os passos acima. Se o problema persistir, o site pode ter configurações de navegação personalizadas que substituem a navegação do hub. Verifique Configurações do Site > Navegação. Se Navegação personalizada estiver selecionada, altere para Herdar do site hub. Salve e atualize a página.
Navegação aparece em alguns sites, mas não em outros
A associação ao site hub pode não estar definida nos sites ausentes. No centro de administração do SharePoint, vá para Sites ativos. Selecione o site que está sem a navegação. No painel, procure por Configurações do site hub. Se nenhum hub estiver listado, clique em Editar e selecione o hub correto. Isso também pode acontecer se o site foi criado após a última atualização da navegação do hub. Reassociar o site puxará a navegação mais recente.
Atualizações de navegação aparecem após 24 horas
Isso é um sintoma de um trabalho do temporizador de cache travado. O trabalho do temporizador do SharePoint que atualiza o cache da navegação do hub pode estar atrasado. Você pode forçar uma atualização executando o seguinte comando PowerShell: Set-SPOHubSite -Identity . Este comando está disponível apenas no SharePoint Online Management Shell. Após a execução, a navegação deve ser atualizada em 15 minutos.
| Problema | Causa Provável | Solução Rápida |
|---|---|---|
| Navegação não atualiza em nenhum site | Cache não atualizado | Faça uma alteração fictícia na navegação do hub e aguarde 15 minutos |
| Navegação ausente em um site | Site não associado ao hub | Reassocie o site nas Configurações do Site ou no centro de administração do SharePoint |
| Navegação exibe links antigos | Limite de 500 nós excedido | Exclua nós de navegação não utilizados |
| Navegação aparece após 24 horas | Trabalho do temporizador travado | Execute Set-SPOHubSite -RerunNavigationSync no PowerShell |
Agora você pode diagnosticar e corrigir falhas de atualização da navegação do hub em sites associados. Comece limpando o cache do navegador e fazendo uma alteração fictícia na navegação do hub. Se o problema persistir, verifique a associação do site hub e o limite de 500 nós. Para casos avançados, use o SharePoint Online Management Shell para forçar uma sincronização de navegação. Essa abordagem resolve a grande maioria dos problemas de atualização da navegação do hub sem precisar do suporte da Microsoft.