資料集- FineReport帮助文档 - 全面的报表使用教程和学习资料

1. 概述

1.1 版本

FineReport版本	功能變動
11.0	-
11.0.4	優化資料集管理，新增「搜尋」、「複製」、「批量選擇資料集」功能。具體請參見本文第三章內容
11.0.7	資料表搜尋框位置行動到上方，使用者可在該搜尋框中搜尋資料表。具體請參見本文第四章內容

1.2 功能簡介

1）資料集是指可直接應用於範本設計的資料展現集合。

2）按其來源範圍資料集可以分為資料庫查詢，內建資料集，檔案資料集， SAP資料集，儲存過程，多維資料庫、聯動資料集以及樹資料集。

注：資料集的名稱中不能包含英文標點【.】。

2. 新增資料集

在 FineReport 中使用者可以新增「伺服器資料集」或「範本資料集」兩種，可根據自己的需要進行新增。

2.1 伺服器資料集

伺服器資料集是對應於整個報表工程的，更換一個範本或建立一個工作簿，仍然可以用伺服器資料集中的資料。

具體的新增方式可參見：伺服器-伺服器資料集。

2.2 範本資料集

範本資料集是對應於當前範本的，儲存在這個範本的 cpt 檔案中，不能與其他範本公用，是私有的。

新增方式一： A 刪除； B 複制；C 上移資料集；D 下移資料集；E 資料集排序，如圖1所示。
新增方式二：如圖2所示。

2.3 資料集型別

根據資料來源，資料集型別分為：資料庫查詢，內建資料集，檔案資料集， SAP資料集，儲存過程，多維資料庫、聯動資料集以及樹資料集。

資料集型別	定義
資料庫查詢	對資料源中的資料庫表，直接使用 SQL 語句，來選擇所需要的資料欄位。
內建資料集	建立一個類似資料庫表的原表，可作為範本的資料源來設計報表。
檔案資料集	是指以 TXT 正文檔案、Excel 檔案和 XML 檔案中的資料為資料集，並以二維表的結構展示在資料集當中。
SAP資料集	先建立一個 SAP 資料連結，透過該資料連結建立 SAP 資料集。
儲存過程	儲存過程，就是直接將儲存過程作為資料集，不需要在資料庫查詢而是去呼叫儲存過程。
多維資料庫	在XMLA 資料連結的基礎上，建立多維資料庫 XMLA 資料集。
聯動資料集	在不同的資料源進行篩選取數；訪問不同的資料庫；利用來自不同的資料源形成一個資料集。
樹資料集	為元件綁定樹資料集， Web 端查看時就會自動生成樹形層級結構。

2.4 慢資料集

當一個資料集執行時間超過 2 s 時，那麼它在設計器中的資料會比實際資料慢。系統會給該資料集加上慢資料集標籤圖，如下圖所示。

3. 管理資料集

使用者可以透過介面左下角對已新增的資料集進行管理，如下圖所示。

功能	介紹
A：編輯	右擊資料集選擇【編輯】，或在工具欄直接點選【編輯】按鈕，即可對資料集進行編輯修改。
B：删除	右擊資料集選擇【刪除】，或在工具欄直接點選【刪除】按鈕，即可刪除所選資料集。
C：預覽	右擊資料集選擇【預覽】，或在工具欄直接點選【預覽】按鈕，即可預覽所選資料集。預覽介面複製資料集：進入預覽介面後，使用者可以直接使用滑鼠框選，也可以透過 shift 鍵來多菜儲存格。然後使用 control/command+c，就可以複制預覽介面的資料。如下圖所示。預覽介面排序：選中表頭後拖拽，可以行動該欄位置；按表頭儲存格可以對該欄進行排序。如下圖所示。查看資料型別：將資料列拉寬可以看到欄位型別
D：定義資料連結	進入【資料連結】配置頁面，方便修改對應的資料庫連結資訊。
E：開啓全部資料快取 F：關閉全部資料快取	對於報表執行速度而言，資料源取數效能是存在較大影響的一環。如果對於資料的實時性要求不高能接受半小時左右的更新頻率，使用快取是一種既能降低伺服器和資料庫壓力，又能提升報表執行速度的方案。詳細請參見：抽數快取介紹
G：搜索	點選【搜尋】，使用者可以輸入關鍵字後【回車】，可匹配尋找【範本資料集】【伺服器資料集】和【資料欄名稱】，如下圖所示。注：若資料集報錯，則該資料集的資料列與其資料集名稱均不參與檢索。
H：複制 I：貼補	選中目標【資料集】或【欄位名】，右擊選擇【複制】鍵，然後在需要貼補的地方右擊選擇【貼補】鍵。支援在同一個範本下複制貼補資料集支援跨範本複制貼補資料集注：聯動資料集、樹資料集這類資料集在複製貼補時，需要先把用到的依賴資料集先複製貼補到目標位置，然後再複製貼補聯動資料集、樹資料集才可以成功。支援範本塊級複用，當使用者複制了圖表或元件等時，這些圖儲存格件使用的資料集也會被一同複制過來。
批量選擇資料集	支援 ctrl 與 shift 鍵多選資料集進行批量管理

4. 功能變動

4.1 11.0.7 及之後版本

資料表搜尋框位置行動到上方，使用者可在該搜尋框中搜尋資料表。如下圖所示：

5. 索引

序號	内容	簡介	文檔教程
1	資料庫查詢	對資料源中的資料庫表，直接使用 SQL 語句，來選擇所需要的資料欄位。	資料庫查詢
2	內建資料集	建立一個類似資料庫表的原表，可作為範本的資料源來設計報表。	內建資料集
3	檔案資料集	是指以 TXT 文字檔案、Excel 檔案和 XML 檔案中的資料為資料集，並以二維表的結構展示在資料集當中。	檔案資料集
	3.1	文字資料集：就是指資料源是一系列的 TXT 文字檔案。	文字資料集
	3.2	Excel 資料集：就是指資料源是一系列的 XLS 檔案。	Excel 資料集
	3.3	遠端 Excel 資料集：透過 URL 方式訪問 JSP 頁面，將對應的 Excel 檔案作為資料集。	遠端 Excel 資料集
	3.4	XML 資料集：就是指資料源是一系列的 XML 檔案。	XML 資料集
4	SAP 資料集	先建立一個 SAP 資料連結，透過該資料連結建立 SAP 資料集。	SAP資料集
	4.1	自訂取數：就是直接呼叫 ABAP Function 獲取資料。	自訂取數
	4.2	簡單通用查詢取數：透過 open SQL 語句，從某張表中讀取出某些欄，並列出資料需要滿足的一些條件。	簡單通用查詢取數
	4.3	通用查詢取數：通用查詢較之簡單通用查詢，增加了表間聯動的能力，支援多表查詢。	通用查詢取數
	4.4	通用查詢取數中的函式：對 EXTRACT_TABLE_DATA 的建立過程及出現的問題解決進行詳細說明。	通用查詢取數中的函式
5	儲存過程	儲存過程，就是直接將儲存過程作為資料集，不需要在資料庫查詢而是去呼叫儲存過程。	儲存過程
6	多維資料庫	在XMLA 資料連結的基礎上，建立多維資料庫 XMLA 資料集。	多維資料庫
	6.1	簡單通用查詢：指 FineReport 透過 XMLA 連結上多維資料庫之後，直接展示多維 CUBE 結構。	簡單通用查詢
	6.2	自訂 MDX 查詢：指使用者直接在 MDX 語句輸入框中輸入 MDX 查詢語句，FineReport 再透過該語句去多維資料庫取數。	自訂MDX查詢
7	聯動資料集	在不同的資料源進行篩選取數；訪問不同的資料庫；利用來自不同的資料源形成一個資料集。	聯動資料集
8	樹資料集	為元件綁定樹資料集， Web 端查看時就會自動生成樹形層級結構。	樹資料集