M365Con 2027 – כנס אונליין חינמי · 11–22 Jan 2027 · 120 sessions→ m365con.net

בלוג · Mirko Peters

מגבלות אורך נתיב ושם קובץ ב-SharePoint: לתקן לפני ההעברה

By · · Updated

מגבלת אורך הכתובת ב-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 limits קובע שנתיב הקובץ המפוענח כולו, כולל שם הקובץ, לא יכול להכיל יותר מ-400 תווים ב-OneDrive וב-SharePoint ב-Microsoft 365. מאמר העזרה What are the file path length limits? מציין את אותו מספר ומוסיף פרטים. באף אחד מהעמודים לא מתואר הגדרה שמעלה את המגבלה, לכן תכננו בהתאם.

נקודות מרכזיות ממאמר זה:

  • כל תיקייה בהיררכיה ושם הקובץ עם הסיומת נספרים. כל תו נספר, כולל מפרידים, רווחים והסיומת.
  • Office for the web משתמש באותן 400 תווים.
  • תווים מיוחדים, רווחים ותווים עם סימני דיאקריטיקה מקודדים ב-SharePoint. רווח הופך ל-%20.

בנקודת הקידוד העמודים חלוקים. מאמר העזרה קובע שצורות מקודדות נספרות במגבלה, אף שהכלל העיקרי שלו מתייחס לנתיב המפוענח. תיאור השירות מזכיר רק את הנתיב המפוענח. בחלק הבא נראה מה עוד מצביע לכיוונים שונים.

כיצד SharePoint סופרת את התווים

שלושה מקורות עונים על שאלת הספירה, ואינם תואמים לחלוטין.

  • מפוענח או מקודד? תשובה מאושרת ב-Microsoft Q&A, שנכתבה על ידי עובדי צד שלישי של Microsoft, קובעת שאורך הנתיב מחושב על הנתיב המפוענח, ומפנה למאמר המגבלות. ההודעה מ-2017 אמרה אותו דבר: Redmondmag מצטט את Bill Baer מ-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 הגדילה את מגבלת נתיב ה-URL?

פעם אחת, לפי Redmondmag. במאי 2017 דיווח המאמר שMicrosoft הרחיבה את אורך נתיב ה-URL המקסימלי ל-SharePoint Online ול-OneDrive for Business מ-256 ל-400 יחידות קוד של Unicode. מאז המספר נשאר 400 בדפי Microsoft שצוטטו לעיל. אם מדריך ישן או כלי הגירה עדיין אומרים 256 או 260, הם מתארים את המגבלה הישנה או את מגבלת Windows, לא את מגבלת הענן הנוכחית.

לעמודות היפר-קישור יש מגבלה משלהן של 255 תווים

מגבלה שנייה מתבלבלת לעתים קרובות עם מגבלת הנתיב. בשרשור Microsoft Q&A, תשובת תמיכה של Microsoft קובעת שלעמודת Hyperlink ברשימת SharePoint או בספרייה יש מגבלה של 255 תווים, וזו התנהגות מכוונת. מבנה תיקיות עמוק יכול בקלות להפיק קישור ארוך מזה, משום שהקישור לקובץ חוזר על שם כל תיקייה.

העקיפה המוצעת היא עמודה מסוג Multiple lines of text עם enhanced rich text, שבה מוסיפים את הקישור דרך אפשרות ההיפר-קישור של העורך. המגיבים בשרשור מציינים שני חסרונות: הקישור עשוי לא להתעדכן כשהקובץ היעד משונה שמו או מועבר, ואפשרות enhanced rich text אינה זמינה בספריות מסמכים. שמות תיקיות קצרים יותר נמנעים מהבעיה משורשה.

המגבלות שנושכות ב-Windows

נתיב יכול להיות תקין בSharePoint ועדיין להישבר במחשב השולחני. אותו מאמר עזרה מפרט את הצד של Windows:

  • אפליקציות Office שולחניות אינן יכולות לפתוח קבצים שהנתיב המלא שלהם חורג מ-260 תווים, גם כשהקובץ מאוחסן מקומית.
  • סייר הקבצים משתמש במגבלה של 260 תווים לפתיחה, שינוי שם והעברה של קבצים. הוא אינו משתמש במדיניות הנתיבים הארוכים של Windows.
  • סנכרון OneDrive מאפשר נתיב מקומי כולל של 520 תווים: נתיב מקומי של עד 400 תווים בתוספת תיקיית שורש של OneDrive של עד 120 תווים.
  • שמות של קבצים או תיקיות בודדים יכולים להגיע עד 255 תווים בסייר הקבצים וב-Finder של macOS.

הנתיב המקומי כולל את התיקייה שמכילה את הספרייה המסונכרנת, וזה ארוך יותר ממה שרוב האנשים מצפים. כלומר נתיב של 250 תווים בענן יכול להיות 310 תווים במחשב הנייד של המשתמש. התייחסו ל-260 כמגבלת עבודה לכל תוכן שאנשים פותחים מתיקיות מסונכרנות.

שמות ש-SharePoint דוחה

האורך הוא רק חצי מרשימת הבדיקה. המאמר של Microsoft Restrictions and limitations in OneDrive and SharePoint מפרט מה לחפש:

  • תווים לא חוקיים: מירכאות כפולות, כוכבית, נקודתיים, סימן קטן מ-, סימן גדול מ-, סימן שאלה, לוכסן קדימה, לוכסן אחורה וקו אנכי (pipe).
  • רווחים: אסור להשתמש ברווחים בתחילת שם או בסופו.
  • שמות שמורים: .lock, CON, PRN, AUX, NUL, COM0 עד COM9, LPT0 עד LPT9, _vti_ ו-desktop.ini.
  • קידומות וקטעי טקסט: שם קובץ שמתחיל ב-~$ אינו מותר, ולא ניתן להשתמש ב-_vti_ בשום מקום בשם. השם forms אסור בשורש של ספרייה.
  • סימן מספר וסימן אחוז: חלק מהארגונים עדיין אינם תומכים בהם בשמות. מנהלים גלובליים ומנהלי SharePoint יכולים להפעיל אותם.

המגבלות האלה חלות על הקבצים ועל התיקיות. תיקייה שהשם שלה מסתיים ברווח חוסמת את כל מה שנמצא מתחתיה, ולכן שם תיקייה בעייתי אחד עלול לגרום לכשלון של אלפי פריטים.

רשימת בדיקה לפני המעבר

יש לעבור על השלבים האלה בסדר הזה, בכל שיתוף או אתר, לפני ההעתקה.

  1. מדדו את אורך הנתיב במקור. ייצאו רשימה של הנתיבים המלאים וחשבו את האורך של כל אחד מהם. בשיתוף קבצים, Get-ChildItem -Recurse ב-PowerShell מחזיר את השם המלא של כל פריט, וסקריפט קצר יכול לספור את התווים.
  2. חשבו את נתיב היעד. הסירו מנתיב המקור את החלק שאינו קיים בספרייה, והוסיפו את הקידומת החדשה היחסית לספרייה. ספרו מ-/sites, כך ששם האתר ושם ספריית המסמכים נכללים בסך הכול.
  3. סמנו כל מה שמעל 300. המגבלה של 400 היא המגבלה הקשיחה. סימון ב-300 משאיר מקום לתיקיית הסנכרון ולשינויי שם עתידיים.
  4. רשמו תווים לא חוקיים ושמות שמורים. חפשו את התווים שצוינו למעלה, רווחים בתחילת שם או בסופו, ושמות כמו קבצי ~$.
  5. תקנו לפי סדר ההשפעה. קצרו קודם את שם התיקייה שנמצאת הכי גבוה בעץ הארוך. שם תיקייה אחד שמתקצר מקצר כל נתיב שנמצא מתחתיו.
  6. מדדו מחדש. הריצו את אותה ספירה שוב. רק אז תכננו את ההעתקה.

גם סריקות ההעברה של 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.

Entities in this article

SharePoint migration SharePoint document libraries SharePoint

Related articles

RSS