使用N/render addRecord添加记录至PDF渲染器失败问题求助

核心问题分析 #

你遇到的问题主要来自两个关键点：

1. Freemarker模板判断逻辑错误：?has_content是用于检测集合/列表是否非空的运算符，而通过addRecord添加的单个记录是对象类型，用该运算符会返回false，导致误判记录不存在。
2. 直接传入加载后的Record对象存在兼容问题：部分NetSuite版本中，addRecord直接接收record.load返回的对象时，可能出现序列化异常，导致模板无法读取记录数据。

具体修复步骤 #

1. 修正Freemarker模板的记录检测逻辑 #

将针对records的集合检测改为对象存在性检测：

<#if billList?has_content>
    ${billList.values[0].id} Bill List Found
<#else>
    Bill List Not Found
</#if>
<br />
<#-- 替换为对象存在性检测运算符 ?? -->
<#if records??>
    Records Object Found (Transaction ID: ${records.tranid})
<#else>
    Records Object Not Found
</#if><br />
<#if record??>
    Record Object Found
<#else>
    Record Object Not Found
</#if><br />

2. 调整addRecord的调用方式 #

改用NetSuite推荐的记录类型+ID方式添加记录，替代直接传入加载后的对象：

const renderPdfTemplate = (pdfTemplateScriptId, paymentRecordObj, billData) => {
    const pdfTemplateObj = render.create();

    pdfTemplateObj.setTemplateById(pdfTemplateScriptId);
    // 用type+id的方式添加记录，提升兼容性
    pdfTemplateObj.addRecord({
        type: record.Type.VENDOR_PAYMENT,
        id: paymentRecordObj.id,
        templateName: 'records'
    });
    
    const data = { values: billData };
    
    pdfTemplateObj.addCustomDataSource({
        alias: 'billList',
        data: JSON.stringify(data),
        format: render.DataSource.JSON
    });
   return pdfTemplateObj.renderAsPdf();
 }

3. 验证脚本权限 #

确保Suitelet脚本部署的权限设置中，已添加Vendor Payment记录的查看权限：

• 进入脚本部署页面，在「Permissions」标签下，添加「Transaction」类型权限，选择「Vendor Payment」并设置为「View」级别。

额外验证点 #

如果以上步骤未解决问题，可以尝试：

• 确认paymentRecordObj有效性：在renderPdfTemplate中添加日志，打印paymentRecordObj.id和paymentRecordObj.getValue({fieldId: 'tranid'})，确保记录加载正常。
• 测试默认模板名：将templateName改为record，模板中用<#if record??>检测，看是否能正常访问。

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