Netsuite客户端脚本：动态模式下子列表项的正确添加与修改实践

/**
 * 示例函数：向指定记录的子列表添加多个商品项
 *
 * @param {N/record} currentRecord - 当前正在操作的记录对象
 * @param {Array<Object>} itemMod - 包含要添加的商品信息的数组
 *                                  每个元素应包含 'id' (商品内部ID) 和 'count' (数量)
 *                                  例如: [{ id: '123', count: 5 }, { id: '456', count: 2 }]
 */
function addItemsToSublist(currentRecord, itemMod) {
    if (!currentRecord || !itemMod || itemMod.length === 0) {
        log.debug('Add Items', '无效的记录对象或商品数据。');
        return;
    }

    try {
        for (var i = 0; i < itemMod.length; i++) {
            var itemData = itemMod[i];

            // 1. 选择一个新行。这将创建一个空行并使其成为当前行。
            currentRecord.selectNewLine({
                sublistId: 'item'
            });

            // 2. 设置新行的商品ID。
            //    ignoreFieldChange: false 确保触发任何关联的字段变更逻辑（如自动填充描述、价格等）。
            currentRecord.setCurrentSublistValue({
                sublistId: 'item',
                fieldId: 'item',
                value: itemData.id,
                ignoreFieldChange: false
            });

            // 3. 设置新行的数量。
            currentRecord.setCurrentSublistValue({
                sublistId: 'item',
                fieldId: 'quantity',
                value: itemData.count
            });

            // 4. 提交新行。这会将当前选中的行保存到子列表中。
            currentRecord.commitLine({
                sublistId: 'item'
            });

            log.debug('Add Items', '成功添加商品: ' + itemData.id + ', 数量: ' + itemData.count);
        }
    } catch (e) {
        log.error('Add Items Error', '添加商品时发生错误: ' + e.message);
        // 可以在此处添加更详细的错误处理逻辑
    }
}

/**
 * 示例函数：修改指定记录子列表中现有商品项的字段值
 *
 * @param {N/record} currentRecord - 当前正在操作的记录对象
 * @param {string} sublistId - 子列表的ID，例如 'item'
 * @param {number} lineIndex - 要修改的行的索引（从0开始）
 * @param {string} fieldId - 要修改的字段ID，例如 'item' 或 'quantity'
 * @param {*} newValue - 字段的新值
 */
function modifyExistingSublistItem(currentRecord, sublistId, lineIndex, fieldId, newValue) {
    if (!currentRecord) {
        log.debug('Modify Item', '无效的记录对象。');
        return;
    }

    try {
        // 1. 选择要修改的现有行
        currentRecord.selectLine({
            sublistId: sublistId,
            line: lineIndex
        });

        // 2. 修改指定字段的值
        currentRecord.setCurrentSublistValue({
            sublistId: sublistId,
            fieldId: fieldId,
            value: newValue,
            ignoreFieldChange: false // 确保触发任何关联的字段变更逻辑
        });

        // 3. 提交修改
        currentRecord.commitLine({
            sublistId: sublistId
        });

        log.debug('Modify Item', '成功修改子列表 ' + sublistId + ' 的第 ' + lineIndex + ' 行，字段 ' + fieldId + ' 为 ' + newValue);

    } catch (e) {
        log.error('Modify Item Error', '修改商品时发生错误: ' + e.message);
    }
}