关于APEX Office Print的两项技术咨询：隐藏空字段与复选框打印

我来帮你解决这两个APEX Office Print的问题，都是实际项目里很常见的场景：

问题1：隐藏无值的可选字段 #

针对模板里的大量可选空字段，有两种常用方案，你可以根据模板类型选适合的：

方案1：模板层面直接做条件判断 #

如果用的是Word模板，APEX Office Print支持用[[if]]和[[endif]]语法包裹字段及其标签，当字段为null时，整个块会自动隐藏。举个例子：

[[if customer_email]]
客户邮箱: [[customer_email]]
[[endif]]

要是用的是HTML/PDF模板，你可以结合CSS和条件渲染，比如在HTML里写：

<div class="optional-field" [[if customer_phone]]style="display:block;"[[else]]style="display:none;"[[endif]]>
  客户电话: [[customer_phone]]
</div>

方案2：PL/SQL预处理数据再传给AOP #

如果不想改模板，也可以在调用AOP之前，先把空字段过滤掉，只传递有值的数据。用APEX_JSON包组装JSON数据是最方便的：

DECLARE
  l_output_json CLOB;
BEGIN
  APEX_JSON.INITIALIZE_CLOB_OUTPUT;
  APEX_JSON.OPEN_OBJECT;
  
  -- 必填字段直接写入
  APEX_JSON.WRITE('order_id', :P1_ORDER_ID);
  
  -- 可选字段判断非空才写入
  IF :P1_CUSTOMER_NAME IS NOT NULL THEN
    APEX_JSON.WRITE('customer_name', :P1_CUSTOMER_NAME);
  END IF;
  IF :P1_SHIPPING_ADDRESS IS NOT NULL THEN
    APEX_JSON.WRITE('shipping_address', :P1_SHIPPING_ADDRESS);
  END IF;
  
  APEX_JSON.CLOSE_OBJECT;
  l_output_json := APEX_JSON.GET_CLOB_OUTPUT;
  APEX_JSON.FREE_OUTPUT;
  
  -- 调用AOP打印
  apex_office_print.print(
    p_template_static_id => 'YOUR_TEMPLATE',
    p_data => l_output_json,
    p_output_type => 'PDF',
    p_download => TRUE
  );
END;

问题2：集成APEX_APPLICATION.G_F01打印选中复选框内容 #

这个问题通常是因为对G_F01的作用域或者复选框配置理解不到位，我给你梳理下正确的步骤：

第一步：正确配置页面复选框 #

在APEX页面的复选框项里，一定要把Element Name设置为F01（注意大小写，APEX是敏感的），并且把Return Value设为你需要关联的记录ID（比如订单ID、客户ID）。这样用户选中复选框提交后，值才会存入APEX_APPLICATION.G_F01数组。

第二步：PL/SQL中处理选中数据并调用AOP #

要注意G_F01是提交后的全局数组，所以你的PL/SQL代码要放在页面流程或者设置了"Submit Page"的动态动作里。示例代码如下：

DECLARE
  l_selected_ids apex_t_varchar2;
  l_print_data   CLOB;
BEGIN
  -- 把G_F01转成apex_t_varchar2类型，方便后续查询
  l_selected_ids := apex_application.g_f01;
  
  -- 先判断有没有选中项
  IF l_selected_ids IS NOT EMPTY THEN
    -- 根据选中的ID查询需要打印的数据，组装成AOP能识别的JSON
    SELECT apex_json.get_json(
             apex_json.t_serialize_clob(
               CURSOR(
                 SELECT order_id, customer_name, order_date, total_amount
                 FROM orders
                 WHERE order_id MEMBER OF l_selected_ids
               )
             )
           ) INTO l_print_data
    FROM dual;
    
    -- 调用AOP打印选中的记录
    apex_office_print.print(
      p_template_static_id => 'SELECTED_ORDERS_TEMPLATE',
      p_data => l_print_data,
      p_output_type => 'PDF',
      p_download => TRUE
    );
  ELSE
    -- 提示用户未选中任何内容
    apex_error.add_error(
      p_message => '请至少选择一条记录再打印',
      p_display_location => apex_error.c_inline_in_notification
    );
  END IF;
END;

常见排查点 #

• 确认复选框的Element Name确实是F01，别写成f01或者其他拼写错误。
• 如果用动态动作触发打印，要把动态动作的Submit Page选项设为"Yes"，否则G_F01会是空的。
• 检查PL/SQL的执行权限，确保用户能访问目标表和APEX_OFFICE_PRINT包。

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