4649c3f8d1
Since odoo/documentation#903, the guideline for the location of new resource (images, downloadable files, RST includes...) files is to place those inside the directory of the RST page that references them. For example, if `doc1.rst` has a reference to `image.png` and to `download.zip`, the file structure should look like this: ├── parent_doc/ │ └── doc1/ │ │ └── image.png │ │ └── download.zip │ └── doc1.rst │ └── doc2.rst ├── parent_doc.rst Before this commit, most of the resource files were still located inside 'media' directories holding all the resource files referenced by RST pages located at the same level as these directories. In the example above, a single 'media' directory would hold all the resource files referenced by both `doc1.rst` and `doc2.rst`. Doing so prevented us from figuring out easily which resource file was referenced by which RST page and, thus, lead to unused resource files piling up in the repository. It also made it more complicated to define codeowners regex rules because a team could not simply be assigned to `/some_page.*` but needed to be assigned to both `/some_page\.rst` and to the location of 'media'. In order to help new content writers figure out the guideline when taking examples from other RST pages, this commit retroactively applies the guideline to existing resource files and 'media' directories. The left-over resource files that are not referenced by any RST page are removed. task-2497965 Part-of: odoo/documentation#2067
95 lines
4.3 KiB
ReStructuredText
95 lines
4.3 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:: understanding_general/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:: understanding_general/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 an action. In Odoo Studio, to create menus (models) and
|
||
rearrange their hierarchy, click on *Edit Menu*.
|
||
|
||
.. image:: understanding_general/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>`_ |