Síntomas
ShareGate Migrate muestra uno de los siguientes mensajes de error:
The specified file or folder name is too long. The URL path for all files and folders must be 260 characters or less (and no more than 128 characters for any single file or folder name in the URL).
The specified item name is too long. The name of the item cannot exceed the limit of 128 characters.
The specified folder name is too long. The name of the folder cannot exceed the limit of 128 characters.
The specified item name is too long. The name of the item cannot exceed the limit of 256 characters.
The specified folder name is too long. The name of the folder cannot exceed the limit of 255 characters.
The specified item name is too long. The server relative path of the item's parent folder cannot exceed the limit of 256 characters.
The specified folder name is too long. The server relative path of the folder's parent folder cannot exceed the limit of 256 characters.
The specified item name is too long. The server relative path of the item's parent folder cannot exceed the limit of 400 characters.
The specified folder name is too long. The server relative path of the folder's parent folder cannot exceed the limit of 400 characters.
The specified item name is too long. The server relative path of the item cannot exceed the limit of 260 characters.
The specified folder name is too long. The server relative path of the folder cannot exceed the limit of 260 characters.
The specified item name is too long. The server relative path of the item cannot exceed the limit of 255 characters.
The specified folder name is too long. The server relative path of the folder cannot exceed the limit of 253 characters.
O uno de los siguientes mensajes de advertencia:
The server relative path of the item exceeds 255 characters. The item will be copied, but you might experience unexpected behavior.
The server relative path of the folder exceeds 255 characters. The folder will be copied, but you might experience unexpected behavior.
Código de error
IN-011-035
IN-013-035
IN-019-035
IN-019-056
IN-026-035
AN-067-035
IN-033-035
IN-072-035
IN-073-035
IN-077-035
IN-791-035
IN-026-000
IN-088-035
IN-098-035
IN-093-035
IN-105-035
AN-066-035
Detalles
SharePoint impone un límite en la cantidad de caracteres que puede tener la ruta de un archivo o carpeta. Los límites son los siguientes:
Ruta validada | Entorno de SharePoint | Longitud máxima |
Nombre del elemento o archivo | On-Premises | 128 |
Nombre del elemento o archivo | Microsoft 365/SharePoint 2019 (Insane Mode) | 400 |
Nombre del elemento o archivo | Microsoft 365/SharePoint 2019 (Normal Mode) | 400 |
Nombre de la carpeta | On-Premises | 128 |
Nombre de la carpeta | Microsoft 365/SharePoint 2019 (Insane Mode) | 400 |
Nombre de la carpeta | Microsoft 365/SharePoint 2019 (Normal Mode) | 400 |
Nombre del Document Set | On-Premises | 128 |
Nombre del Document Set - Content Type no es Folder | Microsoft 365 | 255 |
Título del Discussion Board - Content Type no es Folder | Microsoft 365 | 255 |
Ruta de la carpeta principal | On-Premises | 256 |
Ruta de la carpeta principal | Microsoft 365/SharePoint 2019 (Insane Mode) | 400 |
Ruta de la carpeta principal | Microsoft 365/SharePoint 2019 (Normal Mode) | 400 |
Ruta completa del elemento | On-Premises | 260 |
Ruta completa del elemento | Microsoft 365/SharePoint 2019 (Insane Mode) | 400 |
Ruta completa del elemento | Microsoft 365/SharePoint 2019 (Normal Mode) | 400 |
Ruta completa de la carpeta | Microsoft 365 (Insane Mode), solo al crear | 255 |
Al copiar un archivo, un elemento de lista o una carpeta que superaría este límite, ShareGate Migrate genera un error que indica que la ruta es demasiado larga y que este elemento no se puede crear en el SharePoint de destino.
Por ejemplo, se cargó un archivo en una biblioteca de un entorno de SharePoint con la siguiente URL:
Y se validarían los siguientes valores:
Nombre del archivo: myFile.txt
Nota: Si el elemento cargado hubiera sido una carpeta, se habrían aplicado los límites relacionados con las carpetas.
Ruta de la carpeta principal: sites/mySite/mySubsite/myLibrary/myFolder/myParentFolder
Ruta completa del elemento: sites/mySite/mySubsite/myLibrary/myFolder/myParentFolder/myFile.txt
Posibilidad de comportamiento inesperado
En determinados casos, se mostrará una advertencia que indica la posibilidad de un comportamiento inesperado cuando la longitud de la ruta completa del elemento supere los 255 caracteres en SharePoint on-premises. El elemento se copiará, pero es posible que tengas problemas al abrir el archivo en SharePoint o al intentar eliminar el elemento o la carpeta.
Solución
Si el problema es la longitud de la ruta completa del archivo:
Copia a un nivel inferior en la estructura de carpetas.
Por ejemplo, si estás copiando archivos a MyLibrary/SubFolder1/SubFolder2/... y así sucesivamente (con muchos niveles de subcarpetas), crea una nueva carpeta directamente debajo de MyLibrary y copia tus archivos dentro de ella.
Si el problema es la longitud de los nombres de archivo:
Cambia el nombre de los archivos de origen por nombres más cortos.
Si el error ocurre en un elemento al copiar a un destino de Microsoft 365:
Cambia el nombre de los archivos de origen por nombres más cortos o copia a un nivel inferior en la estructura de carpetas.
Es importante tener en cuenta que la longitud total de una URL equivale a la longitud de la ruta de la carpeta o el archivo, incluyendo el nombre del protocolo, el nombre del servidor, el nombre de la carpeta o el archivo, y cualquier parámetro incluido como parte de la URL.
Así, la URL total = protocolo + nombre del servidor + ruta de la carpeta o el archivo + nombre de la carpeta o el archivo + parámetros.
Para obtener más información, consulta la documentación de Microsoft sobre Naming Files, Paths, and Namespaces.
Si no puedes abrir o eliminar el elemento en el destino y recibiste una advertencia durante la copia que indicaba la posibilidad de un comportamiento inesperado:
Cambia el nombre del elemento o la carpeta por uno más corto para que su ruta completa no supere los 255 caracteres.
Una vez que la ruta no supere esta longitud, deberías poder usar el elemento o la carpeta con normalidad.
Este artículo fue traducido con inteligencia artificial. En caso de duda, consulta la versión original en inglés.