Oracle Apex 21.1 交互式报表自定义打印模板创建方案咨询

版本兼容性说明 #

• Apex 5.1的打印相关教程绝大多数可以直接适配21.1版本，两者底层的报表打印逻辑没有发生破坏性更新，不过21.1新增了原生打印配置项，不需要依赖第三方工具即可实现你的全部需求。

方案一：CSS自定义打印样式（最简便，仅浏览器端打印场景） #

适合不需要导出PDF文件，仅需要用户触发浏览器打印的场景，配置成本极低：

1. 打开交互式报表所在页面，在「页面属性」-「CSS」-「内联」中添加如下代码，按需替换对应配置项即可：

/* 仅打印场景生效的媒体查询 */
@media print {
  /* 隐藏页面不需要打印的元素：导航栏、工具栏、操作按钮等 */
  header, .t-Body-nav, .t-Button-region, .t-IRR-toolbar {
    display: none !important;
  }
  /* 自定义打印页边距，最大化内容占比 */
  @page {
    margin: 1cm !important; /* 可按需求调整上下左右边距数值 */
    size: A4 portrait; /* 需要横向打印可改为A4 landscape */
  }
  /* 打印页头插入公司logo */
  .t-IRR-region::before {
    content: "";
    display: block;
    height: 60px; /* 匹配你司logo的高度 */
    background: url(#APP_FILES#/your-company-logo.png) left center no-repeat; /* 替换为你上传的logo静态文件路径 */
    background-size: auto 60px;
    margin-bottom: 10px;
  }
  /* 打印页脚插入导出日期 */
  .t-IRR-region::after {
    content: "导出日期：" attr(data-print-date);
    display: block;
    text-align: right;
    margin-top: 10px;
    font-size: 12px;
  }
  /* 自定义长文本列宽，替换为你实际的列静态ID */
  .t-IRR-table td[headers="YOUR_COLUMN_STATIC_ID"], .t-IRR-table th[headers="YOUR_COLUMN_STATIC_ID"] {
    width: 300px !important; /* 按需调整宽度数值 */
    word-wrap: break-word !important;
    white-space: pre-wrap !important;
  }
}

2. 新增动态动作实现日期自动生成：在页面「动态动作」中创建触发时机为「页面加载时」的动作，动作类型选择「执行JavaScript代码」，填入以下代码：

// 给报表区域注入当前日期属性，供打印时调用
document.querySelector('.t-IRR-region').setAttribute('data-print-date', new Date().toLocaleDateString('zh-CN'));

方案二：原生自定义报表模板（适配PDF/Word导出场景） #

如果需要支持导出为可下载的文件，可以使用21.1原生的打印模板功能，比5.1版本配置流程大幅简化：

• 第一步：创建自定义打印模板
  1. 进入「共享组件」-「报告和打印」-「打印模板」，点击「创建」
  2. 选择模板类型为「通用模板（HTML）」，按提示配置各部分内容：
     • 页头部分插入logo和日期占位符：<img src="#APP_FILES#/logo.png" height="50"><span style="float:right">导出日期：#PRINT_DATE#</span>
     • 页边距直接在模板的CSS区域设置@page规则即可
     • 列宽可在模板的列样式部分，针对指定列设置固定宽度
• 第二步：绑定模板到交互式报表
  1. 打开交互式报表属性，找到「打印」属性组
  2. 「启用打印」选择「是」，「打印模板」选择你刚刚创建的自定义模板
  3. 如果需要传递自定义参数（比如当前日期），可以在「打印参数」中添加对应参数项，值设置为TO_CHAR(SYSDATE,'yyyy-mm-dd')即可

注意事项 #

• 用静态应用文件存储logo时，路径中的#APP_FILES#占位符会被APEX自动解析，不需要写完整路径
• 交互式报表的列静态ID可以在列的「高级」属性中查看和自定义，确保CSS选择器和模板中的列标识匹配
• 测试效果可以直接用浏览器的打印预览功能，不需要实际打印即可调整参数

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