亲宝软件园·资讯

展开

[Odoo12基础教程]之第一篇-创建Todo应用

YifChan 人气:1

声明:

本教程基于 Ruter 老师的 [Odoo基础教程系列] ,Ruter老师教程的链接地址为:Odoo基础教程系列   。

至于为什么已经有了Ruter老师的教程,还要自己再搬移一份呢?是基于一下几点考虑的:

1.虽然 Ruter 老师的教程可以说已经非常详细了,但因为字数限制难免还会有一些步骤需要读者自己去做,这其中读者自己操作时可能会出错;

2.Ruter 老师的教程是基于Odoo11进行指导的,但现在Odoo13即将发布了,11可能有点落伍了;

3.自己学到的知识才是自己的,将学习中的过程和问题记录下来,才是属于自己的知识。

话不多说,下面让我们进行正题吧。

 

本章内容总结

  • 1.项目前置准备
  • 2.创建模块,模块的简单配置
  • 3.model模型及模块安装
  • 4.创建菜单视图
  • 5.添加应用到应用列表
  • 6.创建任务列表视图。

 

项目初始准备

如果你的odoo环境还没有配合好的话,请参考我的另一篇文章:win10中odoo12环境配置

在配好环境之后,如果要启动项目,需要添加如下配置:

1.将odoo-bin文件放在odoo源码下,如果没有odoo-bin文件,可以将odoo源码下的一个odoo.py文件复制并更名为odoo-bin;

2.在 odoo源码/setup/odoo.conf中添加odoo配置,内容如下:

3.pycharm下项目启动配置,在绿色倒三角形旁边

4.在odoo源码的目录下创建一个myaddons文件夹,用来存放自己编写的odoo应用/模块,这里我的odoo源码是从gitee上下载的odoo12源码;

为了让odoo可以检索到我们自定义myaddons下的模块,我们要将myaddons的路径加入到模块检索路径下

在 odoo.conf 文件下添加如下配置:

addons_path=E:\YifChanSoft\Odoo\OdooSave\odoo_gitee\odoo\addons,E:\YifChanSoft\Odoo\OdooSave\odoo_gitee\myaddons

前一个是系统模块的路径,后面一个是我们自定义模块文件夹的路径

 

Todo应用

创建模块

在配置好环境之后,win10下执行以下命令可以创建一个应用

python odoo-bin scaffold todo myaddons

以上命令代表,在myaddons目录下创建一个名为todo的模块。

目录如下:

创建好todo模块后,我们在 __mainfest__.py 编写模块的清单文件:

__mainfest__.py

{
    'name': "todo",  # 应用/模块名
    'summary': """todo task""",  # 对应用/模块的摘要
    'description': """Todo task-list the things you need to do.""",  # 对应用/模块的描述
    'author': "YifChan",  # 作者
    'application': True,  # 将模块变成一个应用,可以在应用中搜索到
    'sequence': 1,  # 将应用/模块排在所有应用/模块的第一位
}

 

model模型及模块安装

在我们的todo应用中,todo任务模型要有 “待办任务”和“已完成”两个字段,

因此,我们在models/models.py中加入如下代码:

models/models.py

from odoo import models, fields, api


class TodoTask(models.Model):
    _name = 'todo.task'
    _description = '待办事项'

    name = fields.Char('描述', required=True)
    is_done = fields.Boolean('已完成?')

在models/__inti__.py中添加如下代码:

from . import models

 

此时我们的项目已经可以在应用中被找到了

打开浏览器进入 http://127.0.0.1:8069 ,如果你是第一次进入的话,可能需要进行如下配置

其中各个的含义如下:

  • master password:数据库中超级管理员的密码
  • database name:将为你现在odoo源码创建的pg数据库
  • email:odoo管理员,可以不是邮箱,名字任取
  • password:odoo管理员密码

 

填写进入后,我们点击页面左上角的田字形符号,选择参数设置,点击右边的 激活开发者模式,截图如下:

不要纠结我左上角的todo,这是因为我已经装好并配置好了,原来只有todo下面的两列。

激活开发者模式之后,我们继续点击田字形符号里的应用,然后点击导航条上的刷新本地模块列表。

这样我们就可以在右上角的搜索框中搜索todo了,如果是模块的话,记得叉掉应用后再查找模块名,这里因为我们已经配置了todo为应用,所以可以直接查找,查找结果如下:

点击安装,然后会刷新,但是刷新后你会发现还是回到了应用页面,并且再次搜索todo后,会显示已安装。

我们还不能进入todo应用页面,这是因为我们还没有给todo添加应用入口,下面我们来进行添加。

 

创建菜单

在views文件夹下,我们创建一个 views/todo_menus.xml 文件,并添加如下内容

<?xml version="1.0" encoding="utf-8"?>
<odoo>
    <data>
        <!-- 主菜单定义 -->
        <menuitem id="menu_todo" name="Todo"/>
        <!-- 菜单动作定义 -->
        <record id="action_todo_task" model="ir.actions.act_window">
            <field name="name">待办事项</field>
            <field name="res_model">todo.task</field>
            <field name="view_type">form</field>
            <field name="view_mode">tree,form</field>
            <field name="target">current</field>
        </record>
        <!-- 子菜单定义 -->
        <menuitem action="action_todo_task" id="submenu_todo_task" name="待办事项"
                  parent="menu_todo" sequence="10"/>
    <https://img.qb5200.com/download-x/data>
</odoo>

将todo_menus.xml文件添加入data列表中:

__mainfest__.py

'data': [
        'views/views.xml',
        'views/templates.xml',
        'views/todo_menus.xml',
    ],

搜索模块,点击模块右上角的三点,进行升级模块。

 

注意事项

  • 在odoo中,如果你修改了xml文件,你所做的修改要升级应用后才能生效;
  • 如果你修改了py文件,要重启项目并且升级应用后才能使修改生效;但是我个人习惯,只要修改了,就重启项目并且升级应用。
  • 当你添加一个xml视图文件或者权限文件后,要将文件放入应用下的__mainfest__.py文件的data列表中。
  • 当你新建了一个python相关的文件夹,要在项目下的__init__.py文件中引入文件夹;
  • 当你在应用下的某个文件夹中新建了一个要自动初始化的py文件,要在该文件夹中的__init__.py文件中引入你所添加的py文件。

以上几点很重要,故在此统一列出,在后面可能不会再赘述,请读者牢记。

 

添加应用到应用列表

到了上一步其实我们还是不能观察到变化,这是因为我们还没有添加应用到应用列表中,即左上角的田字形列表中,先展示一下效果图:

 为了实现这个,我们要确保一下三点:

  • 1,有model模型,
  • 2,在model模型的基础上,menu.xml中有具体子菜单项及动作
  • 3,在csv权限中有查看model的权限并将csv文件添加到data列表中

前面我们已经实现了model模型,和菜单xml,接下来我们实现第三点,

我们给security/ir.model.access.csv文件中添加如下内容:

id,name,model_id:id,group_id:id,perm_read,perm_write,perm_create,perm_unlink
access_todo_task,todo.task,model_todo_task,,1,1,1,1

这里是给todo.task模型赋予增删改查的权限。

做完这个我们还要将这个文件添加到data列表中,其实只要解开该文件的注释即可,如下:

'data': [
        'security/ir.model.access.csv',
    ],

 

重启项目,升级模块。

至此,我们可以点击左上角的下拉菜单并可以点击todo应用来进入应用,我们可以看到如下内容:

 你可以点击创建一个任务看看。

 

创建任务列表视图

通过上一步我们已经可以看到任务列表了,这个是系统为我们自动配置的视图。

但是我们只能看到任务的name字段,而无法直接看见任务是否完成,此时,我们可以配置自己的视图来按照自己的需求来显示任务列表。

创建 views/todo_views.xml,并在其中加入如下内容

<odoo>
    <data>
        <!-- 待办事项列表显示视图 -->
        <record id="todo_task_view_tree" model="ir.ui.view">
            <field name="name">todo.task.view_tree</field>
            <field name="model">todo.task</field>
            <field name="type">tree</field>
            <field name="arch" type="xml">
                <tree string="Todo">
                    <field name="name"/>
                    <field name="is_done"/>
                </tree>
            </field>
        </record>
    <https://img.qb5200.com/download-x/data>
</odoo>

将todo_view.xml加入data列表中。

升级应用后我们可以看到如下内容:

本节内容基本到此结束了。

 

加载全部内容

相关教程
猜你喜欢
用户评论