1. 概述
1.1 版本
| FineReport 设计器 | Finereport JAR 包 | FineBI 服务器 | FineBI JAR 包 | Spider 数据集插件 |
|---|---|---|---|---|
| 10.0 | 2018-12-27 | 5.1 | 2019-01-15 | V1.0.8 |
| 10.0 | 2019-6-13 | 5.1 | 2019-6-14 | v1.0.8 |
| 10.0 | 2019-7-16 | 5.1 | 2019-7-16 | v1.0.8 |
| 10.0 | 2019-9-27 | 5.1 | 2019-11-29 | v1.0.9 |
| 10.0 | 2020-01-15 | 5.1 | 2020-01-15/2020-03-17 | V1.0.10 |
注：2020-04-26 发布的 FineReport 版本必须将插件升级至 V1.1.3 ，且 FineBI 必须使用 2020-02-28 以后发布的 5.1.3 内测版本，如有需要请联系技术支持获取。
1.2 应用场景
数据需要通过复杂报表展示的需求，FineBI5.1 无法直接实现的时候，可以通过使用 Finereport 设计器获取 FineBI 业务包中的数据实现复杂报表制作的功能。
大数据量的分组汇总计算，可以在 FineBI 的 自助数据集 中操作实现，之后在 FineReport 中展示。
1.3 功能简介
FineReport10.0 设计器中通过安装 Spider数据集插件 ，可对接 FineBI 的 Spider 引擎取数，共享 FineBI 的表数据及数据权限。
注：BI 在 5.0 使用了全新的 Spider 引擎，原 FineIndex 插件不再适用。
Spider 数据集的参数筛选是由 Spider 引擎进行计算，其他的依旧由报表引擎进行计算。
2. 操作步骤
2.1 安装插件
安装 Spider数据集插件 , FineReport 设计器和 FineBI 服务器插件安装的方法如下所示：
Finereport 设计器安装插件，安装方法参见 设计器插件管理 。
FineBI 服务器安装插件，插件方法参见 服务器插件管理 。
2.2 连接 FineBI 工程
1）打开 Finereport 设计器，点击文件>切换工作目录>其他，远程设计 到 FineBI 工程，点击
，新建一个远程服务器。
2）填写远程服务器配置信息、决策系统账号使用「管理员账号」，测试连接成功后，点击确定，切换到 FineBI 工程，如下图所示：
2.3 新建 Spider 数据集
切换到「远程服务器」后，添加 Spider 数据集，如下图所示：
2.3.1 明细表
1）一个 Spider 数据集下面可有多个业务包，点击下拉按钮，可以看到所有业务包，这里选择「地产行业」业务包。
一个业务包下面可有多个表，点击下拉按钮，可以看到所有的表，这里选择「签约事实表」。
可以将表设置为两种类型——明细表和分组表，这里选择「明细表」；
点击数据后的设置按钮进入数据选择对话框，对话框中罗列出所有的字段，直接勾选即可，勾选后点击确定，如下图所示：
2）点击排序后的设置按钮进入排序设置对话框，添加排序列，设置升序、降序；
本次操作中选择「销售单价」，「升序」，点击确定；
点击过滤条件后的设置，进入过滤条件设置对话框，添加列，设置条件；
本次操作中可选列为「合同总价（人民币）」，操作符为「大于」，参数为「$p」；
点击刷新按钮，就能看到参数「$p」了，设置「$p」默认值 140000，点击该界面右下角确定 按钮，Spider 数据集添加完成。如下图所示：
下面列出各种字段类型的过滤方式，如下表所示：
| 字段类型 | 过滤方式 |
|---|---|
| 文本 | 包含于、不包含于、包含、不包含、开头是、结尾是、开头不是、结尾不是、为空、非空 |
| 数值 | 等于、不等于、大于、小于、大于等于、小于等于、为空、非空 |
| 日期 | 大于（某个日期之后）、小于（某个日期之前）、等于、不等于、为空、非空 |
| 布尔 | 等于、不等于（true/false） |
3）设置完成之后，点击左上角的预览按钮 ，可以看到如下图所示的效果：
2.3.2 分组表
1）再添加一个 Spider 数据集，业务包选择「地产行业」，表选择「签约事实表」，类型选择「分组表」；
点击「指标」后面的设置，进入列轴选择对话框，对话框中罗列出业务包中所有数据表的指标字段，依次勾选「合同总价（人民币）」、「销售面积」、「销售单价」；
点击「维度」后面的设置，在弹出的对话框中选择「AREAGUID」、「BUGUID」、「合同总价」和「标准总价」字段。该对话框中显示了所有与上面指标选择字段相关联的数据表；
注：指标和维度不可选择同一字段，当指标选择了 A 字段时，维度的 A 字段选择灰化，反之亦然。
如下图所示：
2）点击「汇总」后面的设置，在弹出的对话框中选择需要各个汇总字段的汇总方式（这里的字段对应指标字段）；
汇总字段依次选择「去重计数」、「计数」、「求和」。如下图所示：
下面列出各种字段类型的汇总方式：
| 字段类型 | 汇总方式 |
|---|---|
| 文本 | 去重计数、记录个数、字符串拼接，默认为去重计数 |
| 数字 | 求和、求平均、求中位数、求最大值、求最小值、去重个数、记录个数、求方差、求标准差，默认为求和 |
| 时间 | 重计数、记录个数、最早时间、最晚时间，默认为去重计数 |
3）点击「排序」后面的设置，进入排序设置对话框，添加排序列（排序列可添加指标及维度中已添加的字段）；
选择「标准总价」，选择「升序」，点击确定；
点击「过滤」条件后面的设置，进入过滤条件设置对话框，添加列，设置条件，点击添加，再点击确定，各种字段类型的过滤方式同明细表。
过滤条件中，可选列为「合同总价」，操作符选择「大于」，设置一个参数「$p」；
点击刷新按钮，参数「$p」的值为 140000，点击该界面右下角确定按钮，Spider 数据集添加完成。如下图所示：
4）设置完成之后，点击左上角的预览按钮 ，可以看到如下图所示的效果：
3. 注意事项
描述：将已建好的 Spider 数据集中的字段拖入到模板中，保存模板，预览时出现如下图所示的错误：
解决方案：Spider 数据集模板必须登录平台获取到用户后才能预览；
即用户登录 FineBI ，选择管理系统>目录管理，将模板挂载在任一目录下便可实现预览。如下图所示：
