Corrigir Links Quebrados Após Migração Tenant-a-Tenant do SharePoint
As migrações tenant-a-tenant estão entre os cenários mais complexos do SharePoint — elas alteram tanto a URL base quanto os IDs internos de itens do SharePoint, quebrando todos os links incorporados em todos os documentos Office. Este guia explica o que quebra, por que, e como o ReplaceMagic repara os três tipos de links em massa.
- Migrações de tenant quebram TODOS os três tipos de links: links de URL absoluta, links de caminho relativo E links baseados em ID do SharePoint
- O reparo manual não é viável em escala empresarial — até 1.000 documentos com 10 links cada = 10.000 edições manuais
- O ReplaceMagic trata os três tipos de links automaticamente, incluindo conversão de links baseados em ID (com base em combinações de busca/substituição fornecidas pelo usuário)
Por Que Migrações Tenant-a-Tenant Quebram Links de Documentos
Quando uma empresa migra de um tenant do Microsoft 365 para outro — devido a aquisição, fusão ou cisão — todas as URLs do SharePoint mudam porque o domínio do tenant muda (empresa.sharepoint.com se torna novaempresa.sharepoint.com). Além disso, cada item do SharePoint possui um ID interno único para aquele tenant — esses IDs não são transferidos para o novo tenant. O resultado é que todos os links incorporados em todos os documentos ficam quebrados no momento da transição.
1. Links de URL Absoluta
Estes referenciam diretamente o domínio antigo do tenant (por exemplo, https://empresaantiga.sharepoint.com/sites/Finance/...). Após a migração, o domínio é inválido. Correção: substituir o domínio antigo pelo novo em todos os documentos.
2. Links de Caminho Relativo
Estes referenciam documentos usando caminhos relativos dentro da hierarquia do site SharePoint. Podem quebrar se a estrutura do site mudar durante a migração. Correção: atualizar os componentes do caminho que foram alterados.
3. Links Baseados em ID (mais críticos)
O SharePoint armazena alguns links como referências ao ID interno do banco de dados do item (por exemplo, /sites/Finance/_layouts/15/Doc.aspx?sourcedoc={GUID}). Esses GUIDs são específicos do tenant e não existem no tenant de destino. Após a migração, esses links não apontam para lugar nenhum. Correção: o ReplaceMagic converte links baseados em ID para links corretos baseados em URL, com base em combinações de busca/substituição fornecidas pelo usuário, antes ou após a migração para que permaneçam funcionais no novo tenant.
Todas as alterações - baseadas em regras de busca/substituição fornecidas pelo usuário
O ReplaceMagic realizará todas as alterações com base em regras de busca/substituição fornecidas pelo usuário. O ReplaceMagic.SmartMapper automatiza a criação dessas regras — resolve DocIDs do SharePoint e gera os padrões necessários diretamente a partir do seu mapeamento origem → destino, antes da transição do tenant. Consulte o guia do SmartMapper para mais detalhes.
Como o ReplaceMagic Corrige os Três Tipos de Links
Etapa 1 — Varredura Pré-Migração
Execute o ReplaceMagic no tenant de origem para construir um inventário completo de todos os documentos e todos os tipos de links. Identifique quantos links absolutos, relativos e baseados em ID existem. Este inventário alimenta diretamente as suas regras de substituição e fornece uma linha de base para verificação pós-migração.
Etapa 2 — Configurar Regras de Substituição
Configure a substituição de domínio (URL antiga → nova URL). Para links baseados em ID, o ReplaceMagic pode convertê-los com base em regras de busca/substituição fornecidas pelo usuário. Todos os tipos de regras são configurados em um único arquivo de importação e executados em uma única passagem de processamento.
Etapa 3 — Visualizar e Validar
Execute no modo de Visualização para ver todas as alterações propostas antes de confirmá-las. Verifique se as regras de substituição cobrem todas as variações de links encontradas na varredura. Ajuste as regras caso algum caso especial seja identificado.
Etapa 4 — Executar
Execute a substituição. O ReplaceMagic processa todos os documentos em paralelo, atualizando os três tipos de links em uma única passagem sem abrir nenhum arquivo. Os metadados do SharePoint (data de última modificação, autor) são preservados quando executado com direitos de Administrador de Site.
Etapa 5 — Verificação Pós-Migração
Execute uma nova varredura no tenant de destino para confirmar que todos os links agora resolvem corretamente. Exporte um relatório de verificação para aprovação do projeto e documentação de auditoria.
O Que o Pacote de Preparação de Substituições Faz
Para migrações complexas tenant-a-tenant com centenas de variações de caminho ou grandes volumes de links baseados em ID, a equipe do ReplaceMagic pode preparar todas as combinações de strings de substituição em seu nome. Este serviço analisa o seu tenant de origem, identifica cada padrão de link exclusivo e entrega um arquivo de regras de substituição pronto para importação. Consulte o Pacote de Preparação de Substituições para mais detalhes.
Considerações Principais
- Momento: idealmente execute o ReplaceMagic APÓS todos os documentos terem sido migrados para o tenant de destino
- Permissões: direitos de Administrador de Site necessários no tenant SharePoint de destino para preservar as datas de última modificação
- Links baseados em ID: a conversão deve ser validada em uma amostra antes da execução completa
- Escopo: documentos do Microsoft Teams e OneDrive for Business são cobertos (backend SharePoint)
Download Teste Gratuito Pacote de Preparação de Substituições










