报表多类型导出插件

1.1 版本

1.2 应用场景

1. 本插件支持将cpt、frm模板导出为Excel、Word、PDF、图片以及PPT（pptx和ppt兼容模式）。

2. 产品提供的cpt或frm批量导出功能配置较为繁琐，本插件提供配置页面可对有访问权限的cpt或frm进行任意组合并配置参数为方案，并能对方案导出为同一种类型文件。

3. 定时调度可根据第2点中配置好的方案进行导出后做后续处理。

1.3 功能描述

1. 使用url进行cpt或frm模板导出时支持PPT(文件后缀名为pptx，仅支持Office 2013及以上)与PPT兼容（文件后缀名为ppt）。

2. cpt模板在工具栏的导出一栏中新增PPT与PPT兼容模式（默认开启），同时可在工具栏中扩展独立的PPT导出按钮。

3. 定时调度的附件存档方式增加ppt，ppt兼容模式和image。

4. 批量导出配置页的访问支持权限控制。访问地址示例：http://localhost:8075/webroot/decision/url/report
   

5. 批量导出时可任意组合cpt或frm模板（模板为当前平台用户权限可访问的模板）进行单模板导出独立文件，或将多模板组合导出为1个文件。

6. 批量导出配置参数时支持对每个模板进行参数设置或将方案中的模板参数进行合并配置，同时也支持该方案下的全局参数配置。

7. 当前登录用户可对批量导出配置进行存储，同时各个用户之间的方案独立访问。

8. 定时调度新增支持报表多类型导出，用户可选择自己创建好的方案进行导出并做后续处理。

2.1 插件安装

点击下载插件：报表多类型导出 

设计器插件安装方法参见 设计器插件管理

服务器安装插件方法参见 服务器插件管理

2.2 操作方法

2.2.1  预览导出

2.2.1.1  通用导出

预览cpt或frm模板时可通过在url最后添加以下参数导出对应的文档内容。

注：

1. 若导出文件的数据内容与预览数据内容不一致（一般出现在参数查询后），可在参数后方添加 &sessionID=xxx。 但需要注意，当添加sessionID导出多次时可能会出现会话失效。

2. 该方式导出frm时默认使用新自适应接口进行导出，因此对于旧模板类型导出时支持有限（若图表位置偏移的情况）。如需要对旧自适应模板进行导出请在URL参数后方添加&executeType=original 

3. 若导出的PPT需要为不可编辑的图片内容时可使用：&op=export&format=ppt&edit=hide

2.2.1.2  CPT模板预览导出PPT

2.2.1.2.1 工具栏导出PPT

工具栏一旦开启，即可在 导出 => PPT 中点击PPT或PPT兼容模式进行导出。

若模板不需要支持该导出，也可通过 模板web属性 => 为该模板单独设置 => 顶部工具栏设置 => 导出 中取消勾选PPT

2.2.1.2.2 PPT按钮导出

如期望可以直接进行PPT导出，可参照 2.2.1.3.1中的配置取消导出中的PPT按钮，然后在模板web属性中直接双击选择PPT添加按钮至工具栏。

预览效果：

2.2.2  批量导出

可通过批量导出页进行导出配置 http://localhost:8075/webroot/decision/url/report

2.2.2.1  创建合并方案

1. 新建方案

2.选择需要导出的模板

注：该目录的模板列表的都通过该用户的目录权限加载，因此可为不同用户配置不同的模板进行导出。

3. 导出方式选择合并

4. 拖动模板可编辑在该组中的导出顺序

5. 下一步，点击模板编辑模板参数（若有参数时）

6. 保存方案

7. 选择导出PPT

注：PPT导出中，内容不可编辑指任意模板都将导出为一张完整图片而非表格显示的具体文本

8. 预览效果

由于该方案仅导出一组合并文档，因此导出模板后仅一个PPT文件。预览如下

2.2.2.2  创建单文件方案

操作方案同2.2.1.1，仅当第3步的导出方式选择为单个

最终导出后将保存一个zip文件，zip文件中包括配置的每一个模板。

2.2.2.3  创建组合方案

组合方案可按2.2.1.1及2.2.1.2中的任意模板按不同方式配置

如图方案配置，最终文件将导出为一个zip压缩包，共包含3个文件。其中，利润中心和资金分析将合并为资金，财务综合指标和生产库存分析将作为独立的文件。

2.2.2.4  批量导出参数配置

注意：批量导出页加载的控件需要数据集参数和参数面板中的控件参数保持同名才能在此页面加载控件。同时参数编辑后务必先点击参数配置中的保存按钮，否则会造成配置丢失。

1. 每一项

   下拉框都包含此选项，该选项可将该模板按所有选项分别导出不同的内容。假设测试中的模板不包含选项，若GettingStarted中地区参数分别为华东和华北，那么选择每一项时将会导出两个GettingStarted和一个测试文件。若公式字段GS1分别为1、2，此时也选择每一项，那最终文件将会是4个GettingStarted，和一个测试文件。

   

   
   

   
   

2. 增加一组参数
   

   该功能可将同一模板配置为多组参数，适用于同一模板少量的根据不同参数组合进行多张导出。
   

   

   
   

3. 全局参数

   全局参数可为该方案中每一模板添加执行参数，模板中的参数配置优先于全局参数。

   
   

   
   

   

   
   

   

   
   

4. 合并参数

   打开该配置，可将所有模板的参数同时展示出来进行配置。一般适用于批量导出的模板都包含同一个参数的情况，以便于快捷配置参数。同时如若下拉框等加载数据失败或其他未加载的情况，也可通过模板名称旁的按钮将控件转换为输入框直接填写值。

   注意：该方式不支持前3种配置方式。

   

   
   

2.2.3  定时调度导出

2.2.3.1  普通定时调度

新增支持ppt兼容模式，ppt，image

2.2.3.2  报表多类型导出定时调度

1. 添加任务

   
   

2. 基本设置

   
   

3. 调度对象

   对象类型选择报表多类型导出，并选择导出方案和导出类型。
   

   
   

4. 调度处理

   
   

5. 文件处理

   

   
   注：正文加上结果链接中的邮件链接，无论何种方案导出，都只显示第一个模板的第一页。

   注：使用附件无论何种导出类型文件都将显示zip。
   

6. 预览

   
   

2.2.4  设计器导出

注：目前设计器仅支持frm模板导出。

1）打开文件选项，选择 报表多类型导出

2）点击 + 选项，出现文件目录下拉树，点击想要合并导出的 frm 文件。按住shift进行多选，或按 ctrl 进行多选。

3）可通过排序按钮或长按模板进行拖动修改模板的导出顺序。

4）双击模板，选中需要导出的组件。按住shift进行多选，或按 ctrl 进行多选。

5）设置模板导出尺寸，并选择导出类型后点击确定选择保存路径并等待导出完成。

6）预览结果

2.3 系统配置

管理系统 =>  系统管理  =>  常规  => 报表多类型导出

并发数：                            批量导出时最大并发数。 该配置允许批量导出时利用多线程处理并计算模板，可加快导出速度。

仅在目录中展示：                开启后批量导出页不能直接通过URL访问，必须将URL挂载在决策目录后通过决策系统访问。

                                        开启后直接访问的效果：                                            

批量导出页标题：                自定义报表多类型导出配置页的标题，支持国际化插件的key。

批量导出参数数据集限制：    批量导出时为模板配置如下拉列表类型的数据行数限制，防止数据过多引起异常。

显示菜单副标题：                开启后可在配置页模板目录树显示该模板的文件类型，方便根据模板类型进行组合配置。

                                        效果如下：

3.1 导出相关

1）定时调度中报表多类型导出生成的挂载目录结果或是邮件结果等链接都只会生成方案的第一个模板的第一页。

2）按钮控件及第三方控件不支持导出，frm模板中Tab 组件只导出第一个Tab下的内容，且Tab本身将会作为背景图片导出。同时翻页仅导出当前页。

3）由于11.0接口限制，批量导出时frm模板中凡是包含body背景图片或报表块，图表块背景时都将导出为一张完整图片。

4）frm模板进行URL导出时不可和同类型插件同时启用，否则会引起冲突（URL无法导出PPT）。如：决策报表导出插件、决策报表多标签页导出插件。

5）批量导出页面的参数控件需要控件名与参数名一一对应才能被加载，同时各参数之间不支持联动效果。

6）若frm模板需要对导出效果有较好支持（除Excel），建议将模板设计尺寸和导出配置尺寸保持一致。

7）批量导出仅支持分页预览方式进行导出，因此填报类型模板导出后的效果只能和分页预览时一样。

8）在保存方案时，如若一个模板中包含的参数内容（一般是选项）较多时可能造成保存失败。请尝试找到finedb中fine_batch_export_list表，将parameters字段长度调整更大一些或不限制长度。

3.2 PPT相关

1)  frm报表若各个组件之间存在重叠情况或模板中报表块行宽过多使用7像素以下宽度时，ppt仅能将内容导出为一张图片的幻灯片。

2）在frm模板中由于接口原因在导出PPT与word时，两个连续组件之间可能会有间隔，所以不建议分别在两个组件中使用渐变色作为背景。

3）PPT普通导出中表格有最小宽高度的限制，同时表格也会根据文字字体大小自动更改宽高的情况。因此可能出现导出的pptx幻灯片表格超出幻灯片范围或是有悬浮元素时表格和悬浮元素位置出现细微不一致的情况，此时可调整模板中行宽和列高或字体大小进行调整。当URL导出时可拼接参数 &width=1920&height=1080（11.0可用） 使模板按该尺寸导出。

4）由于 PPT 的 SDK 自身问题，可能导致某些复杂单元格的边框效果丢失，此时可通过将有边框的单元格相邻的单元格设置相同边框属性解决。

5）文件后缀名为pptx的PPT建议使用PowerPoint 2013及以上的版本打开，若使用WPS打开可能存在兼容性问题导致元素错位或缺失。若仅使用WPS软件查看PPT，请使用PPT兼容模式进行导出。

6）WPS的Mac版本打开.ppt存在中文字体无法正常显示的问题，如包含数字，英文，中文的文本在设计器中使用微软雅黑。但使用Mac版WPS打开后中文显示为Arial (正文)，其他则正常。

注：本文档适用于2.0及以后版本的插件，旧版文档可见：

CPT报表导出PPT

多CPT导出Excel

多CPT导出PDF

决策报表导出plus

合并演示报告