La navegación del concentrador no se actualiza en los sitios asociados: causa raíz y solución

Cuando actualiza la navegación en un sitio concentrador de SharePoint, los cambios no aparecen en los sitios asociados. Este problema ocurre incluso después de borrar la caché del navegador y actualizar la página varias veces. La causa raíz es una combinación de cómo SharePoint almacena en caché los datos de navegación a nivel de colección de sitios y cómo la característica de navegación del concentrador propaga los cambios. Este artículo explica por qué la navegación no se actualiza y proporciona una solución confiable para forzar la actualización.

Por qué la navegación del concentrador no se actualiza automáticamente en los sitios asociados

La navegación del concentrador de SharePoint se almacena como un objeto independiente en la colección de sitios del sitio concentrador. Cuando edita la navegación, SharePoint actualiza el objeto del sitio concentrador pero no inserta inmediatamente los cambios en cada sitio asociado. En su lugar, los datos de navegación se almacenan en caché hasta 24 horas en cada sitio asociado. Este comportamiento de almacenamiento en caché reduce la carga del servidor pero provoca un retraso notable cuando los usuarios esperan actualizaciones instantáneas.

La característica de navegación del concentrador se basa en un trabajo de temporizador denominado “Hub Site Navigation Sync” que se ejecuta cada 15 minutos de forma predeterminada. Si el trabajo de temporizador falla o se retrasa, es posible que la navegación nunca se sincronice. Además, la personalización de la marca o los scripts de terceros que anulan el control de navegación pueden impedir que se represente la navegación actualizada incluso después de que se complete la sincronización.

El rol del trabajo de temporizador Hub Site Navigation Sync

El trabajo de temporizador es responsable de copiar los nodos de navegación del sitio concentrador a la caché de navegación de cada sitio asociado. El trabajo se ejecuta en la granja de servidores de SharePoint. En SharePoint Online, Microsoft administra el trabajo de temporizador, pero aún puede retrasarse durante el uso máximo. Si tiene una gran cantidad de sitios asociados, el trabajo puede tardar más de 15 minutos en completarse, lo que provoca que algunos sitios no reciban la actualización.

Cómo el almacenamiento en caché impide las actualizaciones de navegación

Cada sitio asociado mantiene una caché local de la navegación del concentrador. La caché se almacena en la bolsa de propiedades del sitio y se actualiza solo cuando se ejecuta el trabajo de temporizador. Borrar la caché del navegador no borra la caché de navegación a nivel de sitio. Esta es la razón por la que actualizar la página no tiene efecto. La única forma de forzar una actualización es desencadenar una invalidación de caché en el sitio asociado.

Pasos para forzar las actualizaciones de la navegación del concentrador en los sitios asociados

Método 1: Cambiar la configuración regional en un sitio asociado

1. Vaya al sitio asociado que no muestra la navegación actualizada.
   Abra el sitio en el navegador. Debe ser propietario del sitio o tener el permiso Administrar sitio web.
2. Abra Configuración del sitio.
   Haga clic en el icono de engranaje en la esquina superior derecha y seleccione Configuración del sitio. Si no ve Configuración del sitio, haga clic en Información del sitio y luego en Ver toda la configuración del sitio.
3. Vaya a Configuración regional.
   En Administración del sitio, haga clic en Configuración regional.
4. Cambie la zona horaria a cualquier zona horaria diferente.
   Seleccione una zona horaria que no esté configurada actualmente. Por ejemplo, si su zona horaria actual es (UTC-05:00) Hora del Este (EE. UU. y Canadá), cámbiela a (UTC-06:00) Hora Central (EE. UU. y Canadá).
5. Haga clic en Aceptar para guardar el cambio.
   SharePoint actualizará la caché del sitio, incluida la caché de navegación del concentrador. La navegación actualizada debería aparecer inmediatamente.
6. Opcional: Vuelva a cambiar la zona horaria al valor original.
   Después de confirmar la actualización de la navegación, puede revertir la zona horaria. La navegación permanecerá actualizada porque la actualización de la caché ya se produjo.

Método 2: Volver a registrar el sitio concentrador

1. Abra el centro de administración de SharePoint.
   Inicie sesión en el centro de administración de Microsoft 365 y luego vaya a Centros de administración > SharePoint.
2. Vaya a Sitios activos.
   En la navegación izquierda, haga clic en Sitios activos.
3. Seleccione el sitio concentrador.
   Busque el sitio que está registrado como concentrador. Haga clic en su nombre para abrir el panel de detalles.
4. En Concentrador, haga clic en Editar.
   Esto abre el panel de configuración del concentrador.
5. Desactive la casilla “Los sitios asociados heredarán la navegación del concentrador” y guarde.
   Esto elimina la navegación del concentrador de todos los sitios asociados.
6. Vuelva a activar la casilla y guarde de nuevo.
   Esto vuelve a registrar la navegación del concentrador y desencadena una sincronización completa con todos los sitios asociados.

Método 3: Usar PowerShell para forzar la sincronización de la navegación

1. Instale el Shell de administración de SharePoint Online si aún no está instalado.
   Descargue e instale el módulo desde el Centro de descargas de Microsoft.
2. Conéctese a SharePoint Online.
   Ejecute Connect-SPOService -Url https://yourtenant-admin.sharepoint.com e inicie sesión con una cuenta de administrador de SharePoint.
3. Obtenga la URL del sitio concentrador.
   Ejecute Get-SPOSite -Template “SITEPAGEPUBLISHING#0” | Where-Object {$_.IsHubSite -eq $true} para enumerar todos los sitios concentradores.
4. Fuerce la sincronización de la navegación.
   Ejecute Set-SPOHubSiteNavigation -HubSiteUrl “https://yourtenant.sharepoint.com/sites/hub” -SyncNavigationToAssociatedSites $true. Reemplace la URL con la URL de su sitio concentrador.
5. Verifique la sincronización.
   Abra un sitio asociado y compruebe si la navegación se actualizó. La sincronización suele completarse en unos minutos.

Si la navegación del concentrador aún tiene problemas después de la solución principal

“La navegación del concentrador muestra enlaces antiguos incluso después de la sincronización”

Esto ocurre cuando la caché de navegación del sitio asociado contiene datos obsoletos que no se borraron con la sincronización. Para forzar un restablecimiento completo de la caché, agregue el parámetro de URL ?force=1 a la URL del sitio asociado y vuelva a cargar la página. Por ejemplo, https://yourtenant.sharepoint.com/sites/associatedsite?force=1. Esto fuerza a SharePoint a recargar la navegación desde la base de datos en lugar de la caché.

“La navegación del concentrador desaparece por completo después de volver a registrar”

Si la navegación desaparece después de volver a registrar el sitio concentrador, es posible que la configuración de navegación del sitio concentrador esté dañada. Vaya al sitio concentrador, haga clic en Configuración > Navegación y agregue al menos un vínculo. Guarde los cambios. Luego vuelva a registrar el sitio concentrador con el Método 2. La navegación reaparecerá en los sitios asociados después de la sincronización.

“La navegación del concentrador se actualiza en algunos sitios pero no en otros”

Esto indica que el trabajo de temporizador está fallando para sitios específicos. Compruebe si esos sitios tienen páginas maestras personalizadas o scripts que modifican el control de navegación. Elimine temporalmente cualquier código de navegación personalizado y pruebe la sincronización. Si la navegación se actualiza, el código personalizado está bloqueando la navegación del concentrador. Reemplace el código personalizado con una solución que respete el control de navegación del concentrador.

Elemento	Cambio de configuración regional	Nuevo registro del sitio concentrador	Sincronización con PowerShell
Descripción	Cambia la zona horaria para vaciar la caché del sitio	Anula el registro y vuelve a registrar la navegación del concentrador	Usa el cmdlet Set-SPOHubSiteNavigation para forzar la sincronización
Complejidad	Baja	Media	Alta
Tiempo para completar	2 minutos	5 minutos	10 minutos
Requiere derechos de administrador	Solo propietario del sitio	Administrador de SharePoint	Administrador de SharePoint
Efecto en otros sitios	Ninguno	Todos los sitios asociados pierden temporalmente la navegación	Ninguno

Ahora puede forzar la actualización de la navegación del concentrador en cualquier sitio asociado usando uno de los tres métodos. Comience con el cambio de Configuración regional porque es el más rápido y no requiere acceso de administrador. Si eso no funciona, vuelva a registrar el sitio concentrador. Use el método de PowerShell para entornos grandes donde necesita sincronizar varios sitios concentradores a la vez. Recuerde que agregar el parámetro de URL ?force=1 es un paso de diagnóstico rápido para verificar si los datos de navegación están realmente presentes en la base de datos del sitio.