1. 概述
1.1 版本
报表服务器版本 | JAR 包版本 | 插件版本 |
|---|---|---|
| 11.0&10.0 | 2018-07-31 | V1.2 |
1.2 应用场景
在一个具有复杂列的明细表中，可能不同的用户关注的列是不一样的，全部展现出来不容易查看，所以需要通过功能来筛选出特定的列。
在报表展示过程中，对于列表经常需要获取不同的字段，目前主要根据条件隐藏处理，此插件可以方便的处理列定制的一般情况。
插件处理定制列后，不仅报表预览展示变化，同时改变报表导出结果内容。
1.3 功能介绍
此插件功能为定制报表展示列调整。可依据实际需求选择指定列内容进行隐藏不显示，使得报表展示针对性更强内容更加突出。
功能描述如下：
在工具栏新增一个“定制展示列”按钮；
用户点击按钮时弹出下拉菜单，显示报表所有列内容。
用户勾选列名就立即隐藏此列；取消选择列名，则立即显示此列。
用户点击报表空白处、鼠标离开菜单元素，下拉列表收回隐藏。刷新页面，会恢复为全部展示列。
默认报表首行值作为下拉菜单选项。
在设计器的“模板”提供菜单项“定制列属性”，可配置每个报表的列内容所在行数，以满足不同格式报表的需求。
选择定制列后，报表预览展示变化，同时改变报表导出结果内容。
2. 插件介绍
2.1 插件安装
点击下载插件：报表定制展示列插件
设计器插件安装方法参照：设计器插件管理
服务器安装插件方法参照： 服务器插件管理
2.2 操作方法
2.2.1 添加组件
安装好插件后，设计器打开报表文件，点击菜单栏模板>模板Web属性>分页预览设置>为该模板单独设置，就可以在工具栏选项中看到新增的展示列定制组件，双击组件添加到工具栏，设置完成后即可在报表分页预览时查看效果。
2.2.2 参数配置
插件安装后，可直接使用，基本上可满足大多数场景的需求，因而无需配置参数。
但是插件提供了参数自定义功能，满足用户在特定场景下的自定义需求。
插件可配置参数如下：
表头列参数设置：配置报表列值所在的行数，默认为 首行。
设置方法如下：
在设计器的“模板”提供菜单项“定制列属性”。可配置每个报表的列内容所在行数，以满足不同格式报表的需求。
3. 示例
3.1 报表设计
1）打开报表%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\Advanced\Pagination\BasicPagination.cpt，菜单栏点击模板>模板Web属性>分页预览设置>为该模板单独设置，双击分页器组件，添加到工具栏后点击确定。
3.2 展示列设置
在设计器的“模板”提供菜单项“定制列属性”。配置表头行号为3
3.3 效果预览
保存报表，点击分页预览 ，查看报表效果：
注：不支持移动端。
4. 模板下载
点击下载模板：报表定制展示列插件.cpt
5. 注意事项
合并行的单元格，在最小行获取列值显示；合并列的单元格，在最小列获取列值显示。
行式报表预览、大数据集导出Excel、CSV插件导出、URL导出，不支持隐藏列。工具栏导出功能支持隐藏列。
因WebActor接口限制，不兼容报表调试助手插件。
