Ao atualizar a navegação de um site hub do SharePoint, as alterações podem não aparecer nos sites associados mesmo após várias horas. Esse problema ocorre porque o SharePoint armazena em cache os dados de navegação do hub no nível do conjunto de sites e os atualiza em um intervalo agendado, não instantaneamente. Este artigo explica por que o cache de navegação atrasa as atualizações e fornece um método passo a passo para forçar uma atualização, fazendo com que os sites associados exibam os links de navegação do hub mais recentes.
Principais Conclusões: Forçar Atualização da Navegação do Hub em Sites Associados
- Central de administração do SharePoint > Sites ativos > Sites hub: Verifica quais sites estão associados ao hub e confere o ID do site hub.
- Configurações do site > Navegação > Navegação do hub: Confirma se a herança de navegação do hub está habilitada no site associado.
- Limpar cache do navegador + novo registro do site: Força o site associado a buscar os dados mais recentes de navegação do hub no servidor.
Por que a Navegação do Hub Não Atualiza nos Sites Associados
Os sites hub do SharePoint armazenam as configurações de navegação em um conjunto de propriedades dedicado no próprio site hub. Quando você modifica a navegação do hub — adicionando, removendo ou reordenando links — o SharePoint grava as alterações no armazenamento de navegação do site hub. Os sites associados não leem esses dados em tempo real. Em vez disso, cada site associado armazena em cache uma cópia da navegação do hub quando um usuário o visita pela primeira vez após uma alteração. A versão em cache persiste por até 24 horas ou até que o pool de aplicativos do site seja reciclado.
O atraso é proposital. O SharePoint usa cache para reduzir a carga no servidor e melhorar o desempenho de carregamento das páginas. No entanto, esse design significa que as edições na navegação do hub podem levar um dia inteiro para se propagar para todos os sites associados. O cache é armazenado por conjunto de sites, então um site associado pode exibir a navegação atualizada enquanto outro ainda mostra a versão antiga.
Outra causa comum é que o site associado perdeu a conexão com o hub. Se a associação ao site hub for quebrada — por exemplo, após uma movimentação de site ou uma alteração de permissões — a navegação não pode ser atualizada porque o vínculo entre os sites não existe mais.
Como Funciona a Herança de Navegação do Hub
Quando um site é associado a um hub, ele pode herdar a navegação do hub ou usar sua própria navegação personalizada. A configuração é controlada por um botão nas configurações de navegação do site. Se a herança estiver desativada, o site ignora todas as atualizações de navegação do hub. Essa é uma fonte frequente de confusão, pois os administradores presumem que a herança está habilitada quando não está.
Passos para Forçar Atualizações da Navegação do Hub em Sites Associados
Siga estes passos para limpar o cache da navegação do hub e forçar o site associado a buscar os dados mais recentes. Execute as ações primeiro no site hub e depois em cada site associado afetado.
- Verifique a associação ao site hub na central de administração do SharePoint
Acesse a Central de administração do SharePoint e selecione Sites ativos. Localize o site hub e verifique se a coluna Site hub mostra o ID correto do site hub. Em seguida, encontre cada site associado e confirme se a coluna Site hub corresponde ao mesmo ID. Se um site associado não mostrar nenhum hub, você precisará reassociá-lo. - Verifique a herança de navegação do hub no site associado
Navegue até o site associado. Clique em Configurações (ícone de engrenagem) e selecione Informações do site. Em seguida, clique em Exibir todas as configurações do site. Em Aparência e comportamento, selecione Navegação. Na página de Configurações de Navegação, certifique-se de que a opção Herdar navegação do hub esteja Ativada. Se estiver desativada, ative-a e clique em OK. - Limpe o cache do navegador no site associado
No site associado, pressione Ctrl+F5 (Windows) ou Cmd+Shift+R (Mac) para realizar uma atualização forçada. Isso ignora o cache local do navegador e solicita uma cópia nova da página do servidor. - Re-registre o site associado ao hub
Se a navegação ainda não atualizar, você pode forçar o site a se registrar novamente no hub. Na Central de administração do SharePoint, vá para Sites ativos. Selecione o site associado. Na barra de comandos, clique em Hub e depois em Cancelar registro do hub. Aguarde um minuto. Em seguida, selecione o site novamente, clique em Hub e escolha Registrar como site hub. Selecione o site hub correto na lista e clique em Salvar. - Verifique a atualização da navegação
Navegue até o site associado novamente e pressione Ctrl+F5. A navegação do hub agora deve exibir os links mais recentes. Se não aparecer, aguarde 15 minutos e repita o passo 4.
Se a Navegação do Hub Ainda Não Atualizar Após a Correção Principal
Os passos acima resolvem a maioria dos casos. Se a navegação ainda não atualizar, um dos seguintes problemas provavelmente está presente.
Cache da Navegação do Hub no Nível do Servidor
O SharePoint Online também mantém um cache no lado do servidor para a navegação do hub. Esse cache é atualizado a cada 15 a 30 minutos sob carga normal. Se você fez muitas alterações na navegação do hub recentemente, o servidor pode ainda estar processando as atualizações. Aguarde 30 minutos e repita a atualização forçada do navegador no site associado.
Site Associado Não Está Conectado Corretamente ao Hub
Um site pode aparecer na lista de sites associados do hub, mas ainda ter uma conexão quebrada. Isso acontece quando o site hub foi excluído e recriado com a mesma URL, ou quando o site associado foi movido para outro locatário. Para corrigir, cancele o registro do site no hub e registre-o novamente conforme descrito no passo 4 acima.
Script Personalizado ou Tema Bloqueia a Herança de Navegação
Se o site associado usa uma página mestra personalizada ou um tema personalizado que substitui a renderização da navegação, a navegação do hub pode não aparecer. Verifique as configurações de Página mestra do site em Configurações do site. Se uma página mestra personalizada estiver aplicada, volte para a página mestra padrão Seattle e teste a navegação novamente.
| Sintoma | Causa | Correção |
|---|---|---|
| Navegação do hub mostra links antigos | Cache do navegador ou servidor não atualizado | Atualização forçada com Ctrl+F5 e aguardar 30 minutos |
| Navegação do hub ausente completamente | Herança de navegação do hub desabilitada | Habilitar herdar navegação do hub nas configurações do site |
| Navegação atualiza em alguns sites, mas não em outros | Alguns sites associados têm associação ao hub quebrada | Cancelar registro e registrar novamente esses sites no hub |
A tabela acima resume os padrões de falha mais comuns para atualizações de navegação do hub. Use-a para diagnosticar rapidamente qual correção se aplica à sua situação.
Agora você pode forçar atualizações de navegação do hub em qualquer site associado, limpando o cache do navegador e, se necessário, registrando novamente o site. Para evitar atrasos futuros, agende alterações na navegação do hub durante períodos de baixo uso, para que a janela de cache do servidor de 30 minutos cause o mínimo de interrupção. Se você gerencia muitos sites associados, considere usar o PowerShell com o cmdlet Set-SPOHubSiteAssociation para atualizar associações em massa após uma alteração na navegação.