Introduktion
Om du någonsin har sparat ett formulär i Odoo och sett ett fält bli rött, har du redan stött på obligatoriska fält-mekanismen. Det är en av de mest grundläggande funktionerna i Odoo-datamodellen och ett av de enklaste sätten att säkerställa datakvalitet i dina affärsarbetsflöden.
Oavsett om du konfigurerar Odoo för ett säljteam, sätter upp en anpassad modell eller arbetar med ett tekniskt Odoo-utvecklingsprojekt, kommer förståelsen för hur required-attributet fungerar att hjälpa dig att bygga mer pålitliga processer.
Denna guide täcker allt: hur fältet beter sig i Odoo-ramverket, hur man konfigurerar det med Odoo Studio eller Python-kod, när man ska använda det och vilka misstag man ska se upp för.
Vad är det obligatoriska fältet i Odoo
I Odoo är required-attributet en fältbaserad begränsning som förhindrar att en post sparas om inte fältet innehåller ett värde. Det gäller praktiskt taget alla odoo-fälttyper: textfält, numeriska fält, urvalsfält, many2one-fält, datum och mer.
Det är en del av den grundläggande odoo-datamodellen och är ett av de mest använda attributen vid anpassning av odoo. Att ställa in ett fält som obligatoriskt är det första försvaret mot ofullständig eller inkonsekvent data i din databas.
Hur det visas i gränssnittet
I Odoo-användargränssnittet särskiljs obligatoriska fält visuellt från valfria. När ett formulär är i redigeringsläge visar obligatoriska fält vanligtvis en subtil visuell indikator. När en användare försöker spara posten utan att fylla i ett obligatoriskt fält, markerar Odoo fältet i rött och visar ett varningsmeddelande.
Detta beteende är konsekvent över webbgränssnittet. Användare får omedelbar, tydlig feedback, vilket minskar risken för att skicka ofullständiga poster.
Statisk vs. Dynamisk Obligatorisk
Det finns två sätt att göra ett fält obligatoriskt i Odoo. Det första är en statisk obligatorisk: fältet är alltid obligatoriskt, oavsett vad. Det andra är en dynamisk obligatorisk: fältet blir obligatoriskt endast när vissa villkor är uppfyllda, baserat på värdena i andra fält på samma post.
Båda metoderna används regelbundet i odoo-utveckling. Valet beror på din affärslogik.
Hur fältet fungerar
Att förstå hur required-attributet fungerar på en teknisk nivå hjälper dig att tillämpa det korrekt och felsöka problem när de uppstår.
Applikationsnivå Tillämpning
En viktig detalj som överraskar många Odoo-användare: required-attributet tillämpas på applikationsnivå, inte på databasnivå. Detta innebär att begränsningen kontrolleras av Odoo ORM när en post skapas eller skrivs, innan datan når databasen.
Det finns ingen NOT NULL-begränsning som läggs till den underliggande PostgreSQL-kolumnen som standard när du ställer in required=True på ett fält. Valideringen sker i Python, inuti odoo orm-lagret.
I praktiken betyder detta att data som sätts in direkt i databasen (utan att gå via Odoo) inte kommer att fångas av den obligatoriska begränsningen. Interagera alltid med dina Odoo-databasfält genom ORM eller API för att dra nytta av detta skydd.
Vad händer när begränsningen bryts
När en användare försöker spara ett formulär med ett obligatoriskt fält som lämnas tomt, händer två saker:
- Fältet blir rött i gränssnittet, och Odoo visar ett valideringsmeddelande
- Sparandet blockeras tills fältet är ifyllt
Om du utlöser valideringen programmässigt (till exempel via XML-RPC API eller en serveråtgärd), höjer Odoo ett ValidationError med ett meddelande som anger vilket obligatoriskt fält som saknas.
Dynamiskt obligatoriskt med hjälp av domäner
I Odoo-ramverket kan required-attributet göras villkorligt med hjälp av uttryck på vy-nivå. I Odoo 16 och tidigare görs detta med attrs-attributet i vy-XML:
<field name="x_delivery_date" attrs="{'required': [('order_type', '=', 'delivery')]}" />I Odoo 17 och senare förenklas syntaxen med ett direkt required-uttryck på fält-taggen i vyn:
<field name="x_delivery_date" required="order_type == 'delivery'" />Dessa villkorliga regler finns i vy-lagret, inte i modellagret. Detta är en viktig distinktion: modellnivåns required=True upprätthåller alltid begränsningen, medan uttryck på vy-nivå endast tillämpas i specifika gränssnittssammanhang.
Interaktion med ORM och API
I Odoo ORM, när du anropar create() eller write() på en modell, kontrollerar ORM alla fält med required=True innan databasoperationen utförs. Om ett obligatoriskt fält saknas eller är inställt på False, kastar Odoo ett ValidationError.
Detta gäller också när du skapar poster via XML-RPC API. Alla fält som är markerade som obligatoriska i modellens definition måste anges i datadictionaryn som skickas till create-metoden, annars misslyckas anropet med ett fel.
Affärsanvändningsfall
Obligatoriska fält förekommer genom hela standard Odoo, och de är lika användbara i anpassade konfigurationer. Här är fem konkreta exempel från verkliga affärsarbetsflöden där det gör en verklig skillnad att göra ett fält obligatoriskt.
1. CRM: Kundsegment Obligatoriskt på Leads
Ett säljteam vill säkerställa att varje lead tilldelas ett kundsegment innan det flyttas till pipeline. Utan ett obligatoriskt fält hoppar säljrepresentanter ofta över detta steg, vilket gör det omöjligt att rapportera om leadkällor efter segment senare.
Genom att markera ett anpassat "Kundsegment" urvalsfält som obligatoriskt på CRM-leadformuläret säkerställer teamet att datan alltid fångas vid inmatningspunkten. Inget segment, ingen sparande.
2. Försäljning: Leveransadress Obligatorisk på Beställningar
För företag som skickar fysiska varor är leveransadressen kritisk. I vissa Odoo-konfigurationer är leveransadressfältet inte obligatoriskt som standard, vilket innebär att beställningar kan bekräftas utan en.
Att göra leveransadressfältet obligatoriskt på försäljningsorderformuläret förhindrar att beställningen bekräftas innan logistikteamet har den information de behöver. Detta eliminerar en vanlig källa till fel i uppfyllnadsprocessen.
3. Lager: Partinummer eller Serienummer Obligatoriskt vid Mottagning
För företag som verkar inom reglerade industrier (livsmedel, läkemedel, elektronik) är spårning av partinummer på mottagna varor inte valfritt. Odoo stöder detta nativt genom spårningsinställningen på produkter, vilket effektivt genomdriver ett obligatoriskt partinummer eller serienummer under lagerflyttningar.
För anpassade fält på kvittosformulär, som en kvalitetskontrollreferens, säkerställer det att fältet är obligatoriskt att lagret aldrig glömmer att logga informationen under mottagningsprocessen.
4. Redovisning: Kostnadsställe Obligatoriskt på Leverantörsfakturor
Finansavdelningar behöver ofta att varje utgift tilldelas ett kostnadsställe för budgetuppföljning. Utan påtryckningar kan redovisningsekonomer eller inköpschefer lämna fältet tomt, vilket skapar luckor i den finansiella rapporteringen.
Ett obligatoriskt many2one-fält som pekar på kostnadsställemodellen, tillagt till leverantörsfakturaformuläret, säkerställer att ingen faktura kan registreras utan denna tilldelning. Denna typ av Odoo-anpassning är snabb att implementera och har en direkt påverkan på datakompletthet.
5. HR: Anställningstyp Obligatorisk Innan Onboarding
HR-team som hanterar anställdas onboarding i Odoo vill ofta säkerställa att anställningstypen registreras innan anställdas posten slutförs. Ett obligatoriskt fält på anställdas formulär förhindrar att HR-teamet av misstag sparar en ofullständig anställdspost under en hektisk onboardingperiod.
Skapa eller anpassa fältet
Det finns två huvudsakliga sätt att markera ett fält som obligatoriskt i Odoo: använda Odoo Studio för en kodfri metod, eller skriva Python-kod för full kontroll. Båda är giltiga beroende på din kontext.
Använda Odoo Studio
Odoo Studio är det inbyggda kodfria verktyget som låter dig konfigurera fält utan någon utveckling. När du öppnar Studio och väljer ett fält på ett formulär, kommer du att se en "Obligatorisk"-växel i fältets egenskapspanel till höger.
Att aktivera denna växel markerar fältet som obligatoriskt i vyn och lagrar begränsningen på modellnivå. Detta är det snabbaste tillvägagångssättet för enkla fall och kräver ingen teknisk kunskap. Det fungerar bra för både standard Odoo-fält och anpassade fält som lagts till genom Odoo Studio-fält.
Begränsningen med Studio är att det endast konfigurerar en statisk obligatorisk begränsning. För dynamiskt obligatoriskt beteende baserat på andra fältvärden, behöver du redigera vy-XML direkt eller använda den tekniska metoden.
Teknisk metod: Python-fält
I en anpassad Odoo-modul är det så enkelt att deklarera ett obligatoriskt fält som att lägga till required=True i fältdefinitionen. Detta är det standardmönster som används i utvecklingen av Odoo Python-fält:
from odoo import fields, models
class SaleOrder(models.Model):
_inherit = 'sale.order'
x_customer_segment = fields.Selection(
selection=[
('smb', 'SMB'),
('enterprise', 'Enterprise'),
('public', 'Public Sector'),
],
string='Customer Segment',
required=True,
)
x_cost_center_id = fields.Many2one(
comodel_name='account.analytic.account',
string='Cost Center',
required=True,
)Med detta tillvägagångssätt upprätthålls begränsningen på modellnivå, vilket innebär att den gäller oavsett vilken vy eller gränssnitt som används för att skapa posten. Den kan inte kringgås genom att komma åt posten via en annan vy.
Dynamiskt Obligatoriskt i Vy XML
När den obligatoriska begränsningen endast ska gälla under vissa förhållanden, lägg till den på vy-nivå snarare än modellnivå. I Odoo 16:
<field name="x_cost_center_id"
attrs="{'required': [('order_type', '=', 'invoiced')]}" />I Odoo 17:
<field name="x_cost_center_id"
required="order_type == 'invoiced'" />Detta är en vy-endast begränsning. Den är mindre strikt än en obligatorisk på modellnivå, eftersom den endast gäller när posten redigeras genom den specifika vy som innehåller denna definition.
Skapa Obligatoriska Fält via API
Om du använder XML-RPC API för att skapa fält (som täcks i andra artiklar i Odoo Data & API-samlingen), kan du ställa in required när du anropar create på ir.model.fields. Detta är en del av den standard Odoo utvecklarhandboken för programmatisk anpassning:
models.execute_kw(ODOO_DB, uid, ODOO_API_KEY,
'ir.model.fields', 'create',
[{
'name': 'x_customer_segment',
'field_description': 'Customer Segment',
'model_id': model_id,
'ttype': 'selection',
'selection': "[('smb', 'SMB'), ('enterprise', 'Enterprise')]",
'required': True,
'state': 'manual',
}]
)Detta skapar fältet och upprätthåller den nödvändiga begränsningen i ett steg, vilket är användbart i automatiserade distributionsarbetsflöden för skapa fält odoo-scenarier.
Bästa praxis
Att markera ett fält som obligatoriskt verkar enkelt, men att använda det väl kräver eftertanke. Här är de metoder som sparar tid och förhindrar frustration för dina användare.
1. Gör endast fält obligatoriska när de verkligen är det
Att överkräva fält är ett av de vanligaste konfigurationsmisstagen i Odoo. Om en användare inte kan slutföra ett formulär eftersom ett fält är obligatoriskt men informationen ännu inte är tillgänglig, kommer de att hitta lösningar (som att ange platshållarvärden) som korruptar dina data.
Innan du markerar ett fält som obligatoriskt, fråga: är denna information alltid tillgänglig vid inmatningstillfället? Om svaret inte är ett klart ja, överväg att göra det obligatoriskt vid ett senare tillfälle (till exempel vid bekräftelse snarare än vid skapande) eller använd en dynamisk obligatorisk istället.
2. Använd steg-baserad validering istället för alltid-obligatorisk
För arbetsflöden med flera steg, som en CRM-möjlighet eller en tillverkningsorder, är det ofta bättre att upprätthålla obligatoriska fält vid specifika steg snarare än från början. Detta görs vanligtvis genom Python-begränsningar eller automatiserade åtgärder som kontrollerar fältvärden när posten flyttas till ett givet steg.
Detta mönster är mer flexibelt och användarvänligt än att göra varje fält obligatoriskt från dag ett.
3. Para obligatoriska fält med standardvärden där det är rimligt
Om ett fält är obligatoriskt och har ett rimligt standardvärde för de flesta fall, ställ in en default på fältdefinitionen. Detta minskar friktionen för användare som inte behöver ändra standarden, samtidigt som det säkerställer att fältet aldrig är tomt.
4. Föredra modellnivå-obligatoriska för kritisk data
För data som verkligen är kritisk (som bokföringsinformation, regulatoriska identifierare eller obligatoriska identifierare), upprätthåll begränsningen på modellnivå i Python snarare än endast på vy-nivå. Vy-nivå obligatoriska begränsningar kan kringgås om en post skapas genom API:et eller en annan vy som inte inkluderar begränsningen.
5. Kommunicera Nödvändiga Fält till Slutanvändare
När du lägger till nya nödvändiga fält i befintliga formulär kan användare som är mitt i arbetsflödet bli överraskade. Kommunicera förändringar till ditt team innan du implementerar, särskilt om befintliga poster kan misslyckas med validering vid nästa redigering.
6. Testa med Tomma och Delvisa Data
Innan du implementerar en konfiguration med nya nödvändiga fält, testa alltid hela arbetsflödet med tomma värden och delvis data. Detta inkluderar testning via webbgränssnittet, via API:et och via alla automatiserade åtgärder eller integrationer som skapar poster i Odoo. Detta är ett grundläggande steg i varje ansvarsfull Odoo-teknisk handledning.
Vanliga fallgropar
Även erfarna Odoo-implementerare stöter på problem med nödvändiga fält. Att veta vad man ska se upp för kommer att spara tid vid felsökning och förhindra smärtsamma återställningar.
Fälla 1: Göra ett Fält Nödvändigt på en Modell som Redan Har Poster
Om du lägger till required=True till ett fält på en modell som redan innehåller tusentals poster, och dessa poster inte har ett värde för det fältet, kan du stöta på problem när dessa poster nästa gång redigeras. Användare kommer inte att kunna spara några ändringar förrän de fyller i det nyligen nödvändiga fältet.
Innan du implementerar en nödvändig begränsning på ett befintligt fält, kontrollera alltid om befintliga poster redan har värden. Om de inte har det, kör en datamigrering för att först fylla i fältet.
Fälla 2: Förvirrande Vy-Nivå och Modell-Nivå Nödvändigt
Att ställa in ett fält som nödvändigt i en vy (oavsett om det är genom Studio eller vy XML) tvingar inte fram begränsningen på modellnivå. En post som skapats via API:et, en annan vy eller en import kommer helt att kringgå vy-nivå nödvändiga begränsningar.
Om du behöver en hård begränsning, ställ in required=True i Python-fältdefinitionen. Detta är en ofta missförstådd punkt i Odoo-fälthandledningsgemenskapen, och det orsakar verkliga datakvalitetsproblem i produktion.
Fälla 3: Nödvändiga Fält i Automatiserade eller Schemalagda Åtgärder
När en automatiserad åtgärd eller schemalagd åtgärd skapar poster programmässigt, måste den tillhandahålla värden för alla obligatoriska fält. Om åtgärden skrevs innan ett obligatoriskt fält lades till, kommer den att börja misslyckas tyst eller med ett kryptiskt fel efter att den obligatoriska begränsningen har implementerats.
Granska alltid all kod för automatisk postskapande efter att ett obligatoriskt fält har lagts till i en befintlig modell.
Fälla 4: Importera data som saknar obligatoriska fält
När poster importeras via CSV eller Odoo-importverktyget kommer obligatoriska fält som saknas från importfilen att orsaka att importen misslyckas. Detta är faktiskt det korrekta beteendet, men det överraskar användare som är vana vid att importera partiella data.
Inkludera alltid alla obligatoriska fält i dina importmallar. Det är god praxis att dokumentera vilka fält som är obligatoriska i dina riktlinjer för datainport.
Fälla 5: Använda obligatorisk istället för en Python-begränsning för komplex validering
Attributet required kontrollerar endast att ett fält inte är tomt. Det validerar inte innehållet eller relationen mellan fält. För mer komplex validering (till exempel att säkerställa att ett datum är i framtiden, eller att två fält är konsekventa), använd en @api.constrains-dekorator i Python istället.
Att försöka koda affärslogik enbart i obligatoriska fält leder till oflexibla konfigurationer som är svåra att underhålla.
Slutsats
Attributet obligatoriskt fält är ett av de enklaste verktygen i Odoo, men det har en verklig påverkan på kvaliteten på dina data. Använt väl säkerställer det att kritisk information alltid fångas vid rätt tidpunkt i dina affärsprocesser. Använt dåligt frustrerar det användare och skapar lösningar som gör dina data mindre pålitliga, inte mer.
Nyckeln är att förstå skillnaden mellan modellnivå och vy-nivå obligatoriska begränsningar, att vara medveten om vilka fält som verkligen behöver genomdrivas, och att tänka framåt om hur begränsningen kommer att bete sig i automatiserade arbetsflöden och API-integrationer.
Oavsett om du följer en Odoo-utvecklareguide, gör ett fullständigt Odoo-anpassningsprojekt, eller bara justerar ett formulär i Odoo Studio, är det värt att förstå det obligatoriska attributet på djupet. Det är en av de detaljer som skiljer en ren Odoo-implementering från en som orsakar huvudvärk sex månader efter lansering.
Behöver du hjälp med din Odoo-implementering?
På Dasolo hjälper vi företag att implementera, anpassa och optimera Odoo över alla affärsfunktioner och nivåer av komplexitet. Oavsett om du behöver hjälp med att designa en solid datamodell, konfigurera valideringsregler eller bygga anpassade moduler, tillför vårt team både teknisk och funktionell expertis till varje projekt.
Om du har frågor om obligatoriska fält eller något annat aspekt av din Odoo-installation, hjälper vi gärna till. Kontakta oss och låt oss prata om vad du bygger.