ERPNext v14 中正确覆盖报价单子项的 amount 计算逻辑

在 erpnext v14 客户端脚本中，直接监听字段变更重设 `amount` 常因系统自动重算而被覆盖；需结合 `refresh` 事件确保自定义公式（如 `length × width × rate × qty`）持久生效。

在 ERPNext 中，Quotation Item 的 amount 字段默认由系统基于 qty × rate 自动计算，并在多个场景（如修改 qty、rate、表单加载或刷新）下被强制重写。你遇到的“值闪现后恢复”问题，正是由于客户端脚本的 set_value 被后续系统级计算覆盖所致。

要可靠覆盖该逻辑，关键在于在系统完成默认计算之后再次注入自定义值。refresh 事件是最佳切入点——它在表单初始化、子表行渲染、以及每次系统重算后触发，能有效“兜底”你的修改。

以下是推荐的完整客户端脚本方案：

function calculateAmount(frm, cdt, cdn) {
    const item = locals[cdt][cdn];
    // 防御性检查：确保必要字段存在且为数值
    if (!item || item.length == null || item.width == null || 
        item.qty == null || item.rate == null) return;

    const length = flt(item.length);
    const width = flt(item.width);
    const qty = flt(item.qty);
    const rate = flt(item.rate);
    const amount = length * width * rate * qty;

    // 使用 cdt（doctype）而非硬编码 'Quotation Item'，提升复用性
    frappe.model.set_value(cdt, cdn, 'amount', amount);
}

frappe.ui.form.on('Quotation Item', {
    // 所有影响金额的字段均触发重算
    length: calculateAmount,
    width: calculateAmount,
    qty: calculateAmount,
    rate: calculateAmount,

    // 关键：refresh 确保系统重算后仍应用自定义逻辑
    refresh: function(frm, cdt, cdn) {
        // 仅对当前行生效（避免批量操作时误触发）
        if (cdn) {
            calculateAmount(frm, cdt, cdn);
        }
    }
});

✅ 注意事项与最佳实践：

• 务必添加 flt() 包装：flt() 是 ERPNext 内置函数，可安全将空值/字符串转为浮点数，避免 NaN 导致金额清零；
• 补充 rate 监听：原代码遗漏了 rate 字段监听，而你的公式明确依赖 rate，必须加入；
• refresh 中的 cdn 判断：防止在新建行或批量操作时因 cdn 为空导致异常；
• 服务端优先原则：此方案属客户端“补救”。若需彻底解耦、支持报表/审批流/审计等场景，应同步修改服务端 Python 方法（如 QuotationItem.calculate_amount），否则导出、打印或后台任务中仍会使用默认逻辑；
• 性能提示：避免在 refresh 中执行复杂计算；本例逻辑轻量，无需额外优化。

通过上述方式，你的自定义 amount = length × width × rate × qty 将稳定生效，不再被系统覆盖。