Krav til navngiving av vedleggsfiler

Owned by Tor Oskar Ova Johnsen
Last updated: 08.03.2023 by Veslemøy Søbak
2 min read

Tillatte tegn

Det har blitt ønsket en oversikt over hvilke tegn som ikke kan brukes i navngivning av filer som legges ved innsendinger gjennom Fellestjenester BYGG.

Altinn krever at navngivning av filer skal følge Microsoft Windows file naming conventions: https://docs.microsoft.com/en-us/windows/desktop/fileio/naming-a-file#naming-conventions

Kort oppsummert betyr det at alle tegn som er i "code page" dere bruker, inkl. unicode tegn, kan brukes bortsett fra:

  • < (mindre enn)

  • > (større enn)

  • : (kolon)

  • " (anførselstegn)

  • / (forover skråstrek)

  • \ (bakover skråstrek)

  • | (vertikal strek/"pipe")

  • ? (spørsmålstegn)

  • * (stjerne)

Punktum (".") kan kun brukes til å "hekte på file extension" (suffiks).
Ikke bruk tegn med ASCII-verdi 0 eller mellom 1 og 31.

Her er oversikt over hvilke filtyper, hvilke suffiks, som kan brukes i hvilke innsendinger: FtB tjenesteoppsett i produksjon

Lange filnavn

SvarUt støtter filnavn med en maksimal lengde på 226 tegn. Filnavnet sendt fra Fellestjenester BYGG til SvarUt består av to elementer:

  1. Filnavnet vi får fra søknadssystemet

  2. Metadata som FtB arbeidsflyt legger på til eByggesak (opptil ca. 46 tegn, men kan endre seg etter som vi legger på metadata om nye vedlegg og underskjema)

Om filnavnet sendt fra søknadssystemet + metadata fra FtB overstiger 226 tegn, blir hele søknaden avvist i SvarUt og får status ‘Feil’.

Filer sendt til Fellestjenester BYGG skal derfor ikke være mer enn 180 tegn, gjerne mindre, for å være på den sikre siden. Ved utsendelse til FIKS forsikrer vi oss om at vi ikke overstiger KS sin grense for filnavnlengde ved å slette tegn fra filnavnet bakfra. Vi beholder extension slik at filtypen er ivaretatt, som vist i figuren. Dette gjør at en kan differensiere på filer med samme navn.

I neste versjon av validerings-API-et legger vi på validering for å forhindre for lange filnavn, men inntil videre må søknadssystemene sørge for dette selv.

Streaming av vedlegg

Opplasting av vedlegg til Altinn gjøres ved bruk av streaming-API-et. Her er det viktig at filnavnet URL-enkodes da det er en del av URL-en til API-et. Se for mer informasjon: REST API streaming attachments

Les mer

Filnavnformat i FIKS SvarUt mottak