Indhold
Filnavne og stier i SharePoint og OneDrive: # og %, forbudte tegn og 400 tegn
Hvordan
I foråret 2017 ændrede SharePoint Online og OneDrive to regler om filers navne og adresser. Tegnene # og % kunne tilvælges i fil- og mappenavne i dokumentbiblioteker, og grænsen for den afkodede sti til en fil eller mappe blev hævet fra 256 til 400 tegn. Den første blev varslet i februar 2017 og den anden i maj. Begge dukker op igen, når der migreres: filer med de tegn skal kunne lande, og den nye placering kan gøre stien længere end den gamle.
Status 17. oktober 2026: Hele den afkodede sti, filnavnet medregnet, må højst være 400 tegn i OneDrive og SharePoint i Microsoft 365 (Learn, SharePoint limits). Indstillingen til # og % findes stadig som tenant-indstilling med tre værdier (Learn, Set-SPOTenant).
# og %#
Microsoft varslede ændringen 8. februar 2017. Ændringen krævede nye API’er, fordi SharePoint tidligere læste # som begyndelsen på et fragment i en adresse og % som tegnet for en adresse, der ikke var afkodet. Den nye klasse Microsoft.SharePoint.Client.ResourcePath rummer den afkodede sti og skal bruges i stedet for strengbaserede adresser. Der skal ikke blot søges og erstattes: koden skal først afgøre, om adressen er kodet eller afkodet (Developer-bloggen, 8. februar 2017, Learn, ResourcePath).
Funktionen kunne tilvælges fra 6. april 2017. Den var slået fra som standard, og en global administrator skulle slå den til med SharePoint Online Management Shell (SharePoint-bloggen, Baer, 6. april 2017):
1Set-SPOTenant -SpecialCharactersStateInFileFolderNames Allowed
Værdierne er Allowed, Disallowed og NoPreference (Learn, Set-SPOTenant). NoPreference var udgangspunktet, og Microsoft ville slå tegnene til, når funktionen var klar. Havde administratoren valgt Allowed eller Disallowed, ændrede Microsoft det ikke (SharePoint-bloggen, Baer, 6. april 2017). Ifølge Baer kunne NoPreference ikke sættes med Set-SPOTenant.
Planen i 2017 var, at nye tenants fik # og % slået til fra juni 2017, og at eksisterende tenants, der ikke havde valgt noget, fik det i anden halvdel af 2017. Samtidig skrev Microsoft, at tredjepartsløsninger skulle være opdateret til de nye API’er, før funktionen blev slået til. Indlæggets FAQ svarede dog nej på, om funktionen var slået til som standard (SharePoint-bloggen, Baer, 6. april 2017). Indlæggets FAQ siger, at tidspunktet for udrulningens afslutning afhænger af flere forhold og vil blive opdateret undervejs. Microsofts side om begrænsninger skriver stadig, at nogle organisationer endnu ikke understøtter tegnene, og henviser administratorer til at slå dem til (Microsoft Support).
Microsoft angav i 2017 disse afgrænsninger. Tegnene omfatter filer og mapper i dokumentbiblioteker, mens websteder og site collections er undtaget. I søgning er # og % escapede tegn, så de ikke kan stå alene i en forespørgsel. Groove-klienten understøtter dem ikke, kun den nye synkroniseringsklient (SharePoint-bloggen, Baer, 6. april 2017).
Det, der stadig er forbudt#
Disse tegn er ikke tilladt i fil- og mappenavne i OneDrive og SharePoint: " * : < > ? / \ og |. Det gælder også mellemrum først og sidst i navnet (Microsoft Support).
Disse navne er heller ikke tilladt for filer og mapper: .lock, CON, PRN, AUX, NUL, COM0 til COM9, LPT0 til LPT9, desktop.ini og alle navne, der begynder med ~$. _vti_ må ikke stå nogen steder i et navn, og forms må ikke bruges til en fil eller mappe på øverste niveau i et bibliotek. Et Office-skrivebordsprogram (win32) kan ikke gemme en fil via Backstage i en mappe, hvis mappenavnet indeholder semikolon (Microsoft Support).
Synkroniseringsappen fik i 2019 en løsning, hvor en fil med et ulovligt navn kan omdøbes i appen, så uploaden fortsætter. Microsoft annoncerede den i april 2019 (månedsnoten for april 2019).
400 tegn#
Den 9. maj 2017 meldte Microsoft, at grænsen for URL-stien til en mappe eller fil i SharePoint Online og OneDrive for Business hævedes fra 256 til 400 Unicode code units (UTF-16-enheder). Ifølge indlægget gjaldt grænsen den afkodede sti og ikke parametre, og kodede adresser havde ingen grænse; Learn nævner i dag kun grænsen på 400 afkodede tegn (Learn, SharePoint limits). Eksemplet i indlægget er http://www.contoso.com/sites/marketing/documents/Shared%20Documents/Promotion/Some%20File.xlsx, hvor mappestien og filnavnet er hver sin del af adressen. Ifølge Baers svar i kommentarerne i oktober 2017 gjaldt ændringen kun SharePoint Online og OneDrive for Business, ikke SharePoint 2016 eller 2013 on-premises (SharePoint-bloggen, Baer, 9. maj 2017, svar i kommentarerne).
Microsofts side om begrænsninger minder om, at forskellige apps og Office-versioner har hver deres grænser, og at kombinationen kan være særegen for den enkelte opsætning (Microsoft Support).
I en migrering#
Når en OneDrive flyttes fra kilden til Microsoft 365, ændres adressen fra formatet personal/domain_user til brugerens UPN, og stien kan blive længere. Microsoft viser det for OneDrive: en medarbejders mappe hedder Personal/contoso_bobsmith/Documents/... før flytningen og Personal/bobsmith_contoso_com/Documents/... efter, og i begge tilfælde skal serverstien til filen være højst 400 tegn. Vurderingsscanningen Long OneDrive URLs finder de filer, der bliver for lange, og ejerne skal flytte dem op eller slette dem (Learn, Migration Assessment Scan).
Ved Microsofts tenant-til-tenant-flytning, der i øjeblikket kun er for kunder med Enterprise Agreement, lægges kildens sti sammen med målets bruger- eller site-navn, og lange navne kan få migreringen til at fejle. Microsoft anbefaler at forkorte målets bruger- og site-adresser eller flytte filerne højere op (Learn, Cross-tenant SharePoint migration). Kommandoen Find-SPOCrossTenantLongFilePathsForSiteRename undersøger ét site og finder de filstier, der bliver over 400 tegn, når sitet får den nye adresse (-OldSiteUrl og -NewSiteUrl) (Learn). Værktøjerne og de andre forberedelser står i SharePoint Migration Tool, Migration Manager og Mover, Kopier og gammelt indhold før migrering og Flytning af OneDrive og SharePoint mellem tenants.
Tidslinjen#
- Meddelelse
API-ændringer,
ResourcePath - Udrulning
#og%kan tilvælges medSet-SPOTenant - Plan
#og%planlagt slået til for nye tenants - Meddelelse
Stien hæves fra 256 til 400 tegn
- Plan
#og%planlagt slået til for eksisterende tenants uden valg - Meddelelse
Selvhjælp ved ulovlige filnavne i synkroniseringsappen
I månedsnoterne#
# og % står første gang i februar 2017 og igen i april 2017. Grænsen på 400 tegn står i maj 2017, og de ulovlige filnavne i synkroniseringsappen står i april 2019.