Agrega iconos a los enlaces en la parte web de Vínculos rápidos en una página de SharePoint. Después de que tú u otra persona edite la página, los iconos desaparecen. Los enlaces permanecen, pero las imágenes de los iconos se reemplazan por un marcador de posición genérico. Este problema ocurre porque SharePoint almacena las referencias de iconos como URL relativas que se rompen cuando la página se guarda bajo ciertas condiciones. Este artículo explica por qué los iconos desaparecen y te brinda una solución paso a paso para restaurarlos y protegerlos.
Conclusiones clave: Cómo evitar que los iconos de Vínculos rápidos desaparezcan
- Editar página > parte web de Vínculos rápidos > icono de lápiz: Usa el lápiz de edición, no el cuadro de diálogo de enlace, para seleccionar iconos; esto evita la corrupción de la URL.
- Centro de administración de SharePoint > Edición de páginas: Deshabilita la “creación de páginas modernas” para la colección de sitios para bloquear la representación problemática del lado del cliente.
- PowerShell Set-PnPPage: Ejecuta el cmdlet Set-PnPPage para borrar la propiedad de icono en caché y forzar una nueva lectura desde el ID del icono.
Por qué desaparecen los iconos de Vínculos rápidos en SharePoint
La parte web de Vínculos rápidos te permite agregar un enlace y elegir un icono de una biblioteca integrada. Cuando seleccionas un icono, SharePoint almacena una referencia a ese icono como una propiedad dentro de la definición JSON de la parte web. La propiedad contiene una URL relativa que apunta al archivo de imagen del icono en la biblioteca de activos de SharePoint. Cuando se guarda la página, la URL relativa puede romperse si el ID interno de la parte web cambia o si la página se copia, mueve o restaura desde una versión anterior. La URL rota hace que el icono se reemplace por una imagen de marcador de posición genérica.
La causa raíz es que la referencia del icono se almacena como una cadena que depende de la posición de la parte web en la página. Si editas el diseño de la página, mueves la parte web o usas el comando “Copiar” para duplicar la página, el ID de instancia de la parte web cambia. La URL del icono sigue apuntando al ID de instancia anterior, por lo que SharePoint no puede encontrar la imagen. El mismo fallo ocurre cuando se actualiza el tema del sitio o el conjunto de iconos, porque la asignación de ID de icono cambia pero la URL en caché no se actualiza.
Pasos para solucionar los iconos faltantes en Vínculos rápidos
- Edita la página y abre la parte web de Vínculos rápidos
Navega a la página de SharePoint que muestra los iconos faltantes. Selecciona Editar en la esquina superior derecha. Pasa el cursor sobre la parte web de Vínculos rápidos y haz clic en el icono de lápiz para abrir el panel de propiedades de la parte web. - Elimina el icono roto y vuelve a aplicarlo
En el panel de propiedades, localiza el enlace con el icono faltante. Haz clic en el enlace para expandir su configuración. Haz clic en el marcador de posición del icono actual (la imagen genérica). Selecciona Quitar icono. Luego haz clic en Agregar icono y elige el icono correcto de la biblioteca. Haz clic en Aplicar para guardar el cambio. - Guarda y vuelve a publicar la página
Haz clic en Publicar o Volver a publicar en la esquina superior derecha. El icono debería mostrarse correctamente ahora. Si el icono desaparece nuevamente, continúa con el siguiente paso. - Usa PowerShell para borrar la propiedad de icono en caché
Instala el módulo PnP PowerShell si aún no lo has hecho. Conéctate a tu sitio de SharePoint:Connect-PnPOnline -Url "https://yourtenant.sharepoint.com/sites/yoursite". Ejecuta el siguiente comando para obtener la página:$page = Get-PnPPage -Identity "PageName.aspx". Luego ejecutaSet-PnPPage -Identity "PageName.aspx" -Publishpara forzar una nueva representación completa de la parte web. Este comando borra la referencia de icono en caché y la reconstruye desde el ID del icono. - Deshabilita la creación de páginas modernas como último recurso
Ve al Centro de administración de SharePoint > Configuración > Edición de páginas. Para la colección de sitios afectada, establece “Permitir la creación de páginas modernas” en Desactivado. Esto deshabilita el código del lado del cliente que corrompe las URL de los iconos. Los usuarios editarán páginas en modo clásico, que almacena los iconos de manera diferente. Este paso es una solución alternativa y debe usarse solo si la pérdida de iconos persiste después de los pasos 1-4.
Si los iconos de Vínculos rápidos aún no se muestran después de la solución
La parte web de Vínculos rápidos muestra un icono de imagen rota para todos los enlaces
Este patrón indica que la biblioteca de iconos del sitio se ha eliminado o renombrado. La parte web de Vínculos rápidos hace referencia a los iconos mediante un GUID que apunta a una biblioteca del sistema llamada “Activos del sitio”. Si un administrador eliminó o movió la biblioteca “Activos del sitio”, las imágenes de los iconos son inaccesibles. Para solucionarlo, recrea la biblioteca “Activos del sitio” en la raíz de la colección de sitios. Ve a Contenido del sitio > Agregar una aplicación > Biblioteca de documentos. Nómbrala exactamente “Activos del sitio”. La parte web de Vínculos rápidos encontrará automáticamente la biblioteca y mostrará los iconos nuevamente.
Los iconos desaparecen después de mover la página a otro sitio
Cuando copias o mueves una página a una colección de sitios diferente, las URL de los iconos no se actualizan a la biblioteca de activos del nuevo sitio. Los iconos apuntan a la biblioteca del sitio original, que es inaccesible desde el nuevo sitio. La única solución es volver a aplicar manualmente cada icono después del movimiento. Usa los pasos de la solución principal para quitar y volver a agregar cada icono en la página movida.
Los iconos desaparecen después de un cambio de tema del sitio
Los conjuntos de iconos de SharePoint son sensibles al tema. Cuando cambias el tema del sitio, la asignación de ID de icono puede cambiar. La parte web de Vínculos rápidos almacena el ID del icono en el momento de la selección, no una referencia dinámica. Después de un cambio de tema, el ID almacenado ya no coincide con ningún icono disponible. Vuelve a aplicar el icono después del cambio de tema. Para prevenir esto, establece el tema del sitio antes de agregar iconos de Vínculos rápidos y evita cambiar el tema después.
Tipos de iconos en la parte web de Vínculos rápidos: iconos integrados vs. iconos personalizados
| Elemento | Iconos integrados | Iconos personalizados |
|---|---|---|
| Fuente | Biblioteca de iconos de SharePoint en Activos del sitio | URL de imagen externa cargada por el usuario |
| Formato de almacenamiento | ID de icono (GUID) asignado a una URL relativa | URL absoluta ingresada en el campo de icono |
| Probabilidad de pérdida | Alta: la URL relativa se rompe al mover o copiar la página | Baja: la URL absoluta sigue siendo válida a menos que la imagen externa se elimine |
| Método de solución | Vuelve a aplicar el icono o usa PowerShell para borrar la caché | Verifica que la URL externa siga siendo accesible |
Los iconos integrados son más fáciles de seleccionar pero se rompen con más frecuencia. Los iconos personalizados requieren una URL absoluta pero permanecen estables en las operaciones de página. Para páginas de alto tráfico, considera usar iconos personalizados alojados en una CDN confiable para evitar por completo el problema de pérdida de iconos.