Les cours du BTS SIO

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== La couche ORM  ======

La couche **ORM** (Object-Relational Mapping) d'Odoo évite d'écrire des requêtes SQL. Les objets métiers qui accèdent à la base de données héitent de la **classe Model** qui intègre les mécanismes de persistance des objets. 

===== Déclaration d'un modèle de données =====

Les informations à fournir sont :
  * **_name** : le nom du modèle
  * les champs de données, attributs du modèle
    * les champs **simples** : Boolean, Date, Char ;
    * les champs gérant les **relations** entre enregistrements 

<WRAP center round info>
**Exemples : **
  * déclaration du champ **name** de type **suite de caractères** :
name = fields.Char()

La méthode Char() pourra accepter des paramètres qui précisent les caractéristiques du champ (voir ci-après)
  * déclaration du champ **dateachat** de type **Date** :
dateachat = fields.Date()
</WRAP>


On peut préciser les caractéristiques des champs : 
  * **string** : par défaut c'est le nom du champ et c'est ce qui est affiché comme label dans les pages
  * **required** : booléen et par défaut est False ; Si True le champ doit être renseigné par l'utilisateur ou par défaut lors de la création d'un enregistrement
  * **help** : Unicode et par default '' ; fournit une aide à la saisie
  * **index** : booléen par défault False ; un index sera créé sur le champ par Odoo

<WRAP center round info>
**Exemple : **
  * déclaration du champ **name** de type **suite de caractères** avec un label précis et une saisie obligatoire:
name = fields.Char(string="Titre", required=True)
</WRAP>

===== Les champs réservés =====

Odoo crée des champs réservés qui ne peuvent être modifiés par l'utilisateur. Ils peuvent être lus si nécessaire pour des traitements.

  * **id** (Id)  : identifiant unique ;
  * **create_date** (Datetime) : date de création de l'enregistrement ;
  * **create_uid** (Many2one) : identifiant de l'utilisateur qui a créé l'enregistrement
  * **write_date** (Datetime) : date de la dernière modification
  * **write_uid** (Many2one) : identifiant du dernier utilisateur qui a modifié l'enregistrement.

===== Les champs spéciaux =====
Odoo **exige** l'existence d'un champ **name** pour tous les modèles à des fins d'affichage et de recherches.

<WRAP center round todo>
A faire : 
  * Définissez le modèle suivant pour un cours avec un titre (obligatoire)  et une description.
  * Editez le fichier **models.py** et ajouter la classe **Cours**.

<code python>
from openerp import models, fields, api

class Cours(models.Model):
    _name = 'openacademy.cours'

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

===== Les fichiers de données de démonstration=====
Si un module de données de démonstration a été défini, il est automatiquement chargé.

Un module de données est déclaré dans un fichier au format **XML** avec des éléments **<record>**. Chaque élément **<record>** crée ou met à jour un enregistrement de la base de données.

<code xml>
<openerp>
    <data>
        <record model="{model name}" id="{record identifier}">
            <field name="{a field name}">{a value}</field>
        </record>
    </data>
<openerp>
</code>

  * **model** : est le nom du modèle Odoo dans l'enregistrement ;
  * **id** : est un identifiant externe pour faire référence à l'enregistrement ;
  * les éléments **<field>** ont le même nom que celui du champ dans le modèle. Ils contiennent les valeurs affectées aux champs.

<WRAP center round info >
Les fichiers de données Data doivent être déclarés dans le fichier manifest **%%__openerp__.py%%** :
  * soit dans la section **data** s'ils doivent être systématiquement chargés ;
  * soit dans la section **demo** s'ils ne doivent être chargés que si la base est créée en mode **démonstration**.
</WRAP>

<WRAP center round todo>
**Exercices : définir des donnés de démonstration pour quelques cours :**

  * Modifiez le fichier **demo.xml** avec les informations suivantes .. ou d'autres.

<code xml>
<openerp>
    <data>
        <record model="openacademy.cours" id="cours0">
            <field name="name">Français</field>
            <field name="description">Activités sur la rédaction des mémoires
Activités sur les grands classiques de la science-fiction (Stars Wars, etc.)
et bien d'autres choses encore ...
Plusieurs lignes peuvent être utilisées
            </field>
        </record>
        <record model="openacademy.cours" id="cours1">
            <field name="name">Mathématiques</field>
            <!-- pas de description pour ce cours -->
        </record>
        <record model="openacademy.cours" id="cours2">
            <field name="name">Anglais</field>
            <field name="description">Préparation TOEIC</field>
        </record>
    </data>
</openerp>
</code>
</WRAP>

<WRAP center round important>
Attention au copier-coller pour les caractères accentués.
</WRAP>

**Mettez à jour** le module et visualisez sous PostgreSQL la création de la table **openacademy_cours** qui contient :
  * **7** colonnes,
  * et vos **données de démonstration**. 

<WRAP center round tip>
Si la table table  **openacademy_cours** n'est pas créée :
  * **relancez** le service Odoo :
<code shell>
$ sudo service odoo restart
</code>
    * et **actualisez** le module.
</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>
Les cours du BTS SIO

Outils pour utilisateurs

Outils du site

Outils de la page
