APEX-数据导出/打印

前言：

　由于公司使用了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_DATA和APEX_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实现：

34.2 EXPORT_DATA

　　　在上面示例中添加按钮调用：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