1. 概述
1.1 版本
|
报表服务器版本 |
JAR 包版本 |
插件版本 |
|---|---|---|
| 9.0、10.0 | 2021-06-10 | 1.5.2 |
| 11.0 | 2022-05-20 | 1.4.33 |
1.2 应用场景
目前在对 CPT 报表进行分页预览时有 Word、Excel、PDF、图片这四种报表导出方式。使用此插件可将 CPT 报表以 PPT 的格式导出，支持单个模板导出或是依据用户权限可访问的模板进行批量导出。
1.3 功能介绍
-
支持分页预览、填报预览、数据分析时进行报表的导出。
-
支持报表各类组件、图表的导出。
-
支持各类背景的导出。
-
支持单元格各类元素包括 HTML 类型的导出。
-
支持可配置参数的批量导出（仅支持10.0~11.0）。
2. 示例
2.1 插件安装
设计器插件安装方法参见 设计器插件管理
服务器安装插件方法参见 服务器插件管理
2.2 单个模板导出
1）打开要导出的报表，菜单栏点击模板>模板 Web 属性，进入模板 Web 属性设置界面，如下图所示：
2）模板Web属性面板选择分页预览设置>为该模板单独设置，双击工具选项中的PPT，将 PPT 添加到工具栏中，如下图所示：
3）设计器中点击分页预览，在浏览器中查看报表，点击上方工具栏中的PPT按钮，将报表以 PPT 的格式进行导出，如下图所示：
2.3 批量模板导出
2.3.1 默认导出
1）报表服务器启动后，在地址栏输入：http://ip:端口/工程名/decision/url/multicpt/ppt。
以http://localhost:8075/webroot/decision/url/multicpt/ppt为例，地址栏输入后回车，即打开批量导出界面。
左边的文件列表是决策系统挂载出去的报表，同时包含普通报表和决策报表，但是决策报表由于不支持，所有不能选取。
勾选需要导出后的报表后，点击选择，右边的导出列表会显示这些报表，点击下一步。
2）如果报表有设置参数查询，那么可以编辑参数查询后导出，如果不配置参数，则使用默认参数导出。
所有配置工作完成后点击下方的导出PPT按钮。
注：如果导出列表的报表没有设置参数，那么添加参数配置时会提示：
3）点击导出PPT按钮后，弹出设置幻灯片大小对话框，需要配置幻灯片大小（默认1920*1080），最后点击确定导出。
5）导出的文件会在浏览器中下载，所有报表合并到一个 PPT 中。
2.3.2 配置参数导出
2.3.2.1 基本配置
1）为模板配置模板参数或在数据集中配置参数
2）在参数面板中配置控件（控件名称与1中的模板参数名称相同，标签名称为页面中控件的显示名称） 
3）点击导出列表中需要配置的选项后在右侧列表中配置相应参数。
4）编辑参数并保存，若失败则会根据参数面板配置提示。未保存直接进行导出会直接导出默认数据。
2.3.2.2 支持控件类型说明
注：各控件值之间不支持联动；参数值为公式中的fine_username, fine_role, fine_position时即使配置控件也不将显示，由系统直接生成；
| 控件类型 | 支持说明 |
| 本文框控件 | 支持校验； |
| 下拉框控件 | 支持配置返回值类型为数组或字符串配置；支持校验是否为空，当同时勾选允许直接编辑和自定义值时，前端页面可通过输入内容后回车更增加新选项； |
| 日期控件 | 支持格式；起始结束日期暂不支持；仅支持返回值类型为字符串；支持校验是否为空； |
| 数字控件 | 支持校验； |
| 下拉树 | 支持多选，不支持异步加载，结果返回叶子结点，结果返回完整层次路径；支持校验，当同时勾选允许直接编辑和自定义值时，前端页面可通过输入内容后回车更增加新选项； |
| 单选按钮组控件 | 导出页面显示为下拉框；支持校验； |
| 复选按钮组控件 | 导出页面显示为下拉框；支持校验；支持返回值类型；不支持全选； |
| 文本域控件 | 支持校验； |
| 密码控件 | 支持校验； |
| 复选按钮控件 | 仅支持布尔型及默认为true |
| 视图树 | 支持多选，不支持异步加载，结果返回叶子结点，结果返回完整层次路径；支持校验是否为空，当同时勾选允许直接编辑和自定义值时，前端页面可通过输入内容后回车更增加新选项； |
2.4 文件查看
1.打开单模板导出的 PPT 文件，查看导出效果，如下图所示：
2.打开批量模板导出的 PPT 文件，查看导出效果，如下图所示：
3. 注意事项
1）报表导出为 PPT 时不能自适应大小，如果 PPT 中报表出现错位可拖拽 PPT 中的表格控件控制内容大小，或是通过调整设计器中报表单元格及页面的宽高。
2）过于高的报表可能会根据页面设置显示为超出幻灯片范围，若设置了分页则在ppt中也会分页显示。
3）PPT 幻灯片个数跟随报表页数扩展 ，报表中数据需要分页显示时，同样在 PPT 中会新建幻灯片显示数据。
4）由于 PPT 的 SDK 自身问题，可能导致某些复杂单元格的边框效果丢失。可通过将有边框的单元格相邻的单元格设置相同边框属性解决。
5）由于 PPT 幻灯片大小固定，批量模板导出 PPT 时模板大小不一，默认将按照所有导出模板的平均值设置，若不合适请自行设置幻灯片大小。
6) 工具栏导出的PPT幻灯片尺寸会根据当前模板预览时所示窗口自动计算，即浏览器窗口尺寸越大幻灯片尺寸越大。
7）建议使用PowerPoint打开PPT文件，WPS可能存在兼容性问题导致元素错位。
8）所有模板的内容导出至PPT中基本是基于表格显示的，模板中设置在单元格的图片也会导出至PPT中的单元格中，悬浮元素导出至PPT则是独立的PPT图片元素，默认层级高于表格显示。
4. 单个模板优化导出
该方法可将所有元素导出成 PPT 中的一张图片，能完美解决注意事项5。
1）在浏览器地址栏中输入导出地址即可
2）sessionID需在导出报表页面中查找
1. 打开报表页面后按F12弹出工具栏
2. 在元素（Elements）选项中使用ctrl+f搜索sessionID即可查找到值
