Você está se preparando para mover arquivos para o SharePoint e quer evitar erros de sincronia, links quebrados e problemas de acesso. Muitos nomes de arquivos que funcionam bem em uma unidade local ou compartilhamento de rede contêm caracteres, comprimentos ou padrões que o SharePoint rejeita. Este artigo fornece um checklist prático para limpar nomes de arquivos antes da migração, para que seu conteúdo seja movido sem erros e permaneça acessível.
Principais Conclusões: Limpeza de Nomes de Arquivos Antes da Migração para SharePoint
- Remova caracteres inválidos: O SharePoint bloqueia arquivos com ~ # % & : < > ? / \ { } | nos nomes.
- Encurte caminhos de arquivo: O SharePoint tem um limite de 400 caracteres para o caminho completo da URL, incluindo nomes do site e da biblioteca.
- Substitua espaços e caracteres especiais: Use hífens ou underscores para evitar erros de sincronia e links quebrados.
Por que Nomes de Arquivos Causam Problemas no SharePoint
O SharePoint usa as regras do sistema de arquivos do Windows, além de suas próprias restrições baseadas em URL. Quando você faz upload de um arquivo, o SharePoint cria uma URL a partir do endereço do site, nome da biblioteca, caminho da pasta e nome do arquivo. Se qualquer parte desse caminho contiver caracteres que o SharePoint não consegue codificar corretamente, o upload do arquivo falha ou a sincronia não funciona.
A causa raiz mais comum é a presença de caracteres reservados nos nomes dos arquivos. Caracteres como #, %, & e + têm significado especial em URLs. Quando o SharePoint tenta criar uma URL contendo esses caracteres, ele bloqueia o arquivo ou produz uma URL que quebra quando compartilhada ou sincronizada.
Outro problema frequente é o comprimento do caminho do arquivo. O SharePoint limita o caminho total da URL a 400 caracteres. Isso inclui o nome do site, o nome da biblioteca, todos os nomes de pastas e o nome do arquivo. Uma estrutura de pastas profunda com nomes longos pode facilmente exceder esse limite, causando falhas de upload e erros de sincronia.
Nomes de arquivo que começam ou terminam com ponto ou espaço também causam problemas. O SharePoint remove espaços e pontos finais, o que pode levar a nomes de arquivo duplicados ou renomeações inesperadas.
Checklist para Limpar Nomes de Arquivos Antes da Migração
- Remova caracteres inválidos dos nomes de arquivo
Varra todos os nomes de arquivo em busca destes caracteres bloqueados: ~ # % & : < > ? / \ { } |. Substitua cada um por um hífen ou underscore. Por exemplo, altereQ3%20ReportparaQ3-20-Report. Use um script PowerShell ou uma ferramenta de renomeação de arquivos para automatizar isso em milhares de arquivos. - Encurte caminhos de arquivo para menos de 400 caracteres
Calcule o comprimento total do caminho da URL: URL do site + nome da biblioteca + caminho da pasta + nome do arquivo. Se o total exceder 400 caracteres, encurte os nomes das pastas ou achate a estrutura de pastas. Mova arquivos de pastas aninhadas para uma hierarquia mais rasa. - Substitua espaços por hífens ou underscores
Espaços em nomes de arquivo funcionam no SharePoint, mas causam problemas durante a sincronia com o OneDrive e ao compartilhar links. Substitua espaços por hífens para legibilidade ou underscores para processamento por máquina. Por exemplo, altereMeeting Notes.docxparaMeeting-Notes.docx. - Remova pontos e espaços no início e no final
Nomes de arquivo que começam ou terminam com ponto ou espaço não são permitidos. Renomeie.hidden-fileparahidden-fileereport .docxparareport.docx. - Padronize a capitalização dos nomes de arquivo
O SharePoint não diferencia maiúsculas de minúsculas, mas preserva a capitalização. Para evitar confusão, use uma capitalização consistente. Uma convenção comum é PascalCase para nomes com várias palavras:QuarterlyReport.docxem vez dequarterly_report.docx. - Remova caracteres especiais que quebram a sincronia
Caracteres como@,!,^,~e$são tecnicamente permitidos, mas causam erros de sincronia no OneDrive. Remova-os ou substitua por hífens. - Verifique nomes de arquivo duplicados após renomear
Após renomear arquivos, você pode acabar com dois arquivos que agora têm o mesmo nome. Por exemplo,Q3 ReporteQ3-Reportambos se tornamQ3-Report. Execute uma verificação de duplicatas e renomeie arquivos conflitantes com um identificador único, como data ou número de versão. - Teste um lote de amostra antes da migração completa
Selecione de 50 a 100 arquivos que representem os padrões de nomenclatura mais complexos da sua origem. Faça upload deles em uma biblioteca de teste do SharePoint. Verifique se todos os arquivos são carregados, sincronizados e abertos corretamente. Corrija quaisquer erros antes de migrar o conjunto completo.
O que Acontece se Você Pular a Limpeza dos Nomes de Arquivo
Pular a limpeza dos nomes de arquivo leva a vários problemas que aparecem durante ou após a migração.
Arquivos falham ao fazer upload durante a migração
Ferramentas de migração como SharePoint Migration Tool ou ShareGate relatam erros para arquivos com caracteres inválidos. Cada arquivo com falha requer intervenção manual, retardando toda a migração. Você pode precisar reiniciar a migração após corrigir os nomes.
Erros de sincronia no OneDrive
Arquivos que contêm caracteres como # ou % serão carregados, mas falharão ao sincronizar com o OneDrive. Os usuários veem mensagens de erro como Erro de sincronia: o nome do arquivo contém caracteres inválidos. Eles não conseguem acessar o arquivo offline.
Links quebrados em documentos e e-mails
Quando um nome de arquivo contém um caractere #, o SharePoint o codifica como %23 na URL. Qualquer link que aponte para a URL original com # quebra. Os usuários que clicam no link veem um erro 404.
Problemas de pesquisa e metadados
Nomes de arquivo com caracteres especiais podem não ser indexados corretamente pela pesquisa do SharePoint. Usuários pesquisando por um arquivo que contém & no nome podem não encontrá-lo. A extração de metadados dos nomes de arquivo também falha quando caracteres especiais estão presentes.
Regras de Nomes de Arquivo: Unidade Local vs SharePoint
| Item | Unidade Local (Windows) | SharePoint / OneDrive |
|---|---|---|
| Comprimento máximo do nome do arquivo | 255 caracteres | 255 caracteres (apenas nome do arquivo) |
| Comprimento máximo do caminho da URL | Não aplicável | 400 caracteres (site + biblioteca + caminho + arquivo) |
| Caracteres inválidos | \ / : ? < > | | ~ # % & : < > ? / \ { } | além de pontos e espaços no início/fim |
| Diferenciação maiúsculas/minúsculas | Não diferencia | Não diferencia, mas preserva a capitalização |
| Espaços permitidos | Sim | Sim, mas causam problemas de sincronia e links |
A principal diferença é o limite de 400 caracteres no caminho da URL e os caracteres inválidos adicionais no SharePoint. Um arquivo que funciona perfeitamente em uma unidade local pode falhar no SharePoint devido a essas restrições extras.
Depois de limpar todos os nomes e caminhos de arquivo, execute uma varredura final com uma ferramenta como o SharePoint Migration Assessment Tool. Essa ferramenta verifica problemas de nomenclatura e gera um relatório dos arquivos que precisam de atenção. Aplique o checklist aos seus arquivos de origem antes de iniciar a ferramenta de migração. Seus arquivos serão movidos sem problemas, sincronizarão sem erros e permanecerão acessíveis a todos os usuários.