第 14 章:与其他模块交互¶
在 上一章 中,我们利用继承修改了一个模块的行为。在我们的房地产场景中,我们想更进一步,能够为客户生成发票。Odoo 提供了开票模块,因此如果能在我们的房地产模块中直接创建发票就太好了,即房产一旦设为 ‘已售出’,就在开票应用中创建一张发票。
具体示例:Account Move¶
Note
目标:在本节结束时:
应创建一个新模块
estate_account房源售出时,应为买家开具发票
每当我们与其他模块交互时,都需要牢记模块化。如果我们打算将应用程序出售给房地产中介,有些中介可能想要开票功能,而另一些则可能不想要。
桥接模块¶
针对此类用例,常见的做法是创建一个“桥接”模块。在我们的例子中,该模块将依赖于 estate 和 account,并包含为房地产房源创建发票的逻辑。这样,房地产模块和会计模块就可以独立安装。当两者都安装时,桥接模块提供新功能。
Exercise
创建一个桥接模块。
创建 estate_account 模块,它依赖于 estate 和 account 模块。目前,它只是一个空壳。
提示:你在 教程开头 已经做过类似的事情。流程非常相似。
当 estate_account 模块出现在列表中时,就安装它吧!您会注意到 Invoicing 应用也被一并安装了。这是符合预期的,因为您的模块依赖于它。如果您卸载 Invoicing 应用,您的模块也会随之被卸载。
创建发票¶
现在该生成发票了。我们要给 estate.property 模型添加功能,即在房产售出时添加一些额外逻辑。这听起来熟悉吗?如果不熟悉,最好回到 上一章,你可能漏掉了什么 ;-)
第一步,我们需要扩展在房产上点击 ‘已售出’ 按钮 时调用的动作。为此,我们需要在 estate_account 模块中为 estate.property 模型创建一个 模型继承。目前,重写后的动作只需返回 super 调用。也许一个示例会让事情更清楚:
from odoo import models
class InheritedModel(models.Model):
_inherit = "inherited.model"
def inherited_action(self):
return super().inherited_action()
一个实际示例可在 此处 找到。
Exercise
添加发票创建的第一步。
在
estate_account模块的正确文件夹中创建一个estate_property.py文件。使用
_inherit继承estate.property模型。重写
action_sold方法(您可能为它起了别的名字),使其返回super调用。
提示:为了确保它能正常工作,在被重写的方法中添加一个 print 或调试器断点。
它正常工作了吗?如果没有,也许需要检查所有 Python 文件是否都已正确导入。
如果重写生效了,我们就可以继续创建发票。遗憾的是,在 Odoo 中没有简单的方法可以知道如何创建任意给定的对象。大多数时候,有必要查看其模型以找到必填字段并提供适当的值。
学习的一个好方法是看看其他模块是如何实现您想做的事情的。例如,Sales 的一个基本流程就是从销售订单创建发票。这看起来是一个很好的起点,因为它所做的正是我们想要做的。花一些时间阅读并理解 _create_invoices 方法。当您哭完——因为这项看似简单的任务实际上复杂得可怕——之后,我们就可以继续本教程了。
要创建一张发票,我们需要以下信息:
一个
partner_id:客户一个
move_type:它有若干 可能的取值一个
journal_id:会计日志
这些信息足以创建一张空发票。
Exercise
添加发票创建的第二步。
在 action_sold 方法的重写中创建一个空的 account.move:
partner_id取自当前的estate.propertymove_type应对应 ‘Customer Invoice’
提示:
要创建一个对象,请使用
self.env[model_name].create(values),其中values是一个dict。create方法不接受记录集作为字段值。
当房源被设置为 ‘Sold’ 时,您现在应该会在 Invoicing / 客户 / 发票 中看到一张新建的客户发票。
显然,到目前为止我们还没有任何发票行。要创建发票行,我们需要以下信息:
name:该行的描述quantityprice_unit
此外,发票行需要与一张发票相关联。将行与发票关联起来最简单、最有效的方法是在创建发票时包含所有行。为此,account.move 的创建中会包含 invoice_line_ids 字段,它是一个 One2many。One2many 和 Many2many 使用特殊的“命令”,借助 Command 命名空间,这些命令变得易于人类阅读。该命名空间表示要在记录集上执行的三元组命令。三元组最初是执行这些命令的唯一选择,但现在标准做法是改用该命名空间。其格式是将它们放入一个列表中,按顺序依次执行。下面是一个在创建 test_model 时包含 One2many 字段 line_ids 的简单示例:
from odoo import Command
def inherited_action(self):
self.env["test_model"].create(
{
"name": "Test",
"line_ids": [
Command.create({
"field_1": "value_1",
"field_2": "value_2",
})
],
}
)
return super().inherited_action()
Exercise
添加发票创建的第三步。
在创建 account.move 时添加两条发票行。每个售出的房源将按以下条件开票:
售价的 6%
另加 100.00 的行政管理费
提示:按照上面的示例,在创建时添加 invoice_line_ids。每一行都需要一个 name、quantity 和 price_unit。
这一章可能是到目前为止最难的,但它最接近 Odoo 开发的实际样子。在 下一章 中,我们将介绍 Odoo 使用的模板机制。