Corrigir Links Quebrados Após Migração do SharePoint On-Premises para Online
Migrar do SharePoint on-premises para o SharePoint Online altera todos os URLs do seu ecossistema de documentos. A URL base muda do seu servidor interno (http://intranet ou http://sharepoint.empresa.com) para a nuvem da Microsoft (https://empresa.sharepoint.com), quebrando todos os links incorporados em todos os documentos Office armazenados ou vinculados nos dois ambientes.
- URL Antiga:
http://intranet/sites/Finance/Documents/Budget.xlsx - Nova URL:
https://company.sharepoint.com/sites/Finance/Documents/Budget.xlsx - O ReplaceMagic atualiza todos os links em todos os documentos em uma única execução, preservando todos os metadados do SharePoint
O Que Muda Durante a Migração do On-Premises para Online
- Formato da URL: de HTTP para HTTPS, de nome de host interno para domínio .sharepoint.com
- Autenticação: de Windows/NTLM para autenticação moderna do Microsoft 365
- Considerações sobre metadados: datas de última modificação e dados de autor podem ser preservados com o ReplaceMagic usando direitos de Administrador de Site
- Limitação de taxa: o SharePoint Online aplica limites de taxa de API; o on-premises normalmente não aplica
Tipos de Links Que Quebram
- Hiperlinks apontando para páginas ou documentos do SharePoint on-premises
- Links de objetos OLE referenciando arquivos armazenados no SharePoint antigo
- Fontes de link (dados externos do Excel/Word) referenciando dados do SharePoint on-premises
- Código de macro VBA contendo URLs on-premises codificadas
- Cabeçalhos e rodapés com caminhos do SharePoint incorporados
- Conteúdo de páginas Canvas e Wiki do SharePoint (páginas ASPX)
Como o ReplaceMagic Corrige a Migração
Etapa 1 — Varredura Pré-Migração
Conecte o ReplaceMagic ao SharePoint on-premises e faça a varredura de todas as bibliotecas de documentos. Exporte o inventário completo de links — este se torna a sua linha de base para verificação pós-migração e ajuda a dimensionar o esforço de reparo para o planejamento do projeto.
Etapa 2 — Definir Regras de Mapeamento de URL
A substituição principal é tipicamente simples:
-
http://intranet/sites→https://company.sharepoint.com/sites -
http://sharepoint.company.com→https://company.sharepoint.com
Regras adicionais podem ser necessárias caso os caminhos de URL dos sites tenham mudado durante a migração.
Etapa 3 — Executar no SharePoint Online
Após a migração, conecte o ReplaceMagic ao SharePoint Online. Execute a substituição em massa em todas as bibliotecas de documentos migradas. Os metadados são preservados com direitos de Administrador de Site. Os documentos são processados em paralelo sem serem abertos.
Etapa 4 — Gerenciar a Limitação de Taxa
O SharePoint Online limita as chamadas de API. Configure o ReplaceMagic para usar 3–5 threads paralelas e habilite o gerenciamento automático de limitação de taxa. Execute fora do horário de pico para melhor desempenho em bibliotecas de documentos grandes.
Etapa 5 — Verificar
Execute uma nova varredura para confirmar que todos os links agora resolvem para URLs válidas do SharePoint Online. Exporte um relatório de verificação para auditoria e aprovação do projeto.
Autenticação do SharePoint On-Premises
Ao conectar ao ambiente on-premises de origem, use a Autenticação do Windows. Ao conectar ao SharePoint Online de destino, use a autenticação do SharePoint Online (Office 365) ou MFA. Consulte o Guia de Autenticação do SharePoint para configuração passo a passo.
Considerações Especiais
- Ambientes híbridos: se estiver executando uma configuração híbrida do SharePoint durante a migração, alguns documentos podem estar on-premises e outros online simultaneamente — o ReplaceMagic pode direcionar ambos em execuções separadas
- Páginas Canvas/Wiki do SharePoint: links incorporados em páginas ASPX também são reparados (requer a opção “All SharePoint Libraries” na Configuração)
- Bibliotecas grandes: planeje para a limitação de taxa; considere agendar a execução da substituição fora do horário comercial
- Elemento tenant-a-tenant: se a migração também envolver uma mudança de tenant, consulte o guia de migração tenant-a-tenant para tratamento de links baseados em ID










