Krav til navngiving av vedleggsfiler

Tillatte tegn

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

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:

Filnavnet vi får fra søknadssystemet
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 maks filnavn grense ved å slette tegn fra filnavnet bakfra, men beholder extension slik at filtypen er ivaretatt slik som vist i figuren.

I neste versjon av validerings-APIet 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 streamingAPIet. Her er det viktig at filnavnet URL-enkodes da det er en del av URLen til APIet. Se for mer informasjon: REST API streaming attachments