Como Usar o SmartMapper — Gerar Padrões de Reparo de Links Automaticamente

O reparo de links tradicional exige que você forneça as strings de busca e substituição. O SmartMapper inverte esse fluxo de trabalho: você define regras simples de mapeamento Origem → Destino e o SmartMapper determina automaticamente cada padrão de busca/substituição — resolvendo links relativos, DocIDs do SharePoint baseados em ID, caminhos do PowerQuery e strings de conexão — e reporta a precisão e a cobertura como duas cifras separadas antes de um único documento ser tocado.

O Fluxo de Trabalho do SmartMapper em Resumo

Etapa 1 Faça a Varredura dos Seus Documentos

Antes de o SmartMapper poder gerar padrões, ele precisa de um banco de dados de links populado. Use a função padrão Varrer Documentos para percorrer o armazenamento de origem — uma pasta local ou de rede, uma unidade mapeada ou uma biblioteca do SharePoint conectada nativamente.

• Para fontes de servidor de arquivos ou compartilhamento de rede, aponte o ReplaceMagic para a pasta raiz e execute uma varredura completa. Todos os hiperlinks, links OLE, fontes de link, comandos PowerQuery e strings de conexão descobertos são gravados no banco de dados.
• Para fontes SharePoint (incluindo projetos tenant-a-tenant), conecte-se via integração nativa do SharePoint. É fundamental varrer o tenant de origem enquanto ainda está ativo — o SmartMapper resolve links baseados em ID contra o índice de documentos, e esses IDs deixam de ser resolvíveis no momento em que a origem fica offline.
• Selecione todas as áreas de documentos relevantes nas configurações de varredura: Hiperlinks, Links OLE, Fontes de Link, Power Queries, Conexões, VBA. Qualquer área não varrida será invisível para o SmartMapper.

Consulte Como fazer varredura de documentos e o guia de suporte nativo do SharePoint para instruções completas de varredura.

Etapa 2 Escolha um Banco de Dados de Backend

O SmartMapper armazena todos os links varridos, regras de mapeamento, padrões gerados e resultados de validação em um banco de dados relacional. Três backends são suportados — esquema idêntico, resultados idênticos:

Configure o backend em Configuração → aba SmartMapper → Backend de banco de dados. Você pode alternar backends entre execuções; o esquema é idêntico, portanto a migração de dados é simples.

Etapa 3 Defina Regras de Mapeamento Origem-Destino

As regras de mapeamento são a única entrada que o SmartMapper precisa de você. Cada regra é um único par Origem → Destino:

Dicas para escrever regras de mapeamento eficazes:

• Mapeie no nível mais alto útil — mapeie \\Server\Finance em vez de cada subpasta individual. O SmartMapper consolida padrões de subpastas automaticamente.
• Liste regras do mais específico para o menos específico.
• Para migrações tenant-a-tenant, adicione uma regra para a URL base do tenant antigo e uma para a URL do resolvedor de ID interno do tenant antigo. O SmartMapper resolverá cada link baseado em ID para um caminho absoluto usando o índice de documentos de origem antes da desativação do tenant de origem.
• As regras podem ser inseridas manualmente na grade do SmartMapper ou importadas de um arquivo CSV (separado por barra vertical | por padrão).

Etapa 4 Execute a Geração de Padrões do SmartMapper

Clique em Gerar Padrões na aba SmartMapper. Para cada link no banco de dados, o SmartMapper:

1. Detecta o tipo de link — Absoluto, Relativo, SharePointDocID, OneDriveID, PowerQuery, ConnectionString, OneNote, SharePoint-especial.
2. Resolve cada link para um caminho absoluto — qualquer que seja a forma: relativo, baseado em ID ou embutido em comandos do PowerQuery (File.Contents, Folder.Files, Web.Contents) ou cadeias de conexão (Provider=, DSN=, Data Source=, OPENROWSET).
3. Aplica a sua regra de mapeamento para produzir o novo caminho de destino (NovoLink).
4. Gera padrões no menor escopo suficiente — assim, uma regra ampla \\Server\Finance não produz milhares de padrões redundantes de subpastas.
5. Deduplica e otimiza automaticamente — padrões idênticos de links diferentes são consolidados em uma única entrada.
6. Sinaliza conflitos onde a mesma StringBusca mapeia para dois StringsSubstituição diferentes. Estes são marcados como Conflito e devem ser resolvidos por um humano antes de poderem ser aplicados.

Etapa 5 Revise os Padrões Gerados

A grade de padrões mostra cada combinação de busca/substituição gerada automaticamente com seu status e métricas de validação. Revise cada padrão antes de qualquer documento ser tocado:

Etapa 6 Aplique os Padrões Aceitos aos Documentos

Assim que estiver satisfeito com os padrões revisados, execute o mecanismo de substituição. Apenas padrões com status Aceito ou Modificado são aplicados — padrões Gerados, Rejeitados e Conflitos não resolvidos são ignorados.

• Os documentos são processados em paralelo (contagem de threads configurável) sem serem abertos pelo Word, Excel ou qualquer outro aplicativo.
• Se o modo de Visualização estiver habilitado, o ReplaceMagic reporta cada alteração que faria, mas não grava nada em disco — use isso para verificar o resultado antes de confirmar.
• Habilite o backup automático para salvar uma cópia de cada documento antes de ser modificado.
• Para destinos SharePoint, habilite Manter data de última modificação e valores de Modificado por (requer direitos de Administrador de Site) para preservar metadados após as alterações.

Consulte Como corrigir links quebrados para configurações detalhadas do mecanismo de substituição.

Etapa 7 Verifique e Exporte os Resultados

Após a conclusão da execução de substituição:

1. Execute nova varredura no mesmo armazenamento para confirmar que todos os links anteriormente quebrados estão agora resolvidos. O novo resultado de varredura pode ser comparado com a linha de base para mostrar exatamente quais links mudaram de status.
2. Verifique a aba Informações Adicionais para documentos que foram ignorados (limite de tamanho, timeout, limitação de taxa do SharePoint). Reprocesse arquivos ignorados clicando em Importar Arquivos Ignorados.
3. Exporte os resultados para CSV, Excel ou banco de dados do SmartMapper. A exportação contém o link original, o novo link, o padrão aplicado, o caminho do documento e o timestamp da alteração — uma trilha de auditoria completa para conformidade ou relatórios a stakeholders.
4. Exporte o relatório no nível de execução da aba SmartMapper para fornecer um documento de aprovação mostrando total de links varridos, padrões aplicados, contagens de Corretos / Incorretos e a precisão e a cobertura como duas cifras separadas.

Consulte Como exportar resultados para opções de formato de exportação.

Caso Especial: Links DocID do SharePoint e Migrações Tenant-a-Tenant

Links baseados em ID do SharePoint (DocID, OrganizationalViewLink, DirectLink) são o tipo de link mais difícil de reparar com ferramentas convencionais porque o ID só é significativo dentro do tenant original. Uma vez desativado o tenant de origem, esses IDs desaparecem permanentemente.

O SmartMapper resolve isso varrendo enquanto a origem ainda está ativa:

1. Conecte-se ao tenant SharePoint de origem e execute uma varredura completa enquanto ele ainda estiver ativo.
2. Defina sua regra de mapeamento tenant-a-tenant (URL base do tenant antigo → URL base do novo tenant).
3. Execute a geração de padrões.
4. O padrão gerado substitui a URL antiga baseada em ID pela nova URL absoluta — um reparo que funciona mesmo após o tenant de origem estar offline.

Para o guia completo de migração tenant-a-tenant consulte Migração Tenant-a-Tenant do SharePoint Online: Corrigindo Links Quebrados.

Trabalhando com PowerQuery, Strings de Conexão e Links OLE

Muitos grandes ambientes Excel contêm links que não são expostos como hiperlinks padrão — eles estão enterrados dentro de código M do PowerQuery, strings de conexão OLEDB ou definições de cache de Pivot. O SmartMapper extrai esses automaticamente:

• PowerQuery: O SmartMapper trata os caminhos dentro dos comandos M do PowerQuery, incluindo File.Contents, Folder.Files, Web.Contents e SharePoint.Files. Quando uma migração move arquivos locais para o SharePoint, alterar o caminho não basta — a própria consulta precisa funcionar com o armazenamento na nuvem, e o SmartMapper cuida disso também.
• Strings de Conexão: caminhos dentro de instruções Provider=, DSN=, Data Source=, OPENROWSET, OPENDATASOURCE e BULK INSERT são extraídos, resolvidos e mapeados usando o mesmo pipeline que os links regulares.
• Links OLE e Fontes de Link: pastas de trabalho Excel que vinculam a fontes de dados externas (outra pasta de trabalho, um arquivo de banco de dados) têm seus caminhos de referência externos atualizados via área de Fontes de Link.

Certifique-se de que as áreas Power Queries, Conexões e Fontes de Link estejam selecionadas nas configurações de varredura para incluí-las no banco de dados do SmartMapper.

Dicas e Melhores Práticas

• Use SQLite para prototipagem. Execute sua primeira passagem do SmartMapper com um backend SQLite — sem configuração de servidor, início instantâneo. Verifique a qualidade dos padrões antes de se comprometer com uma implantação completa do SQL Server para um projeto de equipe grande.
• Use RunIDs para migrações em várias ondas. Cada execução do SmartMapper é delimitada por um RunID. Atribua um RunID diferente por onda de migração para que os resultados de ondas diferentes coexistam no mesmo banco de dados sem contaminar uns aos outros.
• Resolva conflitos antes da entrada em produção. Padrões de Conflito não resolvidos são excluídos da execução de substituição. Revise a lista de grupos de conflito após cada passagem de geração e resolva ou rejeite cada um explicitamente.
• Direcione a regra de mapeamento mais específica primeiro. Se \\Server\Finance\Archive deve mapear de forma diferente de \\Server\Finance, adicione a regra Archive acima da regra Finance na grade de mapeamento.
• Visualize antes de aplicar. Sempre execute no modo de Visualização em um subconjunto representativo de documentos para validar o resultado dos padrões antes de executar em toda a biblioteca de documentos.
• Para o serviço de Preparação de Substituições: se o seu projeto for muito grande ou complexo para executar o SmartMapper internamente, a equipe do ReplaceMagic pode preparar todas as regras de mapeamento e padrões em seu nome. Consulte o Pacote de Preparação de Substituições.

Próximos Passos

Guias relacionados

• ReplaceMagic.SmartMapper — página do produto
• Migração Tenant-a-Tenant do SharePoint Online: Corrigindo Links Quebrados
• Migrando SharePoint On-Premises para SharePoint Online: Tratando Links Quebrados
• Como fazer varredura de documentos
• Como corrigir links quebrados
• Guia de suporte nativo do SharePoint
• Pacote de Preparação de Substituições