ReplaceMagic e SharePoint Online — Reparo Nativo em Massa de Links

O SharePoint Online é a plataforma de gerenciamento de documentos e colaboração baseada em nuvem da Microsoft, parte do Microsoft 365. Organizações em todo o mundo o utilizam para armazenar arquivos Word, Excel, PowerPoint, Visio e Project em bibliotecas de documentos estruturadas. Quando essas organizações migram de servidores de arquivos, farms do SharePoint local ou outro tenant do Microsoft 365, cada hiperlink, referência a objeto OLE e caminho incorporado que apontava para um local antigo se torna quebrado. O ReplaceMagic foi desenvolvido especificamente para resolver esse problema — em escala, sem exigir que você abra um único documento manualmente.

Conexão Nativa — Sem Necessidade de Mapeamento de Unidade

O ReplaceMagic se conecta ao SharePoint Online diretamente por meio da API REST do Microsoft SharePoint e do CSOM (Client-Side Object Model). Isso significa que você não precisa mapear o SharePoint como uma unidade de rede nem configurar o WebDAV. A conexão nativa via API é mais rápida, mais confiável e dá ao ReplaceMagic acesso aos metadados do SharePoint que uma unidade mapeada simplesmente não consegue expor. Uma vez conectado, o ReplaceMagic pode enumerar bibliotecas de documentos, baixar arquivos para processamento, aplicar substituições e fazer o upload dos arquivos corrigidos — tudo sem sair da interface do ReplaceMagic.

Métodos de Autenticação Suportados

O ReplaceMagic suporta múltiplos métodos de autenticação para o SharePoint Online, para acomodar diferentes configurações de segurança de tenant:

• SharePoint Online (usuário/senha) — Credenciais padrão do Microsoft 365. Adequado para tenants onde a autenticação legada ainda é permitida.
• MFA com Senha de Aplicativo — Para contas protegidas por autenticação multifator. Gere uma senha de aplicativo nas configurações de segurança da sua conta Microsoft 365 e use-a no lugar da sua senha regular.
• Autenticação Somente por Aplicativo — Registre um aplicativo no Azure AD, conceda as permissões necessárias do SharePoint e use o ID do cliente e o segredo do cliente. Este método é ideal para fluxos de trabalho automatizados, não supervisionados ou agendados onde nenhum login interativo é possível.

O Que o ReplaceMagic Preserva no SharePoint Online

Uma das preocupações mais críticas durante o processamento em massa de documentos é a integridade dos metadados. O ReplaceMagic foi projetado para preservar as seguintes propriedades do SharePoint Online após modificar um arquivo:

• Data de última modificação e autor da modificação
• Status de aprovação de conteúdo (Aprovado, Rejeitado, Pendente)
• Histórico de versões — as alterações são registradas como nova versão em vez de substituir a cadeia de versões
• Estado de check-in e check-out — documentos que estavam com check-out antes do processamento são devolvidos ao mesmo estado

Preservar a data de última modificação e o autor requer direitos de Administrador de Site na coleção de sites de destino. Apenas direitos de Colaborador não são suficientes para esta operação.

Throttling do SharePoint Online (HTTP 429)

O SharePoint Online impõe limites de taxa nas requisições à API. Quando muitas requisições chegam em um curto intervalo, o serviço retorna uma resposta HTTP 429 (Too Many Requests) ou HTTP 503. O ReplaceMagic trata o throttling automaticamente: detecta a resposta 429, lê o cabeçalho Retry-After, pausa o thread afetado pelo tempo especificado e então tenta novamente a requisição. Nenhuma intervenção manual é necessária.

Para minimizar a pressão de throttling, a configuração de processamento paralelo recomendada para o SharePoint Online é de 3 a 5 threads. Maior paralelismo acionará throttling com mais frequência e pode de fato reduzir o throughput geral. Você pode ajustar o número de threads no painel de configurações de Processamento do ReplaceMagic.

Tipos de Biblioteca e Página Suportados

Por meio de sua integração nativa, o ReplaceMagic pode processar os seguintes tipos de conteúdo no SharePoint Online:

• Bibliotecas de documentos padrão (Word, Excel, PowerPoint, Visio, PDF e outros tipos de arquivo)
• Páginas Wiki (conteúdo de Wiki Corporativo armazenado como ASPX)
• Páginas Canvas (páginas modernas do SharePoint)

Limitação de Caracteres Especiais

Arquivos cujos nomes contêm qualquer um dos seguintes caracteres não podem ter seus tokens de link compartilhado ou informações de link organizacional recuperadas pela API do SharePoint: ~ # % & * { } \ : <> ? / + | ". Esses arquivos ainda são baixados, processados em busca de links quebrados e enviados novamente — mas URLs no estilo de link compartilhado que apontam para eles não podem ser reparadas pelo mecanismo de token.

Cenários Típicos de Migração

• Servidor de arquivos → SharePoint Online: Caminhos UNC (\\Servidor\Compartilhamento\Arquivo.xlsx) tornam-se URLs HTTPS de biblioteca de documentos.
• SharePoint Local → SharePoint Online: URLs da intranet (http://intranet/sites/...) mudam para URLs na nuvem (https://empresa.sharepoint.com/sites/...).
• Migração de tenant para tenant: Tanto a URL base quanto os IDs internos de itens do SharePoint mudam; links baseados em ID requerem conversão para o formato de URL absoluta.

Visão Geral do Processamento Passo a Passo

Usar o ReplaceMagic com o SharePoint Online segue um fluxo de trabalho direto: selecione SharePoint Online como destino → autentique-se usando o método de sua preferência → selecione o site e a biblioteca de documentos → execute uma varredura para identificar todos os links → configure as regras de buscar e substituir → visualize as alterações na grade de resultados → execute as substituições. Todo o processo é registrado e reversível por meio do histórico de versões integrado do SharePoint.