====== Relations entre modèles ======
===== Création d'un nouveau modèle pour gérer les session de cours =====

Un enregistrement dans un modèle (une table) peut être **relié** à un enregistrement d'un autre modèle. Par exemple, un ordre de vente est relié à un enregistrement client qui contient les informations sur ce client.

<WRAP center round todo >
**Exercice : créer un modèle de session :**

Pour ce module Open Academy, un modèle va permettre de gérer les **sessions** de cours. Une session est un cours planifié à une date pour des personnes.

Pour créer un modèle de sessions il faut préciser : 
    * le **nom** de la session,
    * une **date de début**,
    * une **durée**,
    * le nombre de place.

Une action doit être ajoutée et associé à un nouvel élément de menu dans le menu pour afficher les sessions
**Démarche à suivre :** 
  - Créez la classe Session dans le fichier **openacademy/models.py**.
  - Ajoutez un accès à l'objet Session dasn le fichier **openacademy/view/openacademy.xml**.

  * Modifiez le fichier **openacademy/models.py**

<code python>
    name = fields.Char(string="Title", required=True)
    description = fields.Text()


class Session(models.Model):
    _name = 'openacademy.session'

    nom = fields.Char(required=True)
    date_deb = fields.Date()
    duree = fields.Float(digits=(6, 2), help="Duree en jours")
    places = fields.Integer(string="Nombre de place")
</code>
  * Modifiez le fichier **openacademy/view/openacademy.xml**
<code xml>
        <!-- Full id location:
             action="openacademy.cours_list_action"
             It is not required when it is the same module -->

        <!-- session form view -->
        <record model="ir.ui.view" id="session_form_view">
            <field name="name">session.form</field>
            <field name="model">openacademy.session</field>
            <field name="arch" type="xml">
                <form string="Formulaire Session">
                    <sheet>
                        <group>
                            <field name="nom"/>
                            <field name="date_deb"/>
                            <field name="duree"/>
                            <field name="places"/>
                        </group>
                    </sheet>
                </form>
            </field>
        </record>

        <record model="ir.actions.act_window" id="session_list_action">
            <field name="name">Sessions</field>
            <field name="res_model">openacademy.session</field>
            <field name="view_type">form</field>
            <field name="view_mode">tree,form</field>
        </record>

        <menuitem id="session_menu" name="Sessions"
                  parent="openacademy_menu"
                  action="session_list_action"/>
    </data>
</openerp>
</code>
</WRAP>
<WRAP center round info>
**Information :** 
digits=(6, 2) indique la précision du réel : 
  * 6 est le nombre total de chiffres,
  * 2 est le nombre de chiffres après la virgule (au maximum 4.
</WRAP>

===== Les champs permettant de gérer les relations =====
Des champs permettent de gèrer les relations entre enregistrements :
  * d'un même modèle -> gérer des hiérarchies,
  * ou entre des modèles différents.

Voici les différebnets types de champs relationnels :
  * **Many2one**(other_model, ondelete='set null') :
    * c'est un simple lien vers un autre objet
  * **One2many**(other_model, related_field)
    * c'est l'inverse Many2one. Cela peut renvoyer une liste d'enregistrement qui seront à traiter au sein d'une boucle.
  * **Many2many**(other_model) :
    * Tout comme **One2many**, cela peut renvoyer une liste d'enregistrement qui seront à traiter au sein d'une boucle.


<WRAP center round todo >
**Exercice : gérer des relations de type Many2one  :**

Vous allez modifier les modèles de **cours** et de **session** pour prendre en compte leurs relations avec d'autres modèles :
  * un **cours** à un **responsable** : la valeur de ce champ permettra de lier l'enregistrement au modèle existant **res.users** ;
  * une **session** a un **formateur** : la valeur de ce champ permettra de lier l'enregistrement au modèle existant **res.users** ;
  * une session est liée à un cours : la valeur de ce champ permettra de lier l'enregistrement au modèle **openacademy.course** que vous avez créé ; 
  * et pour finir, il faudra **adapter les vues**.

**Travail à faire :** 
  - ajouter les champs Many2one aux modèles,
  - et les ajouter aux vues ;

  * Modifiez le fichier **openacademy/models.py**

<code python>
    name = fields.Char(string="Titre", required=True)
    description = fields.Text()

    responsable_id = fields.Many2one('res.users',
        ondelete='set null', string="Responsable", index=True)


class Session(models.Model):
    _name = 'openacademy.session'

    nom = fields.Char(required=True)
    date_deb = fields.Date()
    duree = fields.Float(digits=(6, 2), help="Duree en jours")
    places = fields.Integer(string="Nombre de places")
    formateur_id = fields.Many2one('res.partner', string="Formateur")
    cours_id = fields.Many2one('openacademy.cours',
        ondelete='cascade', string="Cours", required=True)




</code>

  * Modifiez le fichier **openacademy/views/openacademy.xml**
<code xml>
        <!-- modifier la vue list des cours-->     
         <record model="ir.ui.view" id="cours_tree_view">
            <field name="name">course.search</field>
            <field name="model">openacademy.cours</field>
            <field name="arch" type="xml">
                <tree string="Liste des cours">
                   <field name="name"/>
                   <field name="description"/>
                   <field name="responsable_id"/>
                </tree>
            </field>
        </record>
...

        <!-- session form view -->
        <record model="ir.ui.view" id="session_form_view">
            <field name="name">session.form</field>
            <field name="model">openacademy.session</field>
            <field name="arch" type="xml">
                <form string="Formulaire Session">
                    <sheet>
                        <group>
                            <group string="General">
                                <field name="cours_id"/>
                                <field name="nom"/>
                                <field name="formateur_id"/>
                            </group>
                            <group string="Planification">
                                <field name="date_deb"/>
                                <field name="duree"/>
                                <field name="places"/>
                            </group>
                        </group>
                    </sheet>     
                </form>
            </field>
        </record>
        
        <!-- session tree/list view -->
        <record model="ir.ui.view" id="session_tree_view">
            <field name="name">session.tree</field>
            <field name="model">openacademy.session</field>
            <field name="arch" type="xml">
                <tree string="Liste des sessions">
                    <field name="nom"/>
                    <field name="cours_id"/>
                </tree>
            </field>
        </record>

</code>
  * Modifiez la vue **cours_form_view** pour permettre la saisie du responsable du cours dans uin **nouvel onglet**.
<code xml>
                         <notebook>
                            <page string="Responsable">
                                <field name="responsable_id"/>
                            </page>
                            <page string="Description">
                                <field name="description"/>
                            </page>
                            <page string="A propos">
                                Ceci est un exemple de notebooks
                            </page>
                        </notebook>

</code>
</WRAP>

<WRAP center round todo >
**Exercice : gérer des relations de type un à plusieurs One2many :**

Vous allez modifier les modèles de **cours** afin de pouvoir gérer la relation d'**un cours avec plusieurs sessions** de famation :
  *  Modification de la classe Cours, et
  * ajout du champ dans le formulaire de cours.

  * Modifiez le fichier **openacademy/models.py** :
<code python>
    responsable_id = fields.Many2one('res.users',
        ondelete='set null', string="Responsable", index=True)
    session_ids = fields.One2many(
        'openacademy.session', 'cours_id', string="Sessions")
</code>

  * Modifiez le fichier **openacademy/views/openacademy.xml** pour compléter le formulaire **cours_form_view** :
<code xml>
                        <notebook>
                            <page string="Responsable">
                                <field name="responsable_id"/>
                            </page>
                            <page string="Description">
                                <field name="description"/>
                            </page>
                            <page string="Sessions">
                                <field name="session_ids">
                                    <tree string="Sessions enregistrees">
                                        <field name="nom"/>
                                        <field name="formateur_id"/>
                                    </tree>
                                </field>
                            </page>
                            <page string="A propos">
                                Ceci est un exemple de notebooks
                            </page>
                        </notebook>


</code>
</WRAP>

===== Retour au sommaire de création d'un module =====
<WRAP center round info>
[[dev:odoo:creermodule:accueil|Développer un module dans Odoo (version 8)]]
</WRAP>