Quando um usuário da sua organização altera o nome de exibição, os links do SharePoint que apontam para essa pessoa podem quebrar. Esses links, criados com o seletor de pessoas ou o controle Menção em páginas modernas, dependem do identificador único do usuário. Mas o texto do link pode ainda exibir o nome antigo. Essa incompatibilidade pode confundir os visitantes e fazer com que o link falhe ao ser clicado. Este artigo explica por que o link quebra, como identificar os links afetados e quais medidas você pode tomar para restaurá-los.
Principais Conclusões: Corrigindo Links de Pessoas Após Renomeação de Usuário no SharePoint
- Biblioteca de Páginas do Site > Fazer Check-Out e Editar: Atualize manualmente o texto do link de pessoa para corresponder ao novo nome de exibição do usuário.
- Central de Administração do SharePoint > Perfis de Usuário > Gerenciar Perfis de Usuário: Dispare uma sincronização completa de perfil para atualizar os dados de nome em cache em todo o locatário.
- Ferramentas de Desenvolvedor do Navegador (F12) > Guia Rede: Inspecione o link com falha para ver o ID antigo do usuário e a incompatibilidade com o novo nome.
Por que a Renomeação de um Usuário Quebra um Link de Pessoa Específico
O SharePoint armazena links de pessoas usando o identificador único do usuário, como a declaração i:0#.f|membership|user@domain.com. Quando você insere um link de pessoa em uma página moderna, o SharePoint renderiza o link com o nome de exibição atual do usuário como texto visível. O hiperlink subjacente contém o ID do usuário codificado. Quando o nome de exibição do usuário muda no Microsoft Entra ID (antigo Azure AD), a sincronização de perfil para o SharePoint leva tempo. Durante essa lacuna, o texto do link ainda mostra o nome antigo, mas o ID permanece válido. No entanto, se o cache HTML da página ou o controle do seletor de pessoas não for atualizado, clicar no link pode produzir um erro de “usuário não encontrado” ou redirecionar para uma página de perfil quebrada.
O problema não é um hiperlink quebrado no sentido tradicional. A URL do link ainda aponta para o ID correto do usuário. O problema é o rótulo de texto visível que não corresponde mais ao nome atual do usuário. Essa incompatibilidade pode fazer com que o mecanismo de renderização do SharePoint falhe ao tentar resolver o link dinamicamente, especialmente em cenários onde a página usa a web part sp-persons ou o controle Menção em uma web part de texto.
Etapas para Identificar e Corrigir Links de Pessoas Quebrados
- Abra a página do site afetada no modo de edição
Navegue até o site onde o link quebrado aparece. Clique no ícone de engrenagem e selecione Editar página. Se a página for moderna, você entrará na interface de edição da tela. - Encontre a web part de texto do link de pessoa
Procure por uma web part de texto ou uma web part de pessoas que contenha o nome do usuário. Clique dentro da web part para ver a barra de ferramentas de formatação. Se o link estiver em uma web part de texto, selecione o texto do nome do usuário e procure pelo ícone de hiperlink na barra de ferramentas. - Verifique a URL do link subjacente
Clique com o botão direito no nome do usuário vinculado e selecione Inspecionar (ou pressione F12). Na guia Elementos, localize a tag<a>. O atributohrefdeve conter uma URL comohttps://yourtenant.sharepoint.com/:p:/...?people=user@domain.com. Se a URL estiver ausente ou apontar para um ID de usuário antigo, você precisará recriar o link. - Remova e reinsira o link de pessoa
Na web part de texto, exclua o nome antigo do usuário. Digite o novo nome de exibição do usuário. Selecione o texto e clique no botão Inserir link na barra de ferramentas. Escolha Pessoas no seletor de links. Comece a digitar o novo nome do usuário e selecione a entrada correta na lista suspensa. Clique em Inserir. - Salve e republicue a página
Clique em Salvar e depois em Publicar para aplicar as alterações. Teste o link clicando nele em uma visualização sem edição. - Dispara uma sincronização completa do perfil do usuário (se muitos links estiverem quebrados)
Vá para a Central de Administração do SharePoint. Em Perfis de usuário, selecione Gerenciar perfis de usuário. Encontre o usuário renomeado, clique na seta suspensa e escolha Iniciar sincronização completa. Isso atualiza os dados do perfil em todas as coleções de sites. Aguarde até 24 horas para a sincronização ser concluída.
Se o Link de Pessoa Ainda Não Funcionar Após a Correção Principal
O seletor de pessoas não mostra o novo nome
O seletor de pessoas no SharePoint armazena em cache os nomes de usuário do Serviço de Perfil de Usuário. Se a renomeação foi recente, o cache ainda pode conter o nome antigo. Limpe o cache do navegador e saia de todos os aplicativos do Microsoft 365. Em seguida, faça login novamente. Se o problema persistir, peça ao administrador do locatário para executar uma sincronização completa de perfil na Central de Administração do SharePoint.
O link funciona no modo de edição, mas quebra no modo de leitura
Isso geralmente indica um conflito de renderização com um script personalizado ou uma web part de terceiros. Teste a página em uma janela privada do navegador. Se o link funcionar lá, o problema está nas extensões do navegador ou scripts em cache. Desative as extensões uma por uma para encontrar o culpado.
Várias páginas têm links de pessoas quebrados
Quando uma renomeação de usuário afeta muitas páginas, a edição manual é ineficiente. Use o SharePoint PnP PowerShell para pesquisar em todas as páginas do site o nome antigo do usuário. O cmdlet Get-PnPListItem pode recuperar o conteúdo da página. Em seguida, use Set-PnPListItem para atualizar o texto do link de pessoa. Isso requer conhecimento da estrutura HTML da página, então teste em uma única página primeiro.
Tipos de Link de Pessoa: Inserção Manual vs. Controle Menção
| Item | Inserção Manual via Seletor de Links | Controle Menção (@menção) |
|---|---|---|
| Como o link é criado | O usuário digita um nome, seleciona Pessoas no seletor de links e insere | O usuário digita @ seguido do nome e seleciona na lista suspensa |
| Dados subjacentes | Armazena o ID do usuário como um hiperlink com texto do nome de exibição | Armazena o ID do usuário em um atributo especial data-sp-people |
| Comportamento após renomeação | O texto do nome de exibição fica desatualizado; o link pode falhar ao clicar | O nome de exibição é atualizado automaticamente após a sincronização de perfil |
| Como corrigir | Edite manualmente o texto do link e reinsira usando o seletor de links | Nenhuma correção manual necessária; aguarde a sincronização de perfil ou dispare uma sincronização completa |
O controle Menção é mais resiliente porque armazena o ID do usuário em um atributo que o SharePoint renderiza dinamicamente. Os links manuais de pessoas são texto estático que deve ser atualizado por um proprietário do site.
Como proprietário do site, agora você pode identificar quais páginas usam links manuais de pessoas e atualizá-los após uma renomeação de usuário. Para alterações futuras, incentive os editores a usar o controle @menção em vez do seletor manual de links. Isso reduz a carga de manutenção. Se você gerencia muitos sites, considere executar um script periódico do PowerShell para detectar páginas com links de pessoas desatualizados.