APEX-数据导出/打印

时间:2024-01-27 19:16:53

前言:

 由于公司使用了Oracle APEX构建应用,且在APEX新版本v20.2版本中增强了相关报表导出数据相关功能;正好现在做的事情也需要类似的功能,就先来学习一下Oracle的APEX相关功能及实现方式;为自己优化实现相关功能做些积累吧。

 先简单介绍下APEX是什么?

APEX是什么:

 APEX:Oracle Application Express (APEX) 是低代码开发平台。借助该平台,您可以构建功能先进的可扩展安全企业应用,并且可在任何位置部署应用。

 使用 APEX,开发人员可快速开发并部署出色的应用,从而解决实际问题并立即创造价值。您无需精通各种技术,就可以提供高级解决方案。您只需集中精力解决业务问题,其他工作都可以交给 Oracle APEX 来处理。

 v20.2版本导出数据优化点:

  • 内置PDF打印和Excel下载,用于交互式报告,交互式网格和经典报告。确保在您的区域属性中启用PDF和Excel作为其他下载格式。用户可以在下载对话框中更改页面方向和大小。
  • 交互式报告-发送电子邮件:现在可以附加所有下载格式。
  • 与BI Publisher的增强集成。
  • 新的APEX_REGION.EXPORT_DATAAPEX_DATA_EXPORT API,以编程方式生成PDF,CSV,Excel,HTML,JSON和XML文件。
  • 内置PDF现在支持中文,日文和韩文。

 如需要使用可在以下的地址申请工作区:

 申请免费工作区地址:

  https://apex.oracle.com/pls/apex/f?p=4700:2:10115035671324:::RP::

APEX中导出数据实现:

 一、普通表导出、打印实现

  • 示例数据导入:

   进入:SQL工作室->实用程序->示例数据集->【EMP/DEPT】数据安装

  • 创建应用:

   进入:应用程序构建器->创建->新建应用程序->创建应用程序;创建完成如下图

   

  • 页面设计:

   进入应用程序:进入主页设计:添加经典报表元素->绑定数据表->支持导出和打印功能->进行打印设置:打印成Excel

    

 

  • 运行效果

   运行效果如下,点击导出时导出该表csv文件内容;打印时输出该表对于html内容

     

 二、交互式报表导出、打印

  • 设计页面:在页面中添加交互式报表->并绑定数据表

    

  • 预览执行效果:操作->下载->选择下载格式

 

  三、调用APEX提供API实现:

   在上面示例中添加按钮调用:Export_Data接口实现数据导出

    

 

 

     

 

 

    执行代码为以下内容:    

DECLARE
    l_export       apex_data_export.t_export;
    l_region_id    number;
BEGIN

   SELECT region_id into l_region_id
     FROM apex_application_page_regions
    WHERE application_id = 36324--(应用程序ID)
      and page_id = 1--(页码id)
      and static_id = 'EXRep'--(区域静态id-交互式报表需指定该id);
    
    l_export := apex_region.export_data (
         p_format       => apex_data_export.c_format_html,
         p_page_id      => 1,
         p_region_id    => l_region_id );
         
    apex_data_export.download( l_export );
END;

   修改页面提交

   运行效果:

    

  • 13 APEX_DATA_EXPORT(重点)APEX_DATA_EXPORT包含用于从Oracle Application Express导出数据的实现支持的文件类型包括:PDF,XLSX,HTML,CSV,XML和JSON。

   本次使用API服务来测试该接口功能:SQL工作室->RESTful服务->模块->创建模块(export)    

 

 

 

     创建模板和处理方法:

     

    添加执行脚本:

DECLARE
    l_context apex_exec.t_context; 
    l_export  apex_data_export.t_export;
BEGIN

    apex_session.create_session (
    p_app_id   => 36324,
    p_page_id  => 1,
    p_username => 'EXAMPLE USER' );

    l_context := apex_exec.open_query_context(
        p_location    => apex_exec.c_location_local_db,
        p_sql_query   => 'select * from emp' );

    l_export := apex_data_export.export (
                        p_context   => l_context,
                        p_format    => apex_data_export.c_format_pdf );

    apex_exec.close( l_context );

    apex_data_export.download( p_export => l_export );

EXCEPTION
    when others THEN
        apex_exec.close( l_context );
        raise;
END;

    导出接口方法参数说明:

参数 描述
p_context 来自EXEC基础结构的上下文对象。
p_format 导出格式。有效值为:XLSX,PDF,HTML,CSV,XML和JSON。
p_as_clob 导出为CLOB而不是BLOB(默认为FALSE)。
p_columns 以分列符开始的列属性集合,然后按显示顺序。
p_column_groups 按级别和显示顺序收集列组属性。
p_aggregates 报告汇总的集合。
p_highlights 收集报告要点。
p_file_name 定义导出的文件名。
p_print_config 用于EXCEL和PDF设置打印属性。
p_page_header 文本显示在文档的标题部分。覆盖的页面标题p_print_config
p_page_footer 文本显示在文档的页脚部分。覆盖的页面页脚p_print_config
p_supplemental_text 所有下载格式顶部的文本。
p_csv_enclosed_by 用于CSV以封装输出。
p_csv_separator 用于CSV以分隔列值。
p_pdf_accessible 用于PDF以创建可访问的PDF。
p_xml_include_declaration 用于XML以生成XML声明作为第一行。

总结:

 通过简单使用感觉APEX功能比较完善,能快速的构建出业务应用;导出接口功能比较完善,支持灵活。

 对于自己实现相关导出功能有参考价值。 

参考资料:

 https://blogs.oracle.com/apex/exploring-report-printing-in-apex-202

 https://docs.oracle.com/en/database/oracle/application-express/20.2/aeapi/APEX_DATA_EXPORT-EXPORT-Function.html#GUID-6109A537-50C4-4FB2-8414-7A554B19EC8E