Oracle Apex 24.2：无需插件调度PDF报表至邮箱或自定义目录

完全可以结合你已有的知识实现无插件的自动调度需求，核心是将手动触发的PDF生成逻辑适配为后台可执行的PL/SQL代码，再整合到Apex调度任务中。以下是具体步骤：

1. 适配PDF生成逻辑为后台可执行 #

你之前通过空白页+动态内容生成PDF的方式依赖页面上下文，后台调度时需要调整为无交互执行的逻辑，两种可行方案：

方案A：直接用APEX_PDF包生成PDF #

如果报表基于SQL查询，直接用APEX_PDF包从查询生成PDF，无需依赖页面：

DECLARE
  l_pdf_blob BLOB;
BEGIN
  -- 初始化PDF
  APEX_PDF.INIT;
  -- 添加报表内容（示例：从查询生成表格）
  APEX_PDF.P_TABLE(
    p_query => 'SELECT empno, ename, job FROM emp',
    p_header => '<tr><th>员工编号</th><th>姓名</th><th>职位</th></tr>',
    p_table_attr => 'border="1" cellpadding="4"'
  );
  -- 生成PDF Blob
  l_pdf_blob := APEX_PDF.GET_BLOB;
  APEX_PDF.CLEANUP;
  
  -- 后续可调用发送邮件/存储逻辑
END;

方案B：模拟访问空白页获取PDF #

如果不想重构原有页面逻辑，可通过APEX_WEB_SERVICE后台请求空白页的URL获取PDF内容：

DECLARE
  l_pdf_blob BLOB;
BEGIN
  l_pdf_blob := APEX_WEB_SERVICE.MAKE_REQUEST(
    p_url => 'http://你的Apex实例地址/ords/你的工作区别名/你的应用别名/' || :APP_ID || '/' || :PAGE_ID,
    p_http_method => 'GET',
    -- 若页面需要认证，添加用户名密码
    p_username => 'your_apex_user',
    p_password => 'your_password'
  );
  
  -- 后续可调用发送邮件/存储逻辑
END;

注意：需确保数据库服务器能访问到Apex实例的URL，且执行用户有访问该页面的权限。

2. 整合逻辑到Apex调度任务 #

1. 进入Apex应用的共享组件 → 调度任务，创建或修改现有任务；
2. 在任务类型中选择PL/SQL，将上述PDF生成代码+发送/存储逻辑合并为完整PL/SQL块；
3. 设置调度时间（如每天凌晨1点）、执行用户（需具备足够权限）；
4. 启用任务即可自动执行。

3. 实现邮件发送 #

使用Apex原生的APEX_MAIL包发送带PDF附件的邮件，需先在Apex实例中配置SMTP服务器：

-- 发送邮件
APEX_MAIL.SEND(
  p_to => 'recipient@example.com',
  p_from => 'sender@example.com',
  p_subj => '每日报表_' || TO_CHAR(SYSDATE, 'YYYYMMDD'),
  p_body => '请查收附件中的最新报表',
  p_body_html => '<p>请查收附件中的最新报表</p>'
);

-- 添加PDF附件
APEX_MAIL.ADD_ATTACHMENT(
  p_mail_id => APEX_MAIL.LAST_MAIL_ID,
  p_attachment => l_pdf_blob,
  p_filename => 'daily_report_' || TO_CHAR(SYSDATE, 'YYYYMMDD') || '.pdf',
  p_mime_type => 'application/pdf'
);

-- 立即推送邮件队列
APEX_MAIL.PUSH_QUEUE;

4. 存储到自定义目录 #

存储到数据库目录对象（非本地服务器目录需挂载到数据库服务器） #

1. 先创建并授权目录对象：

CREATE OR REPLACE DIRECTORY APEX_REPORTS_STORAGE AS '/mnt/network_storage/reports';
GRANT READ, WRITE ON DIRECTORY APEX_REPORTS_STORAGE TO APEX_PUBLIC_USER;

2. 写入PDF文件：

DECLARE
  l_file UTL_FILE.FILE_TYPE;
  l_buffer RAW(32767);
  l_amount BINARY_INTEGER := 32767;
  l_pos INTEGER := 1;
  l_blob_len INTEGER;
BEGIN
  l_blob_len := DBMS_LOB.GETLENGTH(l_pdf_blob);
  l_file := UTL_FILE.FOPEN('APEX_REPORTS_STORAGE', 'report_' || TO_CHAR(SYSDATE, 'YYYYMMDD') || '.pdf', 'wb', 32767);
  
  WHILE l_pos <= l_blob_len LOOP
    DBMS_LOB.READ(l_pdf_blob, l_amount, l_pos, l_buffer);
    UTL_FILE.PUT_RAW(l_file, l_buffer, TRUE);
    l_pos := l_pos + l_amount;
  END LOOP;
  
  UTL_FILE.FCLOSE(l_file);
EXCEPTION
  WHEN OTHERS THEN
    IF UTL_FILE.IS_OPEN(l_file) THEN
      UTL_FILE.FCLOSE(l_file);
    END IF;
    RAISE;
END;

存储到Apex应用静态文件 #

若要将PDF存储为应用的静态文件，可插入到APEX_APPLICATION_FILES表：

INSERT INTO APEX_APPLICATION_FILES (
  application_id,
  filename,
  blob_content,
  mime_type,
  created_by,
  created_on
) VALUES (
  :APP_ID,
  'report_' || TO_CHAR(SYSDATE, 'YYYYMMDD') || '.pdf',
  l_pdf_blob,
  'application/pdf',
  'APEX_SCHEDULER',
  SYSDATE
);
COMMIT;

之后可在应用的静态文件中查看该文件，也可通过Apex的文件访问URL获取。

5. 权限与错误处理注意事项 #

• 确保调度任务的执行用户具备APEX_PDF、APEX_MAIL、UTL_FILE、APEX_WEB_SERVICE等包的执行权限；
• 在PL/SQL块中添加异常处理，将错误信息记录到自定义日志表，方便排查问题：

EXCEPTION
  WHEN OTHERS THEN
    INSERT INTO report_schedule_log (
      run_time,
      status,
      error_msg
    ) VALUES (
      SYSDATE,
      'FAILED',
      SQLERRM
    );
    COMMIT;
    RAISE;

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