Odoo软件二次开发：Odoo高级编程技巧

Odoo软件二次开发：Odoo高级编程技巧

Odoo开发环境搭建

安装Odoo开发工具

在开始Odoo的二次开发之前，首先需要确保你的开发环境已经就绪。这包括安装必要的开发工具，如Python环境、Odoo框架本身以及版本控制工具如Git。

Python环境

Odoo基于Python开发，因此，首先需要在你的计算机上安装Python。推荐使用Python 3.6或更高版本，因为Odoo不再支持Python 2。

# 安装Python
sudo apt-get update
sudo apt-get install python3.6

123

确认Python已正确安装：

python3 --version

1

安装Odoo

Odoo可以通过源代码安装，这样可以方便地进行定制和调试。从Odoo的GitHub仓库下载源代码：

# 克隆Odoo源代码
git clone https://github.com/odoo/odoo.git

12

进入Odoo目录并安装依赖：

cd odoo
sudo apt-get install -y build-essential libxml2-dev libxslt1-dev python-dev python-setuptools python-mako python-misaka python-pyparsing python-docutils python-ldap python-psycopg2 python-psycopg2-binary python-pybabel python-serial python-protobuf python-libxml2 python-libxslt python-openssl libssl-dev libffi-dev python-pip

12

使用pip安装额外的Python依赖：

pip3 install -r requirements.txt

1

安装PostgreSQL

Odoo使用PostgreSQL作为数据库，因此需要安装PostgreSQL服务器和客户端。

sudo apt-get install postgresql postgresql-contrib

1

创建一个用于Odoo的数据库用户：

# 以postgres用户登录
sudo -u postgres psql

# 创建用户
CREATE USER odoo WITH PASSWORD 'odoo';

12345

退出psql：

q

1

配置Odoo开发环境

配置Odoo开发环境涉及设置Odoo服务器、配置数据库连接以及设置附加模块的路径。

配置Odoo服务器

编辑Odoo的配置文件odoo.conf，通常位于/etc/odoo/目录下，以添加或修改配置参数。

[options]
addons_path = /path/to/your/addons,/path/to/odoo/addons
db_host = localhost
db_user = odoo
db_password = odoo

12345

这里，addons_path参数指定了Odoo附加模块的路径，包括你自己的模块和Odoo自带的模块。

启动Odoo服务器

使用以下命令启动Odoo服务器：

./odoo-bin

1

这将启动Odoo服务器，并在浏览器中打开http://localhost:8069。

Odoo模块开发基础

Odoo模块是其功能的核心，每个模块代表一个特定的业务领域或功能。开发Odoo模块需要理解其结构和生命周期。

模块结构

一个基本的Odoo模块包含以下文件和目录：

__manifest__.py：模块的元数据，包括名称、描述、依赖等。
models：包含模块的业务逻辑和数据模型。
views：定义用户界面和数据展示。
security：定义模块的权限和安全规则。
data：包含预定义的数据，如菜单项、权限等。
static：存放静态资源，如图片、CSS和JS文件。

创建模块

创建一个名为my_module的Odoo模块：

mkdir my_module
cd my_module

12

创建__manifest__.py文件：

# __manifest__.py
{
   
    'name': 'My Module',
    'summary': 'A brief description of the module.',
    'version': '1.0',
    'category': 'Uncategorized',
    'website': 'https://www.example.com',
    'author': 'Your Name',
    'license': 'LGPL-3',
    'application': False,
    'installable': True,
    'depends': ['base'],
    'data': [
        'views/my_module_views.xml',
        'security/ir.model.access.csv',
    ],
}


123456789101112131415161718

创建views/my_module_views.xml文件：

<!-- my_module_views.xml -->
<odoo>
    <data>
        <record id="my_module_menu" model="ir.ui.menu">
            <field name="name">My Module</field>
            <field name="sequence">10</field>
            <field name="parent_id" ref="base.menu_app_root"/>
            <field name="action">
                <ref id="my_module.action_my_module"/>
            </field>
        </record>
    </data>
</odoo>

12345678910111213

创建security/ir.model.access.csv文件：

# ir.model.access.csv
id,model_id,name,group_id,perm_read,perm_write,perm_create,perm_unlink
access_my_module,my_module.model_my_module,my_module,base.group_user,1,1,1,1

123

定义模型

在models目录下创建一个Python文件，定义数据模型：

# models/my_model.py
from odoo import models, fields

class MyModel(models.Model):
    _name = 'my_module.my_model'
    _description = 'My Model Description'

    name = fields.Char(string='Name', required=True)
    value = fields.Integer(string='Value')

123456789

安装模块

在Odoo服务器中，通过“Apps”菜单搜索并安装你的模块。确保Odoo服务器正在运行，并且你有管理员权限。

结论

通过上述步骤，你已经成功搭建了Odoo的开发环境，并创建了一个基本的Odoo模块。这为深入学习Odoo的高级编程技巧奠定了基础。接下来，你可以开始探索Odoo的更复杂功能，如工作流、报告、API集成等。

注意：上述教程中的命令和代码示例适用于基于Debian或Ubuntu的Linux系统。对于其他操作系统，安装步骤可能有所不同。

Odoo核心机制深入

理解Odoo的ORM

Odoo的ORM（Object-Relational Mapping）是一种用于将数据库表映射到Python对象的机制。这使得在不直接操作SQL的情况下，能够高效地处理数据库操作。ORM在Odoo中被广泛使用，以提供一个更高级、更抽象的接口来管理数据。

示例：创建一个简单的模型

# models.py
from odoo import models, fields

class Book(models.Model):
    _name = 'library.book'
    _description = 'Library Book'

    name = fields.Char('Title', required=True)
    author_ids = fields.Many2many('res.partner', string='Authors')
    isbn = fields.Char('ISBN')
    date_published = fields.Date('Publication Date')

1234567891011

在上述代码中，我们定义了一个Book模型，它继承自models.Model。模型的_name属性定义了数据库中的表名，而_description提供了模型的描述。字段如name、author_ids、isbn和date_published分别表示书的标题、作者、ISBN和出版日期。

掌握Odoo的继承机制

Odoo的继承机制允许开发者在不修改原有模型代码的情况下，扩展或修改模型的行为。这是通过在新模型中指定_inherit属性来实现的，该属性指向要继承的模型。

示例：扩展Book模型

# models.py
from odoo import models, fields

class BookExtended(models.Model):
    _name = 'library.book'
    _inherit = 'library.book'

    description = fields.Text('Description')
    category_id = fields.Many2one('library.category', string='Category')

123456789

在这个例子中，BookExtended模型继承了library.book模型，并添加了description和category_id字段。这意味着，所有library.book模型的实例现在都可以拥有描述和分类信息，而无需修改原始模型。

Odoo的多语言与国际化

Odoo支持多语言和国际化，这使得软件能够适应不同的语言和文化需求。开发者可以通过定义翻译字符串和使用特定的函数来实现这一功能。

示例：定义翻译字符串

# models.py
from odoo import models, fields, _
from odoo.exceptions import ValidationError

class Book(models.Model):
    _name = 'library.book'
    _description = 'Library Book'

    name = fields.Char('Title', required=True)
    author_ids = fields.Many2many('res.partner', string='Authors')

    def check_isbn(self):
        self.ensure_one()
        if not self.isbn:
            raise ValidationError(_('Please provide an ISBN for the book "%s".') % self.name)
        if len(self.isbn) != 13:
            raise ValidationError(_('ISBN should have 13 characters.'))


1234567891011121314151617

在上述代码中，_('...')函数用于标记需要翻译的字符串。当Odoo运行时，它会自动检测并替换这些字符串为用户界面语言的翻译。

示例：创建翻译文件

为了使Odoo能够翻译上述字符串，开发者需要创建一个翻译文件。这通常通过在Odoo的开发环境中使用特定的工具来完成，但也可以手动创建.po文件。

# 命令行创建翻译文件
odoo-bin -i library -c /path/to/odoo.conf --stop-after-init

12

然后，在Odoo的开发环境中，选择“翻译”->“创建翻译文件”，并选择你的模块和语言。

示例：翻译文件内容

# library.po
#: models.py:10
msgid "Please provide an ISBN for the book "%s"."
msgstr "请为书籍"%s"提供ISBN。"

#: models.py:11
msgid "ISBN should have 13 characters."
msgstr "ISBN应该有13个字符。"

12345678

在.po文件中，msgid是原始字符串，msgstr是翻译后的字符串。Odoo会使用这些信息来更新翻译。

通过深入理解Odoo的ORM、掌握其继承机制，以及熟悉多语言与国际化功能，开发者可以更有效地利用Odoo的框架，创建出功能丰富、易于维护且具有全球适用性的应用程序。

Odoo自定义模块开发

创建自定义模块

在Odoo中创建自定义模块，首先需要理解Odoo的模块结构。一个Odoo模块通常包含以下文件和目录：

__manifest__.py: 定义模块的元数据，如名称、描述、作者、依赖等。
models: 包含模块的模型定义。
views: 包含XML文件，用于定义用户界面。
security: 包含模块的安全规则。
data: 包含数据文件，如预定义数据或菜单项。
static: 包含静态资源，如图片、CSS和JS文件。

示例：创建一个简单的自定义模块

假设我们要创建一个名为custom_module的模块，用于管理公司内部的图书库存。以下是一个基本的模块结构示例：

custom_module/
├── __manifest__.py
├── models/
│   └── book.py
├── views/
│   └── book_view.xml
├── security/
│   └── custom_module_security.xml
├── data/
│   └── custom_module_data.xml
└── static/
    └── src/
        ├── img/
        └── css/

1234567891011121314

__manifest__.py

{
   
    'name': 'Custom Module',
    'summary': 'Manage company book inventory',
    'version': '1.0',
    'category': 'Custom',
    'author': 'Your Company',
    'depends': ['base']
1234567