1. 概述
1.1 版本说明
| 报表服务器版本 | 功能变动 |
| 10.0 | 版本更新后,组件复用功能已合并至设计器,以后无需安装「组件复用插件」且相关功能随设计器更新 |
1.2 应用场景
下载并复用在线商城组件的步骤如下图所示:
预览效果如下图:
1.3 环境要求
- 10.0.17 之前版本的设计器,需要安装 组件复用插件 才能使用组件复用功能。
- 10.0.17 及之后版本的设计器,无需安装插件即可使用该功能。
2. 功能入口
现在打开组件库的入口有 2 个,分别是:
2.1 组件库
新建或打开决策报表,右侧工具栏有一个「组件库」按钮,这个是所有版本设计器都有的入口。
点击按钮后,会打开组件库页面,如下图所示:
2.2 套用组件
决策报表上方工具栏最右侧新增「套用组件」按钮,这个是 10.0.17 及之后版本才有的入口。
点击按钮后,会跳转到组件库页面,如下图所示:
3. 组件库使用指南
3.1 复用在线组件
3.1.1 下载组件
首先要把组件下载到本地,下载组件的渠道有 2 种。
1)渠道一:直接在设计器在线组件页面下载。
进入「组件库」的「在线组件」页面后,「组件」和「组件包」Tab 下,会有很多组件。
浏览并选择自己想要的,然后鼠标悬浮在这个组件上方,会出现白色下载按钮,同时左边也会弹出组件效果预览图,点击下载按钮后,组件即下载到本地。
切回到本地组件页面,下载好的组件会保存在这个页面,如下图所示:
所有下载的组件都以 .reu 文件的形式保存在%FR_HOME%webappswebrootWEB-INFassetscomponent路径下。
注:如果工程下有 %FR_HOME%webrootWEB-INFassetsFineReport.reuse 文件夹,这个是17年老组件库用的文件夹,可以删除。
2)渠道二:商城下载并安装到本地
打开 组件在线商城 后,挑选自己想要的组件,然后点击这个组件的展示区域,即可进入下载页面。
点击下方的「下载组件」按钮,即可将 .reu 文件下载到本地文件夹,此时还未结束,还需要将文件安装到设计器本地目录下。
组件库打开「本地组件」页面,点击「添加组件>安装组件」,将 .reu 文件安装到设计器本地目录下即可,如下图所示:
注:按住 Shift 键批量选中 .reu 文件可以批量安装组件。
3.1.2 使用组件
使用方法很简单,只需要将组件拖到决策报表的 body 中即可,如果是绝对布局还能自由调整组件位置和大小。
鼠标悬浮在组件上方时,其右上角就会出现「帮助设置」按钮,点击按钮会进入帮助设置页面。
「帮助设置」页面可以看到组件使用说明和组件中所有条件属性、JS、超链接这些特殊设置项。(如果组件没有特殊设置项,则不显示)
在帮助设置的组件介绍处,会有推荐的组件 body 背景色,使用时建议您设置成该颜色,以保证最佳展示效果
3.2 创建可复用组件
如果您想将自己制作的报表块、图表块保存起来,方便下次直接使用,就可以将它们生成为组件,保存到本地目录下,下次可以直接拖进来用。
首先要先用鼠标选中这个报表块或图表块,然后进入组件库的「本地组件」页面。然后点击「添加组件>创建组件」。
打开生成组件的配置页面,设置后相关信息后,点击确定即可生成组件,生成的组件保存在本地组件页面。下次可以直接拿来用。
步骤演示可以看下面这张图:
3.3 管理本地组件
3.3.1 分组管理
有时候本地组件太多了,整个页面非常乱,找的时候也难找,可以将组件整理到不同分组下,这样以后可以直接打开对应分组来找,节省时间。
- 点击「本地组件」页面下的「添加分组」按钮,可以新建分组。
- 右键组件后点击「移动分组」,可以将组件移到某个分组下面去。
完整操作见下图:
3.3.2 批量操作
组件很多时,支持批量删除和移动分组,点击「本地组件」页面下的「管理组件」按钮即可进行相关操作。如下图所示:
3.3 注意事项
3.3.1 版本问题
在遇到过低版本时会出现没有在线组件的栏目,如图:
切换到服务器对应版本或者高版本(也不可过高与服务器版本)即可。
3.3.2 组件添加
当想选中整个页面作为组件时,需注意页面布局方式需为绝对布局,当布局方式为自适应布局时,会出现多个组件无法选中的情况。必须使用这个页面上的组件时,建议单个组件去进行添加或者更改页面布局方式为绝对布局,调整好样式之后在进行添加
3.3.3 组件使用
页面布局方式为绝对布局时,拖入组件可能会出现无法添加到该区域的情况,如图所示:
解决方式:将页面布局方式改为自适应布局即可,就可以正常拖入,拖入之后再去进行修改
3.3.4 使用范围
当前仅支持决策报表去进行组件复用,普通cpt图表暂不支持



