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

Blog · Mirko Peters

SharePoint-padlengte en beperkingen voor bestandsnamen: los ze op voordat je migreert

By · · Updated

De limiet voor de SharePoint-URL-lengte is 400 tekens voor het gedecodeerde bestandspad. Zoek met deze checklist lange paden en ongeldige namen op voordat je migreert.

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

De limiet voor de SharePoint-URL-lengte is 400 tekens voor het gedecodeerde bestandspad, inclusief de bestandsnaam. Alles wat langer is, mislukt bij uploaden, kopiëren of synchroniseren, en gebruikers zien een foutmelding in plaats van het bestand. Deze checklist is bedoeld voor leads van een SharePoint-migratie die lange paden en ongeldige namen in de bron willen vinden vóór de eerste kopie, omdat hernoemen na de migratie trager en riskanter is. Je leert wat Microsoft documenteert, wat onduidelijk blijft, en hoe je de langste paden in de juiste volgorde oplost.

Belangrijkste punten

  • Microsoft hanteert een limiet van 400 tekens voor het volledige gedecodeerde bestandspad, inclusief de bestandsnaam, in OneDrive en SharePoint.
  • Windows voegt eigen limieten toe: Office-desktopapps kunnen geen bestanden openen waarvan het volledige pad langer is dan 260 tekens, ook als de cloud het bestand wel accepteert.
  • Ongeldige tekens zijn onder meer de dubbele aanhalingsteken, asterisk, dubbele punt, punthaken, vraagteken, schuine strepen en verticale streep. Voor- en achterliggende spaties zijn niet toegestaan.
  • Bronnen verschillen van mening over het tellen van gecodeerde versus gedecodeerde tekens en over het startpunt, dus tel vanaf /sites en houd in je controles een veiligheidsmarge aan.
  • Meet de paden in de bron, los eerst de langste op door mapnamen in te korten, en hernoem bestanden vóór het kopiëren, niet erna.

Limiet voor de SharePoint-URL-lengte: wat Microsoft documenteert

Microsoft noemt de limiet van 400 tekens voor SharePoint Online op twee plaatsen. In de servicebeschrijving SharePoint limits staat dat het volledige gedecodeerde bestandspad, inclusief de bestandsnaam, niet meer dan 400 tekens mag bevatten voor OneDrive en SharePoint in Microsoft 365. Het helpartikel What are the file path length limits? noemt hetzelfde getal en geeft meer details. Geen van beide pagina's beschrijft een instelling om de limiet te verhogen, dus houd er rekening mee.

De belangrijkste punten uit dat artikel:

  • Elke map in de hiërarchie en de bestandsnaam met extensie tellen mee. Elk teken telt, inclusief scheidingstekens, spaties en de extensie.
  • Office voor het web hanteert dezelfde 400 tekens.
  • Speciale tekens, spaties en tekens met accenten worden in SharePoint URL-gecodeerd. Een spatie wordt %20.

Op het punt van de codering lopen de pagina's uiteen. Het helpartikel zegt dat gecodeerde vormen meetellen, maar de hoofdregel verwijst naar het gedecodeerde pad. De servicebeschrijving noemt alleen het gedecodeerde pad. In de volgende sectie zie je wat nog meer in verschillende richtingen wijst.

Hoe SharePoint de tekens telt

Drie bronnen beantwoorden de telvraag, en ze komen niet helemaal overeen.

  • Gedecodeerd of gecodeerd? Een geaccepteerd antwoord op Microsoft Q&A, geschreven door externe medewerkers van Microsoft, stelt dat de lengte van het pad wordt berekend op basis van het gedecodeerde pad en verwijst naar het artikel over beperkingen. De aankondiging uit 2017 zei hetzelfde: Redmondmag citeert Bill Baer van Microsoft met "Er is geen limiet voor gecodeerde URL's in SharePoint Online en OneDrive for Business." De vermelding in het Help-artikel dat %20 meetelt, is de uitzondering.
  • Waar begint het tellen? Een ander Microsoft Q&A-antwoord van externe medewerkers van Microsoft zegt dat je moet beginnen bij het segment /sites en queryparameters moet negeren. Bij een link zoals /sites/SiteName/Shared Documents/Forms/AllItems.aspx?FolderCTID=... telt alleen het deel vóór het vraagteken. Volgens dat antwoord tellen de sitenaam en de naam van de bibliotheek mee. Het voorbeeld in het Help-artikel zelf begint bij de hoofdmap van de bibliotheek, dus zie het Q&A-antwoord als ondersteunende richtlijn en niet als documentatie.
  • En de servernaam? De formule die Redmondmag in 2017 meldde luidt: protocol plus servernaam plus map- of bestandspad plus map- of bestandsnaam plus parameters. Die wijkt af van het antwoord van de support, en dat is nog een reden om niet met een krappe telling te werken.

Daaruit volgt een veilige vuistregel. Tel vanaf /sites, reken de sitenaam, de naam van de bibliotheek, elke map en de bestandsnaam mee, en houd een marge van enkele tientallen tekens aan totdat je een echt grensgeval in je tenant hebt getest.

Heeft Microsoft de limiet voor het pad verhoogd?

Eén keer, volgens Redmondmag. In mei 2017 meldde het artikel dat Microsoft de maximale lengte van het URL-pad voor SharePoint Online en OneDrive for Business had uitgebreid van 256 naar 400 Unicode-codeeenheden. Sindsdien staat het getal op 400 in de Microsoft-pagina's die hierboven zijn aangehaald. Als een oudere gids of een migratietool nog 256 of 260 vermeldt, beschrijft die de oude limiet of de Windows-limiet, niet de huidige limiet in de cloud.

Hyperlinkkolommen hebben hun eigen limiet van 255 tekens

Een tweede limiet wordt vaak met de padlimiet verward. In een Microsoft Q&A-thread zegt een antwoord van de Microsoft-support dat de kolom Hyperlink in een SharePoint-lijst of -bibliotheek een limiet van 255 tekens heeft, en dat dit bewust zo is ontworpen. Een diepe mappenstructuur kan makkelijk een langere link opleveren, omdat de link naar een bestand elke mapnaam herhaalt.

De voorgestelde omweg is een kolom Meerdere regels tekst met enhanced rich text, waarbij de link wordt toegevoegd met de hyperlinkoptie van de editor. Reageerders in de thread noemen twee nadelen: de link wordt mogelijk niet bijgewerkt wanneer het doelbestand wordt hernoemd of verplaatst, en de optie enhanced rich text is niet beschikbaar in documentbibliotheken. Kortere mapnamen voorkomen het probleem bij de bron.

De limieten die in Windows bijten

Een pad kan prima zijn in SharePoint en toch misgaan op een desktop. Hetzelfde Help-artikel noemt de Windows-kant:

  • Office-desktopapps kunnen geen bestanden openen waarvan het volledige pad langer is dan 260 tekens, ook niet als het bestand lokaal is opgeslagen.
  • Verkenner gebruikt de limiet van 260 tekens voor het openen, hernoemen en verplaatsen van bestanden. Het gebruikt het Windows-beleid voor lange paden niet.
  • Met de OneDrive-synchronisatie is een totaal lokaal pad van 520 tekens toegestaan: een lokaal pad van maximaal 400 tekens plus een OneDrive-hoofdmap van maximaal 120 tekens.
  • Afzonderlijke bestands- of mapnamen mogen maximaal 255 tekens lang zijn in Verkenner en in de Finder van macOS.

Het lokale pad bevat ook de map waarin de gesynchroniseerde bibliotheek staat, en dat is langer dan de meeste mensen verwachten. Een pad van 250 tekens in de cloud kan dus 310 tekens worden op de laptop van een gebruiker. Hanteer 260 als werklimiet voor alle inhoud die mensen openen vanuit gesynchroniseerde mappen.

Namen die SharePoint weigert

Lengte is maar de helft van de checklist. Het Microsoft-artikel Beperkingen en limieten in OneDrive en SharePoint somt op waar je op moet letten:

  • Ongeldige tekens: dubbele aanhalingsteken, asterisk, dubbele punt, kleiner-dan-teken, groter-dan-teken, vraagteken, schuine streep, backslash en verticale streep.
  • Spaties: voorloop- en volgspaties zijn niet toegestaan.
  • Gereserveerde namen: .lock, CON, PRN, AUX, NUL, COM0 tot en met COM9, LPT0 tot en met LPT9, _vti_ en desktop.ini.
  • Voorvoegsel en fragmenten: een bestandsnaam die begint met ~$ is niet toegestaan, en _vti_ mag nergens in een naam voorkomen. De naam forms is niet toegestaan op het hoogste niveau van een bibliotheek.
  • Nummerteken en procentteken: sommige organisaties ondersteunen ze nog niet in namen. Globale beheerders en SharePoint-beheerders kunnen ze inschakelen.

Deze beperkingen gelden voor zowel de bestanden als de mappen. Een map met een volgspatie blokkeert alles eronder, dus één foute mapnaam kan duizenden mislukte items veroorzaken.

Controlelijst vóór migratie

Volg deze volgorde bij elke share of site voordat je gaat kopiëren.

  1. Meet de padlengte op de bron. Exporteer een lijst met volledige paden en bereken de lengte van elk pad. Voor een bestandsshare geeft Get-ChildItem -Recurse in PowerShell de volledige naam van elk item terug, en met een kort script kun je de tekens tellen.
  2. Bereken het doelpad. Verwijder het deel van het bronpad dat niet in de bibliotheek bestaat en voeg het nieuwe voorvoegsel ten opzichte van de bibliotheek toe. Tel vanaf /sites, zodat de sitenaam en de naam van de documentbibliotheek deel uitmaken van het totaal.
  3. Markeer alles boven 300. De limiet van 400 is de harde grens. Een markering bij 300 geeft ruimte voor de synchronisatiemap en voor latere hernoemingen.
  4. Lijst ongeldige tekens en gereserveerde namen op. Zoek naar de bovenstaande tekens, voorloop- en volgspaties en namen zoals ~$-bestanden.
  5. Los op in volgorde van impact. Verkort eerst de mapnaam die het hoogst in een lange boomstructuur staat. Eén kortere mapnaam verkort elk pad eronder.
  6. Meet opnieuw. Voer dezelfde telling nogmaals uit. Pas daarna plan je het kopiëren.

Microsoft-migratiescans helpen ook. Migration Manager scant elk bestand op bekende mogelijke problemen, en de SharePoint Migration Tool biedt een optie die alleen scant, zodat je problemen kunt zien voordat je iets verplaatst. Gebruik ze als tweede controle, niet als enige.

Voorbeeld: één lang pad, twee limieten

Dit voorbeeld gebruikt verzonnen namen en getallen. Een bestand staat op een bestandsshare op een pad van 247 tekens onder de root van de share, bijvoorbeeld 2019/Customer Contracts and Offers/Northwind Rollout Phase 2/Technical Specification and Requirements/Approved Versions/Final Signed Copies/, gevolgd door een bestandsnaam van 107 tekens. Het doel is een bibliotheek met de naam Projects. Om de getallen eenvoudig te houden, negeert het voorbeeld de sitenaam: de bibliotheek voegt 9 tekens toe voor Projects/, en het totaal is 256.

  • Cloudlimiet: 256 is lager dan 400, dus SharePoint accepteert het bestand.
  • Windows-limiet: een gangbaar gesynchroniseerd pad begint met een lokale map van 62 tekens, zoals C:\Users\anna.example\OneDrive - Contoso\Projects - Team Site\. Het lokale totaal is 62 + 247 = 309, en dat is hoger dan 260. Office-desktopapps kunnen het bestand dan niet openen vanuit de synchronisatiemap.

De oplossing is namen inkorten, niet de limieten verhogen. De migratielead hernoemt de mappen naar Contracts, Northwind Phase 2, Tech Spec, Approved en Signed, en het bestand naar Northwind Phase 2 - Tech Spec v3 signed.docx. Het pad onder de root daalt van 247 naar 103 tekens. Het lokale totaal daalt van 309 naar 165, ruim onder 260, en dat laat ruimte voor een langere gebruikersnaam.

Controleer de zakelijke kant voordat je hernoemt. Contracten en technische specificaties volgen vaak naamgevingsregels, en bestandsnamen moeten om juridische redenen soms identiek blijven. Verkort in dat geval de mappen en behoud de bestandsnamen.

Opties wanneer een pad te lang is

Je hebt vier keuzes, in deze volgorde van voorkeur:

  • Verkort mapnamen. Dit is de goedkoopste manier om de URL te verkorten, en het helpt elk bestand eronder.
  • Vlak de structuur af. Verwijder niveaus die alleen informatie herhalen, zoals Final binnen Approved. De bestandsshare-gids van Microsoft adviseert ook om grote schijven op te splitsen in kleinere, gerichtere bibliotheken.
  • Gebruik metadata in plaats van mappen. Een kolom zoals Jaar of Klant in de bibliotheek vervangt twee mapniveaus.
  • Laat het bestand achter. Als niemand het al jaren heeft geopend, archiveer het dan elders.

Vertrouw niet op een tijdelijke oplossing, zoals het bestand na de migratie één niveau hoger verplaatsen. Zolang de oorzaak niet is opgelost, faalt de volgende herstructurering ook.

Maak afspraken met de contentbeheerders voordat je iets hernoemt. Een korte naamgevingsconventie, bijvoorbeeld maximaal 40 tekens per mapnaam en maximaal 8 mapniveaus, geeft mensen een doel en voorkomt dat nieuwe content na de verhuizing weer over de limiet heen gaat. Herhaal de conventie in de migratiemelding, zodat mensen begrijpen waarom hun vertrouwde mapnamen zijn veranderd.

Veelgemaakte fouten

  • Vanaf het verkeerde punt tellen. Het pad in de bron is niet hetzelfde als het pad in de bibliotheek. Bereken het doelpad.
  • De lokale synchronisatiemap vergeten. Een pad dat in de browser werkt, kan in de desktopapps van Office mislukken.
  • De telregels negeren. Bronnen zijn het oneens over codering en over het startpunt, dus houd een marge aan. Een migratieaanvraag die faalt op één lang item kan de echte oorzaak verbergen tussen veel vergelijkbare fouten.
  • Namen achteraf corrigeren. Hernoemingen in de cloud synchroniseren naar elke client, en een hernoeming na de verhuizing herhaalt werk dat je al op de bron had kunnen doen.
  • Vertrouwen op één controle. Voer je eigen meting uit en draai de migratiescan.

Hoe software kan helpen

PowerShell en een spreadsheet zijn genoeg om te beginnen: lijst alle paden met hun lengte, sorteer op lengte en groepeer op mapniveau bovenaan. De migratiescans van Microsoft geven een tweede beeld. Sommige tools van derden bieden ook rapporten over paden en namen. Beoordeel elke tool op of hij vanaf het juiste startpunt telt en of hij de bestanden en mappen toont die de kopie blokkeren.

Volgende stap

Exporteer deze week de paden van één share en sorteer ze op lengte. Schrijf daarna op hoeveel bestanden langer zijn dan 300 tekens, want dat getal bepaalt de inspanning voor het opschonen van je SharePoint-limiet voor URL-lengte.

Entities in this article

SharePoint migration SharePoint document libraries SharePoint

Related articles

RSS