2.2 模块结构

每个模块内都是模块目录中的一个目录。模块目录使用--addons路径选项指定。技巧：大多数命令行选项也可以使用配置文件设置        一个 Odoo 模块是由它的 Manifest 文件声明。这是强制性的，它包含了一个 Python 字典，声明模块的各种元数据：该模块的名称和说明，他正常工作所依赖的 Odoo 模块列表，引用的数据文件，...Manifest 文件的一般结构为：

{    'name': "MyModule",    'version': '1.0',    'depends': ['base'],    'author': "Author Name",    'category': 'Category',    'description': """    Description text    """,    # data files always loaded at installation    'data': [        'mymodule_view.xml',    ],    # data files containing optionally loaded demonstration data    'demo': [        'demo_data.xml',    ],}

模块也是一个名为 __init__.py 的 python package, 它用 import 引入这个模块的各种 python 文件。举个例子，如果这个模块只有一个文件 mymodule.py, __init_.py 文件内容可能只有这一句：

import mymodule

幸运的是，有一个机制帮助你创建一个模块。odoo.py 命令有一个子命令 scaffold 用来创建一个空模块：odoo.py scaffold

这个命令为你的模块创建了一个子目录，并且自动的创建了模块的各种文件。很多文件只有注释或者是XML。这些文件的使用会在这个教程中详细解释。作业：创建一个模块

openacademy/__init__.py

openacademy/controllers.py

Oopenacademy/demo.xml

penacademy/models.py

from openerp import models, fields, api

openacademy/templates.xml

Odoo的一个关键组成部分是 ORM 层。这层避免了手工编写的大部分SQL，并提供可扩展性和安全性服务[2]。业务对象被声明为扩展模式，它们集成到自动化系统的持久性Python类。模型可以通过在其定义中进行配置设置多个属性。最重要的属性是_name是必需的，它定义了模块在Odoo系统中的名称。这里是一个模块的最小完整定义：from openerp import modelsclass MinimalModel(models.Model):    _name = 'test.model'

字段Fields定义了model 可以保存什么、存在哪里。Fields定义成 model 类的属性:

from openerp import models, fieldsclass LessMinimalModel(models.Model):    _name = 'test.model2'    name = fields.Char()

name = field.Char(required=True)

from openerp import models, fields, apiclass Course(models.Model):    _name = 'openacademy.course'    name = fields.Char(string="Title", required=True)    description = fields.Text()

数据文件(Data files)

Odoo 很大程度上是一个数据驱动系统。尽管模块的行为通过 python code 进行了个性化，但是模块(module)的部分数据在加载的时候已经被设置。

• model is the name of the Odoo model for the record
• id is an external identifier, it allows referring to the record (without having to know its in-database identifier)
• elements have a name which is the name of the field in the model (e.g. description). Their body is the field’s value.

数据文件必须通过 manefest 文件声明以便被夹加载，他们可以定义在'data'列表 (总是加载) or 或者在 'demo' 列表 (只有在演示模式才能被加载。).作业：定义一个演示数据（Define demonstration data）创建一个带几条演示数据填充的 courses 模块，编辑openacademy/demo.xml文件使其包含一些数据.

             model="openacademy.course" id="course0">             name="name">Course 0             name="description">Course 0's description也可以是几行的                             model="openacademy.course" id="course1">             name="name">Course 1                     

                             model="ir.actions.act_window" id="course_list_action">             name="name">Courses             name="res_model">openacademy.course             name="view_type">form             name="view_mode">tree,form             name="help" type="html">                 class="oe_view_nocontent_create">Create the first course