Limites de longueur de chemin et de nom de fichier dans SharePoint : à corriger avant la migration
Par Mirko Peters · · Mis à jour
La limite de longueur d’URL SharePoint est de 400 caractères pour le chemin de fichier décodé. Repérez les chemins trop longs et les noms non valides avant de migrer, grâce à cette liste de contrôle.
Traduit automatiquement par IA à partir de l'article original. Lire l'original en anglais
La limite de longueur d’URL SharePoint est de 400 caractères pour le chemin de fichier décodé, nom de fichier compris. Tout chemin plus long échoue lors du téléversement, de la copie ou de la synchronisation, et les utilisateurs voient un message d’erreur au lieu du fichier. Cette liste de contrôle s’adresse aux responsables d’une migration SharePoint qui souhaitent repérer les chemins longs et les noms non valides à la source, avant la première copie, car renommer après la migration est plus lent et plus risqué. Vous découvrirez ce que Microsoft documente, ce qui reste flou, et comment corriger les chemins les plus longs dans le bon ordre.
Points clés
- Microsoft documente une limite de 400 caractères pour l’ensemble du chemin de fichier décodé, nom de fichier compris, dans OneDrive et SharePoint.
- Windows ajoute ses propres limites : les applications Office de bureau ne peuvent pas ouvrir les fichiers dont le chemin complet dépasse 260 caractères, même si le cloud accepte le fichier.
- Les caractères non valides comprennent le guillemet double, l’astérisque, les deux-points, les chevrons, le point d’interrogation, les barres obliques et la barre verticale, et les espaces en début ou en fin de nom ne sont pas autorisés.
- Les sources divergent sur le comptage des formes encodées ou décodées, ainsi que sur le point de départ. Comptez donc à partir de /sites et conservez une marge de sécurité dans vos contrôles.
- Mesurez les chemins à la source, corrigez d’abord les plus longs en raccourcissant les noms de dossiers, et renommez les fichiers avant la copie, et non après.
Limite de longueur d’URL SharePoint : ce que Microsoft documente
Microsoft mentionne la limite de 400 caractères pour SharePoint Online à deux endroits. La description du service Limites de SharePoint indique que le chemin de fichier complet décodé, nom de fichier compris, ne peut pas dépasser 400 caractères dans OneDrive et SharePoint dans Microsoft 365. L’article d’aide Quelles sont les limites de longueur des chemins de fichiers ? donne le même chiffre et ajoute des précisions. Aucune de ces pages ne décrit de paramètre permettant de relever la limite : planifiez donc en tenant compte de cette contrainte.
Points clés de cet article :
- Chaque dossier de la hiérarchie ainsi que le nom du fichier avec son extension sont comptés. Chaque caractère compte, y compris les séparateurs, les espaces et l’extension.
- Office pour le web applique la même limite de 400 caractères.
- Les caractères spéciaux, les espaces et les caractères accentués sont encodés en URL dans SharePoint. Un espace devient
%20.
C’est sur l’encodage que les pages divergent. L’article d’aide indique que les formes encodées comptent dans la limite, alors que sa règle principale fait référence au chemin décodé. La description du service ne mentionne que le chemin décodé. La section suivante montre ce qui, par ailleurs, va dans des sens différents.
Comment SharePoint compte les caractères
Trois sources répondent à la question du comptage, et elles ne concordent pas totalement.
- Décodé ou encodé ? Une réponse acceptée sur Microsoft Q&A, rédigée par du personnel externe de Microsoft, indique que la longueur du chemin se calcule sur le chemin décodé et renvoie à l’article sur les restrictions. L’annonce de 2017 disait la même chose : Redmondmag cite Bill Baer, de Microsoft : « Il n’existe aucune limite pour les URL encodées dans SharePoint Online et OneDrive Entreprise. » La remarque de l’article d’aide selon laquelle
%20compte fait figure d’exception. - Où commence le décompte ? Une autre réponse de Microsoft Q&A, rédigée par du personnel externe de Microsoft, indique de commencer au segment
/siteset d’ignorer les paramètres de la chaîne de requête. Pour un lien tel que/sites/SiteName/Shared Documents/Forms/AllItems.aspx?FolderCTID=..., seule la partie qui précède le point d’interrogation compte. Selon cette réponse, le nom du site et le nom de la bibliothèque comptent. L’exemple de l’article d’aide commence toutefois à la racine de la bibliothèque : considérez la réponse de Q&A comme une recommandation de support, et non comme de la documentation. - Et le nom du serveur ? La formule rapportée par Redmondmag en 2017 se lit ainsi : protocole, plus nom du serveur, plus chemin du dossier ou du fichier, plus nom du dossier ou du fichier, plus paramètres. Elle diffère de la réponse du support, ce qui est une raison de plus de ne pas compter au plus juste.
Une règle de prudence en découle. Comptez à partir de /sites, incluez le nom du site, le nom de la bibliothèque, chaque dossier et le nom du fichier, et conservez une marge de quelques dizaines de caractères tant que vous n’avez pas testé un cas limite réel dans votre locataire.
Microsoft a-t-il augmenté la limite du chemin d’accès ?
Une seule fois, selon Redmondmag. En mai 2017, l’article indiquait que Microsoft avait porté la longueur maximale du chemin d’URL pour SharePoint Online et OneDrive Entreprise de 256 à 400 unités de code Unicode. Depuis, la valeur reste fixée à 400 dans les pages Microsoft citées ci-dessus. Si un ancien guide ou un outil de migration mentionne encore 256 ou 260, il décrit l’ancienne limite ou celle de Windows, et non la limite actuelle du cloud.
La colonne Hyperlien a sa propre limite de 255 caractères
Une seconde limite est souvent confondue avec celle du chemin. Dans un fil de discussion Microsoft Q&A, une réponse du support Microsoft indique que la colonne Hyperlien d’une liste ou d’une bibliothèque SharePoint est limitée à 255 caractères, et que ce comportement est voulu. Une structure de dossiers profonde peut facilement produire un lien plus long, car le lien vers un fichier répète le nom de chaque dossier.
La solution de contournement proposée consiste à utiliser une colonne Plusieurs lignes de texte avec texte enrichi amélioré, dans laquelle le lien est ajouté avec l’option Lien hypertexte de l’éditeur. Les commentateurs du fil relèvent deux inconvénients : le lien peut ne pas se mettre à jour lorsque le fichier cible est renommé ou déplacé, et l’option de texte enrichi amélioré n’est pas disponible dans les bibliothèques de documents. Des noms de dossiers plus courts évitent le problème à la source.
Les limites qui posent problème sous Windows
Un chemin peut être valide dans SharePoint et poser problème sur un poste de travail. Le même article d’aide détaille le côté Windows :
- Les applications de bureau Office ne peuvent pas ouvrir les fichiers dont le chemin complet dépasse 260 caractères, même lorsqu’ils sont stockés localement.
- L’Explorateur de fichiers applique la limite de 260 caractères pour l’ouverture, le renommage et le déplacement des fichiers. Il n’utilise pas la stratégie de chemins d’accès longs de Windows.
- La synchronisation OneDrive autorise un chemin local total de 520 caractères : un chemin local de 400 caractères au maximum, plus un dossier racine OneDrive de 120 caractères au maximum.
- Les noms de fichiers ou de dossiers individuels peuvent comporter jusqu’à 255 caractères dans l’Explorateur de fichiers et dans le Finder macOS.
Le chemin local inclut le dossier qui contient la bibliothèque synchronisée, ce qui le rallonge plus qu’on ne le pense souvent. Ainsi, un chemin de 250 caractères dans le cloud peut atteindre 310 caractères sur l’ordinateur portable d’un utilisateur. Considérez 260 comme la limite de travail pour tout contenu que les utilisateurs ouvrent depuis des dossiers synchronisés.
Les noms refusés par SharePoint
La longueur ne représente que la moitié de la liste de contrôle. L’article de Microsoft Restrictions et limitations dans OneDrive et SharePoint présente ce qu’il faut vérifier :
- Caractères non valides : guillemet double, astérisque, deux-points, inférieur à, supérieur à, point d’interrogation, barre oblique, barre oblique inverse et barre verticale.
- Espaces : les espaces en début et en fin de nom ne sont pas autorisés.
- Noms réservés : .lock, CON, PRN, AUX, NUL, COM0 à COM9, LPT0 à LPT9, _vti_ et desktop.ini.
- Préfixes et fragments : un nom de fichier qui commence par
~$n’est pas autorisé, et_vti_ne peut figurer nulle part dans un nom. Le nomformsn’est pas autorisé à la racine d’une bibliothèque. - Signe dièse et signe pourcentage : certaines organisations ne les prennent pas encore en charge dans les noms. Les administrateurs généraux et les administrateurs SharePoint peuvent les activer.
Ces restrictions s’appliquent aux fichiers comme aux dossiers. Un dossier dont le nom se termine par une espace bloque tout ce qui se trouve en dessous. Un seul nom de dossier incorrect peut donc entraîner des milliers d’éléments en échec.
Liste de contrôle avant migration
Suivez cet ordre pour chaque partage ou site avant la copie.
- Mesurez la longueur des chemins sur la source. Exportez la liste des chemins complets et calculez la longueur de chacun. Pour un partage de fichiers,
Get-ChildItem -Recursedans PowerShell renvoie le nom complet de chaque élément, et un court script peut compter les caractères. - Calculez le chemin cible. Retirez la partie du chemin source qui n’existe pas dans la bibliothèque, puis ajoutez le nouveau préfixe relatif à la bibliothèque. Comptez à partir de
/sites: le nom du site et celui de la bibliothèque de documents font partie du total. - Signalez tout ce qui dépasse 300. La limite de 400 est la limite stricte. Un signalement à 300 laisse une marge pour le dossier de synchronisation et pour les renommages ultérieurs.
- Recensez les caractères non valides et les noms réservés. Recherchez les caractères mentionnés ci-dessus, les espaces en début et en fin de nom, ainsi que les fichiers dont le nom commence par
~$. - Corrigez par ordre d’impact. Raccourcissez d’abord le nom du dossier situé le plus haut dans une arborescence longue. Un nom de dossier plus court raccourcit tous les chemins qui se trouvent en dessous.
- Mesurez à nouveau. Refaites le même comptage. Ce n’est qu’ensuite que vous planifiez la copie.
Les analyses de migration de Microsoft peuvent aussi vous aider. Migration Manager analyse chaque fichier à la recherche de problèmes potentiels connus, et l’outil de migration SharePoint propose une option qui se contente d’analyser, afin de repérer les problèmes avant de déplacer quoi que ce soit. Utilisez-les comme second contrôle, et non comme unique contrôle.
Exemple : un chemin long, deux limites
Cet exemple utilise des noms et des chiffres fictifs. Un fichier se trouve sur un partage de fichiers, à un chemin de 247 caractères sous la racine du partage, par exemple 2019/Customer Contracts and Offers/Northwind Rollout Phase 2/Technical Specification and Requirements/Approved Versions/Final Signed Copies/, suivi d’un nom de fichier de 107 caractères. La cible est une bibliothèque nommée Projects. Pour simplifier les calculs, l’exemple ne tient pas compte du nom du site : la bibliothèque ajoute 9 caractères pour Projects/, et le total est de 256.
- Limite du cloud : 256 est inférieur à 400, donc SharePoint accepte le fichier.
- Limite de Windows : un chemin synchronisé type commence par un dossier local de 62 caractères, comme
C:\Users\anna.example\OneDrive - Contoso\Projects - Team Site\. Le total local est de 62 + 247 = 309, soit plus de 260. Les applications de bureau Office ne peuvent pas ouvrir le fichier depuis le dossier de synchronisation.
La solution consiste à raccourcir les noms, et non à relever les limites. Le responsable de la migration renomme les dossiers en Contracts, Northwind Phase 2, Tech Spec, Approved et Signed, ainsi que le fichier en Northwind Phase 2 - Tech Spec v3 signed.docx. Le chemin sous la racine passe de 247 à 103 caractères. Le total local passe de 309 à 165, nettement en dessous de 260, ce qui laisse de la place pour un nom d’utilisateur plus long.
Vérifiez les aspects métier avant de renommer. Les contrats et les spécifications techniques suivent souvent des règles de nommage, et les noms de fichiers doivent parfois rester identiques pour des raisons juridiques. Dans ce cas, raccourcissez les dossiers et conservez les noms de fichiers.
Options lorsqu’un chemin est trop long
Vous disposez de quatre choix, classés par ordre de préférence :
- Raccourcir les noms de dossiers. C’est le moyen le moins coûteux de raccourcir l’URL, et il profite à chaque fichier situé en dessous.
- Aplatir la structure. Supprimez les niveaux qui ne font que répéter une information, comme
Finalà l’intérieur deApproved. Le guide de Microsoft sur les partages de fichiers suggère également de scinder les grands lecteurs en bibliothèques plus petites et plus ciblées. - Utilisez les métadonnées au lieu des dossiers. Une colonne telle que Année ou Client dans la bibliothèque remplace deux niveaux de dossiers.
- Laissez le fichier de côté. Si personne ne l’a ouvert depuis des années, archivez-le ailleurs.
Ne vous contentez pas d’un contournement, comme déplacer le fichier d’un niveau vers le haut après la migration. Tant que la cause n’est pas corrigée, la prochaine réorganisation échouera elle aussi.
Convenez des règles avec les propriétaires du contenu avant de renommer quoi que ce soit. Une courte convention de nommage, par exemple au maximum 40 caractères par nom de dossier et au maximum 8 niveaux de dossiers, donne une cible claire et évite que les nouveaux contenus ne dépassent à nouveau la limite après la migration. Reprenez-la dans l’annonce de la migration, afin que les utilisateurs comprennent pourquoi les noms de dossiers qu’ils connaissent ont changé.
Erreurs courantes
- Compter à partir du mauvais point. Le chemin dans la source n’est pas le chemin dans la bibliothèque. Calculez le chemin cible.
- Oublier le dossier de synchronisation local. Un chemin qui fonctionne dans le navigateur peut échouer dans les applications Office de bureau.
- Ignorer les règles de comptage. Les sources ne s’accordent pas sur l’encodage ni sur le point de départ ; prévoyez donc une marge. Une demande de migration qui échoue sur un seul élément trop long peut masquer la cause réelle parmi de nombreuses erreurs similaires.
- Corriger les noms après la copie. Les renommages dans le cloud se synchronisent sur tous les clients, et un renommage après le déplacement répète un travail que vous auriez pu faire sur la source.
- Se fier à une seule vérification. Effectuez votre propre mesure et exécutez l’analyse de migration.
Comment les logiciels peuvent aider
PowerShell et un tableur suffisent pour commencer : listez tous les chemins avec leur longueur, triez-les par longueur et regroupez-les par dossier de premier niveau. Les analyses de migration de Microsoft offrent une seconde vue. Certains outils tiers proposent également des rapports sur les chemins et les noms. Évaluez tout outil en vérifiant s’il compte à partir du bon point de départ et s’il affiche les fichiers et dossiers qui bloquent la copie.
Prochaine étape
Exportez cette semaine les chemins d’un partage et triez-les par longueur. Notez ensuite le nombre de fichiers qui dépassent 300 caractères, car ce chiffre détermine l’effort nécessaire pour votre nettoyage lié à la limite de longueur d’URL SharePoint.