Innledning
Har du noen gang lastet opp et produktbilde, lagt inn firmalogoen eller satt et profilbilde på en ansatt i Odoo? Da har du brukt et Image-felt. Dette er feltet som gjør informasjonen visuelt gjenkjennelig i systemet, og det dukker opp i flere moduler enn mange tror.
For sluttbrukere virker det ofte sømløst: trykk, velg fil, bildet vises. For konsulenter og utviklere ligger det imidlertid flere tekniske detaljer bak — egen lagringslogikk, automatisk skalering og små adferdsspesifikke nyanser som er nyttige å kjenne til før du legger inn egne bilde-felter i modeller.
Denne veiledningen forklarer hva Image-feltet lagrer, hvordan Odoo håndterer bildene, hvordan du legger det til enten via Studio eller kode, og konkrete bruksområder fra typiske forretningsprosesser.
Hva er Image-feltet i Odoo
Image-feltet er en egen felttype i Odoos ORM (definert som fields.Image siden Odoo 13). Tidligere brukte man gjerne fields.Binary sammen med et image-widget. I moderne versjoner håndterer Image-feltet hele livssyklusen for bilder — fra opplasting til skalering og visning — uten ekstra triks.
Teknisk sett lagres bildet som binær data (base64). I praksis ender ofte innholdet opp som en vedleggspost i ir.attachment i stedet for å fylle hovedtabellene med store binærkolonner. Dette holder hoveddatabasen mer kompakt og gjør at Odoo kan servere bildene effektivt via vedleggs-URL-er.
Slik vises det i brukergrensesnittet
I et skjema vises Image-feltet vanligvis som en klikkbar forhåndsvisning. Brukere kan laste opp fra fil eller i noen tilfeller lime inn lenker. Feltet gir ofte en thumbnail direkte i skjemaet, noe som gjør det raskt å få oversikt.
I listevisninger er bilder sjeldnere brukt fordi miniatyrer kan bremse lasting. De er derimot nyttige i kanban-visninger, der små kort drar stor nytte av visuelle markører som produktbilder eller kontakt-avatarer.
Image versus Binary i Odoo
Skill mellom Binary og Image: Binary kan lagre alle filtyper (PDF, regneark, arkiver), mens Image er spesialtilpasset for bilder. Image utfører validering og automatisk skalering, og vises riktig med image-widgeten. Har du ikke-bilde-filer, bruk Binary; for bilder og logoer, bruk Image.
Hvordan feltet fungerer
Når et bilde lastes opp til et Image-felt, lagrer Odoo ikke bare den opprinnelige filen uten videre — bildet blir behandlet først.
Automatisk skalering
fields.Image tar parametere som max_width og max_height. Overskrider opplastet fil disse dimensjonene, skalerer Odoo bildet ned mens forholdet mellom bredde og høyde beholdes. Dette skjer automatisk ved lagring, så brukeren slipper å tenke på piksler.
Standard maksstørrelse for et vanlig Image-felt er 1920 piksler på den lengste siden. Derfor vil du ofte se feltnavn som image_1920 på standardmodeller som product.template eller res.partner.
Størrelsesvarianter av bilder
På standardmodeller følger det ofte flere relaterte bilde-felt: image_1920, image_1024, image_512, image_256 og image_128. Disse er egne fields.Image som relaterer tilbake til hovedbildet og har forskjellige maksbegrensninger.
Tanken er å levere riktig størrelse etter kontekst: produktlister henter små thumbnails for rask lasting, mens produktsider kan vise full oppløsning. I egne modeller vurderer du om flere varianter er nødvendig basert på hvor bildene skal vises.
Lagring som vedlegg
Som regel lagres Image-felt som vedlegg (ir.attachment). Feltet på posten holder referansen, mens selve binærinnholdet ligger i vedleggs-modellen.
Dette holder hovedtabellene lettere og gir forutsigbare URL-mønstre som /web/image/product.template/42/image_1920 — nyttig når du bygger nettsider, e-postmaler eller API-responser.
Tilgangskontroll
Bildene følger samme tilgangsregler som resten av posten. Hvis en bruker ikke har lesetilgang til en produktpost, får vedkommende heller ikke tilgang til bildet. Dette håndteres av Odoos sikkerhetslag og bør tenkes gjennom ved bygging av publikumssider og kundeportaler.
Forretningsscenarier
Hvor brukes Image-felt i praksis? Her er de mest vanlige bruksområdene.
1. Produktkatalog (Salg og Lager)
Produktbilder er sannsynligvis det mest synlige eksempelet. Produktmaler har gjerne et image_1920-felt, og bildene vises i nettbutikk, salgspapirer, POS-skjermer og på plukklister i mobile apper.
Bedrifter med store varekataloger foretrekker ofte å laste opp bilder i bulk via API fremfor manuelt i grensesnittet. Image-feltet aksepterer base64-binærdata, noe som gjør automatisert opplasting via XML-RPC eller JSON-RPC enkelt.
2. Kunders og leverandørers logoer (CRM og Innkjøp)
res.partner har et Image-felt for kontaktbilder og firmasignaturer. Disse vises i partner-skjemaet, i chatteren og i CRM-kanban. Logoer gjør det enklere for salgsteam å kjenne igjen kunder ved første øyekast.
3. Ansattbilder (HR)
hr.employee lagrer profilbilder som vises i personalregisteret, og i noen oppsett også på lønnsslipper eller i diskusjonsmodulen ved meldinger. HR-team laster ofte inn mange bilder ved onboarding gjennom bulkimport eller API.
4. Maskiner og utstyr (Vedlikehold)
I vedlikeholdsmodulen kan teknikerne knytte bilder til utstyrsposter. Et bilde på arbeidsordren hjelper feltpersonell å bekrefte at de jobber på riktig maskin før reparasjon starter.
5. Inspeksjons- og kvalitetsskjemaer
Feltpersonell bruker ofte tilpassede modeller for inspeksjoner, leveringsbekreftelser eller kvalitetskontroll. Et Image-felt gir mulighet til å dokumentere funn med et bilde direkte på posten — en vanlig tilpasning som fungerer både via Studio og kode.
Legge til eller tilpasse feltet
To måter å legge til Image-felt på: uten kode via Odoo Studio, eller med kode i Python for mer kontroll.
Bruke Odoo Studio
Studio er Odoos innebygde verktøy for uten-kode-tilpasninger. Aktiver Studio i toppen av appen og åpne skjemaet der du ønsker feltet.
Dra et Image-felt fra panelen og plasser det i skjemaet. Studio spør om etikett og oppretter feltet på modellen automatisk — en enklere vei for funksjonelle konsulenter og sluttbrukere uten utviklerhjelp.
Studio-felter får gjerne prefikset x_studio_, for eksempel x_studio_site_photo, og oppfører seg som vanlige Image-felt både i lagring og visning.
Bruke Python (utvikling)
For mer avanserte løsninger definerer du Image-felt i en Python-modell. Dette gir full kontroll over parametre og relasjoner.
Eksempel på hvordan et utviklerdefinert Image-felt kan se ut i modellen:
I eksempelet oppgir max_width og max_height på 1920 piksel for hovedbildet. photo_128 er et relatert felt som lagrer en liten versjon for bruk i kanban eller listene — en vanlig utviklerpraksis for å håndtere flere bildestørrelser per post.
Legge feltet i en visning
Feltet må legges inn i et skjema for å være synlig. I XML-visninger bruker du widget="image" for korrekt rendering.
Et typisk felt-tag i en form kan se slik ut:
Klassen oe_avatar gjør bildet rundt i hjørnet som en avatar — standard stil i Odoo — men du kan også plassere bildet inline uten denne klassen avhengig av ønsket layout.
Gode rutiner
Anbefalinger vi gir kunder om Image-felt i Odoo
Sett realistiske størrelsegrenser
1920-pikslers standardgrense er nok for de fleste. Øk kun ved reelle behov, som bilder for trykk i høy oppløsning. Større bilder gir større vedlegg, som påvirker databaseplass og innlastingstid.
Lag en thumbnail for lister og kanban
Viser du bilder i lister eller kanban, opprett et eget lite felt på 128 eller 256 piksler. Å hente en 128-pikslers thumbnail er langt raskere enn å laste fullstørrelse for hver kort på skjermen.
Bruk API ved bulkopplastning
For hundrevis eller tusenvis av bilder bør du bruke XML-RPC/JSON-RPC og sende base64-data automatisk. Dette er mye raskere enn å laste opp manuelt via UI, og lett å automatisere i skript.
Komprimer før opplasting
Selv om Odoo skalerer bilder, komprimerer det ikke alltid maksimalt. En stor JPEG kan fortsatt bli flere hundre KB etter skalering. For store kataloger er det smart å redusere filstørrelsen før opplasting.
Unngå bilder i ofte spurte listevisninger
Å vise et Image-felt i en list-kolonne gjør at Odoo må hente binærdata for hver rad, noe som kan bremse visningen. Bruk små thumbnails i listene og behold full størrelse i skjemaet.
Vanlige fallgruver
De vanligste feilene vi ser rundt Image-felt
Forveksling av Binary og Image
Et Binary-felt uten image-widget vil vises som en nedlastingsknapp, ikke som en forhåndsvisning. For å få korrekt bildevisning må du bruke fields.Image eller sette widget="image" i visningen for et Binary-felt. Dette misforholdet skaper ofte forvirring.
Ikke planlegge bildestørrelsesvarianter tidlig nok
Å starte med kun ett stort Image-felt kan være tilstrekkelig i starten, men hvis du senere trenger mindre varianter for kanban eller nettsider, krever det ofte migrering i en custom-modul. Planlegg varianter fra begynnelsen for å unngå etterarbeid.
Lagre bilder direkte i tabellen i stedet for som vedlegg
I eldre eller feilkonfigurerte installasjoner kan binærdata ende opp direkte i hovedtabellene. Det blåser opp størrelse og gjør spørringer tregere. Sørg for at vedleggsoppsett (lokal fil, S3 osv.) er korrekt konfigurert.
Bruke Image-felt som dokumentlagring
Noen forsøker å bruke Image-felt til skannede dokumenter eller fler-siders filer. Selv om det fungerer, er det ikke riktig verktøy. Bruk Documents-modulen eller Binary-felt med nedlastings-widget for dokumenthåndtering — Image-felt er laget for bilder og logoer.
Glemme tilgangsregler på offentlige sider
Vises et bilde på en offentlig nettside men posten ikke er tilgjengelig for publikum, vil bildet gi 404. Når du bygger nettsider eller portaler, dobbeltsjekk at tilgangsreglene tillater ønsket publikum å se bildet.
Oppsummering
Image-feltet er lett å ta i bruk, men kan by på problemer hvis man ikke planlegger for lagring, skalering og variantbehov. Kjennskap til disse aspektene sparer tid både for funksjonelle team og utviklere.
For forretningsbrukere betyr det trygghet å vite at bilder er lagret riktig og leveres via forutsigbare URL-er. For utviklere er patternet med fields.Image kombinert med relaterte thumbnail-felt en god praksis å mestre tidlig i Odoo-utvikling.
Enten du legger inn produktbilder, dokumenterer inspeksjoner eller bygger en portal som viser kundelogoer, gir Image-feltet et integrert og ryddig rammeverk for visuelle data i Odoo.
Trenger du hjelp med Odoo-implementasjonen din?
Hos Dasolo hjelper vi bedrifter med implementasjon, tilpasning og optimalisering av Odoo på tvers av moduler og versjoner. Enten det handler om å konfigurere standardfelt, utvikle skreddersydde moduler eller migrere data fra eldre systemer, jobber vi tett med dere for å få Odoo til å fungere slik virksomheten virkelig trenger.
Har du spørsmål om ditt Odoo-oppsett eller ønsker å utforske mulighetene plattformen gir, ta kontakt med ossså hjelper vi gjerne.