Limiti di lunghezza del percorso e del nome file in SharePoint: correggili prima di migrare
By Mirko Peters · · Updated
Il limite di lunghezza dell'URL in SharePoint è di 400 caratteri per il percorso decodificato del file. Trova i percorsi lunghi e i nomi non validi prima di migrare, seguendo questa checklist.
Automatically translated with AI from the original post. Read the English original
Il limite di lunghezza dell'URL in SharePoint è di 400 caratteri per il percorso decodificato del file, nome del file incluso. Tutto ciò che supera il limite non viene caricato, copiato o sincronizzato, e gli utenti vedono un errore al posto del file. Questa checklist è pensata per i responsabili di una migrazione verso SharePoint che vogliono individuare i percorsi lunghi e i nomi non validi nell'origine prima della prima copia, perché rinominare dopo la migrazione è più lento e più rischioso. Scoprirai cosa documenta Microsoft, cosa lascia poco chiaro e come correggere, in ordine, i percorsi più lunghi.
Punti chiave
- Microsoft documenta un limite di 400 caratteri per l'intero percorso decodificato del file, nome del file incluso, in OneDrive e SharePoint.
- Windows aggiunge i propri limiti: le app desktop di Office non possono aprire file il cui percorso completo supera i 260 caratteri, anche se il cloud accetta il file.
- I caratteri non validi includono le virgolette doppie, l'asterisco, i due punti, le parentesi angolari, il punto interrogativo, le barre e la barra verticale, e non sono ammessi spazi iniziali o finali.
- Le fonti non concordano sul conteggio tra forme codificate e decodificate e sul punto di partenza, quindi conta a partire da /sites e mantieni un margine di sicurezza nei controlli.
- Misura i percorsi nell'origine, correggi prima i più lunghi accorciando i nomi delle cartelle e rinomina i file prima di copiarli, non dopo.
Limite di lunghezza dell'URL in SharePoint: cosa documenta Microsoft
Microsoft indica il limite di 400 caratteri per SharePoint Online in due punti. La descrizione del servizio SharePoint limits afferma che l'intero percorso decodificato del file, nome del file incluso, non può contenere più di 400 caratteri per OneDrive e SharePoint in Microsoft 365. L'articolo di supporto What are the file path length limits? riporta lo stesso numero e aggiunge dettagli. Nessuna delle due pagine descrive un'impostazione che aumenti il limite, quindi pianifica tenendo conto di questo vincolo.
I punti chiave di questo articolo:
- Ogni cartella della gerarchia e il nome del file con la sua estensione contano. Ogni carattere conta, inclusi separatori, spazi ed estensione.
- Office per il web usa gli stessi 400 caratteri.
- I caratteri speciali, gli spazi e i caratteri accentati sono codificati in URL in SharePoint. Uno spazio diventa
%20.
Il punto sulla codifica è dove le pagine non concordano. L'articolo di supporto afferma che le forme codificate contano ai fini del limite, ma la sua regola principale fa riferimento al percorso decodificato. La descrizione del servizio menziona solo il percorso decodificato. La sezione successiva mostra cos'altro va in direzioni diverse.
Come SharePoint conta i caratteri
Tre fonti rispondono alla domanda sul conteggio, e non coincidono del tutto.
- Decodificato o codificato? Una risposta accettata su Microsoft Q&A, scritta da personale esterno Microsoft, sostiene che la lunghezza del percorso si calcola sul percorso decodificato e rimanda all'articolo sulle restrizioni. L'annuncio del 2017 diceva lo stesso: Redmondmag riporta una citazione di Bill Baer di Microsoft: "There is no limit to encoded URLs in SharePoint Online and OneDrive for Business." La nota dell'articolo di supporto secondo cui anche
%20viene conteggiato è l'eccezione. - Da dove inizia il conteggio? Un'altra risposta su Microsoft Q&A, scritta da personale esterno Microsoft, indica di iniziare dal segmento
/sitese di ignorare i parametri della stringa di query. Per un collegamento come/sites/SiteName/Shared Documents/Forms/AllItems.aspx?FolderCTID=..., conta solo la parte prima del punto interrogativo. Secondo questa risposta contano il nome del sito e il nome della libreria. L'esempio dello stesso articolo di supporto, però, inizia dalla radice della libreria: considera quindi la risposta di Q&A come indicazione di supporto, non come documentazione. - E il nome del server? La formula riportata da Redmondmag nel 2017 è: protocollo più nome del server più percorso della cartella o del file più nome della cartella o del file più parametri. Differisce dalla risposta di supporto, ed è un motivo in più per non fare un conteggio al limite.
Da questo deriva una regola prudente. Conta a partire da /sites, includi il nome del sito, il nome della libreria, ogni cartella e il nome del file, e mantieni un margine di qualche decina di caratteri finché non hai testato un caso limite reale nel tuo tenant.
Microsoft ha aumentato il limite del percorso?
Una volta sola, secondo Redmondmag. Nel maggio 2017 l'articolo riportava che Microsoft aveva portato la lunghezza massima del percorso URL per SharePoint Online e OneDrive for Business da 256 a 400 unità di codice Unicode. Da allora il valore è rimasto 400 nelle pagine Microsoft citate sopra. Se una guida più vecchia o uno strumento di migrazione indica ancora 256 o 260, descrive il vecchio limite o il limite di Windows, non l'attuale limite del cloud.
Le colonne di collegamento ipertestuale hanno un proprio limite di 255 caratteri
Un secondo limite viene spesso confuso con quello del percorso. In una discussione su Microsoft Q&A, una risposta del supporto Microsoft afferma che la colonna Collegamento ipertestuale in un elenco o in una libreria di SharePoint ha un limite di 255 caratteri, e che si tratta di una scelta progettuale. Una struttura di cartelle profonda può facilmente produrre un collegamento più lungo, perché il collegamento a un file ripete il nome di ogni cartella.
La soluzione alternativa proposta è una colonna Testo su più righe con testo arricchito avanzato, in cui il collegamento viene aggiunto con l'opzione di collegamento ipertestuale dell'editor. Chi commenta la discussione segnala due svantaggi: il collegamento potrebbe non aggiornarsi quando il file di destinazione viene rinominato o spostato, e l'opzione di testo arricchito avanzato non è disponibile nelle librerie documenti. Nomi di cartella più brevi eliminano il problema alla radice.
I limiti che creano problemi in Windows
Un percorso può essere valido in SharePoint e poi non funzionare sul desktop. Lo stesso articolo di supporto elenca i limiti lato Windows:
- Le app desktop di Office non possono aprire file il cui percorso completo supera i 260 caratteri, anche quando il file è memorizzato in locale.
- Esplora file usa il limite di 260 caratteri per aprire, rinominare e spostare i file. Non usa il criterio dei percorsi lunghi di Windows.
- La sincronizzazione di OneDrive consente un percorso locale complessivo di 520 caratteri: un percorso locale fino a 400 caratteri più una cartella radice di OneDrive fino a 120 caratteri.
- I nomi di singoli file o cartelle possono arrivare a 255 caratteri in Esplora file e nel Finder di macOS.
Il percorso locale include la cartella che contiene la libreria sincronizzata, ed è più lungo di quanto la maggior parte delle persone si aspetti. Quindi un percorso di 250 caratteri nel cloud può diventare di 310 caratteri sul portatile di un utente. Considera 260 come limite operativo per qualsiasi contenuto che le persone aprono dalle cartelle sincronizzate.
Nomi che SharePoint rifiuta
La lunghezza è solo metà della checklist. L'articolo Microsoft Restrizioni e limitazioni in OneDrive e SharePoint elenca che cosa controllare:
- Caratteri non validi: virgolette doppie, asterisco, due punti, minore di, maggiore di, punto interrogativo, barra, barra rovesciata e barra verticale (pipe).
- Spazi: non sono consentiti spazi iniziali e finali.
- Nomi riservati: .lock, CON, PRN, AUX, NUL, COM0-COM9, LPT0-LPT9, _vti_ e desktop.ini.
- Prefissi e frammenti: non è consentito un nome file che inizi con
~$, e_vti_non può comparire in nessun punto del nome. Il nomeformsnon è consentito nella radice di una libreria. - Simbolo di numero e simbolo di percentuale: alcune organizzazioni non li supportano ancora nei nomi. Gli amministratori globali e gli amministratori di SharePoint possono abilitarli.
Queste restrizioni si applicano sia ai file sia alle cartelle. Una cartella con uno spazio finale blocca tutto ciò che si trova al suo interno, quindi un solo nome di cartella non valido può causare migliaia di elementi non riusciti.
Checklist pre-migrazione
Segui questo ordine per ogni condivisione o sito prima di copiare.
- Misura la lunghezza dei percorsi sull'origine. Esporta un elenco dei percorsi completi e calcola la lunghezza di ciascuno. Per una condivisione file,
Get-ChildItem -Recursein PowerShell restituisce il nome completo di ogni elemento, e uno script breve può contare i caratteri. - Calcola il percorso di destinazione. Rimuovi la parte del percorso di origine che non esiste nella libreria, quindi aggiungi il nuovo prefisso relativo alla libreria. Conta a partire da
/sites, perché il nome del sito e quello della libreria di documenti fanno parte del totale. - Segnala tutto ciò che supera 300. Il limite di 400 è quello reale e non superabile. Una soglia di segnalazione a 300 lascia spazio per la cartella di sincronizzazione e per le rinomine successive.
- Elenca i caratteri non validi e i nomi riservati. Cerca i caratteri sopra indicati, gli spazi iniziali e finali e i file con nomi come
~$. - Correggi in base all'impatto. Accorcia per prima cosa il nome della cartella che si trova più in alto in un albero profondo. Un nome di cartella più corto riduce la lunghezza di tutti i percorsi sottostanti.
- Misura di nuovo. Ripeti lo stesso conteggio. Solo a quel punto pianifica la copia.
Anche le scansioni di migrazione di Microsoft aiutano. Migration Manager analizza ogni file alla ricerca di potenziali problemi noti, e lo strumento di migrazione di SharePoint offre un'opzione che esegue solo la scansione, così puoi individuare i problemi prima di spostare qualsiasi cosa. Usale come secondo controllo, non come unico controllo.
Esempio: un percorso lungo, due limiti
Questo esempio usa nomi e numeri inventati. Un file si trova su una condivisione file con un percorso di 247 caratteri sotto la radice della condivisione, per esempio 2019/Customer Contracts and Offers/Northwind Rollout Phase 2/Technical Specification and Requirements/Approved Versions/Final Signed Copies/, seguito da un nome file di 107 caratteri. La destinazione è una libreria chiamata Projects; per semplificare i conti, l'esempio ignora il nome del sito. La libreria aggiunge 9 caratteri per Projects/, quindi il totale è 256.
- Limite del cloud: 256 è sotto 400, quindi SharePoint accetta il file.
- Limite di Windows: un percorso sincronizzato tipico inizia con una cartella locale di 62 caratteri, come
C:\Users\anna.example\OneDrive - Contoso\Projects - Team Site\. Il totale locale è 62 + 247 = 309, cioè oltre 260. Le app desktop di Office non possono aprire il file dalla cartella di sincronizzazione.
La soluzione è accorciare i nomi, non aumentare i limiti. Il responsabile della migrazione rinomina le cartelle in Contracts, Northwind Phase 2, Tech Spec, Approved e Signed, e il file in Northwind Phase 2 - Tech Spec v3 signed.docx. Il percorso sotto la radice scende da 247 a 103 caratteri. Il totale locale scende da 309 a 165, ben al di sotto di 260 e con margine per un nome utente più lungo.
Verifica l'aspetto di business prima di rinominare. Contratti e specifiche tecniche spesso seguono regole di denominazione precise, e i nomi dei file potrebbero dover restare invariati per motivi legali. In quel caso, accorcia le cartelle e mantieni i nomi dei file.
Opzioni quando un percorso è troppo lungo
Hai quattro possibilità, in quest'ordine di preferenza:
- Accorcia i nomi delle cartelle. È il modo meno costoso per accorciare l'URL e giova a ogni file sottostante.
- Semplifica la struttura. Rimuovi i livelli che ripetono solo informazioni, come
FinaldentroApproved. La guida di Microsoft sulle condivisioni file suggerisce anche di suddividere i grandi volumi in librerie più piccole e più mirate. - Usa i metadati al posto delle cartelle. Una colonna come Anno o Cliente nella libreria sostituisce due livelli di cartelle.
- Lascia indietro il file. Se nessuno lo apre da anni, archivialo altrove.
Non affidarti a un workaround, come spostare il file di un livello più in alto dopo la migrazione. Se la causa non viene risolta, anche la prossima ristrutturazione fallirà.
Concorda le regole con i proprietari dei contenuti prima di rinominare qualsiasi cosa. Una breve convenzione di denominazione, ad esempio non più di 40 caratteri per nome di cartella e non più di 8 livelli di cartelle, offre un obiettivo concreto e impedisce che i nuovi contenuti tornino a superare il limite dopo la migrazione. Ripetila nell'annuncio della migrazione, così le persone sapranno perché i nomi di cartella a cui erano abituate sono cambiati.
Errori comuni
- Contare dal punto sbagliato. Il percorso nell'origine non è il percorso nella libreria. Calcola il percorso di destinazione.
- Dimenticare la cartella di sincronizzazione locale. Un percorso che funziona nel browser può non funzionare nelle app desktop di Office.
- Ignorare le regole di conteggio. Le fonti non concordano su codifica e punto di partenza, quindi lascia un margine di sicurezza. Una richiesta di migrazione che fallisce per un singolo elemento troppo lungo può nascondere la causa reale tra molti errori simili.
- Correggere i nomi dopo la copia. Le rinominazioni nel cloud si sincronizzano su tutti i client, e rinominare dopo lo spostamento significa ripetere un lavoro che avresti potuto fare già sull'origine.
- Fidarsi di un unico controllo. Esegui una misurazione autonoma e la scansione di migrazione.
Come può aiutare il software
PowerShell e un foglio di calcolo bastano per iniziare: elenca tutti i percorsi con la rispettiva lunghezza, ordinali per lunghezza e raggruppali per cartella di primo livello. Le scansioni di migrazione di Microsoft offrono una seconda prospettiva. Alcuni strumenti di terze parti forniscono anche report su percorsi e nomi. Valuta ogni strumento in base a due aspetti: se conta dal punto di partenza corretto e se mostra i file e le cartelle che bloccano la copia.
Prossimo passo
Esporta questa settimana i percorsi di una condivisione e ordinali per lunghezza. Poi annota quanti file superano i 300 caratteri, perché questo numero determina l'impegno necessario per la pulizia dei limiti di lunghezza dell'URL di SharePoint.