Ліміти довжини шляху та імені файлу в SharePoint: виправте їх до міграції
By Mirko Peters · · Updated
Ліміт довжини URL в SharePoint становить 400 символів для декодованого шляху до файлу. Знайдіть довгі шляхи та недопустимі імена перед міграцією за цим контрольним списком.
Automatically translated with AI from the original post. Read the English original
Ліміт довжини URL в SharePoint становить 400 символів для декодованого шляху до файлу, включно з назвою файлу. Довший шлях не завантажиться, не скопіюється й не синхронізується, і користувачі побачать помилку замість файлу. Цей контрольний список призначено для керівників міграції SharePoint, які хочуть знайти довгі шляхи та недопустимі імена у джерелі до першого копіювання, адже перейменування після міграції повільніше й ризикованіше. Ви дізнаєтеся, що документує Microsoft, що лишається неоднозначним, і в якому порядку виправляти найдовші шляхи.
Головне
- Microsoft документує ліміт 400 символів для всього декодованого шляху до файлу, включно з назвою файлу, в OneDrive і SharePoint.
- Windows додає власні обмеження: настільні застосунки Office не можуть відкрити файли, повний шлях яких перевищує 260 символів, навіть якщо хмара приймає файл.
- Недопустимі символи включають подвійні лапки, зірочку, двокрапку, кутові дужки, знак питання, риски та вертикальну риску, а пробіли на початку або в кінці назви не допускаються.
- Джерела розходяться щодо того, як рахувати закодовані та декодовані шляхи, і щодо точки відліку, тож рахуйте від /sites і залишайте запас безпеки під час перевірок.
- Вимірюйте шляхи у джерелі, спочатку виправляйте найдовші, скорочуючи назви папок, і перейменовуйте файли before копіювання, а не після.
Ліміт довжини URL в SharePoint: що документує Microsoft
Microsoft називає ліміт 400 символів для SharePoint Online у двох місцях. В описі служби SharePoint limits сказано, що весь декодований шлях до файлу, включно з назвою файлу, не може містити більше 400 символів для OneDrive і SharePoint у Microsoft 365. У статті довідки What are the file path length limits? наведено те саме число з додатковими деталями. Жодна з цих сторінок не описує налаштування, яке підвищує ліміт, тож плануйте з огляду на нього.
Ключові моменти з цієї статті:
- Враховується кожна папка в ієрархії та назва файлу з розширенням. Рахується кожен символ, включно з роздільниками, пробілами та розширенням.
- Office для вебу використовує ті самі 400 символів.
- Спеціальні символи, пробіли та символи з діакритикою в SharePoint кодуються для URL. Пробіл перетворюється на
%20.
Саме тут сторінки розходяться. У статті довідки сказано, що закодовані форми враховуються в лімітові, проте її основне правило посилається на декодований шлях. Опис служби згадує лише декодований шлях. Наступний розділ показує, що ще суперечить одне одному.
Як SharePoint рахує символи
Три джерела відповідають на питання про підрахунок, але повністю не збігаються.
- Декодований чи закодований? Прийнята відповідь на Microsoft Q&A від зовнішнього персоналу Microsoft стверджує, що довжина шляху обчислюється за декодованим шляхом, і посилається на статтю про обмеження. Оголошення 2017 року говорило те саме: Redmondmag цитує Білла Баєра з Microsoft: «There is no limit to encoded URLs in SharePoint Online and OneDrive for Business.» Примітка в статті довідки про те, що
%20враховується, є винятком. - Звідки починається відлік? Ще одна відповідь на Microsoft Q&A від зовнішнього персоналу Microsoft радить починати з сегмента
/sitesі ігнорувати параметри рядка запиту. Для посилання на кшталт/sites/SiteName/Shared Documents/Forms/AllItems.aspx?FolderCTID=...враховується лише частина до знака питання. За цією відповіддю до довжини входять назва сайту та назва бібліотеки. Власний приклад статті довідки починається з кореня бібліотеки, тож сприймайте відповідь із Q&A як підтримувальну пораду, а не як документацію. - А як щодо імені сервера? Формула, яку Redmondmag наводив у 2017 році, виглядає так: протокол плюс ім'я сервера плюс шлях до папки або файлу плюс ім'я папки або файлу плюс параметри. Вона відрізняється від відповіді підтримки, і це ще одна причина не розраховувати на жорсткий підрахунок.
З цього випливає безпечне правило. Відлічуйте від /sites, враховуйте назву сайту, назву бібліотеки, кожну папку та назву файлу і залишайте запас у кілька десятків символів, доки не перевірите реальний граничний випадок у своєму клієнті.
Чи збільшила Microsoft ліміт довжини шляху?
Так, один раз, за даними Redmondmag. У травні 2017 року стаття повідомляла, що Microsoft збільшила максимальну довжину URL-шляху для SharePoint Online і OneDrive for Business зі 256 до 400 одиниць коду Unicode. Відтоді в цитованих вище сторінках Microsoft це число лишається 400. Якщо старіший посібник або інструмент міграції досі називає 256 чи 260, він описує старе обмеження або обмеження Windows, а не чинне хмарне.
Для стовпців гіперпосилань діє окреме обмеження у 255 символів
Друге обмеження часто плутають із обмеженням шляху. В одній темі Microsoft Q&A відповідь служби підтримки Microsoft стверджує, що стовпець «Гіперпосилання» в списку або бібліотеці SharePoint має ліміт 255 символів і що це задумане обмеження. Глибока структура папок легко створює посилання, довше за цей ліміт, оскільки посилання на файл повторює назву кожної папки.
Запропонований обхідний шлях — стовпець «Багаторядковий текст» із розширеним форматуванням, у який посилання додається через опцію гіперпосилання в редакторі. Коментатори в темі називають два недоліки: посилання може не оновлюватися, якщо цільовий файл перейменували або перемістили, а опція розширеного форматування недоступна в бібліотеках документів. Коротші назви папок усувають проблему в корені.
Обмеження, які даються взнаки у Windows
Шлях може бути нормальним у SharePoint і все одно зламатися на комп'ютері. Та сама стаття довідки перелічує обмеження з боку Windows:
- Настільні застосунки Office не можуть відкрити файли, повний шлях яких перевищує 260 символів, навіть якщо файл збережено локально.
- Провідник файлів використовує ліміт у 260 символів для відкриття, перейменування та переміщення файлів. Він не враховує політику довгих шляхів Windows.
- Синхронізація OneDrive дозволяє загальний локальний шлях у 520 символів: локальний шлях до 400 символів плюс коренева папка OneDrive до 120 символів.
- Окремі імена файлів або папок можуть містити до 255 символів у Провіднику файлів і у macOS Finder.
Локальний шлях включає папку, де розміщено синхронізовану бібліотеку, і він довший, ніж більшість людей очікує. Тож шлях у 250 символів у хмарі може мати 310 символів на ноутбуці користувача. Сприймайте 260 як робочий ліміт для будь-якого вмісту, який люди відкривають із синхронізованих папок.
Імена, які SharePoint відхиляє
Довжина — це лише половина контрольного списку. Стаття Microsoft Restrictions and limitations in OneDrive and SharePoint перелічує, на що звернути увагу:
- Недопустимі символи: подвійні лапки, зірочка, двокрапка, менше ніж, більше ніж, знак питання, пряма коса риска, обернена коса риска та вертикальна риска.
- Пробіли: пробіли на початку та в кінці назви не дозволяються.
- Зарезервовані назви: .lock, CON, PRN, AUX, NUL, COM0–COM9, LPT0–LPT9, _vti_ та desktop.ini.
- Префікси та фрагменти: назва файлу, що починається з
~$, не дозволяється, а_vti_не може траплятися в будь-якому місці назви. Назваformsне дозволяється в корені бібліотеки. - Знак номера та знак відсотка: деякі організації ще не підтримують їх у назвах. Глобальні адміністратори та адміністратори SharePoint можуть їх увімкнути.
Ці обмеження стосуються і файлів, і папок. Папка з пробілом в кінці блокує все, що міститься нижче, тож одна неправильна назва папки може спричинити тисячі помилкових елементів.
Контрольний список перед міграцією
Дотримуйтеся цього порядку для кожного спільного ресурсу або сайту перед копіюванням.
- Виміряйте довжину шляху у джерелі. Експортуйте список повних шляхів і обчисліть довжину кожного. Для файлового ресурсу
Get-ChildItem -Recurseу PowerShell повертає повне ім'я кожного елемента, а короткий скрипт може підрахувати символи. - Обчисліть цільовий шлях. Видаліть частину вихідного шляху, якої немає в бібліотеці, а потім додайте новий префікс відносно бібліотеки. Відлік ведіть від
/sites, адже назва сайту та назва бібліотеки документів входять до загальної довжини. - Позначте все, що перевищує 300. Ліміт 400 є жорстким. Позначка на рівні 300 залишає запас для папки синхронізації та подальших перейменувань.
- Складіть перелік недопустимих символів і зарезервованих назв. Шукайте зазначені вище символи, пробіли на початку та в кінці, а також назви на зразок файлів
~$. - Виправляйте за рівнем впливу. Спочатку скоротіть назву папки, яка розташована найвище в довгому дереві. Одна коротша назва папки скорочує шлях до всього, що лежить нижче.
- Виміряйте повторно. Виконайте той самий підрахунок ще раз. Тільки після цього плануйте копіювання.
Допомагають і сканування міграції від Microsoft. Migration Manager перевіряє кожен файл на відомі потенційні проблеми, а SharePoint Migration Tool пропонує опцію лише сканування, щоб ви побачили проблеми до переміщення будь-чого. Використовуйте їх як другу перевірку, а не як єдину.
Приклад: один довгий шлях, два ліміти
У цьому прикладі використано вигадані назви та числа. Файл розташований на файловому ресурсі за шляхом довжиною 247 символів від кореня ресурсу, наприклад 2019/Customer Contracts and Offers/Northwind Rollout Phase 2/Technical Specification and Requirements/Approved Versions/Final Signed Copies/, а назва файлу має 107 символів. Ціль — бібліотека з назвою Projects. Щоб спростити розрахунки, приклад не враховує назву сайту: бібліотека додає 9 символів для Projects/, і загальна довжина становить 256.
- Ліміт хмари: 256 менше за 400, тож SharePoint приймає файл.
- Ліміт Windows: типовий синхронізований шлях починається з локальної папки довжиною 62 символи, наприклад
C:\Users\anna.example\OneDrive - Contoso\Projects - Team Site\. Локальна загальна довжина становить 62 + 247 = 309, що більше за 260. Програми Office для настільних комп'ютерів не можуть відкрити файл із папки синхронізації.
Виправлення полягає в скороченні назв, а не в підвищенні лімітів. Керівник міграції перейменовує папки на Contracts, Northwind Phase 2, Tech Spec, Approved і Signed, а файл — на Northwind Phase 2 - Tech Spec v3 signed.docx. Шлях нижче кореня скорочується з 247 до 103 символів. Локальна загальна довжина зменшується з 309 до 165, що значно менше за 260 і залишає місце для довшого імені користувача.
Перед перейменуванням перевірте бізнес-вимоги. Договори та технічні специфікації часто підпорядковуються правилам іменування, а назви файлів можуть мати залишитися незмінними з юридичних причин. У такому разі скорочуйте папки та зберігайте назви файлів.
Варіанти, коли шлях занадто довгий
Є чотири варіанти, у порядку пріоритету:
- Скоротіть назви папок. Це найдешевший спосіб скоротити URL, і це допомагає для кожного файлу всередині.
- Спростіть структуру. Видаліть рівні, які лише повторюють інформацію, наприклад
FinalвсерединіApproved. Посібник Microsoft із файлових ресурсів також радить розділяти великі диски на менші, більш цільові бібліотеки. - Використовуйте метадані замість папок. Стовпець, наприклад Year або Customer, у бібліотеці замінює два рівні папок.
- Залиште файл у минулому. Якщо його ніхто не відкривав роками, перенесіть його в архів.
Не покладайтеся на обхідний шлях, наприклад на переміщення файлу на один рівень вище після міграції. Доки причину не усунено, наступна реорганізація теж завершиться невдачею.
Узгодьте правила з власниками вмісту, перш ніж щось перейменовувати. Коротка угода про найменування, наприклад не більше 40 символів у назві папки та не більше 8 рівнів папок, дає людям орієнтир і не дозволяє новому вмісту знову перевищити ліміт після переміщення. Повторіть її в оголошенні про міграцію, щоб люди розуміли, чому звичні назви папок змінилися.
Типові помилки
- Відлік від неправильної точки. Шлях у джерелі не є шляхом у бібліотеці. Розрахуйте цільовий шлях.
- Забута локальна папка синхронізації. Шлях, який працює в браузері, може не працювати в настільних застосунках Office.
- Ігнорування правил підрахунку. Джерела розходяться щодо кодування та початкової точки відліку, тому залишайте запас. Запит на міграцію, який завершується помилкою через один довгий елемент, може приховати справжню причину серед багатьох подібних помилок.
- Виправлення назв після копіювання. Перейменування в хмарі синхронізується на всіх клієнтах, а перейменування після переміщення дублює роботу, яку можна було виконати в джерелі.
- Довіра до однієї перевірки. Виконайте власне вимірювання та скан міграції.
Як може допомогти програмне забезпечення
Для початку достатньо PowerShell і електронної таблиці: складіть список усіх шляхів із їх довжиною, відсортуйте за довжиною та згрупуйте за папкою верхнього рівня. Скани міграції від Microsoft дають другий погляд. Деякі сторонні інструменти також пропонують звіти про шляхи та назви. Оцінюйте будь-який інструмент за тим, чи він рахує від правильної точки відліку та чи показує файли й папки, які блокують копіювання.
Наступний крок
Експортуйте шляхи однієї спільної папки цього тижня та відсортуйте їх за довжиною. Потім запишіть, скільки файлів перевищують 300 символів, адже саме ця цифра визначає обсяг роботи з очищення для обмеження довжини URL у SharePoint.