Limitações Conhecidas do SharePoint ao Usar o ReplaceMagic

O ReplaceMagic foi projetado para lidar com toda a complexidade do processamento de documentos no SharePoint, mas como qualquer ferramenta que opera em uma plataforma desenvolvida por outro fornecedor, está sujeito a certas restrições. As limitações documentadas nesta página são impostas pelo próprio SharePoint, pelo sistema operacional Windows ou pelas especificações de formato de arquivo do Office. Compreender esses limites antes de iniciar um grande projeto de migração ajudará a planejar com eficácia e a evitar surpresas.

Grupo 1: Limitações de Arquivo e Caminho

• Caracteres especiais em nomes de arquivos — Arquivos cujos nomes contêm qualquer um dos seguintes caracteres não podem ter seus tokens de link compartilhado ou links organizacionais recuperados via API do SharePoint: ~ # % & * { } \ : <> ? / + | ". Esses arquivos ainda são baixados, processados em busca de links quebrados em seu conteúdo e enviados novamente — mas URLs no estilo de link compartilhado que referenciam o arquivo por token não podem ser reparadas. Esta é uma limitação da API REST do SharePoint, não do ReplaceMagic.
• Limite de comprimento do caminho do Windows (260 caracteres) — Quando o ReplaceMagic baixa arquivos do SharePoint para um caminho local temporário de processamento, o comprimento combinado do caminho da pasta temporária e do nome do arquivo não deve exceder 260 caracteres. Uma solução alternativa está disponível nas configurações de Processamento do ReplaceMagic: habilite o suporte a caminhos longos ou encurte o caminho da pasta temporária para um diretório de nível raiz, como C:\Temp.
• Comprimento do caminho de origem de link do Excel — O Excel impõe comprimentos máximos de caminho em fontes de links externos. Em formatos mais antigos do Excel (.xls), o comprimento máximo do caminho para uma fonte de link é de 253 caracteres. Em formatos mais novos (.xlsx, .xlsm), o limite é de 2.000 caracteres. Se uma substituição produzir uma URL ou caminho de arquivo que exceda esses limites, o ReplaceMagic ignora o link específico e o registra no relatório de resultados. O documento em si ainda é processado; apenas o link excedente é ignorado.

Grupo 2: Limitações da Plataforma SharePoint

• Limite de exibição de lista do SharePoint (5.000 itens) — Tanto o SharePoint Online quanto o local impõem um máximo de 5.000 itens por consulta de lista. O ReplaceMagic usa um limite padrão de 4.900 linhas de consulta para permanecer com segurança abaixo desse limite. Se você reduzir este valor na aba Configuração do SharePoint, as consultas serão menores e mais seguras, mas também levarão mais tempo para enumerar bibliotecas grandes.
• ID máximo de documento (30.000.000) — Ao resolver links do SharePoint baseados em ID, o ReplaceMagic itera pelos IDs de documento até o máximo configurado. O padrão de 30.000.000 corresponde ao limite prático superior do SharePoint. Se o seu tenant tiver documentos com IDs acima desse valor (incomum, mas possível em tenants muito grandes e de longa duração), aumente a configuração de ID Máximo do Documento na configuração.
• Throttling do SharePoint (HTTP 429 / 503) — O SharePoint Online impõe limitação de taxa nas requisições à API. O ReplaceMagic detecta respostas de throttling e tenta novamente automaticamente, mas o processamento sustentado com alto paralelismo ainda encontrará atrasos de throttling. O número recomendado de threads para o SharePoint Online é de 3–5. Usar mais threads não aumenta proporcionalmente o throughput no SharePoint Online porque o throttling compensa cada vez mais os ganhos.
• Requisito de autenticação moderna — Os administradores de tenant podem desabilitar protocolos de autenticação legados no Microsoft 365, o que significa que os métodos de login por usuário/senha e senha de aplicativo podem não funcionar. Nesse caso, use a Autenticação Somente por Aplicativo com um registro de aplicativo no Azure AD. A Autenticação Somente por Aplicativo não está sujeita a restrições de autenticação legada.

Grupo 3: Metadados e Controle de Versões

• Preservar a data de última modificação e o autor requer direitos de Administrador de Site — O ReplaceMagic utiliza uma chamada privilegiada à API do SharePoint para restaurar o editor original e o carimbo de data/hora da modificação. Essa chamada está disponível apenas para contas com direitos de Administrador de Site (Administrador de Coleção de Sites). Permissões de Colaborador ou Membro não são suficientes. Se a conta de processamento tiver apenas direitos de colaborador, o campo Modificado por exibirá a conta de processamento e a data de modificação será definida como o momento do processamento.
• O backup de documentos não está disponível no modo nativo do SharePoint — O recurso integrado de backup de arquivos do ReplaceMagic (que copia os originais para uma pasta de backup antes da modificação) não funciona ao processar documentos nativamente pela API do SharePoint. Use o histórico de versões integrado do SharePoint como sua rede de segurança. Certifique-se de que o controle de versões esteja habilitado na biblioteca de destino antes de executar um trabalho de processamento.
• A preservação da aprovação de conteúdo requer direitos apropriados — Restaurar o status de aprovação de conteúdo de um documento após o processamento requer que a conta de processamento tenha permissão para aprovar e rejeitar itens na biblioteca. Sem direitos de aprovação, o ReplaceMagic concluirá a modificação do conteúdo, mas não conseguirá restaurar o status de aprovação.

Grupo 4: Conectividade

• Acesso de rede local necessário — Para o SharePoint local, o ReplaceMagic deve ser instalado em uma máquina que consiga alcançar o servidor SharePoint pela rede. A máquina deve ser capaz de resolver o nome do host do servidor SharePoint via DNS e conectar-se a ele na porta HTTP ou HTTPS apropriada. Nenhum componente é instalado no próprio servidor SharePoint, mas a visibilidade de rede é obrigatória.
• Proxies corporativos e firewalls — Se a sua organização roteia o tráfego HTTPS de saída por um proxy corporativo ou firewall, as conexões do ReplaceMagic com o SharePoint Online podem ser bloqueadas ou exigir autenticação de proxy. Configure as configurações de proxy no painel de configurações de Processamento do ReplaceMagic. Se a inspeção SSL estiver habilitada no proxy, os certificados do SharePoint Online podem parecer inválidos — coordene com a equipe de rede para adicionar as exceções necessárias.

Essas limitações estão documentadas para ajudá-lo a planejar seu projeto de migração com precisão. Se encontrar um cenário específico não descrito aqui, entre em contato conosco em support@replacemagic.com e teremos prazer em orientá-lo.