حدود طول المسار وأسماء الملفات في 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، واحتفظ بهامش أمان في فحوصاتك.
- قِس المسارات في المصدر، وأصلح الأطول أولًا بتقصير أسماء المجلدات، وأعد تسمية الملفات قبل النسخ، لا بعده.
حدّ طول عنوان URL في SharePoint: ما توثّقه Microsoft
تذكر Microsoft حدّ الـ 400 حرف لـ SharePoint Online في موضعين. يقول وصف الخدمة حدود SharePoint إن المسار الكامل للملف بعد فك الترميز، بما في ذلك اسم الملف، لا يمكن أن يتجاوز 400 حرف في OneDrive وSharePoint في Microsoft 365. وتقدّم مقالة المساعدة ما هي حدود طول مسار الملف؟ الرقم نفسه مع تفاصيل إضافية. ولا تصف أي من الصفحتين إعدادًا يرفع هذا الحد، لذا خطّط على أساسه.
النقاط الرئيسية من تلك المقالة:
- يُحسب كل مجلد في التسلسل الهرمي، واسم الملف مع امتداده. كل حرف يُحسب، بما في ذلك الفواصل والمسافات والامتداد.
- يستخدم Office for the web الحد نفسه البالغ 400 حرف.
- تُرمَّز الأحرف الخاصة والمسافات والأحرف المعلّمة في SharePoint بترميز URL. تتحول المسافة إلى
%20.
نقطة الترميز هي موضع اختلاف الصفحات. تقول مقالة المساعدة إن الأشكال المرمّزة تُحسب ضمن الحد، لكن قاعدتها الرئيسية تشير إلى المسار المفكوك. ويذكر وصف الخدمة المسار المفكوك فقط. يعرض القسم التالي ما يشير أيضًا في اتجاهات مختلفة.
كيف يحسب SharePoint الأحرف
ثلاثة مصادر تجيب عن سؤال الحساب، ولا تتطابق تمامًا.
- مُفكَّك الترميز أم مُرمَّز؟ تقول إجابة مقبولة على Microsoft Q&A كتبها موظفون خارجيون في Microsoft، إن طول المسار يُحسب على المسار بعد فك الترميز، وتشير إلى مقالة القيود. وأعلن الإعلان الصادر عام 2017 الأمر نفسه: ينقل موقع Redmondmag عن Bill Baer من Microsoft قوله: «لا يوجد حد لعدد عناوين URL المرمّزة في SharePoint Online و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. ومنذ ذلك الحين بقي الرقم 400 في صفحات Microsoft المذكورة أعلاه. وإذا ذكر دليل أقدم أو أداة ترحيل الرقم 256 أو 260، فهذا يصف الحد القديم أو حد Windows، لا الحد الحالي في السحابة.
لأعمدة الارتباط التشعبي حدها الخاص البالغ 255 حرفًا
كثيرًا ما يُخلط بين حد ثانٍ وحد المسار. ففي سلسلة نقاش على Microsoft Q&A، تذكر إجابة من دعم Microsoft أن عمود الارتباط التشعبي في قائمة SharePoint أو مكتبة فيها حد أقصى 255 حرفًا، وأن ذلك مقصود في تصميم المنتج. وقد يؤدي هيكل المجلدات العميق بسهولة إلى رابط أطول من ذلك، لأن الرابط إلى الملف يكرر اسم كل مجلد.
الحل البديل المقترح هو استخدام عمود نص متعدد الأسطر مع النص المنسق المحسّن، حيث يُضاف الرابط عبر خيار الارتباط التشعبي في المحرر. ويشير المعلقون في السلسلة إلى عيبين: قد لا يُحدَّث الرابط عند إعادة تسمية الملف الهدف أو نقله، كما أن خيار النص المنسق المحسّن غير متاح في مكتبات المستندات. وتحلّ أسماء المجلدات الأقصر المشكلة من جذورها.
الحدود التي تُربك المستخدمين في Windows
قد يكون المسار سليمًا في SharePoint، ثم يتعطل على جهاز سطح المكتب. وتذكر المقالة نفسها الجانب الخاص بـ Windows:
- لا تستطيع تطبيقات Office لسطح المكتب فتح الملفات التي يتجاوز مسارها الكامل 260 حرفًا، حتى لو كان الملف مخزنًا محليًا.
- يستخدم مستكشف الملفات حد 260 حرفًا عند الفتح وإعادة التسمية والنقل، ولا يستخدم سياسة المسارات الطويلة في Windows.
- تسمح مزامنة OneDrive بمسار محلي كلي يبلغ 520 حرفًا: مسار محلي يصل إلى 400 حرف، مع مجلد جذر في OneDrive يصل إلى 120 حرفًا.
- يمكن أن يصل طول أسماء الملفات أو المجلدات الفردية إلى 255 حرفًا في مستكشف الملفات وفي Finder على macOS.
يتضمن المسار المحلي المجلد الذي يحتوي المكتبة المتزامنة، وهو أطول مما يتوقعه معظم الناس. لذا قد يبلغ مسار طوله 250 حرفًا في السحابة 310 أحرف على حاسوب المستخدم المحمول. عامل 260 حرفًا كحد عملي لأي محتوى يفتحه الأشخاص من المجلدات المتزامنة.
أسماء ترفضها SharePoint
الطول ليس إلا نصف قائمة المراجعة. تحدد مقالة Microsoft القيود والحدود في OneDrive وSharePoint ما ينبغي البحث عنه:
- الأحرف غير الصالحة: علامة الاقتباس المزدوجة، والنجمة، والنقطتان الرأسيتان، وعلامة أصغر من، وعلامة أكبر من، وعلامة الاستفهام، والشرطة المائلة للأمام، والشرطة المائلة للخلف، والخط العمودي.
- المسافات: المسافات في بداية الاسم أو نهايته غير مسموح بها.
- الأسماء المحجوزة: .lock، وCON، وPRN، وAUX، وNUL، وCOM0 حتى COM9، وLPT0 حتى LPT9، و_vti_، وdesktop.ini.
- البادئة والمقاطع: لا يُسمح باسم ملف يبدأ بـ
~$، ولا يمكن أن يظهر_vti_في أي موضع داخل الاسم. كما أن الاسمformsغير مسموح به في the جذر المكتبة. - علامة الرقم وعلامة النسبة المئوية: بعض المؤسسات لا تدعمهما في الأسماء بعد. يمكن للمسؤولين العامين ومسؤولي SharePoint تفعيلهما.
تنطبق هذه القيود على الملفات والمجلدات معاً. فالمجلد الذي ينتهي باسمه بمسافة يعطّل كل ما يقع تحته، لذلك قد يتسبب اسم مجلد واحد سيئ في فشل آلاف العناصر.
قائمة التحقق قبل الترحيل
اتبع هذا الترتيب مع كل مشاركة أو موقع قبل النسخ.
- قِس طول المسار في المصدر. صدّر قائمة بالمسارات الكاملة واحسب طول كل منها. بالنسبة إلى مشاركة ملفات، يعيد الأمر
Get-ChildItem -Recurseفي PowerShell الاسم الكامل لكل عنصر، ويمكن لسكربت قصير أن يحسب عدد الأحرف. - احسب المسار الهدف. احذف الجزء من مسار المصدر غير الموجود في المكتبة، ثم أضف البادئة الجديدة النسبية إلى المكتبة. احسب بدءاً من
/sites، بحيث يدخل اسم الموقع واسم مكتبة المستندات ضمن الإجمالي. - ضع علامة على كل ما يتجاوز 300. الحد 400 هو الحد الصارم. أما العلامة عند 300 فتترك مساحة لمجلد المزامنة ولإعادة التسمية لاحقاً.
- اجرد الأحرف غير الصالحة والأسماء المحجوزة. ابحث عن الأحرف المذكورة أعلاه، والمسافات في بداية الاسم ونهايته، وأسماء مثل ملفات
~$. - أصلح بحسب الأثر. قصّر اسم المجلد الأعلى في الشجرة الطويلة أولاً، فاسم مجلد واحد أقصر يقصّر كل مسار يقع تحته.
- أعد القياس. نفّذ العد نفسه مرة أخرى، ثم خطّط للنسخ بعد ذلك فقط.
كما تساعد عمليات الفحص الخاصة بالترحيل من Microsoft. فـ Migration Manager يفحص كل ملف بحثاً عن المشكلات المحتملة المعروفة، وتتيح أداة ترحيل SharePoint خياراً يقوم بالفحص فقط، فترى المشكلات قبل نقل أي شيء. استخدمها كفحص ثانٍ، لا كفحص وحيد.
مثال: مسار طويل وحدّان
يستخدم هذا المثال أسماء وأرقاماً مختلقة. يقع ملف على مشاركة ملفات بمسار طوله 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 تقسيم الأقراص الكبيرة إلى مكتبات أصغر وأكثر تركيزاً. - استخدم البيانات الوصفية بدلاً من المجلدات. عمود مثل «السنة» أو «العميل» في المكتبة يحل محل مستويين من المجلدات.
- اترك الملف القديم. إذا لم يفتحه أحد منذ سنوات، فانقله إلى الأرشيف في مكان آخر.
لا تعتمد على حل مؤقت مثل نقل الملف مستوى واحداً إلى الأعلى بعد الترحيل. فما لم تُعالج السبب الجذري، سيفشل إعادة الهيكلة التالية أيضاً.
اتفق على القواعد مع مالكي المحتوى قبل إعادة تسمية أي شيء. فاصطلاح تسمية قصير، مثل ألا يتجاوز اسم المجلد 40 حرفاً وألا يتجاوز عدد مستويات المجلدات 8 مستويات، يمنح الناس هدفاً واضحاً ويمنع المحتوى الجديد من تجاوز الحد مجدداً بعد الترحيل. كرّر هذا الاصطلاح في إعلان الترحيل، حتى يعرف الناس سبب تغيّر أسماء المجلدات المألوفة لديهم.
الأخطاء الشائعة
- احتساب المسار من نقطة خاطئة. المسار في المصدر ليس هو المسار في المكتبة. احسب مسار الوجهة.
- نسيان مجلد المزامنة المحلي. قد يعمل المسار في المتصفح ويفشل في تطبيقات Office لسطح المكتب.
- تجاهل قواعد الحساب. تختلف المصادر في الترميز ونقطة البداية، لذا احتفظ بهامش أمان. فطلب ترحيل يفشل بسبب عنصر واحد طويل قد يُخفي السبب الحقيقي بين أخطاء كثيرة متشابهة.
- إصلاح الأسماء بعد النسخ. تنتقل عمليات إعادة التسمية في السحابة إلى كل عميل مزامن، وإعادة التسمية بعد النقل تكرر عملاً كان بالإمكان إنجازه على المصدر.
- الوثوق بفحص واحد فقط. شغّل قياسك الخاص وفحص الترحيل معاً.
كيف يمكن للبرمجيات أن تساعد
يكفي PowerShell وجدول بيانات للبدء: اسرد جميع المسارات مع أطوالها، ورتّبها حسب الطول، وصنّفها حسب المجلد ذي المستوى الأعلى. تقدم فحوصات الترحيل من Microsoft منظوراً ثانياً. وتوفر بعض الأدوات التابعة لجهات خارجية تقارير للمسارات والأسماء أيضاً. وقيّم أي أداة بحسب ما إذا كانت تحسب من نقطة البداية الصحيحة، وتُظهر الملفات والمجلدات التي تعيق عملية النسخ.
الخطوة التالية
صدّر مسارات مشاركة واحدة هذا الأسبوع ورتّبها حسب الطول. ثم دوّن عدد الملفات التي تتجاوز 300 حرف، لأن هذا الرقم يحدد حجم الجهد اللازم لتنظيف طول عناوين URL في SharePoint.