SuiteScript 2.x用户事件脚本INVALID_API_USAGE错误：新建记录报错

问题根源分析 #

1. INVALID_API_USAGE错误原因：创建新记录时，行项目字段的值是通过setSublistValue设置的（后台默认逻辑），此时直接调用getSublistText会触发API约束错误——必须用getSublistValue读取用setSublistValue设置的值。
2. getSublistValue返回值不正确：getSublistValue获取的是job的内部ID，而非显示的编号文本，直接赋值会得到一串数字而非预期的job编号。
3. record.load的局限性：beforeSubmit阶段新记录尚未保存，没有生成有效ID，无法用record.load加载；afterSubmit加载后修改会额外触发一次保存，可能引发循环提交问题。

修正后的脚本代码 #

const beforeSubmit = (scriptContext) => {
    try {
        const newRecord = scriptContext.newRecord;
        let jobNumber = '';
        const lineCount = newRecord.getLineCount({ sublistId: 'item' });

        // 遍历行项目，找到第一个非空的job
        for (let i = 0; i < lineCount; i++) {
            const jobInternalId = newRecord.getSublistValue({
                sublistId: 'item',
                fieldId: 'job',
                line: i
            });

            if (jobInternalId) {
                // 通过lookup获取job的编号文本
                const jobRecord = search.lookupFields({
                    type: search.Type.JOB,
                    id: jobInternalId,
                    columns: ['tranid']
                });
                jobNumber = jobRecord.tranid;
                break; // 找到第一个非空job后退出循环
            }
        }

        // 只有获取到jobNumber时才赋值表头字段
        if (jobNumber) {
            newRecord.setText({
                fieldId: 'custbody_job_number',
                value: jobNumber
            });
        }
    } catch (e) {
        log.error({
            title: e.name,
            details: e.message
        });
    }
};

关键修正点说明 #

• 统一用getSublistValue读取：无论创建还是编辑记录，都用getSublistValue获取job的内部ID，避免API兼容性问题。
• 通过search.lookupFields获取文本值：用lookup查询job记录的tranid（即job编号），确保赋值的是正确的显示文本。
• 优化循环逻辑：用break替代i = count，代码更易读；增加jobNumber初始值，避免未定义时赋值报错。
• 直接操作newRecord：无需加载额外记录，beforeSubmit阶段直接修改scriptContext.newRecord即可，提交时会自动保存修改。

额外注意事项 #

• 确保脚本有权限访问search模块（在脚本部署的权限设置中开启）。
• 如果表头字段custbody_job_number是引用类型而非文本类型，需改用setValue并传入job的内部ID，而非文本。

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