组件复用插件

1.1 版本

1.2 应用场景

决策模板中的图表块、报表块等组件，样式调整耗时长，风格统一困难，制作效率被大幅度拉低。

如果在设计器中封装一些具备样式、功能和示例数据的组件，用户调用封装好的组件制作模板，制作效率将极大提升。

1.3 功能介绍

通过组件商城及组件复用插件，适合应用在决策报表中，可以实现决策报表中组件样式的封装和复用，具体功能如下：

1）生成个人组件，本地复用。

2）商城组件和在线组件下载与复用。

3）组件管理，包括筛选、搜索、排序等。

2.1 插件安装

注：远程设计时，报表服务器也要安装「组件复用插件」，且要求服务器 JAR 包版本、安装的插件版本和本地设计器端一致。

插件下载请点击：模板组件复用插件

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

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

首次安装该插件，会出现新手用户使用引导，如下图所示：

2.2 插件界面

插件安装完成后，在决策报表右侧组件库，可安装使用、管理、生成组件。如下图所示：

注：V3.0 及以上的版本增加「在线组件」功能，涵盖了帆软商城的所有组件，用户可以直接在设计器内下载使用，免手动安装。

注：V4.0 及以上的版本增加自定义组件分组功能，支持用户对组件做一些基本操作，如分组排序、增删改等。

用户可通过「帆软市场>组件商城」下载组件后手动安装，也可以在「在线组件」处下载安装组件，在线组件涵盖了帆软商城的所有组件，用户可以直接在设计器内下载使用，免手动安装。

推荐通过「在线组件」下载安装插件，方便快捷，若设计器无法连接外网可以通过「帆软市场>组件商城」下载安装使用。

注：插件版本 V3.0 及以上的版本才支持「在线组件」功能，若想使用此功能，请升级插件版本。

3.1 组件商城

用户可通过 帆软市场 进入组件商城，进入组件商城后，用户可通过搜索、筛选、排序找到需要的组件。如下图所示：

选择需要的组件，点击下载，在本地将会获得.reu 组件属性文件。如下图所示：

3.2 在线组件

用户在设计器「组件库>在线组件」中也可下载组件使用，免手动安装，「在线组件」库涵盖了帆软商城的所有组件。如下图所示：

「在线组件」库中也可以通过搜索、筛选、排序，找到需要的组件，如下图所示：

选择需要的组件后，点击组件图片即可下载，下载后默认安装在「本地组件」库中，不用再手动安装。如下图所示：

4.1 本地组件

用户通过商城下载或从其他途径获取的组件，均可手动安装至设计器。
打开决策报表，点击组件库>安装，找到对应的组件 .reu 属性文件，安装至设计器即可。如下图所示：

4.2 在线组件

注：插件版本为 V3.0 及以上才有此功能，若想使用此功能，请升级插件版本。

用户可在「在线组件」库中下载组件使用，免手动安装，「在线组件」库涵盖了帆软商城的所有组件。如下图所示：

「在线组件」库中有组件和组件包。

一套风格统一的组件被打包成组件包，用户可以查看和使用组件包中的组件。如下图所示：

组件包的设定可帮助用户缩短筛选同类组件的时间，提高设计效率。

用户可以通过「创建组件」功能将自己满意的图表、控件打包成组件，下次直接从组件库中添加使用。如下图所示：

注：插件版本为 V3.0 创建组件功能名称为生成组件，名称不同，功能无差别。

注：body 自适应布局下，不支持将多个图表、控件打包成组件。

5.1 填写信息

选中组件后，点击创建组件时，出现组件生成的资料填写界面。如下图所示：

详细信息如下表所示：

注：如不选中任一组件，则出现报错「请选择一个合理的控件」，如下图所示：

5.2 生成组件

填写完毕后点击确定，将生成组件，出现如下图所示的提示，即意味着组件生成成功。组件生成后将出现在组件库中。

6.1 使用方法

下载安装的组件或用户创建的组件都会出现在「本地组件」库，拖动至决策报表即可使用，如下图所示：

为方便用户查找、使用组件，本地组件库中，有筛选、搜索、排序、刷新功能，用户通过这些功能，可方便快捷的使用组件，如下图所示：

注：插件版本为 V4.0 及以上才有此功能，若想使用此功能，请升级插件版本。

6.2 存放位置

生成的组件存放在%FR_HOME%\webroot\WEB-INF\assets路径下的component文件夹中。如下图所示：

注：component文件夹存放的是复用组件的帮助文件和属性文件。请不要移动和删除该文件夹。迁移时尽量整体拷贝assets文件夹。

注：插件版本为 V4.0 及以上才有此功能，若想使用此功能，请升级插件版本。

下载安装在「本地组件」库中的组件，可以按用户需求分组。下载后若不做调整默认属于「默认分组」，如下图所示：

7.1 管理分组

用户可以新建和删除分组，新建分组后，即可将同类的组件放置在一个分组中。如下图所示：

添加分组后，当需要删除和修改分组名称时，可以点击分组名称旁的展开按钮，选择对应的操作，如下图所示：

7.2 管理组件

用户选择管理软件，出现「删除选中」、「移动分组」、「取消」按钮，选择任意组件后，可以将该组件从当前分组删除或移动该组件到其他分组，如下图所示：