Câmpuri și widget-uri

Câmpurile compun structura unei baze de date. Dacă vă imaginați un model ca o tabelă sau un tabel, câmpurile sunt coloanele unde datele sunt stocate în înregistrări (adică rândurile). Câmpurile definesc de asemenea tipul de date stocate în ele. Modul în care sunt prezentate și forma datelor în UI este definit de widget-ul lor.

Din punct de vedere tehnic, există 15 tipuri de câmpuri în Odoo. Cu toate acestea, puteți alege din 20 de câmpuri în Studio, deoarece unele tipuri de câmpuri sunt disponibile de mai multe ori cu un widget implicit diferit.

Sfat

Câmpuri noi pot fi adăugate doar la vizualizările de tip Formular și Listă. Pe alte vizualizări, puteți adăuga doar Câmpuri existente (câmpuri deja existente pe model).

Câmpuri simple

Câmpurile simple conțin valori de bază, cum ar fi text, numere, fișiere, etc.

Notă

Non-default widgets, when available, are presented as bullet points or sub-headings below.

Text (char)

Câmpul Text este utilizat pentru text scurt care conține orice caracter. O singură linie de text este afișată la completarea câmpului.

• Etichetă: afișează valoarea într-o formă rotunjită, similar cu o etichetă. Valoarea nu poate fi editată în UI, dar o valoare implicită poate fi setată.

• Copiază în Clipboard: utilizatorii pot copia valoarea apăsând pe un buton.

• E-mail: valoarea devine un link mailto (email către).

• Imagine: afișează o imagine folosind un URL. Valoarea nu poate fi editată manual, dar o valoare implicită poate fi setată.

  Notă

  This works differently than selecting the Image field directly, as the image is not stored in Odoo when using a Text field with the Image widget. For example, it can be useful if you want to save disk space.

• Telefon: valoarea devine un link tel.

  Sfat

  Bifați Activează SMS pentru a adăuga o opțiune de a trimite un SMS direct din Odoo lângă câmp.

• URL: valoarea devine un URL pe care se poate face clic.

Example

Text Multilinie (text)

Câmpul Text Multilinie este utilizat pentru text mai lung care conține orice tip de caracter. Două linii de text sunt afișate în UI la completarea câmpului.

• Copiază în Clipboard: utilizatorii pot copia valoarea apăsând pe un buton.

Example

Întregi (integer)

Câmpul Integer este utilizat pentru toate numerele întregi (pozitive, negative, sau zero, fără zecimale).

• Grafic al proporțiilor: afișează valoarea într-un cerc procentual, de obicei pentru o valoare calculată. Valoarea nu poate fi editată în UI, dar o valoare implicită îi poate fi setată.

• Bară de progres: afișează valoarea lângă o bară procentuală, de obicei pentru o valoare calculată. Câmpul nu poate fi editat manual, dar o valoare implicită îi poate fi setată.

• Mâner: afișează o pictogramă de mâner pentru a ordona înregistrările manual în Vizualizarea listă.

Example

Zecimal (float)

Câmpul Zecimal este utilizat pentru toate numerele zecimale (pozitive, negative, sau zero, cu zecimale).

Notă

Numerele zecimale sunt afișate în UI (Interfața cu Utilizatorul) cu două zecimale după virgulă, dar sunt stocate în baza de date cu o precizie mai mare.

• Monetary: it is similar to using the Monetary field. It is recommended to use the latter as it offers more functionalities.

• Procentaj: afișează un caracter procent % după valoare.

• Grafic al proporțiilor: afișează valoarea într-un cerc procentual, de obicei pentru o valoare calculată. Câmpul nu poate fi editat manual, dar o valoare implicită îi poate fi setată.

• Bară de progres: afișează valoarea lângă o bară procentuală, de obicei pentru o valoare calculată. Câmpul nu poate fi editat manual, dar o valoare implicită îi poate fi setată.

• Timp: valoarea trebuie să urmeze formatul hh:mm, cu un maxim de 59 minute.

Example

Monetar (monetary)

Câmpul Monetar este utilizat pentru toate valorile monetare.

Notă

Când adăugați prima dată un câmp monetar, vă este solicitat să adăugați un câmp monedă dacă nu există deja unul pe model. Odoo vă întreaba să adăugați câmpul Monedă pentru dvs. Odată adăugat, adăugați câmpul Monetar din nou.

Example

Html (html)

Câmpul Html este utilizat pentru a adăuga text care poate fi editat folosind editorul HTML al Odoo.

• Text Multilinie: dezactivează editorul HTML al Odoo pentru a permite editarea HTML brut.

Example

Dată calendaristică (date)

Câmpul Dată calendaristică este utilizat pentru a selecta o dată pe un calendar.

• Remaining Days: the remaining number of days before the selected date is displayed (e.g., In 5 days), based on the current date. This field should be set to Read only.

Example

Dată și oră (datetime)

Câmpul Dată și oră este utilizat pentru a selecta o dată pe un calendar și o ora anume. Timpul curent al utilizatorului este utilizat automat dacă nu este setat.

Sfat

As well as general properties, some specific properties are available for Date & Time fields that have the Date & Time or Date Range widget set.

Date Range (daterange)

The Date Range widget is used to display a period of time defined by a start date and an end date in a single line. A date range can have a mandatory start and end date, e.g., for a multi-day event, or allow an optional start or end date, e.g., for a field service intervention or a project task.

Adding a date range requires two fields: a Date & Time field with the Date Range widget set and another field that is selected as the start date or end date. This underlying field can be an existing Date or Date & Time field, or one created specifically for this purpose.

To add a date range:

1. Identify an existing Date or Date & Time field that can be used as the underlying start/end date field, or add a new one. If the date range:

   • has a mandatory start date and end date, this field can be either the start date or end date; the outcome is the same.

   • allows an optional start or end date, this field is the start date or end date, respectively.

   Sfat

   To avoid displaying the same information twice, the underlying start/end date field can be made invisible by enabling Invisible or removed from the view by clicking Remove from view.

2. Add a Date & Time field and set the Widget field to Date Range.

3. Enter an appropriate Label.

4. Select the underlying start/end date field from the Start date field or End date field dropdown, as relevant.

5. If the date range should have a mandatory start and end date, enable Always range.

6. Update any other general properties or specific properties for Date & Time fields as needed, then click Close in the upper right corner of the screen.

Example

Remaining Days (remaining_days)

The Remaining Days widget displays the remaining number of days before the selected date (e.g., In 5 days), based on the current date and time. This field should be set to Read only.

Bifă (boolean)

Câmpul Bifă este utilizat atunci când o valoare trebuie să fie adevărată sau falsă, indicată prin bifarea sau debifarea unui câmp.

• Buton: afișează un buton radio. Widget-ul funcționează fără a trebui să treci în modul de editare.

• Comutator: afișează un buton de comutare. Widget-ul funcționează fără a trebui să treci în modul de editare.

Example

Selcție (selection)

Câmpul Selcție este utilizat atunci când utilizatorii trebuie să selecteze o singură valoare dintr-un grup de valori predefinite.

• Etichetă: afișează valoarea într-o formă rotunjită, similar cu o etichetă. Valoarea nu poate fi editată în UI, dar o valoare implicită poate fi setată.

• Etichete: afișează toate valorile selectabile simultan în interiorul formelor dreptunghiulare, organizate orizontal.

• Priority: displays star symbols instead of values, which can be used to indicate an importance or satisfaction level, for example. This has the same effect as selecting the Priority field, although, for the latter, four priority values are already predefined.

• Radio: afișează toate valorile selectabile simultan ca butoane radio.

  Sfat

  By default, radio buttons are organized vertically. Enable Display horizontally to switch the way they are displayed.

• Status Bar: displays all selectable values at the same time as an arrow progress bar.

  Sfat

  By default, values on the status bar are selectable. Disable Clickable to prevent the value being edited on the UI.

Example

Prioritate (selection)

The Priority field is used to display a three-star rating system, which can be used to indicate importance or satisfaction level. This field type is a Selection field with the Priority widget selected by default and four priority values predefined. Consequently, the Badge, Badges, Radio, and Selection widgets have the same effects as described under Selection.

Sfat

Pentru a modifica numărul de stele disponibile prin adăugarea sau eliminarea valorilor, faceți clic pe Editează valorile. Rețineți că prima valoare este egală cu 0 stele (adică, de exempu, atunci când nu este făcută nicio selecție), astfel încât având patru valori rezultă într-un sistem de evaluare cu trei stele.

Example

Fișier (binary)

Câmpul Fișier este utilizat pentru a încărca orice tip de fișier, sau pentru a semna un formular (Semnează widget).

• Image: users can upload an image file, which is then displayed in Form view. This has the same effect as using the Image field.

• PDF Viewer: utilizatorii pot încărca un fișier PDF, care poate fi apoi vizualizat din Vizualizare formular.

• Sign: users can electronically sign the form. This has the same effect as selecting the Sign field.

Example

Imagine (binary)

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, PDF Viewer, and Sign widgets have the same effects as described under File.

Sfat

Pentru a modifica dimensiunea afișării imaginilor încărcate, selectați Mic, Mediu, sau Mare sub opțiunea Dimensiune.

Semnătură (binary)

The Sign field is used to sign the form electronically. This field type is a File field with the Sign widget selected by default. Consequently, the File, Image, and PDF Viewer widgets have the same effects as described under File.

Sfat

To give users the Auto option when having to draw their signature, select one of the available Auto-complete with fields (Text, Many2One, and Related Field on the model only). The signature is automatically generated using the data from the selected field.

Câmpuri relaționale

Câmpurile relaționale sunt utilizate pentru a lega și afișa datele din înregistrări de pe alt model.

Notă

Widget-urile non-implicite, sunt prezentate mai jos.

Many2One (many2one)

Câmpul Many2One este utilizat pentru a lega o altă înregistrare (de pe alt model) cu înregistrarea care este editată. Numele înregistrării din alt model este apoi afișat în înregistrarea care este editată.

Example

Pe modelul Comandă de Vânzare, câmpul Client este un câmp Many2One care indică modelul Contact. Acest lucru permite multe comenzi de vânzare să fie legate de un contact (client).

Sfat

• Pentru a preveni utilizatorii din a crea o nouă înregistrare în modelul legat, bifați Dezactivează crearea.

• Pentru a preveni utilizatorii din a deschide înregistrări într-o fereastră pop-up, bifați Dezactivează deschiderea.

• Pentru a ajuta utilizatorii să selecteze doar înregistrarea potrivită, faceți clic pe Domeniu pentru a crea un filtru.

• Etichetă: afișează valoarea într-o formă rotunjită, similară cu o etichetă. Valoarea nu poate fi editată în interfața utilizatorului.

• Radio: afișează toate valorile selectabile simultan ca butoane radio.

One2Many (one2many) (Unul către mai multe)

Câmpul One2Many este utilizat pentru a afișa relațiile existente între o înregistrare de pe modelul curent și mai multe înregistrări de pe alt model.

Example

Aveți posibilitatea să adăugați un câmp One2Many pe modelul Contact pentru a vedea mai multe comenzi de vânzare ale unui client.

Notă

To use a One2Many field, the two models must have been linked already using a Many2One field. One2Many relations do not exist independently: a reverse-search of existing Many2One relations is performed.

Linii (one2many)

Câmpul Linii este utilizat pentru a crea o tabelă cu rânduri și coloane (de exemplu, linii de produse pe o comandă de vânzare).

Sfat

Pentru a modifica coloanele, faceți clic pe câmpul Linii și apoi Editați vizualizarea de tip lista. Pentru a edita formularul care apare atunci când un utilizator face clic pe Adăugați o linie, faceți clic pe Editați vizualizarea formularului.

Example

Many2Many (many2many)

The Many2Many field is used to link multiple records from another model to multiple records on the current model. Many2Many fields can use Disable creation, Disable opening, Domain, just like Many2One fields.

Example

Pe modelul Task, câmpul Atribuiți este un câmp Many2Many care indică modelul Contact. Acest lucru permite unui singur utilizator să îi fie atribuite mai multe sarcini și mai mulți utilizatori să fie atribuiți unei singure sarcini.

• Casete de selectare: utilizatorii pot selecta mai multe valori folosind casetele de selectare.

• Tags: users can select several values appearing in rounded shapes, also known as tags. This has the same effect as selecting the Tags field.

Etichete (many2many)

The Tags field is used to display several values from another model appearing in rounded shapes, also known as tags. This field type is a Many2Many field with the Tags widget selected by default. Consequently, the Checkboxes and Many2Many widgets have the same effects as described under Many2Many.

Sfat

Pentru a afișa etichete cu culori de fundal diferite, bifați Folosiți culori.

Example

Câmp Relaționat (related)

Un Câmp Relaționat nu este un câmp relațional în sine; nu este creată nicio relație între modele. Acesta utilizează o relație existentă pentru a prelua și afișa informații dintr-o altă înregistrare.

Example

Pentru a afișa adresa de email a unui client pe modelul Comandă de Vânzare, utilizați câmpul Câmp Relaționat partner_id.email prin selectarea Client și apoi Email.

Proprietăți

General properties

• Invisible: Enable this property when it is not necessary for users to view a field on the UI. This helps declutter the UI by only showing the essential fields depending on a specific situation.

  The Invisible attribute also applies inside Studio. To view hidden fields in Studio, click on a view’s View tab and enable Show Invisible Elements.

• Required: Enable this property if a field should always be completed by the user before being able to proceed.

• Readonly: Enable this property if users should not be able to modify a field.

Notă

You can choose to enable Invisible, Required and Readonly for specific records only by clicking on Conditional and creating a filter.

Example

Pe vizualizarea Formular a modelului Contact, câmpul Titlu apare doar atunci când este selectat Individual, deoarece acest câmp nu ar fi util pentru un contact de tip Companie.

• Label: the field’s name on the UI. This is not the name used in the PostgreSQL database. To view and change the latter, activate the developer mode and edit the Technical Name.

• Help Tooltip: To explain the purpose of a field, add a description. The text is displayed inside a tooltip box when hovering with your mouse over the question mark beside the field’s label.

• Widget: Pentru a schimba aspectul sau funcționalitatea implicită a unui câmp, selectați unul dintre widget-urile disponibile.

• Placeholder: To provide an example of how a field should be completed, add placeholder text. The 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, add a value.

• Allow visibility to groups: To limit which users can view the field, select one or more user access groups.

• Forbid visibility to groups: To prevent certain users from seeing the field, select one or more user access groups.

Properties for Date & Time fields

For Date & Time fields that have the Date & Time or Date Range widget set, some specific properties are available:

• Time interval: Enter a value to determine the minute intervals shown in the time selector. For example, enter 15 to allow quarter-hour intervals. The default value is set to 5 minutes.

• Warning for future dates: Enable this property to display a warning icon if a future date is selected.

• Show time: This property is enabled by default for Date & Time fields. On a read-only field, disable the property to show only the date. This can keep a list view less cluttered, for example.

• Earliest accepted date: Enter the earliest date that can be selected in the date selector in ISO-format, i.e., YYYY-MM-DD. If the current date is always the earliest accepted date, enter today. On the date selector, dates prior to the earliest accepted date are grayed out.

• Latest accepted date: Enter the latest date that can be selected in the date selector in ISO-format, i.e., YYYY-MM-DD. If the current date is always the latest accepted date, enter today. On the date selector, dates later than the latest accepted date are grayed out.