NetSuite SuiteScript获取记录子列表：ID查找与返回-1问题解决

一、获取子列表ID的方法 #

• NetSuite界面自定义模式查看：打开对应记录的表单，进入「自定义>表单>自定义表单」找到目标表单并编辑，在子列表区域查看「ID」字段，这就是子列表的内部ID，注意大小写敏感。
• 浏览器开发者工具查询：打开记录页面右键检查元素，在DOM中搜索sublist关键字，找到类似id="sublist_XXX"的属性，XXX就是子列表ID。
• 记录浏览器（Record Browser）查询：在NetSuite帮助中心进入记录浏览器，找到对应记录类型，查看其包含的子列表信息，里面会列出子列表ID及对应字段ID。

二、正确检索子列表数据的步骤及问题排查 #

1. 确保记录加载模式正确 #

定时脚本里加载记录必须用静态模式（isDynamic: false），动态模式下getLineCount返回-1是正常现象。示例代码：

// 加载目标记录（替换为你的记录类型和ID）
var currentRecord = record.load({
    type: record.Type.SALES_ORDER,
    id: 123,
    isDynamic: false
});

2. 正确遍历子列表数据 #

替换为实际的子列表ID和字段ID后，按以下方式遍历：

var sublistId = 'item'; // 替换为真实子列表ID
var sublistLines = currentRecord.getLineCount({
    sublistId: sublistId
});

if (sublistLines > 0) {
    for (var i = 0; i < sublistLines; i++) {
        var itemValue = currentRecord.getSublistValue({
            sublistId: sublistId,
            fieldId: 'item', // 替换为真实子列表字段ID
            line: i
        });
        
        // 条件判断与后续操作
        if (itemValue === '目标值') {
            sendNotificationEmail(); // 调用邮件发送函数
        }
    }
} else {
    log.debug('子列表状态', '当前记录无有效子列表数据或子列表ID错误');
}

3. 排查sublistlines返回-1的原因 #

• 子列表ID拼写错误：确认ID大小写、拼写和系统内完全一致。
• 用了动态模式加载记录：必须切换为静态模式。
• 目标记录无对应子列表数据：手动打开记录检查是否存在子列表行。
• 脚本权限不足：定时脚本的执行角色需要具备该记录类型和子列表的查看权限。

三、自动邮件发送示例 #

条件满足后，可使用N/email模块发送邮件：

function sendNotificationEmail() {
    var sendResult = email.send({
        author: -5, // 替换为实际发件人ID，-5代表管理员
        recipients: 'user@example.com', // 收件人邮箱
        subject: '子列表数据满足条件通知',
        body: '您关注的记录子列表数据已符合设定条件，请及时查看。'
    });
    log.debug('邮件发送结果', sendResult);
}

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