Netsuite客户端脚本：子列表动态添加项目及跨平台兼容性指南

/**
 * @NApiVersion 2.x
 * @NScriptType ClientScript
 * @NModuleScope SameAccount
 */
define(['N/currentRecord'], function(currentRecordModule) {

    /**
     * 这是一个示例函数，用于演示如何在客户端脚本中向子列表添加项目。
     * 实际应用中，此函数可能由按钮点击事件、字段变更事件或其他逻辑触发。
     *
     * @param {Array<Object>} itemModArray 包含要添加项目信息的数组，
     *                                      例如：[{ id: 'ITEM_ID_1', count: 10 }, { id: 'ITEM_ID_2', count: 5 }]
     */
    function addItemsToSublist(itemModArray) {
        var currentRecord = currentRecordModule.get(); // 获取当前记录实例

        // 遍历项目数组，逐一添加到子列表
        for (var i = 0; i < itemModArray.length; i++) {
            // 1. 选择并准备一个新的子列表行。
            //    这是在动态模式下添加新行的关键步骤。
            currentRecord.selectNewLine({
                sublistId: 'item' // 指定要操作的子列表ID
            });

            // 2. 设置新行的项目ID。
            //    此操作将作用于通过 selectNewLine 准备好的当前新行。
            currentRecord.setCurrentSublistValue({
                sublistId: 'item',
                fieldId: 'item', // 项目ID字段
                value: itemModArray[i].id, // 项目的内部ID
                ignoreFieldChange: false // 设置为 false 以触发字段变更事件（如自动填充描述、价格等）
            });

            // 3. 设置新行的数量。
            currentRecord.setCurrentSublistValue({
                sublistId: 'item',
                fieldId: 'quantity', // 数量字段
                value: itemModArray[i].count, // 项目数量
                ignoreFieldChange: false
            });

            // 4. 可以继续设置其他字段值，例如：
            // currentRecord.setCurrentSublistValue({
            //     sublistId: 'item',
            //     fieldId: 'pricelevel',
            //     value: '1', // 价格级别ID
            //     ignoreFieldChange: false
            // });

            // 5. 提交新行。
            //    此步骤将把当前已设置值的行正式添加到子列表中。
            currentRecord.commitLine({
                sublistId: 'item'
            });
        }
        alert('所有项目已成功添加到子列表。'); // 提示用户操作完成
    }

    // 实际的客户端脚本入口点，例如 pageInit 或一个自定义的按钮点击事件处理函数
    function pageInit(context) {
        // 示例：可以在这里调用 addItemsToSublist，或通过一个自定义按钮触发
        // console.log("Page Initialized. You can call addItemsToSublist from a button click.");
    }

    return {
        pageInit: pageInit,
        addItemsToSublist: addItemsToSublist // 暴露函数，以便从其他地方调用
    };
});

// 假设要修改子列表中的第 'i' 行（索引从0开始）
function modifyExistingLine(lineNumber, newQuantity) {
    var currentRecord = currentRecordModule.get();

    currentRecord.selectLine({
        sublistId: 'item',
        line: lineNumber // 指定要修改的行号
    });

    // 设置要修改的字段值
    currentRecord.setCurrentSublistValue({
        sublistId: 'item',
        fieldId: 'quantity',
        value: newQuantity,
        ignoreFieldChange: false
    });

    // 提交修改
    currentRecord.commitLine({
        sublistId: 'item'
    });
    alert('第 ' + (lineNumber + 1) + ' 行已成功修改。');
}