Você adiciona ícones aos links no web part de Links Rápidos em uma página do SharePoint. Após você ou outra pessoa editar a página, os ícones desaparecem. Os links permanecem, mas as imagens dos ícones são substituídas por um placeholder genérico. Esse problema ocorre porque o SharePoint armazena referências de ícones como URLs relativas que se quebram quando a página é salva em certas condições. Este artigo explica por que os ícones desaparecem e fornece uma correção passo a passo para restaurá-los e protegê-los.
Principais Conclusões: Como Evitar que os Ícones dos Links Rápidos Desapareçam
- Editar página > Web part Links Rápidos > Ícone de lápis: Use o lápis de edição, não a caixa de diálogo do link, para selecionar ícones — isso evita a corrupção da URL.
- Central de administração do SharePoint > Edição de página: Desative a “criação de página moderna” para o conjunto de sites para bloquear a renderização problemática do lado do cliente.
- PowerShell Set-PnPPage: Execute o cmdlet Set-PnPPage para limpar a propriedade de ícone em cache e forçar uma nova leitura a partir do ID do ícone.
Por que os Ícones dos Links Rápidos Desaparecem no SharePoint
O web part de Links Rápidos permite adicionar um link e escolher um ícone de uma biblioteca interna. Quando você seleciona um ícone, o SharePoint armazena uma referência a esse ícone como uma propriedade dentro da definição JSON do web part. A propriedade contém uma URL relativa que aponta para o arquivo de imagem do ícone na biblioteca de ativos do SharePoint. Quando a página é salva, a URL relativa pode quebrar se o ID interno do web part mudar ou se a página for copiada, movida ou restaurada de uma versão anterior. A URL quebrada faz com que o ícone seja substituído por uma imagem placeholder genérica.
A causa raiz é que a referência do ícone é armazenada como uma string que depende da posição do web part na página. Se você editar o layout da página, mover o web part ou usar o comando “Copiar” para duplicar a página, o ID de instância do web part muda. A URL do ícone ainda aponta para o ID de instância antigo, então o SharePoint não consegue encontrar a imagem. A mesma falha ocorre quando o tema do site ou o conjunto de ícones é atualizado, pois o mapeamento do ID do ícone muda, mas a URL em cache não é atualizada.
Passos para Corrigir Ícones Ausentes nos Links Rápidos
- Edite a página e abra o web part de Links Rápidos
Navegue até a página do SharePoint que mostra os ícones ausentes. Selecione Editar no canto superior direito. Passe o mouse sobre o web part de Links Rápidos e clique no ícone de lápis para abrir o painel de propriedades do web part. - Remova o ícone quebrado e reaplique-o
No painel de propriedades, localize o link com o ícone ausente. Clique no link para expandir suas configurações. Clique no placeholder do ícone atual (a imagem genérica). Selecione Remover ícone. Em seguida, clique em Adicionar ícone e escolha o ícone correto na biblioteca. Clique em Aplicar para salvar a alteração. - Salve e republicue a página
Clique em Publicar ou Republicar no canto superior direito. O ícone agora deve ser exibido corretamente. Se o ícone desaparecer novamente, prossiga para a próxima etapa. - Use o PowerShell para limpar a propriedade de ícone em cache
Instale o módulo PnP PowerShell se ainda não o fez. Conecte-se ao seu site do SharePoint:Connect-PnPOnline -Url "https://sualocacao.sharepoint.com/sites/seustie". Execute o seguinte comando para obter a página:$page = Get-PnPPage -Identity "NomeDaPagina.aspx". Em seguida, executeSet-PnPPage -Identity "NomeDaPagina.aspx" -Publishpara forçar uma re-renderização completa do web part. Este comando limpa a referência de ícone em cache e a reconstrói a partir do ID do ícone. - Desative a criação de página moderna como último recurso
Vá para Central de administração do SharePoint > Configurações > Edição de página. Para o conjunto de sites afetado, defina “Permitir criação de página moderna” como Desligado. Isso desativa o código do lado do cliente que corrompe as URLs dos ícones. Os usuários editarão páginas no modo clássico, que armazena ícones de forma diferente. Esta etapa é uma solução alternativa e deve ser usada apenas se a perda de ícones persistir após as etapas 1-4.
Se os Ícones dos Links Rápidos Ainda Não Aparecerem Após a Correção
O web part de Links Rápidos mostra um ícone de imagem quebrada para todos os links
Esse padrão indica que a biblioteca de ícones do site foi removida ou renomeada. O web part de Links Rápidos referencia ícones por um GUID que aponta para uma biblioteca do sistema chamada “Ativos do Site”. Se um administrador excluiu ou moveu a biblioteca “Ativos do Site”, as imagens dos ícones ficam inacessíveis. Para corrigir, recrie a biblioteca “Ativos do Site” na raiz do conjunto de sites. Vá para Conteúdo do Site > Adicionar um aplicativo > Biblioteca de Documentos. Nomeie-a exatamente como “Ativos do Site”. O web part de Links Rápidos encontrará automaticamente a biblioteca e exibirá os ícones novamente.
Ícones desaparecem após mover a página para outro site
Ao copiar ou mover uma página para um conjunto de sites diferente, as URLs dos ícones não são atualizadas para a biblioteca de ativos do novo site. Os ícones apontam para a biblioteca do site original, que fica inacessível a partir do novo site. A única correção é reaplicar manualmente cada ícone após a movimentação. Use as etapas da correção principal para remover e readicionar cada ícone na página movida.
Ícones desaparecem após uma alteração de tema do site
Os conjuntos de ícones do SharePoint são sensíveis ao tema. Quando você altera o tema do site, o mapeamento do ID do ícone pode mudar. O web part de Links Rápidos armazena o ID do ícone no momento da seleção, não uma referência dinâmica. Após uma alteração de tema, o ID armazenado não corresponde mais a nenhum ícone disponível. Reaplique o ícone após a alteração do tema. Para evitar isso, defina o tema do site antes de adicionar ícones aos Links Rápidos e evite alterar o tema posteriormente.
Tipos de Ícone do Web Part de Links Rápidos: Ícones Internos vs Ícones Personalizados
| Item | Ícones Internos | Ícones Personalizados |
|---|---|---|
| Origem | Biblioteca de ícones do SharePoint em Ativos do Site | URL de imagem externa enviada pelo usuário |
| Formato de armazenamento | ID do ícone (GUID) mapeado para uma URL relativa | URL absoluta inserida no campo de ícone |
| Probabilidade de perda | Alta — a URL relativa quebra ao mover ou copiar a página | Baixa — a URL absoluta permanece válida a menos que a imagem externa seja excluída |
| Método de correção | Reaplicar o ícone ou usar PowerShell para limpar o cache | Verificar se a URL externa ainda está acessível |
Ícones internos são mais fáceis de selecionar, mas quebram com mais frequência. Ícones personalizados exigem uma URL absoluta, mas permanecem estáveis durante operações na página. Para páginas de alto tráfego, considere usar ícones personalizados hospedados em uma CDN confiável para evitar completamente o problema de perda de ícones.