NetSuite中Script 2.0客户端脚本无法触发执行问题排查

问题现象 #

提交的2.x版本ClientScript脚本，预期在交易表单的item子列表勾选自定义复选框（custcol21）时弹出提示，但实际无任何反应，调试器仅高亮define行。

核心问题与修复步骤 #

1. currentRecord获取方式错误
   不要使用currentRecord.get()，ClientScript的validateLine事件中，应直接通过context.currentRecord获取当前记录对象，这是NetSuite 2.x客户端脚本的标准用法。

2. 复选框值判断逻辑错误
   NetSuite中复选框字段返回的是字符串'T'（勾选）或'F'（未勾选），而非布尔值true/false，原代码的lineItemChecked === true永远不会触发。

3. 异步弹窗的执行时机问题
   N/ui/dialog.alert是异步方法，而validateLine是同步执行的事件函数，直接调用可能导致弹窗在函数返回后才触发，被浏览器或NetSuite的事件机制忽略。改用原生window.alert()可以确保同步显示提示。

4. 脚本部署验证

   • 确认脚本已部署到目标交易类型（如销售订单、采购订单），部署状态为已发布。
   • 检查部署的「应用到」设置，是否覆盖了测试用的表单/记录类型。
   • 确认部署的「受众」包含当前测试用户。

5. 控制台报错检查
   按F12打开浏览器开发者工具，查看控制台是否有模块加载失败、语法错误等信息，这是快速定位问题的关键。

修正后的完整代码 #

/**
 * @NApiVersion 2.x
 * @NScriptType ClientScript
 */
define(['N/currentRecord'], function(currentRecord) {
    
    function validateLine(context) {
        var rec = context.currentRecord;
        
        if (context.sublistId === 'item') {
            var lineItemChecked = rec.getCurrentSublistValue({
                sublistId: 'item',
                fieldId: 'custcol21' // 自定义复选框字段
            });

            // 复选框勾选时触发提示
            if (lineItemChecked === 'T') {
                window.alert('请为此项目应用批量配送');
            }
        }
        return true;
    }

    return {
        validateLine: validateLine
    };
});

注：如果坚持使用N/ui/dialog，需要处理异步逻辑，但原生弹窗在validateLine事件中更可靠。

内容的提问来源于stack exchange，提问作者Muhammad