Odoo 14 POS会话：获取与调试支付明细的实用指南

本教程详细介绍了如何在odoo 14的pos（销售点）会话中，通过javascript代码准确获取并计算订单的现金支付总额。文章不仅提供了遍历订单和支付明细的示例代码，更强调了利用浏览器开发者工具进行调试的关键技巧，特别是使用`debugger`语句来检查运行时对象结构，从而识别正确的属性名称，解决数据访问问题。

Odoo POS会话数据访问基础

在Odoo 14的POS前端环境中，访问当前的销售数据是进行定制开发的基础。this.env.pos 对象提供了丰富的接口来管理和获取POS会话的实时信息。其中，this.env.pos.get_order_list() 方法是获取当前所有订单列表的关键。每个订单对象内部又包含了其对应的支付明细（payment lines），这些明细记录了客户如何支付订单。

我们的目标是遍历这些订单和支付明细，筛选出所有现金支付，并计算其总额。

初始尝试与问题分析

开发者在尝试获取现金支付总额时，通常会采用以下逻辑：

get totalCash() {
    const orders = this.env.pos.get_order_list();
    let totalCash = 0;

    console.log("Order list: ", orders);

    for (const order of orders) {
        console.log("Order: ", order);
        for (const paymentLine of order.paymentlines.models) {
            console.log("Payment line: ", paymentLine);
            // 尝试访问支付方式类型
            if (paymentLine.cashregister.journal.type === 'cash') {
                console.log("Cash register type: ", paymentLine.cashregister.journal.type);
                totalCash += paymentLine.amount;
            }
        }
    }
    return totalCash.toFixed(2);
}

这段代码的逻辑思路是正确的：获取所有订单，然后遍历每个订单的支付明细。核心问题通常出现在对 paymentLine 对象内部属性的访问上，例如 paymentLine.cashregister.journal.type。尽管代码逻辑上符合预期，但在实际运行时，如果 cashregister 或 journal 属性的路径不完全正确，或者对象结构与预期不符，就会导致无法正确获取数据，甚至可能抛出错误。console.log 输出的对象信息可能不够直观，无法清晰展示深层嵌套的属性结构，从而给调试带来困难。

核心解决方案：遍历与计算

为了确保代码的健壮性并准确计算现金支付总额，我们需要在遍历支付明细时，谨慎地访问其属性。以下是经过优化和验证的代码片段，它在访问深层属性时增加了必要的检查，以避免潜在的运行时错误：

get totalCash() {
    const orders = this.env.pos.get_order_list();
    let totalCash = 0;

    for (const order of orders) {
        // 确保 paymentlines 存在且为可迭代对象
        if (order.paymentlines && order.paymentlines.models) {
            for (const paymentLine of order.paymentlines.models) {
                // 关键：安全地检查支付方式是否为现金
                // 确保 cashregister 和 journal 属性存在，避免访问 undefined 属性
                if (paymentLine.cashregister && 
                    paymentLine.cashregister.journal && 
                    paymentLine.cashregister.journal.type === 'cash') {
                    totalCash += paymentLine.amount;
                }
            }
        }
    }
    return totalCash.toFixed(2);
}

代码解析：

乾坤圈新媒体矩阵管家

新媒体账号、门店矩阵智能管理系统

219

查看详情

• const orders = this.env.pos.get_order_list();: 获取当前POS会话中的所有订单列表。
• let totalCash = 0;: 初始化现金总额计数器。
• for (const order of orders): 遍历每一个订单。
• if (order.paymentlines && order.paymentlines.models): 这是一个重要的健壮性检查，确保订单对象中存在 paymentlines 集合，并且其 models 属性（包含实际的支付明细模型）是可用的。
• for (const paymentLine of order.paymentlines.models): 遍历当前订单的所有支付明细。
• if (paymentLine.cashregister && paymentLine.cashregister.journal && paymentLine.cashregister.journal.type === 'cash'): 这是核心逻辑，用于判断支付方式是否为现金。
  • paymentLine.cashregister: 检查 paymentLine 是否有 cashregister 属性。
  • paymentLine.cashregister.journal: 检查 cashregister 对象是否有 journal 属性。
  • paymentLine.cashregister.journal.type === 'cash': 最后，检查 journal 的 type 属性是否为 'cash'。
  • 这些层层递进的检查可以有效防止因对象结构不完整而导致的运行时错误（例如尝试访问 undefined 的属性）。
• totalCash += paymentLine.amount;: 如果支付方式是现金，则将其金额累加到 totalCash。
• return totalCash.toFixed(2);: 返回格式化为两位小数的现金总额。

专业调试技巧：利用浏览器开发者工具

当对Odoo前端代码中的对象结构不确定时，浏览器开发者工具是进行调试的强大武器。它允许我们在代码执行时暂停，并实时检查变量和对象的状态。

1. 设置断点 (debugger)

在你的JavaScript代码中，于你希望暂停执行并检查变量的位置插入 debugger; 语句。例如：

get totalCash() {
    debugger; // 在这里设置断点，代码执行到此处时会暂停
    const orders = this.env.pos.get_order_list();
    let totalCash = 0;

    // ... 后续代码
}

2. 打开浏览器开发者工具

• 在Odoo POS界面上，右键点击页面并选择“检查”（Inspect），或使用快捷键：
  • Windows/Linux: Ctrl+Shift+I
  • macOS: Cmd+Option+I
• 这将打开浏览器开发者工具面板。导航到“Sources”（源代码）或“Debugger”（调试器）标签页。

3. 检查运行时对象

当你的代码执行到 debugger; 语句时，浏览器会暂停执行，并在开发者工具的“Sources”标签页中显示当前代码位置。

• 观察“Scope”（作用域）面板： 在这个面板中，你可以看到当前作用域内的所有变量及其值。展开 orders 变量，然后展开其中的 order 对象，接着展开 paymentlines -> models，直到找到 paymentLine 对象。
• 逐步检查属性： 仔细展开 paymentLine 对象，查找 cashregister 属性。如果存在，再展开 cashregister 查找 journal 属性，最后检查 journal 内部的 type 属性。通过这种方式，你可以直观地确认 paymentLine.cashregister.journal.type 是否是正确的访问路径。
• 使用“Console”（控制台）面板： 当代码暂停时，你也可以在“Console”面板中直接输入变量名（例如 paymentLine 或 paymentLine.cashregister.journal.type）并回车，来查看它们的值和结构。

通过这种方式，你可以精确地定位问题，确认对象属性的名称和嵌套层级，从而修正代码中的数据访问路径。

注意事项

• Odoo版本兼容性： 不同Odoo版本（即使是小版本更新）其前端JS对象的内部结构可能会有细微变化。本教程基于Odoo 14，但对于其他版本，建议同样使用调试工具进行验证。
• 前端性能： 频繁的循环和复杂的计算可能会影响POS界面的响应速度。在处理大量数据时，应考虑代码的效率。
• 生产环境： 在生产环境中部署代码前，应移除所有的 debugger; 语句和不必要的 console.log，以避免影响用户体验和暴露内部信息。
• 错误处理： 对于生产级代码，除了上述的属性存在性检查，还应考虑更全面的错误处理机制，例如使用 try...catch 块来捕获潜在的运行时异常。

总结

在Odoo 14 POS会话中准确获取支付明细并进行计算，需要开发者对Odoo前端的JavaScript数据模型有清晰的理解。当遇到数据访问问题时，切勿盲目猜测，而应充分利用浏览器开发者工具，特别是 debugger 语句，进行精确的运行时对象检查。掌握这些调试技巧，将极大地提升Odoo前端定制开发的效率和代码质量。

以上就是Odoo 14 POS会话：获取与调试支付明细的实用指南的详细内容，更多请关注php中文网其它相关文章！