95 lines
4.2 KiB
ReStructuredText
95 lines
4.2 KiB
ReStructuredText
|
==============================
|
|||
|
|
Understanding General Concepts
|
|||
|
|
==============================
|
|||
|
|
|
|||
|
|
| Odoo Studio is a toolbox that allows you to add models or adapt functionalities on top of Odoo’s
|
|||
|
|
standard behavior without coding knowledge. You can also create custom views and modify existing
|
|||
|
|
ones without having to get into the XML code.
|
|||
|
|
| Even for experienced developers, typing out code requires time. By using Odoo Studio, you can
|
|||
|
|
quickly get your models up and going and focus on the crucial parts of your application. The
|
|||
|
|
result is a user-friendly solution that makes customizations and designing new applications easy
|
|||
|
|
with or without programming skills.
|
|||
|
|
|
|||
|
|
|
|||
|
|
Getting started
|
|||
|
|
===============
|
|||
|
|
|
|||
|
|
One you start using Odoo Studio, you automatically create a new *module* that contains all your
|
|||
|
|
modifications. These modifications can be done on existing screens (*views*), by adding new
|
|||
|
|
*fields* in existing applications, or by creating an entirely new *model*.
|
|||
|
|
|
|||
|
|
What is a Module?
|
|||
|
|
-----------------
|
|||
|
|
|
|||
|
|
| An Odoo **Module** can contain a number of elements, such as: business objects (models), object
|
|||
|
|
views, data files, web controllers, and static web data. An application is a collection of modules.
|
|||
|
|
| In object-oriented programming, models usually represent a concept from the real world.
|
|||
|
|
Example: Odoo has models for Sales Orders, Users, Countries, etc. If you were to build an
|
|||
|
|
application to manage Real Estate sales, a model that represents the Properties for sale would
|
|||
|
|
probably be your first step.
|
|||
|
|
|
|||
|
|
.. image:: media/new_app.png
|
|||
|
|
:align: center
|
|||
|
|
:alt: Overview of the main dashboard emphasizing the option to create a new app in Odoo Studio
|
|||
|
|
|
|||
|
|
.. _studio/concepts/understanding_general/models:
|
|||
|
|
|
|||
|
|
What is a Model (also called Object)?
|
|||
|
|
-------------------------------------
|
|||
|
|
|
|||
|
|
A **Model** determines the logical structure of a database and fundamentally determines in which
|
|||
|
|
manner data can be stored, organized, and manipulated. In other words, a model is a table of
|
|||
|
|
information that can be bridged with other tables.
|
|||
|
|
|
|||
|
|
What are Fields?
|
|||
|
|
----------------
|
|||
|
|
|
|||
|
|
| **Fields** compose models. It is where a record (a piece of data) is registered.
|
|||
|
|
| Example: on the Real Estate application, fields on the Properties model would include
|
|||
|
|
the price, address, a picture, a link to the current owner, etc.
|
|||
|
|
| There are 2 main types of fields in Odoo: *basic (or scalar) fields* and *relational fields*.
|
|||
|
|
| Basic fields represent simple values, like numbers or text. Relational fields represent relations
|
|||
|
|
between models. So, if you have a model for *Customers* and another one for *Properties*, you
|
|||
|
|
would use a relational field to link each Property to its Customer.
|
|||
|
|
|
|||
|
|
Relational Fields in detail
|
|||
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|||
|
|
|
|||
|
|
| **Relational Fields** provide the option to link the data of one model with the data of another
|
|||
|
|
model.
|
|||
|
|
| In Odoo, relational field types are: *One2many*, *Many2one*, *Many2many*.
|
|||
|
|
|
|||
|
|
.. image:: media/relational_fields.png
|
|||
|
|
:align: center
|
|||
|
|
:alt: Tables with a visual explanation of related fields for Odoo Studio
|
|||
|
|
|
|||
|
|
| An **One2many** field is a *one-way* direction of selecting *multiple* records from a table.
|
|||
|
|
| Example: a Sales Order can contain multiple Sales Order Lines, which also contain multiple fields
|
|||
|
|
of information.
|
|||
|
|
| A **Many2one** field is a *one-way* direction of selecting *one* record from a table.
|
|||
|
|
| Example: you can have many product categories, but each product can only belong to one category.
|
|||
|
|
| A **Many2many** field is a *two-way* direction of selecting records from a table.
|
|||
|
|
| Example: multiple tags can be added to a lead’s form.
|
|||
|
|
|
|||
|
|
.. note::
|
|||
|
|
An *One2many* field must have a *Many2one* related to it.
|
|||
|
|
|
|||
|
|
What are Views?
|
|||
|
|
---------------
|
|||
|
|
|
|||
|
|
**Views** define how records are displayed. They are specified in XML which means that they can be
|
|||
|
|
edited independently from the models that they represent. There are various types of views in Odoo,
|
|||
|
|
and each of them represents a mode of visualization. Some examples are: *form*, *list*, *kanban*.
|
|||
|
|
|
|||
|
|
What is a Menu?
|
|||
|
|
---------------
|
|||
|
|
|
|||
|
|
A **Menu** is a button that executes and action. In Odoo Studio, to create menus (models) and
|
|||
|
|
rearrange their hierarchy, click on *Edit Menu*.
|
|||
|
|
|
|||
|
|
.. image:: media/edit_menu.png
|
|||
|
|
:align: center
|
|||
|
|
:alt: Overview of a menu being edit in Odoo Studio
|
|||
|
|
|
|||
|
|
.. seealso::
|
|||
|
|
- `Studio Basics <https://www.odoo.com/fr_FR/slides/studio-31>`_
|