M365Con 2027 – konferensi online gratis · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Batas panjang path dan nama file SharePoint: perbaiki sebelum bermigrasi

By · · Updated

Batas panjang URL SharePoint adalah 400 karakter untuk path file yang sudah di-decode. Temukan path yang terlalu panjang dan nama yang tidak valid sebelum bermigrasi dengan daftar periksa ini.

Automatically translated with AI from the original post. Read the English original

Batas panjang URL SharePoint adalah 400 karakter untuk path file yang sudah di-decode, termasuk nama file. Path yang lebih panjang akan gagal diunggah, disalin, atau disinkronkan, dan pengguna melihat pesan error alih-alih file. Daftar periksa ini ditujukan bagi pimpinan migrasi SharePoint yang ingin menemukan path panjang dan nama tidak valid di sumber sebelum penyalinan pertama, karena mengganti nama setelah migrasi lebih lambat dan lebih berisiko. Anda akan mempelajari apa yang didokumentasikan Microsoft, apa yang masih tidak jelas, dan cara memperbaiki path terpanjang secara berurutan.

Poin Penting

  • Microsoft mendokumentasikan batas 400 karakter untuk seluruh path file yang sudah di-decode, termasuk nama file, di OneDrive dan SharePoint.
  • Windows menambahkan batasnya sendiri: aplikasi desktop Office tidak dapat membuka file yang path lengkapnya melebihi 260 karakter, meskipun cloud menerima file tersebut.
  • Karakter yang tidak valid meliputi tanda kutip ganda, tanda bintang, titik dua, tanda kurung sudut, tanda tanya, garis miring, dan tanda pipa, serta spasi di awal atau akhir nama tidak diizinkan.
  • Sumber-sumber tidak sepakat tentang penghitungan karakter yang di-encode versus yang di-decode, dan tentang titik awal penghitungan, jadi hitung dari /sites dan sisakan margin pengaman dalam pemeriksaan Anda.
  • Ukur path di sumber, perbaiki yang terpanjang lebih dulu dengan memperpendek nama folder, dan ganti nama file sebelum disalin, bukan sesudahnya.

Batas panjang URL SharePoint: yang didokumentasikan Microsoft

Microsoft menyatakan batas 400 karakter untuk SharePoint Online di dua tempat. Deskripsi layanan SharePoint limits menyebutkan bahwa seluruh path file yang sudah di-decode, termasuk nama file, tidak boleh berisi lebih dari 400 karakter untuk OneDrive dan SharePoint di Microsoft 365. Artikel bantuan What are the file path length limits? memberikan angka yang sama dan menambahkan rincian. Kedua halaman tersebut tidak menjelaskan pengaturan yang dapat menaikkan batas, jadi rancanglah proses Anda dengan batas tersebut.

Poin-poin penting dari artikel tersebut:

  • Setiap folder dalam hierarki dan nama file beserta ekstensinya dihitung. Setiap karakter dihitung, termasuk pemisah, spasi, dan ekstensi.
  • Office untuk web menggunakan batas 400 karakter yang sama.
  • Karakter khusus, spasi, dan karakter beraksen di SharePoint di-encode dengan URL. Spasi menjadi %20.

Di sinilah halaman-halaman tersebut tidak sejalan. Artikel bantuan menyatakan bahwa bentuk yang di-encode dihitung ke dalam batas, namun aturan utamanya merujuk pada path yang di-decode. Deskripsi layanan hanya menyebutkan path yang di-decode. Bagian berikutnya menunjukkan hal lain yang juga berbeda arah.

Cara SharePoint menghitung karakter

Tiga sumber menjawab pertanyaan penghitungan ini, dan jawabannya tidak sepenuhnya sama.

  • Didekode atau dienkode? Sebuah jawaban yang diterima di Microsoft Q&A, yang ditulis oleh staf eksternal Microsoft, menyatakan bahwa panjang jalur dihitung dari jalur yang sudah didekode, dan mengarahkan ke artikel batasan. Pengumuman tahun 2017 juga menyatakan hal yang sama: Redmondmag mengutip Bill Baer dari Microsoft: "Tidak ada batas untuk URL yang dienkode di SharePoint Online dan OneDrive for Business." Catatan dalam artikel bantuan bahwa %20 ikut dihitung justru menjadi pengecualian.
  • Dari mana penghitungan dimulai? Jawaban Microsoft Q&A lain dari staf eksternal Microsoft menyatakan bahwa penghitungan dimulai dari segmen /sites dan parameter query string diabaikan. Untuk tautan seperti /sites/SiteName/Shared Documents/Forms/AllItems.aspx?FolderCTID=..., hanya bagian sebelum tanda tanya yang dihitung. Menurut jawaban tersebut, nama situs dan nama pustaka ikut dihitung. Contoh dalam artikel bantuan itu sendiri dimulai dari root pustaka, jadi perlakukan jawaban Q&A sebagai panduan dukungan, bukan dokumentasi.
  • Bagaimana dengan nama server? Rumus yang dilaporkan Redmondmag pada 2017 berbunyi: protokol ditambah nama server ditambah jalur folder atau file ditambah nama folder atau file ditambah parameter. Rumus ini berbeda dengan jawaban dukungan tadi, dan ini alasan lain untuk tidak menghitung secara mepet.

Dari sini muncul aturan yang aman. Hitung mulai dari /sites, sertakan nama situs, nama pustaka, setiap folder, dan nama file, serta sisakan margin beberapa puluh karakter sampai Anda menguji kasus tepi nyata di penyewa Anda.

Apakah Microsoft pernah menaikkan batas jalur?

Sekali, menurut Redmondmag. Pada Mei 2017 artikel itu melaporkan bahwa Microsoft telah memperluas panjang maksimum jalur URL untuk SharePoint Online dan OneDrive for Business dari 256 menjadi 400 unit kode Unicode. Sejak itu angkanya tetap 400 di halaman Microsoft yang dikutip di atas. Jika panduan lama atau alat migrasi masih menyebut 256 atau 260, itu menggambarkan batas lama atau batas Windows, bukan batas cloud saat ini.

Kolom Hyperlink memiliki batas 255 karakter sendiri

Batas kedua ini sering tertukar dengan batas jalur. Dalam utas Microsoft Q&A, jawaban dukungan Microsoft menyatakan bahwa kolom Hyperlink dalam daftar atau pustaka SharePoint memiliki batas 255 karakter, dan itu memang dirancang demikian. Struktur folder yang dalam dengan mudah menghasilkan tautan yang lebih panjang, karena tautan ke sebuah file mengulang setiap nama folder.

Solusi yang disarankan adalah kolom Multiple lines of text dengan enhanced rich text, lalu tautan ditambahkan melalui opsi hyperlink pada editor. Komentator dalam utas tersebut menyebut dua kekurangan: tautan mungkin tidak diperbarui saat file target diganti nama atau dipindahkan, dan opsi enhanced rich text tidak tersedia di pustaka dokumen. Nama folder yang lebih pendek menyelesaikan masalah ini dari akarnya.

Batasan yang merepotkan di Windows

Sebuah jalur bisa baik-baik saja di SharePoint tetapi tetap gagal di desktop. Artikel bantuan yang sama mencantumkan sisi Windows:

  • Aplikasi desktop Office tidak dapat membuka file yang jalur lengkapnya melebihi 260 karakter, meskipun file tersimpan secara lokal.
  • File Explorer menggunakan batas 260 karakter untuk membuka, mengganti nama, dan memindahkan file. Batas ini tidak mengikuti kebijakan jalur panjang (long path) Windows.
  • Sinkronisasi OneDrive mengizinkan total jalur lokal 520 karakter: jalur lokal hingga 400 karakter ditambah folder root OneDrive hingga 120 karakter.
  • Nama file atau folder individual dapat mencapai 255 karakter di File Explorer dan di Finder macOS.

Jalur lokal mencakup folder yang menyimpan pustaka yang disinkronkan, dan jalur ini lebih panjang dari yang kebanyakan orang perkirakan. Jadi jalur 250 karakter di cloud bisa menjadi 310 karakter di laptop pengguna. Perlakukan 260 sebagai batas kerja untuk konten apa pun yang dibuka pengguna dari folder yang disinkronkan.

Nama yang ditolak SharePoint

Panjang hanya separuh dari daftar periksa. Artikel Microsoft Restrictions and limitations in OneDrive and SharePoint mencantumkan hal-hal yang perlu diwaspadai:

  • Karakter yang tidak valid: tanda kutip ganda, tanda bintang, titik dua, tanda kurang dari, tanda lebih dari, tanda tanya, garis miring, garis miring terbalik, dan tanda pipa.
  • Spasi: spasi di awal dan di akhir nama tidak diizinkan.
  • Nama yang dicadangkan: .lock, CON, PRN, AUX, NUL, COM0 sampai COM9, LPT0 sampai LPT9, _vti_, dan desktop.ini.
  • Awalan dan fragmen: nama file yang diawali ~$ tidak diizinkan, dan _vti_ tidak boleh muncul di mana pun dalam sebuah nama. Nama forms tidak diizinkan di tingkat root pustaka.
  • Tanda pagar dan tanda persen: sebagian organisasi belum mendukung keduanya dalam nama. Admin global dan admin SharePoint dapat mengaktifkannya.

Batasan ini berlaku untuk file maupun folder. Folder dengan spasi di akhir akan memblokir semua item di bawahnya, sehingga satu nama folder yang bermasalah dapat menyebabkan ribuan item gagal.

Daftar periksa sebelum migrasi

Gunakan urutan ini untuk setiap share atau situs sebelum Anda menyalin.

  1. Ukur panjang path di sumber. Ekspor daftar semua path lengkap dan hitung panjang masing-masing. Untuk file share, Get-ChildItem -Recurse di PowerShell mengembalikan nama lengkap setiap item, dan sebuah skrip singkat dapat menghitung jumlah karakternya.
  2. Hitung path target. Hapus bagian path sumber yang tidak ada di pustaka, lalu tambahkan awalan relatif terhadap pustaka yang baru. Hitung dimulai dari /sites, sehingga nama situs dan nama pustaka dokumen ikut dihitung dalam total.
  3. Tandai semua yang melebihi 300. Batas 400 adalah batas keras. Penanda pada 300 menyisakan ruang untuk folder sinkronisasi dan untuk perubahan nama di kemudian hari.
  4. Daftarkan karakter dan nama cadangan yang tidak valid. Cari karakter di atas, spasi di awal dan di akhir, serta nama seperti file ~$.
  5. Perbaiki sesuai dampaknya. Pendekkan dulu nama folder yang berada paling tinggi di pohon yang panjang. Satu nama folder yang lebih pendek akan memperpendek setiap path di bawahnya.
  6. Ukur ulang. Jalankan penghitungan yang sama sekali lagi. Baru setelah itu rencanakan penyalinan.

Pemindaian migrasi dari Microsoft juga membantu. Migration Manager memindai setiap file untuk potensi masalah yang sudah diketahui, dan SharePoint Migration Tool menyediakan opsi yang hanya memindai, sehingga Anda dapat melihat masalah sebelum memindahkan apa pun. Gunakan keduanya sebagai pemeriksaan kedua, bukan satu-satunya pemeriksaan.

Contoh: satu path panjang, dua batas

Contoh ini menggunakan nama dan angka rekaan. Sebuah file berada di file share dengan path 247 karakter di bawah root share, misalnya 2019/Customer Contracts and Offers/Northwind Rollout Phase 2/Technical Specification and Requirements/Approved Versions/Final Signed Copies/ diikuti nama file sepanjang 107 karakter. Targetnya adalah pustaka bernama Projects. Agar angkanya sederhana, contoh ini mengabaikan nama situs: pustaka menambah 9 karakter untuk Projects/, sehingga totalnya menjadi 256.

  • Batas cloud: 256 berada di bawah 400, sehingga SharePoint menerima file tersebut.
  • Batas Windows: path yang tersinkronisasi biasanya diawali folder lokal sepanjang 62 karakter, seperti C:\Users\anna.example\OneDrive - Contoso\Projects - Team Site\. Total lokalnya adalah 62 + 247 = 309, yang melebihi 260. Aplikasi desktop Office tidak dapat membuka file dari folder sinkronisasi.

Solusinya adalah memperpendek nama, bukan menaikkan batas. Pimpinan migrasi mengganti nama folder menjadi Contracts, Northwind Phase 2, Tech Spec, Approved, dan Signed, serta mengganti nama file menjadi Northwind Phase 2 - Tech Spec v3 signed.docx. Path di bawah root turun dari 247 menjadi 103 karakter. Total lokal turun dari 309 menjadi 165, jauh di bawah 260 dan menyisakan ruang untuk nama pengguna yang lebih panjang.

Periksa sisi bisnisnya sebelum mengganti nama. Kontrak dan spesifikasi teknis sering mengikuti aturan penamaan tertentu, dan nama file mungkin harus tetap sama karena alasan hukum. Dalam kasus itu, pendekkan folder dan pertahankan nama file.

Opsi ketika path terlalu panjang

Ada empat pilihan, diurutkan berdasarkan preferensi:

  • Pendekkan nama folder. Ini cara termurah untuk memperpendek URL, dan manfaatnya dirasakan oleh setiap file di bawahnya.
  • Ratakan struktur. Hapus level yang hanya mengulang informasi, misalnya Final di dalam Approved. Panduan file share dari Microsoft juga menyarankan untuk membagi drive besar menjadi pustaka yang lebih kecil dan lebih terfokus.
  • Gunakan metadata sebagai pengganti folder. Kolom seperti Year atau Customer di pustaka menggantikan dua tingkat folder.
  • Tinggalkan file yang tidak terpakai. Jika tidak ada yang membukanya selama bertahun-tahun, arsipkan di tempat lain.

Jangan mengandalkan solusi sementara, misalnya memindahkan file satu tingkat ke atas setelah migrasi. Tanpa memperbaiki penyebabnya, restrukturisasi berikutnya juga akan gagal.

Sepakati aturan dengan pemilik konten sebelum mengganti nama apa pun. Konvensi penamaan yang singkat, misalnya tidak lebih dari 40 karakter per nama folder dan tidak lebih dari 8 tingkat folder, memberi orang target yang jelas dan mencegah konten baru kembali melampaui batas setelah pemindahan. Ulangi konvensi ini dalam pengumuman migrasi, agar orang memahami alasan nama folder yang mereka kenal kini berubah.

Kesalahan umum

  • Menghitung dari titik yang salah. Path di sumber tidak sama dengan path di pustaka. Hitung path tujuannya.
  • Melupakan folder sinkronisasi lokal. Path yang berfungsi di browser bisa gagal di aplikasi desktop Office.
  • Mengabaikan aturan penghitungan. Sumber-sumber berbeda pendapat tentang encoding dan titik awal penghitungan, jadi sisakan margin. Permintaan migrasi yang gagal karena satu item yang terlalu panjang dapat menyembunyikan penyebab sebenarnya di antara banyak kesalahan serupa.
  • Memperbaiki nama setelah penyalinan. Perubahan nama di cloud akan disinkronkan ke setiap klien, dan mengganti nama setelah pemindahan berarti mengulang pekerjaan yang sebenarnya bisa dilakukan di sumber.
  • Hanya mengandalkan satu pemeriksaan. Lakukan pengukuran sendiri dan jalankan pemindaian migrasi.

Bagaimana perangkat lunak dapat membantu

PowerShell dan spreadsheet sudah cukup untuk memulai: daftarkan semua path beserta panjangnya, urutkan berdasarkan panjang, dan kelompokkan menurut folder tingkat atas. Pemindaian migrasi dari Microsoft memberikan sudut pandang kedua. Beberapa alat pihak ketiga juga menyediakan laporan path dan nama. Nilailah setiap alat dari apakah ia menghitung dari titik awal yang benar dan apakah ia menampilkan file serta folder yang menghambat penyalinan.

Langkah berikutnya

Ekspor path dari satu share minggu ini dan urutkan berdasarkan panjangnya. Setelah itu, catat berapa banyak file yang melebihi 300 karakter, karena jumlah tersebut menentukan besarnya upaya pembersihan untuk batas panjang URL SharePoint Anda.

Entities in this article

SharePoint migration SharePoint document libraries SharePoint

Related articles

RSS