NetSuite中PDF按需隐藏页眉页脚：非固定页码场景实现咨询

针对采购订单PDF中项目表格页显示页眉页脚、条形码页隐藏的需求（页码不固定），以下是两种可行的实现方案：

方案一：基于页面模板切换（推荐） #

利用NetSuite高级PDF底层的BFO渲染引擎的<@page>标签定义两种页面模板，在不同内容区域切换使用，精确控制页眉页脚的显示。

实现步骤： #

1. 定义带页眉页脚和不带页眉页脚的页面模板，以及对应的页眉页脚宏：

<!-- 带页眉页脚的页面模板 -->
<@page name="withHF" header="headerMacro" footer="footerMacro"/>
<!-- 不带页眉页脚的页面模板 -->
<@page name="withoutHF" header="" footer=""/>

<!-- 页眉内容宏 -->
<#macro headerMacro>
  <div style="padding:10px; text-align:center; border-bottom:1px solid #ccc;">
    采购订单 ${transaction.tranid}
  </div>
</#macro>

<!-- 页脚内容宏 -->
<#macro footerMacro>
  <div style="padding:10px; text-align:right; border-top:1px solid #ccc;">
    第 ${currentPageNumber} 页 / 共 ${totalPageNumber} 页
  </div>
</#macro>

2. 在项目表格区域指定使用带页眉页脚的模板：

<@page name="withHF"/>
<!-- 项目表格内容 -->
<table style="width:100%; border-collapse:collapse;">
  <thead>
    <tr>
      <th style="border:1px solid #ccc; padding:8px;">项目名称</th>
      <th style="border:1px solid #ccc; padding:8px;">数量</th>
      <th style="border:1px solid #ccc; padding:8px;">单价</th>
    </tr>
  </thead>
  <tbody>
    <#list transaction.item as item>
      <tr>
        <td style="border:1px solid #ccc; padding:8px;">${item.itemname}</td>
        <td style="border:1px solid #ccc; padding:8px; text-align:right;">${item.quantity}</td>
        <td style="border:1px solid #ccc; padding:8px; text-align:right;">${item.rate}</td>
      </tr>
    </#list>
  </tbody>
</table>

3. 在条形码区域切换到无页眉页脚的模板，并强制分页：

<@page name="withoutHF"/>
<p style="page-break-before:always;"></p>
<!-- 条形码内容 -->
<div style="text-align:center; margin-top:50px;">
  <barcode value="${transaction.tranid}" type="CODE128" height="50" width="200"/>
  <p style="margin-top:10px;">订单号：${transaction.tranid}</p>
</div>

方案二：基于Freemarker变量的条件渲染 #

通过在不同内容区域设置全局变量，在页眉页脚部分判断变量值来控制显示隐藏。

实现步骤： #

1. 在项目表格区域设置显示标记：

<#assign showHF = true in document>
<!-- 项目表格内容（同方案一） -->

2. 在条形码区域设置隐藏标记并强制分页：

<#assign showHF = false in document>
<p style="page-break-before:always;"></p>
<!-- 条形码内容（同方案一） -->

3. 页眉页脚部分通过变量判断渲染：

<header>
  <#if showHF>
    <div style="padding:10px; text-align:center; border-bottom:1px solid #ccc;">
      采购订单 ${transaction.tranid}
    </div>
  </#if>
</header>

<footer>
  <#if showHF>
    <div style="padding:10px; text-align:right; border-top:1px solid #ccc;">
      第 ${currentPageNumber} 页 / 共 ${totalPageNumber} 页
    </div>
  </#if>
</footer>

注意事项： #

• 方案一的页面模板切换更稳定，避免因Freemarker变量作用域问题导致的渲染异常；
• 测试时需覆盖项目表格跨页、条形码单独占页等场景，确保页眉页脚显示符合预期；
• 条形码渲染需确保barcode标签的参数（type/height/width）符合NetSuite的BFO引擎要求。

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