Integração do ReplaceMagic com SharePoint — Corrigir Links Quebrados de Forma Nativa

O ReplaceMagic oferece duas formas de trabalhar com o SharePoint: integração nativa via API (recomendado) e acesso por unidade mapeada. Entender a diferença entre esses dois métodos ajuda a escolher a abordagem correta para o seu ambiente e garante que o projeto de processamento de documentos seja concluído com êxito, sem perda de dados ou corrupção de metadados.

Integração Nativa vs. Unidade Mapeada

Quando o SharePoint é mapeado como uma unidade de rede usando WebDAV, o Windows apresenta a biblioteca do SharePoint como uma pasta do sistema de arquivos. Essa abordagem é simples de configurar, mas apresenta limitações significativas: nenhum metadado é acessível, o check-in/check-out não é gerenciado e as informações de controle de versões são invisíveis para a ferramenta de processamento. Também tende a ser mais lenta e menos confiável, especialmente por VPN ou conexões WAN.

A integração nativa via API, por outro lado, comunica-se diretamente com o SharePoint por meio de sua API REST e CSOM. Isso dá ao ReplaceMagic acesso completo às propriedades dos documentos, às configurações de biblioteca e aos recursos de nível de plataforma que o WebDAV simplesmente não consegue expor. A integração nativa é mais rápida, mais confiável e é o único modo que suporta toda a gama de recursos do SharePoint no ReplaceMagic.

O Que a Integração Nativa Permite

Recursos disponíveis somente por meio da integração nativa via API — e não por uma unidade mapeada — incluem:

• Preservação da data de última modificação e do autor após as alterações
• Check-out automático antes do processamento e check-in após a conclusão
• Manutenção do histórico de versões (as alterações aparecem como novas versões, não como substituições)
• Preservação do status de aprovação de conteúdo
• Processamento de páginas Wiki e páginas Canvas (modernas)
• Tratamento correto da limitação de requisições do SharePoint (HTTP 429)
• Acesso ao Início Rápido e às barras de Navegação Superior do SharePoint para substituição de URL

Plataformas Suportadas

A camada de integração nativa no ReplaceMagic suporta as seguintes plataformas Microsoft, todas as quais utilizam a API do SharePoint como backend de armazenamento de documentos:

• SharePoint Online — SharePoint hospedado na nuvem do Microsoft 365
• SharePoint Local — versões 2010, 2013, 2016, 2019 e Subscription Edition
• Microsoft Teams — Os arquivos de canais do Teams são armazenados em bibliotecas de documentos do SharePoint; o ReplaceMagic os processa por meio da mesma API do SharePoint
• OneDrive for Business — O OneDrive for Business é alimentado pelo SharePoint; os arquivos armazenados lá são acessíveis por meio da mesma integração nativa

Visão Geral dos Modos de Autenticação

O ReplaceMagic suporta seis modos de autenticação para cobrir todos os cenários de implantação do SharePoint:

• Online (usuário/senha) — Credenciais padrão do Microsoft 365 para SharePoint Online
• Autenticação do Windows — Credenciais de domínio para SharePoint local
• Anônimo — Para sites publicamente acessíveis onde nenhuma credencial é necessária
• MFA com Senha de Aplicativo — Para contas Microsoft 365 protegidas por autenticação multifator
• Autenticação Somente por Aplicativo — Credenciais de aplicativo do Azure AD para fluxos de trabalho automatizados e não supervisionados
• Modo de Autenticação Legada — Para ambientes locais onde protocolos de autenticação modernos estão desabilitados

Tipos de Conteúdo Processados via Integração Nativa

Por meio da API nativa do SharePoint, o ReplaceMagic pode processar:

• Bibliotecas de documentos padrão (todos os tipos de arquivo do Office, PDF e outros)
• Itens de lista do SharePoint (quando a opção Processar Itens de Lista está habilitada)
• Páginas de Wiki Corporativo e páginas Canvas (páginas modernas)
• Páginas ASPX no SharePoint (quando o modo Todas as Bibliotecas do SharePoint está habilitado)
• URLs do Início Rápido e da barra de Navegação Superior

Desempenho e Configuração

A integração nativa suporta processamento paralelo configurável. Para o SharePoint Online, recomenda-se 3–5 threads para permanecer dentro dos limites de throttling da Microsoft. Para ambientes locais, contagens de threads mais altas são possíveis. A detecção integrada de throttling pausa e tenta novamente automaticamente quando uma resposta 429 é recebida, garantindo que o processamento continue sem intervenção manual.

Vantagens em Relação a Ferramentas Concorrentes

A integração nativa do ReplaceMagic com o SharePoint não requer que o Microsoft Office esteja instalado na máquina de processamento. Não utiliza Automação do Office (COM interop), o que significa que pode ser executado em um servidor sem interface gráfica ou como uma tarefa agendada sem qualquer GUI. Um modo de linha de comando está disponível para integração em pipelines de migração e fluxos de trabalho com scripts, tornando o ReplaceMagic adequado para implantações em escala empresarial onde a operação manual não é prática.