ReplaceMagic e SharePoint On-Premises — Reparo em Massa de Links Quebrados

SharePoint on-premises refere-se às versões do Microsoft SharePoint que as organizações hospedam em seus próprios servidores, em vez de na nuvem da Microsoft. O ReplaceMagic suporta todas as versões on-premises com manutenção ativa: SharePoint 2010, 2013, 2016, 2019 e Subscription Edition. Seja consolidando farms, renomeando servidores ou preparando uma migração para o SharePoint Online, o ReplaceMagic oferece as ferramentas para localizar e reparar links quebrados em todas as bibliotecas de documentos sem abrir um único arquivo manualmente.

Como o ReplaceMagic se Conecta ao SharePoint On-Premises

O ReplaceMagic se conecta ao SharePoint on-premises por meio do SharePoint Client-Side Object Model (CSOM) e da API REST, utilizando um dos seguintes métodos de autenticação:

• Autenticação Windows (credenciais de domínio) — O método mais comum. O ReplaceMagic passa seu nome de usuário e senha do domínio Windows para o SharePoint, que os valida no Active Directory. Nenhuma configuração adicional é necessária no lado do SharePoint.
• Acesso anônimo — Para ambientes SharePoint onde o acesso anônimo de leitura está habilitado. Raramente utilizado para processamento de documentos, mas suportado.
• Modo de Autenticação Legado — Para ambientes onde a autenticação moderna está desativada ou onde o servidor SharePoint requer autenticação baseada em formulários ou autenticação básica. Habilite esta opção na guia Configuração → SharePoint do ReplaceMagic quando a Autenticação Windows padrão falhar.

Vantagens de Desempenho em Relação ao SharePoint Online

Ao contrário do SharePoint Online, o SharePoint on-premises não impõe limitação de API (rate limiting HTTP 429). Isso significa que o ReplaceMagic pode processar documentos em uma taxa mais elevada e sustentada. É possível aumentar com segurança o número de threads de processamento paralelo além do intervalo de 3–5 recomendado para o SharePoint Online — valores de 8 a 15 threads são normalmente bem tolerados por servidores on-premises, dependendo do hardware do servidor e da largura de banda da rede. Maior paralelismo se traduz diretamente em conclusão mais rápida de projetos para bibliotecas grandes.

O Que o ReplaceMagic Preserva

A preservação de metadados é tão importante on-premises quanto na nuvem. Após modificar um documento, o ReplaceMagic restaura as seguintes propriedades do SharePoint:

• Data da última modificação e autor da modificação
• Status de aprovação de conteúdo (Aprovado, Rejeitado, Pendente)
• Histórico de versões — cada arquivo processado é registrado como uma nova versão menor ou maior
• Estado de check-in e check-out — documentos bloqueados podem ter o check-in forçado se a opção Forçar Check-in estiver habilitada na configuração

Cenários Comuns de Migração On-Premises

• SharePoint on-prem → SharePoint Online: As URLs mudam do formato intranet (http://intranet/sites/team) para o formato de nuvem (https://empresa.sharepoint.com/sites/team). O ReplaceMagic pode processar a biblioteca on-prem de origem, aplicar a transformação de URL e fazer upload dos arquivos corrigidos para o site SharePoint Online de destino.
• Migração entre farms: Ao migrar de um farm on-premises para outro — seja por atualização de hardware, consolidação ou recuperação de desastres — todas as URLs incorporadas que referenciam o farm antigo devem ser atualizadas para apontar para a URL do novo farm.
• Renomeação de servidor: Se a URL de uma aplicação web do SharePoint mudar porque o servidor subjacente ou o nome do host do balanceador de carga for alterado, cada documento que contiver esse nome de host em um hyperlink ou referência OLE terá um link quebrado. O ReplaceMagic resolve isso com uma única regra de buscar e substituir aplicada em todas as bibliotecas afetadas.

Modo de Autenticação Legado

Alguns ambientes SharePoint on-premises — particularmente farms mais antigos do SharePoint 2010 e 2013 — estão configurados para usar autenticação baseada em formulários ou têm protocolos de autenticação modernos desativados. Nesses casos, as conexões padrão de Autenticação Windows do ReplaceMagic podem ser rejeitadas pelo servidor. Habilitar o Modo de Autenticação Legado do SharePoint no painel de Configuração do ReplaceMagic alterna o handshake de autenticação para um modo compatível. Esta configuração não tem efeito no SharePoint Online; aplica-se exclusivamente a conexões on-premises.

Requisitos de Rede

O ReplaceMagic deve ser instalado em uma máquina Windows que tenha acesso direto à rede ao servidor SharePoint on-premises. A máquina que executa o ReplaceMagic deve ser capaz de alcançar as URLs da aplicação web do SharePoint via HTTP ou HTTPS. Conectividade VPN, regras de firewall e resolução DNS para os hostnames do SharePoint devem estar todos configurados antes de iniciar. Nenhum componente precisa ser instalado no servidor SharePoint.