1. 概述
1.1 版本
| FineReport 設計器 | Finereport JAR 包 | FineBI JAR 包 | Spider 數據集插件 |
|---|---|---|---|
| 10.0 | 2018-12-27 | 2019-01-15 | V1.0.8 |
| 2019-6-13 | 2019-6-14 | V1.0.8 | |
| 2019-7-16 | 2019-7-16 | V1.0.8 | |
| 2019-9-27 | 2019-11-29 | V1.0.9 | |
| 2020-01-15 | 2020-01-15/2020-03-17 | V1.0.10 | |
| 2020-08-03 | 2020-08-04 | V1.1.5 |
1.2 應用場景
數據需要通過複雜報表展示的需求，FineBI5.1 無法直接實現的時候，可以通過使用 Finereport 設計器獲取 FineBI 業務包中的數據實現複雜報表制作的功能。
大數據量的分組彙總計算，可以在 FineBI 自助數據集的 分組彙總 功能中操作實現，之後在 FineReport 中展示。
1.3 功能簡介
FineReport10.0 設計器中通過安裝 Spider數據集插件 ，可對接 FineBI 的 Spider 引擎取數，共享 FineBI 的表數據及數據權限。
當 FineBI 的表數據進行了更新，FineReport 中的 Spider 數據集也會随之更新
Spider 數據集的參數篩選是由 Spider 引擎進行計算，其他的依舊由報表引擎進行計算。
2. 操作步驟
2.1 安裝插件
安裝 Spider數據集插件 , FineReport 設計器和 FineBI 服務器插件安裝的方法如下所示：
Finereport 設計器安裝插件，安裝方法參見 設計器插件管理 。
FineBI 服務器安裝插件，插件方法參見 服務器插件管理 。
2.2 連接 FineBI 工程
1）打開 Finereport 設計器，點擊文件>切換工作目錄>其他，遠程設計 到 FineBI 工程，點擊
，新建一個遠程服務器。
2）填寫遠程服務器配置信息、決策系統賬号使用「管理員賬号」，測試連接成功後，點擊确定，切換到 FineBI 工程，如下圖所示：
2.3 新建 Spider 數據集
切換到「遠程服務器」後，添加 Spider 數據集，如下圖所示：
注：Spider 數據集從 FineBI 取數後，FineBI 被取數的表的表名以及所在業務包都不能變動，否則 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 ，選擇管理系統>目錄管理，将模板挂載在任一目錄下便可實現預覽。如下圖所示：
