Odoo的基础知识与环境配置

ゝ一纸荒年。 2023-10-03 12:17 24阅读 0赞

**1.Odoo是什么？**  
Odoo（原名为OpenERP，更早之前则为TinyERP）是一套企业资源规划（ERP）及以客户为中心的客户关系管理（CRM）系统。以Python语言开发，数据库采用开源的PostgreSQL，系统以GNU GPL开源协议发布。

系统提供较灵活的模块架构，常用模块包括：采购管理、销售管理、库存管理、财务管理、货品管理、营销管理、客户关系管理、生产管理、人事管理及服务支持等等。用户可以直接从模块库中选择安装适用的模块，进行模块卸载、升级的管理操作。Odoo现在有一套完整的业务应用，满足所有的企业业务需求，从网站、电子商务到制造，库存和会计等，所有的领域无缝集成。这是第一次一个软件系统，被设计成能达到这么全面的功能覆盖。

客户端用户界面是基于GTK的，同时支持Linux和Windows平台。目前还有开发中的基于TurboGears的eTiny Web客户端。

**2.Odoo的环境配置**  
在开始环境配置之前，我们可以先了解一下WSL（全称为Windows Subsystem for Linux），官方翻译为“适用于Linux的Windows子系统”。因为程序开发会特别依赖终端命令的开发，而win10下的cmd终端并没有linux那么多的命令和软件扩展。而且作为一个程序员，不管我们是做前端或者是后端，多少都需要对linux环境有一定的了解，因为程序运行的环境就是在linux中，有些功能只有在linux环境下才能实现。

而WSL的优势就在于，在win10的环境下运行，并不需要特地装一个Linux的系统。并且其唤出终端就可以直接使用linux的命令，相比虚拟机来说会方便许多。最重要的是wsl的学习成本很低。在此处WSL只需要了解即可。

接下来开始正式的环境配置:

第①步 连接WSL

以管理员模式运行Windows powerShell

输入以下代码 启动WSL（Windows subsystem for linux）功能

![0ece89b347b2b7152164c51404cd123d.png][]

输入以下代码启动虚拟机功能

![bca8440d68248310849d9b7f81831079.png][]

此时重启电脑以完成WSL的安装及更新。

接下来还是打开Power Shell，将WSL2设置为默认版本

![0e76c89476ff822d62bb5304cca245be.png][]

现在可以下载Windows terminal和Ubuntu 20.04LTS，在微软商店中即可下载。

![bd14540167eac9402818b51b997d0b0c.png][]

下载好后打开Ubuntu控制台就会让你为新的Linux系统创建用户和密码

接下来用Windows Terminal打开Power shell在其中查看WSL的状态 （wsl --list -v)

![1f1342ad8235a151635f3b6895a6a3cb.png][]

在powershell中启动并进入WSL(wsl)

![5dce347f85a24bb97347bd25195d268b.png][]

在这里输入exit可以从Linux Bash中 logout 并回头PowerShell中

![100c603dce9d42325423c99a19c1c1f1.png][]

但此时Linux系统仍然会在后台运行， 需要使用以下代码关闭Linux系统

![c99ffe4ea9c5f000ceca5279c2fad98b.png][]

此时再查看发现状态由Running变成了Stopped

![f933c28b48952685b8ad2dad5f140a67.png][]

点击此处即可再Windows Terminal中连接WSL

![2ac16ab93a44a2611d36247f135d081e.png][]

第②步 安装postgreSQL

输入sudo apt-get update更新apt工具源，并验证新建Linux用户时的密码

![3971b840e8ff1352f5d8c26f1641a69c.png][]

然后再用apt工具安装postgreSQL

![ded61f8fd0f5b6ed59d037b1f5c367e9.png][]

确认postgreSQL安装成功

![8a4fae117446587f47ca8bb081b474f7.png][]

启动PostgreSQL服务

![a5408b242a874544f7067cd272553382.png][]

PostgreSQL默认用户为postgres， 但Odoo会禁止以默认用户连接，所以此时我们需要创建一个新的postgreSQL用户，建议与Linux用户同名。

![3d96f38f919c632f04476bc17a2f071a.png][]

同时也需要创建一个数据库（需要postgreSQL服务运行），这里我同样同名创建。

![1540f55f112f1c2fc514baf488396c2e.png][]

下面有一些postgreSQL的常用命令：

查看postgreSQL服务状态：sudo service postgresql status

启动PostgreSQL服务： sudo service postgresql start

停止PostgreSQL服务： sudo service postgresql stop

创建数据库： createdb <数据库名>

连接到数据库: psql <数据库名>

第③步 安装python及其他依赖：

首先检查python版本（版本不够时可以使用“sudo apt install python3” 安装）：

![5644a4b620d5b1c0344f11dafe183793.png][]

安装python开发工具用：sudo apt install python3-pip python3-dev libxml2-dev libxslt1-dev libldap2-dev libsasl2-dev libssl-dev libpq-dev libjpeg-dev

![3577431f4ad6eb13e569a9b8a61b9efb.png][]

第④步 下载Odoo源码：

首先我们创建source文件夹并进入，然后从GIthub拉取Odoo源码

![b0d795c53972b225eed01f8516f997f8.png][]

用cd切换到 /src/odoo后安装工具

![46c094e3e1ce721f2640addfe4c42c57.png][]

设置python虚拟环境并启动

![b2148754c47ce3ae477ee2a56ad075f7.png][]

接下来依照odoo文件夹中的requirements.txt安装依赖（此过程耗时较长且可能因为网络等原因中断，如果发生此情况请多试几次）

![c752791c78e71ffd0e9e5dcce5f2078c.png][]

依赖安装完毕后，可以在确认PostgreSQL服务已经在运行后（sudo service postgresql status查看服务状态）通过二进制文件运行Odoo， 要注意自己数据库的名字要输入正确(-i base为首次启动初始化数据库， 以后启动不需要）

![71a3896a353746066ec4fd051d0d7d69.png][]

成功后可在浏览器中输入[localhost][] [进入到登录界面，以默认用户名及密码admin登录。][admin]

![8549457060ddbeb58d58e2e71af890e5.png][]

![3b59a1a16c4ffbb764f169d3ef63b136.png][]

到此处Odoo的开发环境就算是配置完成啦！

**3.Odoo的一些基础知识。**  
在学习Odoo开发之前，我们需要了解一下Odoo的基础知识。Odoo遵行的是MVC设计模式，我们可以从这个方面入手了解odoo。

首先是odoo模型开发：

odoo模型对象基本分为三种：

odoo.models.Model:常规数据库持久模型，在模块安装或升级的时候会自动在数据库中创建相应的数据表。

odoo.models.TransientModel:临时记录的模型超类，可暂时的持久化，表中数据会定期进行清理。

odoo.models.AbstractModel:抽象模型超类，不会在数据库创建对应表，可为多个Model提供相同属性的统一声明。

odoo模型常用的属性定义有以下几种：

\_name:模型唯一的标识，该类非继承父类时必须指定。

\_description:模型描述。

\_inherit:被继承的模型名称。

\_table:模型对应的数据表的名称，默认值是\_name的值中将.转换成\_（一般无需配置）

\_rec\_name:在其他模型中引用此模型时显示的字段，默认为name。

\_order:排序字段。

然后是view视图的开发：

常用的视图字段有：

name:视图描述，必须配置

model：视图对应的模型名称

arch： 视图布局描述

常用的视图属性：

create: 禁用/启用创建记录，值为ture或false

edit：禁用/启用编辑记录，值为true或false（在form、list、gantt中使用）

delete：禁用/启用删除记录，值为true或false（在form、list中使用）

duplicate：禁用/启用复制记录，值为true或false（在form、list中使用）

import：禁用/启用导入功能，值为true或false（list中使用）

widget：控件类型

常用的widget类型：

progressbar：进度条，按百分比标签

selection： 下拉选择菜单

radio ：单选标签

date： 日期标签

text： 文本标签

checkbox： 复选框标签

url： 网站链接标签

one2many\_list： 一对多标签

monetary：金额标签

many2many\_binary ：文件上传

接下来是Odoo常用的字段类型

我们可以自己理解一下模型与字段的关系：简单理解为模型由字段组合配置，字段装饰了模型。连接数据库后模型映射为数据库中的表，字段映射为表中的例。

基础字段类型：

char ： 单行字符串（限制长度）

text ： 多行字符串 （无长度限制）客户端中显示为文本框

Boolean ：True /False

integer：封装int

float ：fields.Float(string='\*\*',digists=(1,2)) digists属性定义整数部分和小数部分的位数。

Date： 短日期型 包含年月日

Datetime： 时间戳型 包含年月日时分秒

Html： 封装html代码内容

binary ：封装二进制内容

selection：枚举类型（下拉列表显示）需要在其中预定义展示的数据

高级字段类型：

reference：引用字段，可以实现让用户自定义要引用的模型和记录。可以通过定义函数来定义字段选择过滤条件。

关系字段类型：

many2one：需要在字段属性中填写关联模型的名称(主键)

one2many：需要在字段属性中填写关联模型的名称（主键）和关联字段（外键）

使用one2many字段时，many2one必须同时使用。

many2many:需要制定关联模型名称，中间表名称，当前关联模型id，需要关联模型的id。

如果没有指定关联表，odoo会自动创建一张关联表，包含两张表的主键字段。

格式： fields.many2many(关联模型名称,中间表名称，当前关联模型id，需要关联模型的id)

保留字段类型：

id: Integer类型，表主键模型中记录的唯一标识。

create\_date： Datetime类型， 记录的创建日期。

create\_uid: Many2one类型，记录的创建者。

write\_date： Datetime类型， 记录的最后修改日期。

write\_uid: Many2one类型， 记录最后修改者。

特殊字段类型：

active： Boolean类型，控制记录是否可见。 (default=False 记录不可见）

name: Unicode（字符串）类型，显示各种行为。

下面补充一下常用字段的属性：

string ： 字符串类型 默认值为字段名，是在视图中显示的字段标签。

required ： bool类型 默认值为False， 表示这个字段是否可以为空（设置是否必填作用）。

readonly： bool类型 默认值为False， 表示这个字段是否只读。

help： 字符串类型， 为用户提供帮助提示。

index： bool类型 默认值为False，表示是否在对应数据库列上创建数据库索引。

最后说一下模型中的装饰器：

装饰器: 是指让其他函数不需要做任何代码变动的前提下增加额外功能。

Odoo常用的装饰器：

Model装饰器： @api.model self仅代表自己 不包含记录信息。

onChange装饰器： @api.onchange('field') 监听某个字段发生改变时，触发对应方法。

Constraints装饰器: @api.Constraints('field') 约束某些字段（记录修改包含装饰器指定的字段，就会触发对应方法，通常用于字段检验。

Depends装饰器： @api.depends('field') 在函数中，对该字段值进行处理时，如果计算值依赖于其他相关字段，不论是与该字段隶属同一张表的还是其他表的字段，都会触发所编写的字段函数。

### 总结： ###

方法中包含的self不想包含任何记录 使用model装饰器 与self无关

onchange字段发生监听改变时绑定函数，绑定字段执行相应的方法

对字段合法性进行校验时使用constraints装饰器进行字段约束。

虽然 @api.depends 与@api.onchange有诸多相似的地方，但一个重要区别就是 onchange 的侦测字段范围需要在同一个模型或界面上；而depends 可以侦测关联的模型的字段（可以跨不同表）。

以上是本人近期开始学习Odoo整理的一些知识，写的比较杂乱，如有错误的地方请指正。

[0ece89b347b2b7152164c51404cd123d.png]: https://img-blog.csdnimg.cn/img_convert/0ece89b347b2b7152164c51404cd123d.png
[bca8440d68248310849d9b7f81831079.png]: https://img-blog.csdnimg.cn/img_convert/bca8440d68248310849d9b7f81831079.png
[0e76c89476ff822d62bb5304cca245be.png]: https://img-blog.csdnimg.cn/img_convert/0e76c89476ff822d62bb5304cca245be.png
[bd14540167eac9402818b51b997d0b0c.png]: https://img-blog.csdnimg.cn/img_convert/bd14540167eac9402818b51b997d0b0c.png
[1f1342ad8235a151635f3b6895a6a3cb.png]: https://img-blog.csdnimg.cn/img_convert/1f1342ad8235a151635f3b6895a6a3cb.png
[5dce347f85a24bb97347bd25195d268b.png]: https://img-blog.csdnimg.cn/img_convert/5dce347f85a24bb97347bd25195d268b.png
[100c603dce9d42325423c99a19c1c1f1.png]: https://img-blog.csdnimg.cn/img_convert/100c603dce9d42325423c99a19c1c1f1.png
[c99ffe4ea9c5f000ceca5279c2fad98b.png]: https://img-blog.csdnimg.cn/img_convert/c99ffe4ea9c5f000ceca5279c2fad98b.png
[f933c28b48952685b8ad2dad5f140a67.png]: https://img-blog.csdnimg.cn/img_convert/f933c28b48952685b8ad2dad5f140a67.png
[2ac16ab93a44a2611d36247f135d081e.png]: https://img-blog.csdnimg.cn/img_convert/2ac16ab93a44a2611d36247f135d081e.png
[3971b840e8ff1352f5d8c26f1641a69c.png]: https://img-blog.csdnimg.cn/img_convert/3971b840e8ff1352f5d8c26f1641a69c.png
[ded61f8fd0f5b6ed59d037b1f5c367e9.png]: https://img-blog.csdnimg.cn/img_convert/ded61f8fd0f5b6ed59d037b1f5c367e9.png
[8a4fae117446587f47ca8bb081b474f7.png]: https://img-blog.csdnimg.cn/img_convert/8a4fae117446587f47ca8bb081b474f7.png
[a5408b242a874544f7067cd272553382.png]: https://img-blog.csdnimg.cn/img_convert/a5408b242a874544f7067cd272553382.png
[3d96f38f919c632f04476bc17a2f071a.png]: https://img-blog.csdnimg.cn/img_convert/3d96f38f919c632f04476bc17a2f071a.png
[1540f55f112f1c2fc514baf488396c2e.png]: https://img-blog.csdnimg.cn/img_convert/1540f55f112f1c2fc514baf488396c2e.png
[5644a4b620d5b1c0344f11dafe183793.png]: https://img-blog.csdnimg.cn/img_convert/5644a4b620d5b1c0344f11dafe183793.png
[3577431f4ad6eb13e569a9b8a61b9efb.png]: https://img-blog.csdnimg.cn/img_convert/3577431f4ad6eb13e569a9b8a61b9efb.png
[b0d795c53972b225eed01f8516f997f8.png]: https://img-blog.csdnimg.cn/img_convert/b0d795c53972b225eed01f8516f997f8.png
[46c094e3e1ce721f2640addfe4c42c57.png]: https://img-blog.csdnimg.cn/img_convert/46c094e3e1ce721f2640addfe4c42c57.png
[b2148754c47ce3ae477ee2a56ad075f7.png]: https://img-blog.csdnimg.cn/img_convert/b2148754c47ce3ae477ee2a56ad075f7.png
[c752791c78e71ffd0e9e5dcce5f2078c.png]: https://img-blog.csdnimg.cn/img_convert/c752791c78e71ffd0e9e5dcce5f2078c.png
[71a3896a353746066ec4fd051d0d7d69.png]: https://img-blog.csdnimg.cn/img_convert/71a3896a353746066ec4fd051d0d7d69.png
[localhost]: http://localhost:8069/
[admin]: http://localhost:8069/%E8%BF%9B%E5%85%A5%E5%88%B0%E7%99%BB%E5%BD%95%E7%95%8C%E9%9D%A2%EF%BC%8C%E4%BB%A5%E9%BB%98%E8%AE%A4%E7%94%A8%E6%88%B7%E5%90%8D%E5%8F%8A%E5%AF%86%E7%A0%81admin%E7%99%BB%E5%BD%95%E3%80%82
[8549457060ddbeb58d58e2e71af890e5.png]: https://img-blog.csdnimg.cn/img_convert/8549457060ddbeb58d58e2e71af890e5.png
[3b59a1a16c4ffbb764f169d3ef63b136.png]: https://img-blog.csdnimg.cn/img_convert/3b59a1a16c4ffbb764f169d3ef63b136.png