NetSuite销售订单PDF模板选择Suitelet功能故障排查请求

我们希望在NetSuite销售订单页面添加PDF模板下拉选择列表，尝试用Suitelet实现该功能，但目前仅能弹出选择窗口，点击选项后无法加载并填充对应交易的专属信息。

原代码 #

function suitelet(request, response) {
      var recordId = request.getParameter('id'); // 获取Proposal记录的ID
      var pdf1FileId = "138"; // 替换为第一个表单对应的PDF文件ID
      var pdf2FileId = "139"; // 替换为第二个表单对应的PDF文件ID
    
      nlapiLogExecution('DEBUG', 'recordId', recordId);
      nlapiLogExecution('DEBUG', 'pdf1FileId', pdf1FileId);
      nlapiLogExecution('DEBUG', 'pdf2FileId', pdf2FileId);
    
      var html = '<html>';
      html += '<head>';
      html += '<title>Select PDF</title>';
      html += '</head>';
      html += '<body>';
      html += '<h2>Select PDF to Print:</h2>';
      html += '<button onclick="openPDF(\'' + pdf1FileId + '\',\'' + recordId + '\',\'' + response +     '\')">PDF Option 1</button>';
      html += '<button onclick="openPDF(\'' + pdf2FileId + '\',\'' + recordId + '\',\'' + response + '\')">PDF Option 2</button>';
      html += '</body>';
      html += '</html>';

      nlapiLogExecution('DEBUG', 'html', html);

      response.write(html); // 将HTML写入响应
    }

    function openPDF(fileId, recordId, response) {
      var file = nlapiLoadFile(fileId); // 加载PDF文件

      nlapiLogExecution('DEBUG', 'fileId', fileId);
      nlapiLogExecution('DEBUG', 'recordId', recordId);
      nlapiLogExecution('DEBUG', 'file', file);

      var url = file.getURL(); // 获取PDF文件的URL

      url += '&id=' + recordId; // 将Proposal记录的ID作为参数传递

      nlapiLogExecution('DEBUG', 'url', url);

      response.sendRedirect(url); // 重定向用户到PDF URL
    }

    function onRequest(context) {
      var request = context.request;
      var response = context.response;

      nlapiLogExecution('DEBUG', 'request method', request.method);

      if (request.method === 'GET') {
        suitelet(request, response); // 当通过HTTP GET访问Suitelet时调用suitelet函数
      }
    }

问题分析 #

• 前端无法调用服务器端API：openPDF函数被绑定到前端按钮的onclick事件中，但nlapiLoadFile是NetSuite专属的服务器端API，浏览器环境无法执行该方法，直接调用会触发报错。
• 错误传递服务器端对象：将后端的response对象传入前端参数中，前端无法识别这个服务器端对象，导致response.sendRedirect无法执行。
• PDF模板调用逻辑错误：直接加载PDF文件URL并附加id参数，不会触发NetSuite的模板渲染逻辑，无法将交易数据填充到PDF模板中。正确方式是调用NetSuite的打印服务接口，指定模板ID和交易记录ID。

修正方案 #

方案1：前端直接构造标准打印URL #

无需前端调用服务器端API，直接构造NetSuite打印PDF的标准URL，点击按钮后跳转即可：

function suitelet(request, response) {
    var recordId = request.getParameter('id');
    var pdf1TemplateId = "138"; // 注意：这里是PDF模板记录ID，不是文件ID
    var pdf2TemplateId = "139";

    nlapiLogExecution('DEBUG', 'recordId', recordId);

    var html = '<html>';
    html += '<head><title>Select PDF</title></head>';
    html += '<body>';
    html += '<h2>Select PDF to Print:</h2>';
    // 构造NetSuite标准打印URL，指定交易类型、记录ID、模板ID
    html += `<button onclick="window.location.href='/app/common/print/printcheck.nl?printtype=transaction&id=${recordId}&templateid=${pdf1TemplateId}'">PDF Option 1</button>`;
    html += `<button onclick="window.location.href='/app/common/print/printcheck.nl?printtype=transaction&id=${recordId}&templateid=${pdf2TemplateId}'">PDF Option 2</button>`;
    html += '</body></html>';

    response.write(html);
}

function onRequest(context) {
    var request = context.request;
    var response = context.response;

    if (request.method === 'GET') {
        suitelet(request, response);
    }
}

方案2：通过Suitelet POST请求处理（更安全） #

如果需要增加服务器端权限验证逻辑，可通过POST请求处理跳转：

function suitelet(request, response) {
    var recordId = request.getParameter('id');
    
    if (request.method === 'POST') {
        // 处理POST请求，获取选择的模板ID
        var templateId = request.getParameter('templateid');
        if (!templateId || !recordId) {
            response.write('<script>alert("参数错误"); window.history.back();</script>');
            return;
        }
        // 构造打印URL并重定向
        var printUrl = `/app/common/print/printcheck.nl?printtype=transaction&id=${recordId}&templateid=${templateId}`;
        response.sendRedirect(printUrl);
        return;
    }

    // GET请求返回选择界面
    var pdf1TemplateId = "138";
    var pdf2TemplateId = "139";

    var html = '<html>';
    html += '<head><title>Select PDF</title></head>';
    html += '<body>';
    html += '<h2>Select PDF to Print:</h2>';
    // 使用表单提交到当前Suitelet
    html += `<form method="post">`;
    html += `<input type="hidden" name="id" value="${recordId}">`;
    html += `<button type="submit" name="templateid" value="${pdf1TemplateId}">PDF Option 1</button>`;
    html += `<button type="submit" name="templateid" value="${pdf2TemplateId}">PDF Option 2</button>`;
    html += `</form>`;
    html += '</body></html>';

    response.write(html);
}

function onRequest(context) {
    var request = context.request;
    var response = context.response;
    suitelet(request, response);
}

关键说明 #

• 确保pdf1TemplateId和pdf2TemplateId是NetSuite中PDF模板记录的ID，不是生成后的PDF文件ID。
• 标准打印URL的printtype参数需根据交易类型调整，销售订单对应transaction，其他类型可参考NetSuite官方文档。
• 方案2通过POST提交，可额外增加服务器端的权限验证逻辑，避免非法访问。

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