设置¶
在本章中,您将学习到:
设置本地开发环境。
Odoo数据库结构概述。
在本地环境中导出和导入Odoo数据库。
要启动和运行Odoo实例。
安装¶
有多种方式可以 安装 Odoo,具体取决于预期的使用场景。本文档假设您使用的是 :doc:`源码安装 </administration/on_premise/source>`(从源代码运行 Odoo),这最适合 Odoo 设计师和开发者。
数据库¶
结构¶
每个Odoo应用程序的工作方式都相似;它们都是按照相同的逻辑构建的。一个模型包含字段和与其他模型链接的关系字段。每个模型都有表示其所有字段的视图,包括后端和前端视图。
型号¶
Odoo 的基础是模型。模型使用字段来记录数据。记录存储在数据库中:因此它们与模型相关联。在 Odoo 中,您可以通过启用 开发者模式 并转到 来找到不同的模型。
字段¶
在一个模型中,我们将集中字段(我们需要在代码中定位的字段名称)。
另请参阅
经典字段¶
日期
字符
选择
…
关联字段¶
关系字段调用另一个模型中的字段。它们允许您将模型链接在一起并使其轻松交互。换句话说,当您使用关系字段时,您将一条记录与另一条记录(位于另一个模型上)链接起来,从而使您能够检索位于此链接记录上的字段的内容。
Many2one 字段通过从另一个模型的记录列表中选择一条记录来填充(从 many 条记录中选择 one 条)。例如,报价单上的 customer 字段让您从 contact 模型上的多个客户中选择一个客户。
One2many 字段是对现有 many2one 关系的反向搜索。例如,您可以在联系人上列出他们所有的现有报价(从 一条 记录中,您显示 多条)。
Many2many 字段通过从另一个模型的记录列表中选择一个或多个记录来填充。例如,您可以在一个产品上放置多个标签,并且多个产品可以使用相同的标签(从 many 记录中,您可以选择 many)。
查看¶
视图定义了记录在最终用户面前的显示方式。它们以XML格式指定,这意味着可以独立于它们所代表的模型进行编辑。它们灵活且允许对其控制的屏幕进行深度定制。
后端 vs. 前端¶
后端视图:看板视图、列表视图、表单视图等。
前端视图:QWeb
静态 vs. 动态¶
静态页面 有稳定的内容,比如主页。您可以定义它们的URL并设置一些属性,如发布、索引等。
动态页面 是动态生成的,例如产品页面。它们的 URL 是动态的,默认情况下所有人都可以访问(可以通过配置访问权限来更改)。
标准 vs. 继承¶
标准视图 是由 Odoo 实现的基础视图。它们直接派生自其模型。你永远不应该更改它们,因为它们允许更新 Odoo 数据库而不会覆盖客户的修改。
继承视图 是重复的视图。修改总是在继承视图中进行。如果存在重复的视图,数据库中会有两个同名的视图,但重复的视图不会像标准视图那样拥有一个 ID。
导入现有数据库¶
注解
如果您不需要导入现有数据库,您可以直接转到 主题化 章节。
转储¶
Odoo SaaS¶
前往 <database_url>/saas_worker/dump
。
Odoo.sh¶
连接到Odoo.sh。
选择您要备份的分支。
选择 备份 选项卡。
点击 创建备份 按钮。
当过程结束时,会出现一个通知。打开它并点击 转到备份 按钮。
点击 Download 图标。选择 Testing 在 Purpose 下,选择 With filestore 在 Filestore 下。
当备份准备好可以下载时,您将收到通知。打开它并点击 下载 来获取您的备份。
移动文件存储¶
复制文件存储文件夹中的所有文件夹,并将它们粘贴到您计算机上的以下位置:
macOS:
/Users/<用户>/Library/Application Support/Odoo/filestore/<数据库名称>
Linux:
/home/<用户>/.local/share/Odoo/filestore/<数据库名称>
注解
/Library
是一个隐藏的文件夹。
数据库设置¶
创建一个空数据库。
createdb <database_name>
导入刚刚创建的数据库中的SQL文件。
psql <database_name> < dump.sql
重置管理员用户密码。
psql \c
<database_name>
update res_users set login='admin', password='admin' where id=2;
开始¶
运行 Odoo¶
一旦所有依赖项设置完成,可以通过运行 odoo-bin
命令行界面来启动 Odoo 服务器。它位于 Odoo 社区目录的根目录。
要配置服务器,您可以指定命令行参数或配置文件。下面是第一种方法的演示。
The CLI offers several functionalities related to Odoo. You can use it to run the server, scaffold an Odoo theme, populate a database, or count the number of lines of code.
Shell脚本¶
一种典型的 运行服务器 的方法是将所有命令行参数添加到 .sh
脚本中。
Example
./odoo-bin --addons-path=../enterprise,addons --db-filter=<database> -d <database> --without-demo=all -i website --dev=xml
文件夹 |
描述 |
---|---|
以逗号分隔的目录列表,其中存储了模块。这些目录将被扫描以查找模块。 |
|
安装或更新模块时使用的数据库。 |
|
隐藏不符合过滤器条件的数据库。 |
|
在运行服务器之前要安装的模块的逗号分隔列表。(需要 |
|
在运行服务器之前要更新的模块的逗号分隔列表。(需要 |
|
禁用以逗号分隔的已安装模块的演示数据加载;对于所有模块,请使用 |
|
逗号分隔的功能列表。仅供开发目的使用。 更多信息 |
登录¶
服务器启动后(INFO日志 odoo.modules.loading: Modules loaded.
被打印出来),在您的网络浏览器中打开http://localhost:8069,并使用基本管理员账户登录。
输入 admin 作为电子邮件和 admin 作为密码。
小技巧
按下 CTRL+C 停止服务器。如果需要,可以按两次。
开发者模式¶
开发者模式,也称为调试模式,对于开发非常有用,因为它提供了额外的工具。在接下来的章节中,假设您已经启用了开发者模式。
另请参阅