应用共享插件

1.1 版本

1.2 应用场景

传统的FineReport模板分享，只能通过将模板另存为或将原文件发送给其他人来实现。

• 无法实现关联模板同时导出，导致其他用户使用时经常出现报错，需要花费大量人力进行修改。

• 无法实现数据脱敏等操作，容易引发数据安全问题。

1.3 功能简介

本插件实现导出模板时，将相关联的模板同时导出在同一文件夹下，并自动修改超链等跳转路径，避免复用时出现报错。

同时支持设置脱敏规则，在导出可根据脱敏规则对数据进行脱敏处理，避免数据安全问题，使得资源复用更加便捷安全。

• 导出 FVS 模板及其关联模板：

支持导出 FVS 模板以及模板中相关联的模板。例如，A 模板中有相关链接跳转到 B 模板，在将 A 模板导出为 mfvs 文件时，会自动将 B 模板同时导出到此文件中，并修改 A 模板中的跳转链接路径。

• 数据脱敏：

支持设置脱敏规则，并根据脱敏规则将模板中的数据进行脱敏处理，确保数据安全。

• 数据库表导出：

导出时会将数据库中的表导出为 AppData 文件，实现参数查询联动效果。

• 模板封装与配置：

导出时可以根据需求将模板进行封装并配置内容，使得在导入时在资源中心预览时可实现封装效果。

• 数据血缘：

导入的 mfvs 模板支持「数据血缘」功能，便于理解模板内容的构成、实现数据的溯源。

注：数据血缘功能仅支持 FVS 为 V3.1.0 及以上版本且应用共享插件为 V1.4 及以上版本。

2.1 使用前提

1）如需安装「应用共享插件」：

• 请先确保升级 FineReport 至 11.0.24 及以上

• 请确保安装并启用「FineVis数据可视化插件」至 V2.10.0 及以上

• 再安装应用共享插件

2）安装「应用共享插件」后，FVS和应用共享插件的升级有关联关系

• 每次升级「FineVis数据可视化插件」前，请先升级「FineVis数据可视化插件」至最新，再升级应用共享插件。

• 「FineVis数据可视化插件」升级时，「应用共享插件」会被自动禁用，请在 FVS 升级完成后手动启用。

2.2 插件安装

点击下载插件：应用共享插件

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

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

2.3 插件功能

2.3.1 导出

1）入口一

点击设计器左上角「文件>复用>导出」。

注：「预览」功能可实现快速预览脱敏导出后的模板，向数据库中添加数据，以检测是否有问题。一般情况下，不建议用户使用该功能。如有实际应用场景，可联系帆软技术支持协助。

在弹出页面中，点击「内容配置>全部页面/添加页面>模板资源」即可选择需要导出的模板资源，选择导出方式后即可导出。如下图所示：

2）入口二

点击设计器左上角「服务器>FVS我的资源管理」，选择「应用封装>新建」，选择需要导出的模板后点击「确定」。如下图所示：

在新建的应用右侧，点击「导出」，选择导出方式后即可导出。

2.3.2 导入

点击设计器左上角「文件>新建可视化看板」，选择「我的资源」，可通过拖拽或点击本地模板打开。

3.1 导出

1）点击设计器左上角「文件>复用>导出」，点击「内容配置>全部页面>模板资源」。

2）选择需要导出的模板后点击「确定」

3）在右侧可以看到设计器内的封装预览界面，如下图所示：

4）点击「应用配置」即可对导出的资源进行配置。

具体配置项说明如下表所示：

5）配置完成后，点击右下角「直接导出/脱敏导出」即可导出。

本例选择脱敏导出，在弹出的数据脱敏页面，选择「确定」。如下图所示：

6）在保存页面中，文件名默认为「应用配置」中的「应用名称」，点击保存

弹出 提示：导出成功，即为保存成功。

3.2 导入

1）点击设计器左上角「文件>新建可视化看板」，选择「我的资源」，选择「应用共享示例.mfvs」文件，保存至我的资源并打开。

2）导入的资源在 reportlets 目录下自动创建一个文件夹，文件夹内包含 H2 格式的数据文件：appdata.mv.db 。

注1：远程设计下载导入时，需要确保账号可以看到 Reportlets 文件夹全部文件的预览权限。

注2：FVS V3.1.0 之前版本且应用共享插件为 V1.4 之前版本，数据文件格式为 DuckDB。

3）导入的模板默认使用 AppData 作为数据连接，示例数据的查询语句为 PGSQL 语句。用户根据不同需求切换为其他数据连接。

3.3 数据血缘

升级 FVS 插件至 V3.1.0 及以上版本、应用共享插件至 V1.4 及以上版本，设计器新增「数据血缘」功能。

通过表血缘和组件血缘，模板开发人员可以快速了解数据表和组件之间的关系，清晰看到数据来源和流向。这有助于快速理解模板结构，定位数据异常，提高开发和维护效率，便于数据溯源和优化。

注：资源中心的历史资源包不支持使用数据血缘。

3.3.1 功能入口

对于复用的 FVS 模板，底部工具栏处新增「血缘」按钮，如下图所示：

3.3.2 血缘视图构成

点击「血缘视图」按钮，画布下方弹出血缘视图，支持通过拖拽移动视图内位置。如下图所示：

血缘视图分数据来源、模板数据集、组件、页面 4 层，视图窗口中设有工具栏。具体说明如下表所示：

3.3.3 血缘视图交互

1）选中一个节点后，模板中有选中效果。该节点上下游的所有节点以及箭头，均变为联动状态，如下图所示：

2）选中节点，右侧显示「编辑」按钮，点击「编辑」即可打开编辑界面。如下图所示：

注1：仅支持编辑「模板数据集」部分。

注2：若数据集已被删除，点击编辑按钮后，显示弹窗「数据集已删除，无法编辑」。

1）支持导出 .cpt 和 .fvs 格式的模板

2）仅支持导入使用本插件导出的 .mfvs 文件，非本插件导出的文件缺少必要的 appdata.db 文件，会导致无法正常使用

3）支持新建并使用示例数据集，如下图所示：

注：缺少 appdata.db 文件时，不支持新建「示例数据集」

4）若需要删除资源，点击设计器左上角「服务器>FVS我的资源管理」，在「模板」和「应用封装」中找到对应资源一并删除即可。

注：reportlets 目录下的资源文件与「FVS我的资源管理」中的资源是独立的，以上删除操作不会影响 reportlets 目录下的资源文件。