Limity długości ścieżki i nazw plików w SharePoint: napraw je przed migracją
By Mirko Peters · · Updated
Limit długości adresu URL w SharePoint wynosi 400 znaków dla zdekodowanej ścieżki pliku. Znajdź długie ścieżki i nieprawidłowe nazwy przed migracją, korzystając z tej listy kontrolnej.
Automatically translated with AI from the original post. Read the English original
Limit długości adresu URL w SharePoint wynosi 400 znaków dla zdekodowanej ścieżki pliku, wliczając nazwę pliku. Dłuższe ścieżki nie zostaną przesłane, skopiowane ani zsynchronizowane, a użytkownik zobaczy błąd zamiast pliku. Ta lista kontrolna jest przeznaczona dla kierowników migracji do SharePoint, którzy chcą znaleźć długie ścieżki i nieprawidłowe nazwy w źródle, zanim wykonają pierwsze kopiowanie. Zmiana nazw po migracji jest wolniejsza i bardziej ryzykowna. Dowiesz się, co dokumentuje Microsoft, czego nie precyzuje, i jak po kolei naprawiać najdłuższe ścieżki.
Najważniejsze wnioski
- Microsoft podaje limit 400 znaków dla całej zdekodowanej ścieżki pliku, wliczając nazwę pliku, w usługach OneDrive i SharePoint.
- Windows dodaje własne limity: aplikacje biurowe na komputer nie mogą otworzyć plików, których pełna ścieżka przekracza 260 znaków, nawet jeśli chmura zaakceptuje plik.
- Do nieprawidłowych znaków należą cudzysłów, gwiazdka, dwukropek, nawiasy ostre, znak zapytania, ukośniki i kreska pionowa. Nie są dozwolone spacje na początku ani na końcu nazwy.
- Źródła nie zgadzają się co do liczenia znaków zakodowanych i zdekodowanych oraz co do punktu początkowego, dlatego licz od /sites i zachowuj margines bezpieczeństwa w kontrolach.
- Mierz ścieżki w źródle, najpierw skracaj najdłuższe, skracając nazwy folderów, i zmieniaj nazwy plików przed kopiowaniem, a nie po nim.
Limit długości adresu URL w SharePoint: co dokumentuje Microsoft
Microsoft podaje limit 400 znaków dla SharePoint Online w dwóch miejscach. Opis usługi SharePoint limits mówi, że cała zdekodowana ścieżka pliku, wliczając nazwę pliku, nie może zawierać więcej niż 400 znaków w usługach OneDrive i SharePoint w Microsoft 365. Artykuł pomocy What are the file path length limits? podaje tę samą liczbę i dodaje szczegóły. Żadna ze stron nie opisuje ustawienia, które podnosi limit, dlatego planuj w oparciu o ten limit.
Najważniejsze punkty z tego artykułu:
- Liczy się każdy folder w hierarchii oraz nazwa pliku wraz z rozszerzeniem. Wlicza się każdy znak, w tym separatory, spacje i rozszerzenie.
- Office dla sieci stosuje ten sam limit 400 znaków.
- Znaki specjalne, spacje i znaki diakrytyczne są kodowane w adresach URL w SharePoint. Spacja staje się
%20.
Właśnie w kwestii kodowania strony są niezgodne. Artykuł pomocy mówi, że zakodowane postacie wliczają się do limitu, ale jego główna zasada odnosi się do ścieżki zdekodowanej. Opis usługi wspomina wyłącznie o ścieżce zdekodowanej. Kolejna sekcja pokazuje, co jeszcze prowadzi do różnych wniosków.
Jak SharePoint liczy znaki
Na pytanie o sposób liczenia odpowiadają trzy źródła, które nie pasują do siebie w pełni.
- Zdekodowana czy zakodowana? Zaakceptowana odpowiedź w serwisie Microsoft Q&A, napisana przez zewnętrznych pracowników Microsoft, mówi, że długość ścieżki liczy się na podstawie ścieżki zdekodowanej, i odsyła do artykułu o ograniczeniach. Zapowiedź z 2017 roku mówiła to samo: Redmondmag cytuje Billa Baera z Microsoftu: „There is no limit to encoded URLs in SharePoint Online and OneDrive for Business.”. Uwaga z artykułu pomocy, że
%20się liczy, jest tu wyjątkiem. - Od czego zaczyna się liczenie? Inna odpowiedź w Microsoft Q&A, udzielona przez zewnętrznego pracownika Microsoft, mówi, że liczenie zaczyna się od segmentu
/sites, a parametry ciągu zapytania należy pominąć. Dla linku w rodzaju/sites/SiteName/Shared Documents/Forms/AllItems.aspx?FolderCTID=...liczy się tylko część przed znakiem zapytania. Według tej odpowiedzi wlicza się nazwa witryny i nazwa biblioteki. Przykład z samego artykułu pomocy zaczyna się jednak od katalogu głównego biblioteki, więc odpowiedź z Q&A traktuj jako wskazówkę pomocniczą, a nie jako dokumentację. - A nazwa serwera? Wzór, o którym Redmondmag pisał w 2017 roku, brzmi: protokół plus nazwa serwera plus ścieżka folderu lub pliku plus nazwa folderu lub pliku plus parametry. Różni się to od odpowiedzi wsparcia, i to kolejny powód, by nie liczyć na styk.
Z tego wynika bezpieczna zasada. Licz od /sites, uwzględnij nazwę witryny, nazwę biblioteki, każdy folder i nazwę pliku, i zostaw margines kilkudziesięciu znaków, dopóki nie przetestujesz rzeczywistego przypadku brzegowego w swojej dzierżawie.
Czy Microsoft zwiększył limit ścieżki?
Raz, według Redmondmag. W maju 2017 roku artykuł informował, że Microsoft zwiększył maksymalną długość ścieżki URL dla usług SharePoint Online i OneDrive dla firm z 256 do 400 jednostek kodowych Unicode. Od tamtej pory wartość pozostaje na poziomie 400 na stronach Microsoft, do których odwołano się powyżej. Jeśli starszy przewodnik lub narzędzie do migracji nadal podaje 256 lub 260, opisuje dawny limit albo limit systemu Windows, a nie obecny limit chmury.
Kolumny hiperłączy mają własny limit 255 znaków
Drugi limit jest często mylony z limitem ścieżki. W wątku w Microsoft Q&A odpowiedź pracownika pomocy technicznej Microsoft mówi, że kolumna Hiperłącze na liście lub w bibliotece SharePoint ma limit 255 znaków i jest to zamierzone działanie. Głęboka struktura folderów może łatwo wygenerować dłuższy link, ponieważ link do pliku powtarza nazwę każdego folderu.
Sugerowane obejście to kolumna Wiele wierszy tekstu z rozszerzonym tekstem sformatowanym, w której link dodaje się opcją hiperłącza edytora. Komentujący w wątku wskazują dwie wady: link może nie zostać zaktualizowany po zmianie nazwy lub przeniesieniu pliku docelowego, a opcja rozszerzonego tekstu sformatowanego nie jest dostępna w bibliotekach dokumentów. Krótsze nazwy folderów rozwiązują problem u źródła.
Limity, które gryzą w systemie Windows
Ścieżka może być poprawna w SharePoint i mimo to przestać działać na komputerze. Ten sam artykuł pomocy wymienia ograniczenia po stronie Windows:
- Aplikacje pakietu Office na komputery nie mogą otworzyć plików, których pełna ścieżka przekracza 260 znaków, nawet jeśli plik jest zapisany lokalnie.
- Eksplorator plików stosuje limit 260 znaków przy otwieraniu, zmianie nazwy i przenoszeniu plików. Nie korzysta z zasad długich ścieżek systemu Windows.
- Synchronizacja OneDrive dopuszcza łączną lokalną ścieżkę o długości 520 znaków: lokalną ścieżkę o długości do 400 znaków plus katalog główny OneDrive o długości do 120 znaków.
- Pojedyncze nazwy plików lub folderów mogą mieć do 255 znaków w Eksploratorze plików i w Finderze w systemie macOS.
Lokalna ścieżka obejmuje folder, w którym znajduje się zsynchronizowana biblioteka, a jest on dłuższy, niż większość ludzi się spodziewa. Ścieżka o długości 250 znaków w chmurze może więc mieć 310 znaków na laptopie użytkownika. Dla każdej treści, którą ludzie otwierają z folderów zsynchronizowanych, przyjmij 260 jako roboczy limit.
Nazwy, które SharePoint odrzuca
Długość to tylko połowa listy kontrolnej. Artykuł Microsoft Ograniczenia i limity w usługach OneDrive i SharePoint wymienia, na co zwrócić uwagę:
- Niedozwolone znaki: cudzysłów, gwiazdka, dwukropek, mniejsze niż, większe niż, znak zapytania, ukośnik, ukośnik odwrotny i kreska pionowa.
- Spacje: spacje na początku i na końcu nazwy są niedozwolone.
- Zastrzeżone nazwy: .lock, CON, PRN, AUX, NUL, COM0–COM9, LPT0–LPT9, _vti_ oraz desktop.ini.
- Prefiksy i fragmenty: nazwa pliku zaczynająca się od
~$jest niedozwolona, a_vti_nie może pojawić się w żadnym miejscu nazwy. Nazwaformsjest niedozwolona w katalogu głównym biblioteki. - Znak numeru i znak procentu: niektóre organizacje nie obsługują ich jeszcze w nazwach. Globalni administratorzy i administratorzy SharePoint mogą je włączyć.
Te ograniczenia dotyczą zarówno plików, jak i folderów. Folder kończący się spacją blokuje wszystko, co znajduje się poniżej, więc jedna błędna nazwa folderu może spowodować tysiące niepowodzeń.
Lista kontrolna przed migracją
Stosuj tę kolejność dla każdego udziału lub witryny przed rozpoczęciem kopiowania.
- Zmierz długość ścieżek w źródle. Wyeksportuj listę pełnych ścieżek i oblicz długość każdej z nich. W przypadku udziału plikowego polecenie
Get-ChildItem -Recursew PowerShell zwraca pełną nazwę każdego elementu, a krótki skrypt może policzyć znaki. - Oblicz ścieżkę docelową. Usuń z ścieżki źródłowej część, która nie istnieje w bibliotece, a następnie dodaj nowy prefiks względny wobec biblioteki. Licz od
/sites, ponieważ nazwa witryny i nazwa biblioteki dokumentów wchodzą w łączną długość. - Oznacz wszystko, co przekracza 300 znaków. Limit 400 znaków jest limitem twardym. Próg 300 pozostawia zapas na folder synchronizacji i późniejsze zmiany nazw.
- Wypisz niedozwolone znaki i zastrzeżone nazwy. Wyszukaj wyżej wymienione znaki, spacje na początku i na końcu nazw oraz nazwy takie jak pliki
~$. - Napraw w kolejności według wpływu. Najpierw skróć nazwę folderu znajdującego się najwyżej w długim drzewie. Jedna krótsza nazwa folderu skraca każdą ścieżkę poniżej niego.
- Zmierz ponownie. Wykonaj ten sam pomiar jeszcze raz. Dopiero wtedy zaplanuj kopiowanie.
Pomocne są także skanowania migracyjne firmy Microsoft. Migration Manager skanuje każdy plik pod kątem znanych potencjalnych problemów, a narzędzie SharePoint Migration Tool oferuje opcję wyłącznie skanowania, dzięki czemu można zobaczyć problemy przed przeniesieniem czegokolwiek. Traktuj je jako drugą kontrolę, a nie jedyną.
Przykład: jedna długa ścieżka, dwa limity
Ten przykład wykorzystuje wymyślone nazwy i liczby. Plik znajduje się na udziale plikowym pod ścieżką o długości 247 znaków poniżej katalogu głównego udziału, na przykład 2019/Customer Contracts and Offers/Northwind Rollout Phase 2/Technical Specification and Requirements/Approved Versions/Final Signed Copies/, a jego nazwa ma 107 znaków. Miejscem docelowym jest biblioteka o nazwie Projects. Aby uprościć obliczenia, przykład pomija nazwę witryny: biblioteka dodaje 9 znaków za Projects/, a łączna długość wynosi 256.
- Limit chmury: 256 jest poniżej 400, więc SharePoint akceptuje plik.
- Limit systemu Windows: typowa zsynchronizowana ścieżka zaczyna się od lokalnego folderu o długości 62 znaków, na przykład
C:\Users\anna.example\OneDrive - Contoso\Projects - Team Site\. Łączna długość lokalna to 62 + 247 = 309, czyli więcej niż 260. Aplikacje biurowe na komputerze nie mogą otworzyć pliku z folderu synchronizacji.
Rozwiązaniem jest skrócenie nazw, a nie podnoszenie limitów. Kierownik migracji zmienia nazwy folderów na Contracts, Northwind Phase 2, Tech Spec, Approved i Signed, a plik na Northwind Phase 2 - Tech Spec v3 signed.docx. Ścieżka poniżej katalogu głównego spada z 247 do 103 znaków. Łączna długość lokalna spada z 309 do 165, czyli wyraźnie poniżej 260, i pozostawia zapas na dłuższą nazwę użytkownika.
Przed zmianą nazw sprawdź wymagania biznesowe. Umowy i specyfikacje techniczne często podlegają regułom nazewnictwa, a nazwy plików mogą musieć pozostać niezmienione ze względów prawnych. W takim przypadku skracaj foldery i zachowaj nazwy plików.
Opcje, gdy ścieżka jest zbyt długa
Masz cztery możliwości, w kolejności od najbardziej preferowanej:
- Skróć nazwy folderów. To najtańszy sposób skrócenia adresu URL, a dotyczy każdego pliku znajdującego się poniżej.
- Spłaszcz strukturę. Usuń poziomy, które jedynie powtarzają informacje, na przykład
FinalwewnątrzApproved. Przewodnik firmy Microsoft dotyczący udziałów plikowych sugeruje także dzielenie dużych dysków na mniejsze, bardziej tematyczne biblioteki. - Użyj metadanych zamiast folderów. Kolumna, na przykład Rok lub Klient, w bibliotece zastępuje dwa poziomy folderów.
- Zostaw plik tam, gdzie jest. Jeśli nikt go od lat nie otwierał, zarchiwizuj go w innym miejscu.
Nie polegaj na obejściu, na przykład przeniesieniu pliku o jeden poziom wyżej po migracji. Dopóki przyczyna nie zostanie usunięta, następna reorganizacja też się nie powiedzie.
Uzgodnij zasady z właścicielami treści, zanim cokolwiek zmienisz. Krótka konwencja nazewnictwa, na przykład nie więcej niż 40 znaków w nazwie folderu i nie więcej niż 8 poziomów folderów, daje ludziom konkretny cel i zapobiega ponownemu przekraczaniu limitów przez nowe treści po migracji. Powtórz ją w komunikacie o migracji, aby ludzie wiedzieli, dlaczego znane im nazwy folderów się zmieniły.
Częste błędy
- Liczenie od niewłaściwego punktu. Ścieżka w źródle nie jest ścieżką w bibliotece. Oblicz ścieżkę docelową.
- Zapomnienie o lokalnym folderze synchronizacji. Ścieżka, która działa w przeglądarce, może zawieść w aplikacjach pakietu Office na komputerze.
- Ignorowanie zasad liczenia. Źródła różnie podchodzą do kodowania i punktu startowego, dlatego zachowaj margines. Żądanie migracji, które kończy się błędem na jednym długim elemencie, może ukryć prawdziwą przyczynę wśród wielu podobnych błędów.
- Poprawianie nazw po skopiowaniu. Zmiany nazw w chmurze synchronizują się z każdym klientem, a zmiana nazwy po przeniesieniu powtarza pracę, którą można było wykonać u źródła.
- Poleganie na jednym sprawdzeniu. Wykonaj własny pomiar i uruchom skanowanie migracji.
Jak oprogramowanie może pomóc
PowerShell i arkusz kalkulacyjny wystarczą, aby zacząć: wypisz wszystkie ścieżki wraz z ich długością, posortuj je według długości i pogrupuj według folderu najwyższego poziomu. Skanowania migracyjne firmy Microsoft dają drugi punkt widzenia. Niektóre narzędzia zewnętrzne także oferują raporty ścieżek i nazw. Oceniaj każde narzędzie według tego, czy liczy od właściwego punktu startowego i czy pokazuje pliki oraz foldery blokujące kopiowanie.
Następny krok
W tym tygodniu wyeksportuj ścieżki z jednego udziału i posortuj je według długości. Następnie zapisz, ile plików przekracza 300 znaków, ponieważ ta liczba określi nakład pracy związany z porządkowaniem ścieżek ze względu na limit długości adresu URL w SharePoint.