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

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

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

OpenERP 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.

Odoo exige l'existence d'un champ name pour tous les modèles à des fins d'affichage et de recherches.

# -*- coding: utf-8 -*-
from osv import osv, fields
 
class cours(osv.Model):
    _name = 'openacademy.cours'
    _columns = {
      'name': fields.char(string='Titre', required=True),
      'description': fields.text(string='Description'),
    }

Si un module de données 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.

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

• 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 dasn le modèle. Ils contiennent les valeurs affectées aux champs.

<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 ête 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>

# service openerp restart