Fält och widgetar¶
Fält strukturerar modellerna i en databas. Om du tänker dig en modell som en tabell eller ett kalkylark är fälten kolumnerna och handlingarna de enskilda raderna. Fält definierar också vilken typ av data som lagras i dem. Sättet på vilket ett fälts data presenteras och formateras på användargränssnittet styrs av dess widget.
Med Studio är det möjligt att:
add new fields to your database. From a technical point of view, there are 15 field types in Odoo. However, you can choose from 20 field types in Studio, as some field types are available more than once with a different default widget;
add existing fields, i.e., fields that already exist on a model, to any view of that model;
ändra ett fälts egenskaper; eller
Studio-fält kontra egenskapsfält
Fält som skapats med Studio sparas som kolumner i din Odoo-databas. Egenskapsfält fungerar däremot som pseudofält; de delas av alla handlingar som är kopplade till samma överordnade handling (t.ex. för arbetsuppgifter, projektet, eller för en produkt, produktkategorin), men de sparas inte som kolumner i din databas.
Example
Att lägga till ett Deadline-fält i formulärvyn för en arbetsuppgift med Studio gör det fältet synligt i varje arbetsuppgift i din databas. Att lägga till ett Special instructions-egenskapsfält till en arbetsuppgift gör fältet synligt i alla arbetsuppgifter inom samma projekt (dvs. dess överordnade) medan andra projekts arbetsuppgifter förblir opåverkade.
Fälttyper¶
Fält kan grovt delas in i två kategorier:
Enkla fält, som innehåller grundläggande värden, såsom text, nummer, filer osv.
Relationsfält, som används för att länka och visa data från handlingar på en annan modell.
Enkla fält¶
Observera
Icke-standardwidgetar, när de finns tillgängliga, presenteras som punktlistor eller underrubriker.
Text (char)¶
Fältet Text används för kort text som innehåller valfritt tecken. En textrad visas när fältet fylls i.
Badge: visar värdet inuti en rundad form, liknande en tagg. Värdet kan inte redigeras i användargränssnittet, men ett standardvärde kan anges.
Copy to Clipboard: användare kan kopiera värdet genom att klicka på en knapp.
E-post: värdet blir en klickbar mailto-länk.
Image: visar en bild med hjälp av en URL. Värdet kan inte redigeras manuellt, men ett standardvärde kan anges.
Observera
Detta fungerar annorlunda än att välja Bildfältet direkt, eftersom bilden inte lagras i Odoo när du använder ett Text-fält med widgeten Bild. Det kan till exempel vara användbart om du vill spara diskutrymme.
Phone: värdet blir en klickbar tel-länk.
Tips
Bocka i Enable SMS för att lägga till ett alternativ för att skicka ett SMS direkt från Odoo bredvid fältet.
URL: värdet blir en klickbar URL.
Example
Text med flera rader (text)¶
Fältet Multiline Text används för längre text som innehåller alla typer av tecken. Två textrader visas på användargränssnittet när fältet fylls i.
Copy to Clipboard: användare kan kopiera värdet genom att klicka på en knapp.
Example
Heltal (integer)¶
Fältet Integer används för alla heltal (positivt, negativt, eller noll, utan decimal).
Percentage Pie: visar värdet inuti en procentcirkel, vanligtvis för ett beräknat värde. Värdet kan inte redigeras i användargränssnittet, men ett standardvärde kan anges.
Progressstapel: visar värdet bredvid en procentstapel, vanligtvis för ett beräknat värde. Fältet kan inte redigeras manuellt, men ett standardvärde kan anges.
Handle: visar en draghandtagsikon för att beställa poster manuellt i Listvy.
Example
Decimal (float)¶
Fältet Decimal används för alla decimaltal (positiv, negativ eller noll, med decimal).
Observera
Decimaltal visas med två decimaler efter decimaltecknet på användargränssnittet, men de lagras i databasen med större precision.
Valutafält: liknar användningen av valutafältet. Det rekommenderas att använda det senare eftersom det erbjuder fler funktioner.
Percentage: visar ett procenttecken
%efter värdet.Percentage Pie: visar värdet i en procentcirkel, vanligtvis för ett beräknat värde. Fältet kan inte redigeras manuellt, men ett standardvärde kan anges.
Progressstapel: visar värdet bredvid en procentstapel, vanligtvis för ett beräknat värde. Fältet kan inte redigeras manuellt, men ett standardvärde kan anges.
Time: värdet måste följa formatet hh:mm, med ett maximum på 59 minuter.
Example
Html (html)¶
Fältet Html används för att lägga till text som kan redigeras med Odoos HTML-redigerare.
Multiline Text: inaktiverar Odoo HTML-editor för att tillåta redigering av rå HTML.
Example
Monetära (monetära)¶
Fältet Monetary används för alla monetära värden.
Observera
När du först lägger till ett Monetary-fält uppmanas du att lägga till ett Currency-fält om det inte redan finns något i modellen. Odoo erbjuder sig att lägga till Currency-fältet åt dig. När det har lagts till lägger du till Monetary-fältet igen.
Example
Date (date) and Datetime (datetime)¶
The Date field is used to display a read-only date or when users should select a date on a calendar. The Datetime field is used to display a read-only date and time, or when users should select a date on a calendar and a time from the available options; if no time is set, the time of the user’s local device is automatically used.
Date Range: allows the display of a period of time with a start date and end date in a single line. A date range can be configured to always display an input field for both a start and end date, e.g., for a multi-day event, or to provide the option to enter a Range, e.g., for a field service intervention that may or may not span several days. If the field is a Datetime field, the user also selects a start time and end time.
Remaining Days: expresses the field value in relation to the current date using relative terms such as Yesterday, Today, In 3 days, 2 months ago, etc. This field should be set to Readonly.
Example
Tips
As well as general properties, some specific properties are available for Date and Datetime fields.
Datumintervall (daterange)¶
Adding a date range requires two fields:
a Date or Datetime field with the Date Range widget set. This is the field from which the user selects the date or date and time.
another field that is selected as the start date or end date. This underlying field can be an existing Date or Datetime field, or one created specifically for this purpose.
Så här lägger du till ett datumintervall:
Identify the existing Date or Datetime field to use as the underlying start/end date field, or add a new one. If the date range:
will always display an input field for both a start date and end date, this field can be either the start date or end date; the outcome is the same.
tillåter ett valfritt start- eller slutdatum är detta fält startdatumet respektive slutdatumet.
Tips
För att undvika att visa samma information två gånger kan det underliggande start-/slutdatumfältet göras osynligt genom att aktivera Osynlig eller tas bort från vyn genom att klicka på Ta bort från vy.
Add the Date or Datetime field from which the user will select the date or date and time, then set the Widget property to Date Range.
Ange en lämplig etikett.
Välj det underliggande start-/slutdatumfältet från rullgardinsmenyn Startdatumfält eller Slutdatumfält, beroende på vad som är relevant.
If the date range should, by default, allow the input of both a start and end date, enable Always range.
Update any other general properties or specific properties for Date and Datetime fields as needed, then click Close in the upper right corner of the screen.
Kryssruta (boolean)¶
Fältet Checkbox används när ett värde endast ska vara sant eller falskt, vilket anges genom att markera eller avmarkera en kryssruta.
Button: visar en radioknapp. Widgeten fungerar utan att växla till redigeringsläget.
Toggle: visar en växlingsknapp. Widgeten fungerar utan att växla till redigeringsläget.
Example
Urval (urval)¶
Fältet Selection används när användare ska välja ett enskilt värde från en grupp fördefinierade värden.
Badge: visar värdet inuti en rundad form, liknande en tagg. Värdet kan inte redigeras i användargränssnittet, men ett standardvärde kan anges.
Badges: visar alla valbara värden samtidigt i rektangulära former, organiserade horisontellt.
Prioritet: visar stjärnsymboler istället för värden, som kan användas för att indikera en viktighets- eller tillfredsställelsesnivå, till exempel. Detta har samma effekt som att välja prioritetsfältet, även om fyra prioritetsvärden redan är fördefinierade för det senare.
Radio: visar alla valbara värden samtidigt som radioknappar.
Tips
Som standard är alternativknapparna organiserade vertikalt. Aktivera Visa horisontellt för att byta sätt de visas på.
Statusfält: visar alla valbara värden samtidigt som ett förloppsstreck med pilar.
Tips
Som standard är värdena i statusfältet valbara. Avaktivera Klickbar för att förhindra att värdet redigeras i användargränssnittet.
Example
Fil (binär)¶
The File field is used to upload any type of file.
Bild: användare kan ladda upp en bildfil som sedan visas i formulärvyn. Detta har samma effekt som att använda bildfältet.
PDF Viewer: användare kan ladda upp en PDF-fil, som sedan kan läsas från Formulärvyn.
Example
Image (image)¶
The Image field is used to upload an image and display it in Form view. This field type is a File field with the Image widget selected by default. Consequently, the File and PDF Viewer widgets have the same effects as described under File.
Tips
För att ändra visningsstorleken på uppladdade bilder, välj Small, Medium, eller Large under alternativet Size.
Prioritet (urval)¶
Fältet Prioritet används för att visa ett betygssystem med tre stjärnor, vilket kan användas för att ange betydelse eller tillfredsställelsenivå. Denna fälttyp är ett urvalsfält med widgeten Prioritet vald som standard och fyra prioritetsvärden fördefinierade. Följaktligen har widgetarna Bricka, Brickor, Radio och Urval samma effekter som beskrivs under Urval.
Tips
Klicka på Edit Values om du vill ändra antalet tillgängliga stjärnor genom att lägga till eller ta bort värden. Observera att det första värdet är lika med 0 stjärnor (dvs. när inget val görs), så att ha fyra värden resulterar i ett trestjärnigt klassificeringssystem, till exempel.
Example
Signature (signature)¶
The Signature field is used to sign the form electronically. This field type is a File field with the Signature widget selected by default. Consequently, the File, Image, and PDF Viewer widgets have the same effects as described under File.
Tips
To give users the Auto option when having to draw their signature, select one of the available Prefill with fields (Many2One, and Related Field on the model only). The signature is then automatically generated using the data from the selected field.
Example
Relationella fält¶
Observera
Icke-standardwidgetar, när de finns tillgängliga, presenteras som punktlistor eller underrubriker.
Linjer (one2many)¶
Fältet Lines används för att skapa en tabell med rader och kolumner (t.ex. raderna med produkter på en försäljningsorder).
Tips
Om du vill ändra kolumnerna klickar du på fältet Lines och sedan på Edit List View. Om du vill redigera formuläret som visas när en användare klickar på Lägg till en rad, klickar du istället på Redigera formulärvy.
Example
One2Many (one2many)¶
Fältet One2Many används för att visa de befintliga relationerna mellan en post i den aktuella modellen och flera poster från en annan modell.
Example
Du kan lägga till ett One2Many-fält på Contact-modellen för att titta på en kunds många försäljningsorder.
Observera
För att använda ett en till många-fält måste de två modellerna redan ha länkats med ett många till en-fält. En till många-relationer existerar inte oberoende: en omvänd sökning av befintliga många till en-relationer utförs.
Many2One (many2one)¶
Fältet Many2One används för att länka en annan post (från en annan modell) till den post som redigeras. Postens namn från den andra modellen visas sedan på den post som redigeras.
Example
I modellen Säljorder är fältet Customer ett Many2One-fält som pekar på modellen Contact. Detta gör att många försäljningsorder kan kopplas till en kontakt (kund).
Tips
För att hindra användare från att skapa en ny post i den länkade modellen, kryssa i Inaktivera skapande.
För att förhindra användare från att öppna poster i ett popup-fönster, bocka i Inaktivera öppning.
För att hjälpa användare att bara välja rätt post, klicka på Domän för att skapa ett filter.
För att endast utlösa sökningen efter en länkad post efter att ett minsta antal tecken har angetts, ange önskat antal i fältet Typeahead-sökning. I situationer där datamängden är stor kan detta förbättra både sökrelevans och prestanda.
Badge: visar värdet inuti en rundad form, liknande en tagg. Värdet kan inte redigeras i användargränssnittet.
Radio: visar alla valbara värden samtidigt som radioknappar.
Many2Many (many2many)¶
Fältet Många till många används för att länka flera handlingar från en annan modell till flera handlingar på den aktuella modellen. Många till många-fält kan använda Avaktivera skapande, Avaktivera öppning, Domän, precis som många till en-fält.
Example
I modellen Task är fältet Assignees ett Many2Many-fält som pekar på modellen Contact. Detta gör att en enskild användare kan tilldelas många uppgifter och många användare kan tilldelas en enskild uppgift.
Tips
För att endast utlösa sökningen efter den länkade posten efter att ett minsta antal tecken har angetts, ange önskat antal i fältet Typeahead-sökning. I situationer där datamängden är stor kan detta förbättra både sökrelevans och prestanda.
Checkboxes: användarna kan välja flera värden med hjälp av kryssrutor.
Taggar: användare kan välja flera värden som visas i rundade former, även kallade taggar. Detta har samma effekt som att välja taggfältet.
Lägg till ett fält i en vy¶
Med Studio är det möjligt att lägga till:
ett nytt fält i en formulär- eller listvy för en modell
ett befintligt fält, det vill säga ett fält som redan finns på den aktuella modellen, i vilken som helst vy för den modellen
Tips
Lägg till ett nytt fält i en formulär- eller listvy för att spara det till modellen och göra det tillgängligt som ett befintligt fält i andra vyer för samma modell.
Lägg till ett nytt fält¶
Tips
Aktivera utvecklarläge innan du lägger till ett nytt fält för att se och kunna redigera fältets tekniska namn under konfigurationen.
Följ dessa steg för att lägga till ett nytt fält:
Navigera till relevant formulär- eller listvy och klicka sedan på ikonen (Växla Studio) i det övre högra hörnet. Alternativt kan du, när någon app är öppen, klicka på ikonen (Växla Studio) och sedan navigera till relevant formulär- eller listvy.
In the Add tab, drag the relevant field type from the New Fields section and drop it in the desired position. If the new field is a relational field, select the relevant reciprocal field, model, or related field in the pop-up.
In the Properties tab, configure the field’s properties:
Ange Etikett som ska visas som fältnamn i användargränssnittet. Detta används också för att generera fältets standardtekniska namn.
Klicka var som helst utanför fältet Etikett för att se Tekniskt namn uppdaterat med det standardtekniska namnet.
Observera
Tekniskt namn för ett nytt fält kan redigeras i Studio under konfigurationsprocessen. Vid alla andra tillfällen kan ett fälts tekniska namn endast ändras via databasens tekniska inställningar.
Det tekniska namnet för ett nytt fält som läggs till med Studio har som standard prefixet
x_studio_.
Välj om du vill en annan Widget via rullgardinsmenyn. Standardwidgeten för fälttypen är vald som standard.
Konfigurera vid behov andra fältegenskaper.
Klicka på Stäng i det övre högra hörnet för att stänga Studio.
Se även
Lägg till ett befintligt fält¶
För att lägga till ett fält som finns i modellen men som inte är närvarande i den aktuella vyn, följ dessa steg:
Navigera till relevant vy och klicka sedan på ikonen (Växla Studio) i det övre högra hörnet. Alternativt, med vilken app som helst öppen, klicka på ikonen (Växla Studio) och navigera sedan till relevant vy.
In the Add tab, in the left panel, click Existing Fields to reveal a list of all the model’s fields that are not currently present in the view.
Dra det relevanta fältet och släpp det på önskad position.
In the Properties tab, configure the relevant properties for the field in the current view.
Observera
Olika egenskaper kan konfigureras oberoende för olika vyer vid behov, såsom etikett, widget, fältets synlighet för vissa användargrupper, samt huruvida fältet är osynligt, obligatoriskt eller skrivskyddat.
Klicka på Stäng i det övre högra hörnet för att stänga Studio.
Fältegenskaper¶
A series of general properties can be configured for most combinations of field type and widget. Additional properties are available depending on the specific field type and widget selected. For example, various specific properties can be configured for Date and Datetime fields.
Allmänna egenskaper¶
Klass: Använd Bootstrap eller andra anpassade klasser definierade i Odoo för att anpassa hur fältet är formaterat och visas i användargränssnittet.
Osynlig: Aktivera denna egenskap när det inte är nödvändigt för användare att se ett fält i användargränssnittet. Detta hjälper till att rensa upp användargränssnittet genom att endast visa de väsentliga fälten beroende på en specifik situation.
Obligatorisk: Aktivera denna egenskap om ett fält alltid ska fyllas i av användaren innan det går att fortsätta.
Skrivskyddad: Aktivera denna egenskap om användare inte ska kunna ändra ett fält.
Tips
The Invisible property also applies inside Studio. To view hidden fields in Studio, click on a view’s View tab and enable Show Invisible Elements.
Egenskaperna osynlig, obligatorisk och skrivskyddad kan aktiveras endast för specifika handlingar genom att klicka på villkorlig och skapa ett filter.
Example
I formulärvyn för modellen Kontakt visas fältet rubrik endast när individuell är valt, eftersom det fältet inte skulle vara användbart för en företagskontakt.
Etikett: Detta är fältets namn i användargränssnittet; etiketten används för att generera fältets tekniska namn.
Hjälpverktygstips: För att förklara syftet med ett fält, lägg till en beskrivning. Texten visas i en verktygstipsruta när du håller muspekaren över frågetecknet bredvid fältets etikett.
AI Autofill: Enable this option to add AI capabilities allowing the value of the field to be generated automatically through a prompt. When the browser page reloads, click Set prompt, then enter the prompt; type
/to open the AI prompt tools and use the Field Selector to tell Odoo AI which fields to check for context. Click Save.Track in chatter: Enable this option to track changes to the field in the record’s chatter.
Technical Name: To view the field’s technical name in Studio (and, during the configuration of a new field, edit it if desired), activate developer mode.
Tips
If the technical name needs to be updated but is no longer editable via Studio, it can be modified via the technical settings of the database.
Widget: För att ändra standardutseende eller funktionalitet för ett fält, välj en av de tillgängliga widgetarna.
Placeholder: To provide an example of how a field should be completed, add a fixed placeholder text. This text appears in light gray until a value is entered.
Dynamic Placeholder: To provide the value of the selected field as an example of how a field should be completed. This text appears in light gray until a value is entered.
Default value: To display a default value in a field when a record is created, enter a value.
Tillåt synlighet för grupper: För att begränsa vilka användare som kan se fältet, välj en eller flera användaråtkomstgrupper.
Förhindra synlighet för grupper: För att förhindra vissa användare från att se fältet, välj en eller flera användaråtkomstgrupper.
Properties for Date and Datetime fields¶
For Date fields using the Date or Date Range widget and Datetime fields using the Date & Time or Date Range widget, some specific properties are available:
Minimal precision: Determine the smallest date unit that must be selected in the date picker. The possible values are
Days,Decades,MonthsandYears. If no value is selected, the user must select a day in the date picker.Maximal precision: Determine the largest date unit that can be used to navigate the date picker. The possible values are
Days,Decades,MonthsandYears. If no value is selected, the user can navigate the date picker by decade.Date format: By default the date will be shown as e.g.,
Jan 31, 2026(or the equivalent for the user’s language/regional settings). Select the all-numeric date format, e.g., 31/01/2026, if desired.Warning: Add a warning if a future or past date is selected. The possible values are No warning, Future date, or Past date. If the user enters a future or past date when the expected date is either today’s date or a date in the past or future, respectively, the entered date appears in red.
Earliest accepted date: Enter the earliest date that can be selected in the date picker in ISO format, i.e.,
YYYY-MM-DD. If the current date is always the earliest accepted date, entertoday. On the date picker, dates prior to the earliest accepted date are grayed out.Latest accepted date: Enter the latest date that can be selected in the date picker in ISO format, i.e.,
YYYY-MM-DD. If the current date is always the latest accepted date, entertoday. On the date picker, dates later than the latest accepted date are grayed out.
For Date or Datetime fields using the Date Range widget, additional properties are available:
Start date field and End date field: These properties are used to define a start or end date for a date range or date and time range; only one of these properties can be populated.
Show time: This property is enabled by default. Disable the property to show only the date in a Datetime field.
Show seconds: This property is disabled by default. Enable the property to show the seconds in a Datetime field.
Always range: Enable this option to always display an input field for both a start and end date. If left disabled, the date or date and time picker allows the user to choose to enter a single Date (i.e., a date or date and time, depending on the field type) by default, or to click Range to enter a date range or date and time range, as relevant.
Time interval: Enter a value to determine the minute intervals shown in the time picker of a Datetime field. For example, enter 15 to allow quarter-hour intervals. The default value is set to
5(minutes).
Ändra egenskaper för ett fält¶
Följ dessa steg för att ändra egenskaperna för ett fält:
Navigera till relevant vy och klicka sedan på ikonen (Växla Studio) i det övre högra hörnet. Alternativt, med vilken app som helst öppen, klicka på ikonen (Växla Studio) och navigera sedan till relevant vy.
Klicka på det relevanta fältet.
In the Properties tab, make any desired changes to the field properties.
Tips
Olika egenskaper kan konfigureras oberoende av varandra för olika vyer, såsom Label, Widget, fältets synlighet för vissa användargrupper, samt om fältet är Invisible, Obligatorisk eller Readonly.
Klicka på Stäng i det övre högra hörnet för att stänga Studio.
Observera
Tekniskt namn för ett fält (synligt i Studio med utvecklarläge aktiverat) kan inte ändras i Studio; detta kan göras via databasens tekniska inställningar.
Ändra ett fälts tekniska namn¶
För att ändra det tekniska namnet för ett fält, aktivera utvecklarläge, följ sedan dessa steg:
With the field open in Studio, copy the Technical Name of the field.
Ta bort fältet från alla vyer i Studio, klicka sedan på Klar för att stänga Studio.
Navigate to the Settings app, then go to .
Klistra in det kopierade tekniska namnet i sökfältet och öppna sedan det relevanta fältet.
Ändra Fältnamn efter behov.
När fältets tekniska namn har uppdaterats kan fältet sedan läggas till (tillbaka) i relevanta vy(er) från listan över befintliga fält.
Viktigt
När du uppdaterar det tekniska namnet för ett fält, se till att behålla åtminstone prefixet x_, vilket krävs för alla anpassade fält; för fält som skapats med Studio, behåll prefixet x_studio_ för att fält ska kunna identifieras enklare.
Ta bort ett fält från en vy¶
Följ dessa steg för att ta bort ett fält från en vy:
Navigera till relevant vy och klicka sedan på ikonen (Växla Studio) i det övre högra hörnet. Alternativt, med vilken app som helst öppen, klicka på ikonen (Växla Studio) och navigera sedan till relevant vy.
Klicka på det relevanta fältet.
Scrolla till slutet av fliken Egenskaper, klicka sedan på Ta bort från vy.
Click Remove field to confirm the action.
Tips
Ett borttaget fält kan enkelt läggas tillbaka till vyn vid ett senare tillfälle, om det behövs.
Om avsikten är att rensa upp vyn är det också möjligt att ändra ett fält och göra det Osynligt i den aktuella vyn.