
在 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 将稳定生效,不再被系统覆盖。










