第 14 章:与其他模块交互

在 上一章 中,我们利用继承修改了一个模块的行为。在我们的房地产场景中,我们想更进一步,能够为客户生成发票。Odoo 提供了开票模块,因此如果能在我们的房地产模块中直接创建发票就太好了,即房产一旦设为 ‘已售出’,就在开票应用中创建一张发票。

具体示例:Account Move

Note

目标:在本节结束时:

  • 应创建一个新模块 estate_account

  • 房源售出时,应为买家开具发票

发票创建

每当我们与其他模块交互时,都需要牢记模块化。如果我们打算将应用程序出售给房地产中介,有些中介可能想要开票功能,而另一些则可能不想要。

创建发票

现在该生成发票了。我们要给 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.property

  • move_type 应对应 ‘Customer Invoice’

提示:

  • 要创建一个对象,请使用 self.env[model_name].create(values),其中 values 是一个 dict。

  • create 方法不接受记录集作为字段值。

当房源被设置为 ‘Sold’ 时,您现在应该会在 Invoicing / 客户 / 发票 中看到一张新建的客户发票。

显然,到目前为止我们还没有任何发票行。要创建发票行,我们需要以下信息:

  • name:该行的描述

  • quantity

  • price_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 使用的模板机制。