Configuração do SharePoint no ReplaceMagic — Guia Completo de Configurações

Todas as configurações específicas do SharePoint no ReplaceMagic estão localizadas no painel de Configuração, na aba SharePoint. Você acessa esse painel clicando no botão Configuração na barra de ferramentas principal. Essa aba controla a preservação de metadados, o comportamento de bloqueio de documentos, os limites da plataforma, os modos de processamento de páginas e as opções de codificação. Compreender cada configuração antes de iniciar um grande trabalho de processamento ajudará a evitar resultados inesperados e a proteger a integridade do seu ambiente SharePoint.

Configurações de Metadados e Estado do Documento

• Manter Data de Última Modificação e Modificado Por — Após o ReplaceMagic fazer o upload de um arquivo modificado, ele restaura o carimbo de data/hora original da última modificação e o nome do editor original. Essa configuração requer direitos de Administrador de Site na coleção de sites de destino. Sem esses direitos, o SharePoint registrará a conta de serviço do ReplaceMagic como o último editor e definirá o horário de modificação para o momento atual.
• Check-out / Check-in de Documentos — O ReplaceMagic faz automaticamente o check-out de um documento antes de baixá-lo e o check-in após fazer o upload da versão modificada. Isso garante que outros usuários não possam modificar o arquivo durante o processamento e que o SharePoint registre a alteração como uma nova versão adequada.
• Forçar Check-in — Quando habilitado, o ReplaceMagic forçará o check-in de documentos que estejam com check-out feito por outro usuário. Use esta opção com cautela: ela descarta todas as alterações pendentes que o outro usuário ainda não fez check-in. É mais apropriada em cenários de migração automatizada onde se sabe que a biblioteca está inativa.
• Manter Status de Aprovação de Conteúdo — Se uma biblioteca utiliza aprovação de conteúdo, esta configuração restaura o status original Aprovado, Rejeitado ou Pendente do documento após o processamento. Sem esta opção, um documento aprovado poderá reverter para Pendente após a modificação.
• Manter Status de Publicação — Mantém a visibilidade de versão principal/secundária de cada documento. Um documento que foi publicado como versão principal antes do processamento permanecerá publicado após a conclusão do trabalho do ReplaceMagic.
• Definir Controle de Versões — Controla como o ReplaceMagic interage com o sistema de controle de versões do SharePoint ao fazer o check-in de documentos. Habilite para garantir que cada documento processado seja rastreado adequadamente no histórico de versões.

Configurações de Consulta e Limites

• Verificação de Linhas da Consulta — Define o número máximo de itens recuperados por consulta de lista do SharePoint. O padrão é 4.900 e o máximo é 5.000, o que corresponde ao limite de exibição de listas do SharePoint. Ultrapassar 5.000 itens em uma única consulta faz o SharePoint retornar um erro de limite. O padrão de 4.900 fornece uma margem segura abaixo desse limite. Ajuste somente se houver razões específicas para isso.
• Valor Máximo do ID do Documento — O ID máximo de documento do SharePoint que o ReplaceMagic tentará recuperar ao resolver links baseados em ID. O padrão é 30.000.000, o que corresponde ao máximo interno do SharePoint. Aumente este valor somente se o seu tenant tiver intervalos de ID de documento incomumente altos.

Configurações de Escopo de Biblioteca e Página

• Todas as Bibliotecas do SharePoint — Quando habilitado, o ReplaceMagic acessa bibliotecas do sistema ocultas e conteúdo de páginas ASPX além das bibliotecas de documentos padrão. Este modo é poderoso, mas deve ser usado com cautela, pois expõe arquivos do sistema do SharePoint que normalmente não são visíveis para os usuários finais.
• Processar Itens de Lista — Habilita a substituição de URL em campos de itens de lista do SharePoint (não apenas em arquivos de documentos). Útil quando colunas de lista armazenam hiperlinks ou caminhos de arquivo que precisam ser atualizados.
• Barra de Início Rápido e Barra de Navegação Superior — Quando habilitado, o ReplaceMagic também atualiza as URLs incorporadas no painel de navegação Início Rápido do site SharePoint e na barra de Navegação Superior. Isso é especialmente útil após uma migração de tenant para tenant, onde os links de navegação apontam para a URL do tenant antigo.

Configurações de Codificação e Legado

• Decodificação/Codificação HTML de Páginas SharePoint — Para páginas de Wiki Corporativo que armazenam conteúdo codificado em HTML, esta opção decodifica o conteúdo antes do processamento e o recodifica após. Necessário para determinados formatos legados de página Wiki onde caracteres especiais são armazenados como entidades HTML.
• Decodificação/Codificação Unicode de Páginas SharePoint — Aplica normalização Unicode ao ler e gravar conteúdo de páginas SharePoint. Habilite quando o conteúdo da página contiver sequências de escape Unicode que devem ser preservadas corretamente.
• Modo de Autenticação Legada do SharePoint — Alterna o handshake de autenticação para um modo legado compatível com autenticação baseada em formulários ou autenticação básica em farms SharePoint locais mais antigos. Não tem efeito no SharePoint Online.
• Verificação Nativa de Links Quebrados do SharePoint — Realiza uma verificação de links quebrados in-situ usando a API do SharePoint em vez de baixar os arquivos. Este método é significativamente mais lento que a verificação padrão baseada em arquivos do ReplaceMagic e não é recomendado para bibliotecas grandes. Use somente quando a verificação baseada em arquivos não for adequada para um cenário específico.
• Processar Todos os Documentos Ignorados — Força o ReplaceMagic a reprocessar documentos que foram ignorados em uma execução anterior devido a códigos de erro específicos. Use após resolver o problema subjacente (por exemplo, após conceder permissões adicionais) para processar documentos que não foram tratados na passagem inicial.

Configurações Recomendadas por Cenário

• Migração para o SharePoint Online: Habilitar Manter Data de Última Modificação e Modificado Por, Check-out/Check-in, Manter Status de Aprovação de Conteúdo, Manter Status de Publicação. Definir threads paralelas entre 3–5.
• Local para SharePoint Online: Igual ao anterior; adicionalmente habilitar Barra de Início Rápido e Barra de Navegação Superior se os links de navegação precisarem de atualização.
• Migração de tenant para tenant: Habilitar todas as opções de preservação de metadados; habilitar Processar Itens de Lista e Início Rápido/Barra de Navegação Superior; confirmar que o ID Máximo do Documento está definido alto o suficiente para cobrir todos os links baseados em ID no tenant de origem.