Johdanto
Jokaisella Odoo-lomakkeella on kenttiä, ja osa niistä täytetään joka kerta käsin. Monissa tapauksissa lomake voidaan kuitenkin esitäyttää järkevällä aloitusarvolla, jolloin käyttäjä saa heti toimivan lähtökohdan. Oletusarvojärjestelmä on yksinkertainen, mutta sen taustalla on useita tasoja — on hyödyllistä ymmärtää ne, kun suunnittelet yrityksesi lomakkeita ja työnkulkuja.
Olitpa sitten avainkäyttäjä, joka määrittelee kentän Odoo Studion kautta, tai kehittäjä joka opettelee Odoo-kenttien käytön, oletusarvojen tuntemus säästää aikaa ja estää hiljaisia konfiguraatiovirheitä, jotka muuten tulevat esiin vasta myöhemmin.
Tässä oppaassa käydään läpi, mitä oletusarvot tarkoittavat Odoo:ssa, miten ne toimivat ORM-tasolla, milloin kannattaa käyttää staattista tai dynaamista oletusarvoa, ja miten ne voi määrittää joko Studion kautta tai Python-koodilla.
Mikä on oletusarvo Odoo:ssa
Odoo-ORM:ssa oletusarvo tarkoittaa arvoa, joka annetaan kentälle uuden tietueen luonnin yhteydessä ennen käyttäjän syötettä. Se ei sido käyttäjää — kentän arvo on vapaasti muutettavissa. Oletusarvo on tarkoitettu parempaan käyttökokemukseen ja johdonmukaisuuteen, ei rajoitteeksi.
Melkein kaikissa Odoo-kenttätyypeissä voit määrittää oletusarvon: tekstikentät, numerot, valintalistat, päivämäärät, Many2one-suhteet ja niin edelleen. Oletus voi olla kiinteä arvo, Python-lambda tai viittaus metodille — kaikki ovat päteviä tapoja rakentaa oletuksia käyttötapauksen mukaan.
Odoo Studio tarjoaa helpon käyttöliittymän oletusarvojen asettamiseen ilman koodia. Liiketoimintakäyttäjä voi määrittää staattisen oletusarvon suoraan kentän asetuksista, mikä on kätevää tietojen yhdenmukaistamiseen ilman kehittäjän apua.
Tietokantatasolla oletusarvot eivät välttämättä istu suoraan sarakkeen metadataan. Ne voivat olla mallin Python-määrittelyssä tai tallennettuina ir.default-tietueina. Kun uusi tietue luodaan, Odoo lukee sovellettavat oletusarvot ja täyttää lomakkeen ennen kuin käyttäjä näkee sen.
Miten oletusarvot toimivat
Kun käyttäjä avaa uuden lomakkeen, Odoo kutsuu mallin default_get()-metodia. Se kerää kenttien oletusarvot ja palauttaa sanakirjan (dictionary), jossa kenttänimet mapataan arvoihin. Lomake käyttää tätä esitäyttöä käyttäjän tekemien toimenpiteiden sijaan.
Oletusarvoja on käytännössä neljää eri tyyppiä, jotka sopivat eri tilanteisiin.
Staattiset oletusarvot
Staattinen oletusarvo on kiinteä arvo, joka on joko kovakoodattu kenttädefinition tai asetettu Studion kautta. Esimerkiksi Boolean-kenttä voi olla oletuksena True tai valintalistan arvo voi olla 'draft'. Tämä on yksinkertaisin ja yleisimmin riittävä tapa käsitellä monia arkipäivän tarpeita.
Dynaamiset oletusarvot (lambda tai metodi)
Dynaaminen oletus on Python-funktio tai lambda, joka suoritetaan uuden tietueen luonnin yhteydessä. Näin oletusarvo voi perustua nykyiseen päivämäärään, kirjautuneeseen käyttäjään tai muuhun kontekstiin — esimerkiksi asettaa vastuuhenkilöksi sen käyttäjän, joka luo tietueen, tai merkitä dokumentin päivämääräksi tämän päivän.
Seuraavassa esimerkissä näet, miten staattiset ja dynaamiset oletusarvot ilmenevät Python-mallissa noudattaen tavallista Odoo-kehityskäytäntöä:
from odoo import fields, models
class CrmLead(models.Model):
_inherit = 'crm.lead'
# Staattinen oletus
x_priority_level = fields.Selection(
[('low', 'Low'), ('medium', 'Medium'), ('high', 'High')],
string='Priority Level',
default='medium',
)
# Dynaaminen oletus: nykyinen käyttäjä
x_assigned_by = fields.Many2one(
'res.users',
string='Assigned By',
default=lambda self: self.env.user,
)
# Dynaaminen oletus: tämän päivän päivämäärä
x_expected_date = fields.Date(
string='Expected Close Date',
default=lambda self: fields.Date.today(),
)
Kontekstiin perustuvat oletusarvot
Voit myös välittää oletusarvoja toimintojen kontekstissa käyttämällä muotoa default_field_name. Esimerkiksi kun luot uuden tehtävän projektinäkymästä, konteksti usein asettaa projektin kenttään automaattisen oletusarvon. Tämä toimintalogiikka perustuu kontekstin avain-arvo-pareihin, joita voi muokata sekä kehittäjä että kokenut ylläpitäjä.
Käyttäjäkohtaiset oletusarvot (ir.default)
Odoo tukee käyttäjäkohtaisia oletusarvoja ir.default-tietueilla. Ylläpitäjä voi määrittää henkilön oman oletuksen tietylle kentälle ja mallille. Kun kyseinen käyttäjä luo uuden tietueen, tämä henkilökohtainen oletus menee model-tason oletuksen edelle — kätevää silloin, kun eri tiimeillä on erilaiset työskentelytavat.
Prioriteettijärjestys
Kun samaan kenttään kohdistuu useita oletuslähteitä, Odoo ratkoo ne seuraavassa järjestyksessä: ensin käyttäjäkohtaiset ir.default-asetukset, sitten yhtiötason ir.default, ja lopuksi mallin Python-määrittely. Lisäksi runtime-konteksti voi yliajaa model-tason oletuksen. Tämän järjestyksen tunteminen auttaa selvittämään, miksi näyttöön ei tule odotettua arvoa uuden lomakkeen avauksessa.
Liiketoimintatilanteet
Oletusarvoja nähdään lähes kaikissa Odoo-moduuleissa. Alla viisi käytännön esimerkkiä yritysprosesseista.
CRM: oletusmyyjä uusille liideille
Kun myyjä luo uuden liidin, Vastuu-kenttä voi oletuksena olla kirjautunut käyttäjä. Näin liidit eivät jää ilman vastuuhenkilöä, ja myyjät näkevät omat liidinsä heti. Tämä pieni oletus parantaa CRM:n käyttöönottoa ja vähentää manuaalista työtä.
Myynti: oletusehdot myyntitilauksille
Myyntitilauksella hinnasto ja maksuehdot voivat valikoitua automaattisesti asiakkaan asetusten mukaisesti. Asiakas, jolla on Net 30 -maksuehdot, saa nämä automaattisesti täytettynä jokaiseen tilaukseen, mikä vähentää virheitä ja pitää sopimusehdot johdonmukaisina riippumatta siitä, kuka tilauksen luo.
Varasto: oletussijainnit siirroissa
Sisäisissä siirroissa lähde- ja kohdesijainnit täyttyvät varaston asetusten mukaisesti. Varastohenkilökunta, joka työskentelee aina tietyllä alueella, saa oikean sijainnin valittuna heti, mikä säästää klikkauksia ja vähentää kiireessä tapahtuvia virhevalintoja.
Kirjanpito: oletuskirjanpitojärjestelmä kirjanpitomerkinnöille
Kun luodaan lasku tai ostolasku, Odoo valitsee usein oletuksena oikean päiväkirjan yrityksen asetusten perusteella. Tilitoimiston ei tarvitse valita ostolaskun päiväkirjaa joka kerta — oletus haetaan dynaamisesti yrityksen kokoonpanosta, joten se pysyy oikeana myös järjestelmän muutosten jälkeen.
Projekti: oletusvaihe uusille tehtäville
Uusi tehtävä aloittaa projektin kanbanin ensimmäisestä vaiheesta. Jos tehtävä avataan tietyn projektinäkymästä, konteksti voi myös esitäyttää projektin ja jopa vastuuhenkilön. Tämä pitää tehtävät heti oikeassa paikassa ilman erillisiä manuaalisia vaiheita.
Oletusarvojen luominen ja muokkaaminen
Oletusarvojen asettamiseen on kolme päämetodia: Studion kautta ilman koodia, Python-malliarkkitehtuurissa, tai ir.default-tietueiden kautta asennusprosessissa.
Odoo Studiolla (ei koodia)
Studio tarjoaa visuaalisen tavan asettaa oletusarvoja lomakkeiden kentille. Näin voit tehdä muutoksen nopeasti ilman kehittäjää.
- Avaa Studio haluamassasi lomakkeessa
- Valitse kenttä, jota haluat muokata
- Kenttäasetuksissa oikealla löydät kentän oletusarvo-kentän
- Syötä tai valitse haluamasi oletusarvo
- Tallenna ja poistu Studiosta
Studio tallentaa asetuksen ir.default-tietueena, ja se vaikuttaa koko yritykseen ellei sitä rajoiteta käyttäjäkohtaisesti. Tämä sopii erinomaisesti staattisiksi oletuksiksi valinta-, kyllä/ei-, tekstija numerokentille. Many2one-kentissä voit valita olemassa olevan tietueen alasvetovalikosta. Studio on käytännöllinen tapa luoda kenttiä ja asettaa oletuksia ilman ohjelmointia.
Muista, että Studion kautta tehty oletusarvon muutos ei muokkaa jo olemassa olevia tietueita — uusi oletus koskee vain sen jälkeen luotavia tietueita.
Pythonissa tekninen muokkaus
Teknisissä muutoksissa oletusarvot määritellään suoraan kenttädefinition yhteydessä Python-mallissa. Tämä antaa täyden hallinnan staattisiin arvoihin, lambda-funktioihin ja metodipohjaisiin oletuksiin — erityisesti kun oletus perustuu ajohetken tietoon kuten käyttäjään tai yritykseen.
Seuraava esimerkki havainnollistaa useita oletustyyppejä räätälöidyssä moduulissa:
from odoo import fields, models
class SaleOrder(models.Model):
_inherit = 'sale.order'
# Staattinen boolean-oletus
x_requires_review = fields.Boolean(
string='Requires Review',
default=False,
)
# Staattinen valintalista-oletus
x_delivery_preference = fields.Selection(
[('standard', 'Standard'), ('express', 'Express')],
string='Delivery Preference',
default='standard',
)
# Dynaaminen oletus metodin avulla
def _default_note(self):
return self.env['ir.config_parameter'].sudo().get_param(
'sale.default_note', default=''
)
x_internal_note = fields.Text(
string='Internal Note',
default=_default_note,
)
Tämä malli noudattaa Odoon konventioita ja toimii kaikissa kenttätyypeissä. Metodiin perustuva oletus on hyödyllinen, kun logiikka on liian monimutkainen yksittäiselle lambdalle.
Ohjelmallinen ir.default-muokkaus
Voit myös luoda tai päivittää ir.default-tietueita ohjelmallisesti XML-RPC:n kautta tai moduulin data-tiedostossa. Tämä on käyttökelpoinen tapa toimittaa oletuskonfiguraatio osana räätälöidyn moduulin asennusta, ja ir.default -tietueeseen voi liittää mallin nimen, kentän nimen, arvon sekä tarvittaessa yritys- tai käyttäjäkohtaisen laajuuden.
Tätä lähestymistapaa käytetään harvemmin päivittäisessä kehityksessä, mutta se on hyödyllinen asennettavien moduulien mukana toimitettavissa asetuksissa.
Hyvät käytännöt oletusarvoille Odoo:ssa
Aseta oletusarvot pakollisille kentille
Jos kenttä on pakollinen, anna sille järkevä oletusarvo aina kun mahdollista. Näin vältät tallennusvirheet ja vähennät käyttäjän ärsytystä lomakkeen yhteydessä. Yhdistä required=True käytännölliseen oletusarvoon, jos kenttä täytyy aina täyttää.
Käytä lambdaa päivämäärien oletusarvoissa
Älä kovakoodaa päivämääriä oletukseksi. Käytä lambda self: fields.Date.today(), jotta oletus on aina kyseisen hetken päivämäärä. Kovakoodattu päivämäärä vanhenee nopeasti ja johtaa virheellisiin tietoihin.
Pidä oletuslogiikka kevyeenä
Oletusfunktiot ajetaan aina uuden lomakkeen avauksessa, joten vältä raskaita tietokantakyselyjä, ulkoisia API-kutsuja tai monimutkaisia laskelmia oletus-metodeissa. Pidä ne nopeina ja yksinkertaisina. Jos tarvitaan monimutkaisempaa käsittelyä, harkitse onchange- tai compute-kenttää.
Käytä kontekstin oletuksia navigointivirtoihin
Kun rakennat mukautettuja toimintoja tai painikkeita, jotka avaavat uuden lomakkeen, lähetä default_field_name-arvot kontekstissa. Näin mukautukset käyttäytyvät samoin kuin Odoon omat toiminnot ja pidät sovelluksen yhtenäisenä.
Testaa oletuksia eri käyttäjäprofiileilla
Dynaamiset oletukset, jotka viittaavat self.env.user tai self.env.company, käyttäytyvät eri tavalla eri käyttäjillä. Testaa vähintään kahdella käyttäjätilillä ja tarvittaessa eri yrityskonfiguraatioilla, jotta löydät yllätyksettömät erot adminin ja normaali käyttäjän välillä.
Yleiset sudenkuopat
Muuttuvan olion käyttäminen oletuksena
Älä aseta default=[] tai default={} suoraan — Python jakaa saman objektin kaikille instansseille, mikä aiheuttaa datan sekoittumista. Käytä lambdaa: default=lambda self: [], niin saat uuden listan joka kerta, kun tietue alustetaan.
Oletusarvot eivät laukaise onchange-tapahtumia
Kun kenttä saa oletusarvon, se ei käynnistä onchange-metodeja. Jos lomakkeessa on onchange-logiikkaa, oletusarvo vain täyttää kentän — mutta mahdolliset johdannaispäivitykset eivät tapahdu automaattisesti. Tarvittaessa aja onchange-logiikka manuaalisesti default_get-ylikirjoituksessa tai muulla ratkaisulla.
Ristiriidat ir.defaultin ja mallin oletuksen välillä
Jos sama oletus on määritelty sekä Pythonissa että ir.default:ssä (esim. Studio-muutos), ir.default voittaa. Tämä aiheuttaa usein hämmennystä, kun odotettu arvo ei näy — tarkista aina, onko joku käyttänyt Studion kautta tallennettua oletusta yliajamassa koodin määritystä.
Oletusarvon ei pidä korvata vaatimusta
Oletusarvo ei tee kentästä pakollista: käyttäjä voi tyhjentää kentän ja tallentaa sen tyhjänä. Jos kenttä pitää aina olla täytettynä, käytä lisäksi required=True.
Yrityksen tai käyttäjän tietue-ID:n kovakoodaus
Älä käytä kovakoodattuja ID-arvoja kuten default=1 viitatessasi yritykseen tai käyttäjään — se rikkoutuu eri ympäristöissä. Käytä dynaamisia viittauksia, esimerkiksi lambda self: self.env.company.id tai lambda self: self.env.ref('module.xml_id').id.
Yhteenveto
Oletusarvot ovat pieni mutta tehokas osa Odoon tietomallia: ne vähentävät manuaalista syöttöä, ohjaavat käyttäjiä valitsemaan yhdenmukaisesti ja tekevät lomakkeista miellyttävämpiä käyttää. Olipa kyse nopeasta Studion muutoksesta tai koodipohjaisesta räätälöinnistä, oletusarvojen ymmärtäminen parantaa Odoo-ratkaisun toimivuutta.
Tärkeimmät muistettavat asiat: oletusarvot ajautuvat vain tietueen luontivaiheessa; ne eivät laukaise onchange-metodeja; useat oletuslähteet ratkaistaan määritellyn prioriteetin mukaan; ja muuttuvat objektit tulee aina luoda lambda-funktiolla oletuksia varten.
Oikein määritellyt oletusarvot erottavat intuitiivisen lomakkeen sellaisesta, joka hidastaa käyttäjiä. Pieni panostus oletuksiin säästää aikaa ja parantaa käyttäjäkokemusta päivittäisessä käytössä.
Me Dasololla autamme yrityksiä ottamaan Odoo:n käyttöön, räätälöimään sitä ja optimoimaan työnkulkuja. Jos tarvitsette apua kenttäoletusten määrittelyssä, uusien kenttien rakentamisessa tai toimivan tietomallin suunnittelussa, autamme mielellämme. Ota yhteyttä ja jutellaan teidän Odoo-projektista.