Ao adicionar um web part de Links Rápidos a uma página do SharePoint, você pode atribuir ícones a cada link. Alguns proprietários de sites relatam que esses ícones desaparecem após editar a página ou após uma migração do site. Esse problema geralmente ocorre porque a origem do ícone não é armazenada de forma que sobreviva à republicação da página ou porque o próprio arquivo de ícone se torna inacessível. Este artigo explica por que os ícones desaparecem do web part de Links Rápidos e mostra as configurações e soluções alternativas que evitam a perda de ícones.
Principais Conclusões: Prevenção de Perda de Ícones em Links Rápidos
- Web part Links Rápidos > Editar web part > Seletor de ícones: Use o seletor de ícones interno em vez de URLs de imagem personalizadas para manter os ícones após a republicação.
- Central de administração do SharePoint > Coleções de sites > Limites de armazenamento da coleção de sites: Verifique se o arquivo de imagem do ícone está armazenado em uma biblioteca do SharePoint que não foi excluída ou movida.
- Fluxo de trabalho de republicação de página: Sempre publique novamente a página após adicionar ou alterar ícones para confirmar os metadados que vinculam o ícone ao link.
Por que os Ícones dos Links Rápidos Desaparecem Após Edição ou Migração
O web part de Links Rápidos armazena cada link como um objeto JSON dentro do conteúdo da página. A propriedade do ícone pode referenciar um ícone interno da biblioteca de ícones do SharePoint ou uma URL de imagem personalizada. Quando você edita a página e a salva, o SharePoint serializa novamente os dados do web part. Se a origem do ícone for uma URL relativa que aponta para um arquivo em uma biblioteca de documentos, e esse arquivo for movido, renomeado ou excluído, o ícone quebra.
Durante a migração do site ou operações de cópia do site, o conteúdo da página é copiado, mas os arquivos de imagem associados podem não ser copiados se residirem em uma biblioteca que está excluída do escopo da migração. O web part de Links Rápidos não avisa que o arquivo de ícone está faltando. Ele simplesmente mostra o link sem um ícone.
Outra causa comum é usar o seletor de ícones clássico, que armazena uma referência a um arquivo na biblioteca Ativos do Site. Quando a página é republicada por um usuário diferente ou por meio de um script, o caminho relativo pode mudar. O ícone então aparece em branco.
Etapas para Verificar as Configurações de Ícone dos Links Rápidos e Evitar a Perda de Ícones
Siga estas etapas para verificar a configuração atual do ícone e aplicar uma origem de ícone estável que sobreviva a edições e migrações de página.
- Abra a página no modo de edição
Vá para o site do SharePoint que contém o web part de Links Rápidos. Selecione Editar no canto superior direito da página para entrar no modo de edição. - Edite o web part de Links Rápidos
Clique no ícone de lápis no web part de Links Rápidos para abrir o painel de propriedades no lado direito da tela. - Selecione um link e verifique a origem do ícone
Clique no ícone de lápis ao lado de um dos links na lista. Na caixa de diálogo de edição de link, observe o campo Ícone. Se mostrar uma URL que começa com /sites/ ou /SiteAssets/, o ícone está apontando para um arquivo. Esta é a configuração mais frágil. - Substitua um ícone baseado em arquivo por um ícone interno
Clique no botão seletor de ícone ao lado do campo Ícone. Escolha um ícone da biblioteca interna. Os ícones internos são armazenados nos ativos do sistema do SharePoint e nunca quebram. Clique em Selecionar. - Salve o link e publique novamente a página
Clique em Salvar na caixa de diálogo do link. Em seguida, clique em Publicar novamente na barra de ferramentas superior do editor de página. Esta etapa confirma a referência do ícone no conteúdo da página.
Se Você Precisar Usar uma Imagem Personalizada como Ícone
Alguns proprietários de sites preferem usar um logotipo da empresa ou um gráfico personalizado como ícone dos Links Rápidos. Para minimizar o risco de perda de ícone, armazene o arquivo de imagem na mesma biblioteca de documentos que contém a página. Use uma URL relativa que comece com /sites/nomedosite/nomedabiblioteca/nomedoarquivo.png. Não use uma URL que inclua pastas pessoais como /personal/ ou /userphoto/.
- Carregue o arquivo de ícone na biblioteca Ativos do Site
Vá para Conteúdo do Site > Ativos do Site. Carregue o arquivo de imagem. Anote o nome do arquivo exatamente como aparece, incluindo a extensão. - Copie a URL relativa do arquivo
Selecione o arquivo, clique nas reticências (…) e escolha Detalhes. No painel de detalhes, copie o campo Caminho. Ele deve começar com /sites/. - Cole a URL relativa no campo Ícone
No editor de link dos Links Rápidos, cole a URL relativa no campo Ícone. Não use uma URL https:// completa, a menos que o arquivo esteja em um local público. Uma URL completa pode quebrar se a URL do site mudar. - Teste o ícone visualizando a página
Selecione Visualizar na barra de ferramentas do editor de página. Verifique se o ícone é exibido corretamente. Em seguida, publique novamente a página.
Se os Ícones dos Links Rápidos Ainda Desaparecerem Após a Correção Principal
Web part de Links Rápidos mostra ícones em branco após uma migração do site
Quando um site é migrado do SharePoint Server para o SharePoint Online ou entre locatários, o web part de Links Rápidos pode perder ícones porque os caminhos relativos mudam. Após a migração, abra cada página que contém Links Rápidos, edite o web part e reaplique os ícones usando o seletor de ícones interno. Não confie nas URLs de ícone migradas.
Ícones desaparecem quando uma página é copiada para outro site
Copiar uma página de um site do SharePoint para outro não copia os arquivos na biblioteca Ativos do Site. O web part de Links Rápidos na página copiada ainda referencia o caminho da biblioteca original. Após a cópia, edite cada link e altere o ícone para um ícone interno ou para um arquivo que exista na biblioteca Ativos do Site do site de destino.
Ícones desaparecem após um usuário editar a página e salvar sem republicar
Se um usuário com permissões de edição alterar o layout da página ou adicionar outros web parts e salvar a página como rascunho, os ícones dos Links Rápidos permanecem. Mas se esse usuário publicar a página novamente por meio de um fluxo de trabalho de publicação diferente, os metadados do ícone podem ser removidos. Treine seus editores de conteúdo para sempre republicar a partir da barra de ferramentas do editor de página após qualquer alteração no web part de Links Rápidos.
Métodos de Armazenamento de Ícones dos Links Rápidos: Interno vs Imagem Personalizada
| Item | Ícone Interno | Imagem Personalizada |
|---|---|---|
| Origem do ícone | Biblioteca de ícones do sistema SharePoint | Arquivo em uma biblioteca de documentos do SharePoint |
| Persistência após edição da página | Sempre persiste | Pode quebrar se o arquivo for movido ou excluído |
| Persistência após migração do site | Sempre persiste | Quebra a menos que o arquivo seja migrado e o caminho atualizado |
| Esforço para configurar | Um clique no seletor de ícones | Carregar arquivo, copiar URL, colar no campo de ícone |
| Risco de perda de ícone | Nenhum | Alto sem gerenciamento cuidadoso de arquivos |
Ícones internos são a escolha recomendada para a maioria dos cenários de Links Rápidos. Eles não exigem gerenciamento de arquivos e sobrevivem a qualquer operação do SharePoint que preserve o conteúdo da página. Imagens personalizadas oferecem mais flexibilidade de branding, mas exigem governança rigorosa de arquivos.
Agora você pode verificar a origem do ícone para cada link dos Links Rápidos em seu site e substituir ícones baseados em arquivo por ícones internos para evitar futuras perdas de ícone. Para necessidades de branding personalizado, armazene o arquivo de ícone na biblioteca Ativos do Site e use uma URL relativa. Após qualquer migração ou operação de cópia de página, reabra o web part de Links Rápidos e reaplique os ícones usando o seletor interno. Essa abordagem elimina a causa mais comum de desaparecimento de ícones.