创建和安装一个新的Odoo模块

StackSurfer

已于 2024-03-09 23:34:45 修改

阅读量646

点赞数 10

文章标签： python

于 2024-03-09 23:32:39 首次发布

本文链接：https://blog.csdn.net/StackSurfer/article/details/136593363

版权

创建和安装一个新的Odoo模块涉及到一系列的步骤，包括模块的创建、文件结构的组织、模型的添加以及视图和菜单项的配置。

创建和安装一个新的插件模块

在Odoo中，一个插件模块通常指的是一个自定义模块，它扩展了Odoo的功能。创建新模块的第一步是在Odoo的“addons”目录下创建一个新的目录来存放模块的所有文件。

使用脚手架命令来创建模块

Odoo提供了一个很方便的odoo-bin scaffold命令来帮助开发者快速生成一个模板模块结构。运行以下命令：

./odoo-bin scaffold <module_name> <where_to_store>

这里的<module_name>是你的模块名，<where_to_store>是要创建模块的目录路径，通常是Odoo的addons路径。

完成插件模块的声明

模块声明是在__manifest__.py文件中进行的。这个文件告诉Odoo关于模块的一些基本信息，如：

{
    'name': 'Module Name',
    'version': '1.0',
    'summary': 'Module Summary',
    'sequence': 10,
    'description': 'Module Description',
    'category': 'Category',
    'website': 'Website',
    'depends': ['base'],
    'data': [
        'security/ir.model.access.csv',
        'views/module_view.xml',
    ],
    'demo': [
        'demo/demo_data.xml',
    ],
    'installable': True,
    'application': True,
    'auto_install': False,
}

组织插件模块文件结构

一个典型的Odoo模块文件结构如下：

/module_name
    /controllers
    /demo
    /models
    /security
    /views
    __init__.py
    __manifest__.py

每个目录包含对应的文件类型，如模型定义在models目录，视图和菜单定义在views目录等。

添加模型

模型是Odoo中对数据结构的抽象表示。在models目录中创建一个Python文件（例如model_name.py），并定义一个类来创建新模型：

from odoo import models, fields

class YourModel(models.Model):
    _name = 'your.module.model_name'
    _description = 'Model Description'

    name = fields.Char('Name')
    # 添加更多字段...

在__init__.py文件中，确保导入新建的模型：

from . import models

并在models/__init__.py中导入具体的模型类：

from . import model_name

添加菜单项和视图

菜单项和视图定义在XML文件中，通常放置在views目录里。创建一个XML文件（如module_view.xml），并定义菜单和视图：

<odoo>
    <menuitem id="main_menu" name="Main Menu"/>
    
    <menuitem id="sub_menu" name="Sub Menu" parent="main_menu"/>
    
    <record model="ir.ui.view" id="model_form_view">
        <field name="name">Your Model Form</field>
        <field name="model">your.module.model_name</field>
        <field name="arch" type="xml">
            <form string="Your Model">
                <sheet>
                    <group>
                        <field name="name"/>
                        <!-- 更多字段... -->
                    </group>
                </sheet>
            </form>
        </field>
    </record>
    
    <record id="action_your_model" model="ir.actions.act_window">
        <field name="name">Your Model</field>
        <field name="res_model">your.module.model_name</field>
        <field name="view_mode">form,tree</field>
    </record>
    
    <menuitem id="your_model_menu" name="Your Model" action="action_your_model" parent="sub_menu"/>
</odoo>

添加访问权限

访问权限是在security目录下的ir.model.access.csv文件中定义的。创建或编辑这个文件并定义权限规则：

id,name,model_id:id,group_id:id,perm_read,perm_write,perm_create,perm_unlink
access_your_model,your.module.model_name,model_your_module_model_name,,1,0,0,0