NetSuite Saved Searches API无法返回完整数据行求助

核心原因 #

你当前的RESTlet代码使用query.runSuiteQL().asMappedResults()获取数据，而NetSuite的SuiteQL查询默认仅返回前1000行数据（或系统设定的单页最大行数），这就是API提取行数远少于Excel导出的根本原因——你只拿到了第一页的结果，未处理分页逻辑。

修复方案：实现SuiteQL分页查询 #

需要将runSuiteQL()替换为支持分页的runSuiteQLPaged()方法，通过遍历所有分页来收集完整数据。以下是两种落地思路：

思路1：RESTlet自动返回全量数据（适合数据量不大的场景） #

修改RESTlet代码，自动遍历所有分页并拼接结果，一次性返回全部数据：

var 
    log,
    query,
    response = new Object();    

define( [ 'N/log', 'N/query' ], main );

function main( logModule, queryModule ) {
    log = logModule;
    query = queryModule;
    return { post: postProcess }
}

function postProcess( request ) {   
    try {
        if ( ( typeof request.query == 'undefined' ) || ( request.query === null ) || ( request.query == '' ) ) {       
            throw { 'type': 'error.SuiteAPIError', 'name': 'INVALID_REQUEST', 'message': 'No query was specified.' }
        }   
        if ( typeof request.params == 'undefined' ) { request.params = new Array(); }
        
        // 使用分页查询替代普通查询
        var pagedResults = query.runSuiteQLPaged({
            query: request.query,
            params: request.params,
            pageSize: 1000 // 单页最大行数，可按需调整
        });
        
        var allRows = [];
        // 遍历所有分页，收集全量数据
        pagedResults.pageRanges.forEach(function(pageRange) {
            var page = pagedResults.fetch({ index: pageRange.index });
            page.data.forEach(function(row) {
                allRows.push(row);
            });
        });
        
        response.rows = allRows;
        response.totalCount = pagedResults.count; // 返回总行数，方便验证完整性
        return response;
                
    } catch( e ) {  
        log.debug( { 'title': 'error', 'details': e } );
        return { 'error': { 'type': e.type, 'name': e.name, 'message': e.message } }
    }   
}

思路2：RESTlet实现分页接口（适合超大数据量场景） #

如果数据量极大（如几十万行），一次性返回会引发性能问题，可让RESTlet支持接收分页参数，分批返回数据：

// 仅修改postProcess核心逻辑部分
function postProcess( request ) {   
    try {
        if ( ( typeof request.query == 'undefined' ) || ( request.query === null ) || ( request.query == '' ) ) {       
            throw { 'type': 'error.SuiteAPIError', 'name': 'INVALID_REQUEST', 'message': 'No query was specified.' }
        }   
        if ( typeof request.params == 'undefined' ) { request.params = new Array(); }
        
        var pageIndex = request.pageIndex || 0; // 默认从第0页开始
        var pageSize = request.pageSize || 1000;
        
        var pagedResults = query.runSuiteQLPaged({
            query: request.query,
            params: request.params,
            pageSize: pageSize
        });
        
        var currentPage = pagedResults.fetch({ index: pageIndex });
        var rows = [];
        currentPage.data.forEach(function(row) {
            rows.push(row);
        });
        
        response.rows = rows;
        response.totalCount = pagedResults.count;
        response.totalPages = pagedResults.pageRanges.length;
        response.currentPage = pageIndex;
        
        return response;
                
    } catch( e ) {  
        log.debug( { 'title': 'error', 'details': e } );
        return { 'error': { 'type': e.type, 'name': e.name, 'message': e.message } }
    }   
}

对应的Python脚本需要循环请求，直到currentPage等于totalPages-1，拼接所有页的数据。

验证方法 #

部署修改后的RESTlet后，重新调用API，对比返回的totalCount与Excel导出的行数是否一致，再检查rows的实际数量是否匹配。

内容的提问来源于stack exchange，提问作者Alex of the Wild