1.概述
1.1 版本
| 報表服務器版本 | JAR 包 |
|---|---|
| 10.0.12 | 2020-12-28 |
1.2 應用場景
大部分系統生成的 Log 文件都是文本文件，例如網站的浏覽訪問量，每個頁面的停留時間等等。
那麽報表系統對文本文件的分析就必不可少。用戶可以通過服務器數據集導入文本文件作爲數據源。
1.3 功能簡介
文本數據集，就是指數據源是一系列的 TXT 文本文件。
管理員可以将這些文件作爲數據來源，用 FineReport 來呈現這些數據，并做相應的數據分析。
2. 準備文本文件
TXT 文件的内容由「文本」和「分隔符」構成。
支持的文本編碼類型有：GBK、BIG5、ISO-8859-1、UTF-8、UTF-16、EUC_JP、EUC_KR、CP850。默認爲空。
支持的文本分隔符有：制表符、空格、逗号、其他自定義分隔符。默認爲空格。
例如：準備的文本文件如下，編碼格式爲無，分隔符爲逗号。
Name,Capital,Continent,Area,Population Argentina,Buenos Aires,South America,2777815.00,32300003.00 Bolivia,La Paz,South America,1098575.00,7300000.00 Brazil,Brasilia,South America,8511196.00,150400000.00 Canada,Ottawa,North America,9976147.00,26500000.00 Chile,Santiago,South America,756943.00,13200000.00 Colombia,Bagota,South America,1138907.00,33000000.00 Cuba,Havana,North America,114524.00,10600000.00 Ecuador,Quito,South America,455502.00,10600000.00 El Salvador,San Salvador,North America,20865.00,5300000.00 Guyana,Georgetown,South America,214969.00,800000.00 Jamaica,Kingston,North America,11424.00,2500000.00 Mexico,Mexico City,North America,1967180.00,88600000.00 Nicaragua,Managua,North America,139000.00,3900000.00 Paraguay,Asuncion,South America,406576.00,4660000.00 Peru,Lima,South America,1285215.00,21600000.00 United States of America,Washington,North America,9363130.00,249200000.00 Uruguay,Montevideo,South America,176140.00,3002000.00 Venezuela,Caracas,South America,912047.00,19700000.00
3. 添加權限
超級管理員默認可從數據決策系統添加服務器數據集。普通用戶如需添加，需要超管授予權限。
超級管理員登錄數據決策系統，點擊「管理系統>權限管理>全局設置」，打開「分級授權」和「數據連接控制」，點擊「保存」。如下圖所示：
超級管理員登錄數據決策系統，點擊「管理系統>權限管理>權限配置」，選擇權限載體「部門/角色/用戶」，選擇具體項，打開「管理系統>數據連接>查看權限」。如下圖所示：
4. 調用文本文件
服務器數據集支持三種方法調用文本文件，用戶可根據自身情況進行選擇。
1）服務器文件：文本文件存儲在報表工程的%FR_HOME%\webroot\WEB-INF\reportlets目錄下。
2）本地文件：文本文件存儲在用戶電腦上，調用後自動存儲至報表工程的%FR_HOME%\webroot\WEB-INF\reportlets\txt目錄下。
3）遠程 URL 文件：文本文件存儲在某個服務器端，調用該文件的訪問 URL 即可。
4.1 服務器文件
将第 2 章準備的文本文件上傳至報表工程的%FR_HOME%\webroot\WEB-INF\reportlets目錄下。如下圖所示：
擁有權限的用戶登錄報表工程，點擊「管理系統>數據連接>服務器數據集」，選擇「創建數據集>文件數據集」，如下圖所示：
1）設置數據集名稱，名稱不可爲空，不可與已有數據集重複。
2）選擇文件類型爲 TXT。
3）文件來源選擇「服務器文件」，選擇 reportlets 目錄下的文本文件。
4.2 本地文件
本地文件上傳前，需要關閉「管理系統>安全管理>安全防護>文件上傳校驗」，否則上傳按鈕灰化。如下圖所示：
擁有權限的用戶登錄報表工程，點擊「管理系統>數據連接>服務器數據集」，選擇「創建數據集>文件數據集」，如下圖所示：
1）設置數據集名稱，名稱不可爲空，不可與已有數據集重複。
2）選擇文件類型爲 TXT。
3）文件來源選擇「本地文件」，選擇本地電腦準備好的文本文件。上傳成功後跳出提示框：TXT上傳成功！
已上傳的文件自動存儲至報表工程的%FR_HOME%\webroot\WEB-INF\reportlets\txt目錄下。如下圖所示：
注：若該目錄下存在同名文件，則無法成功上傳。
4.3 遠程 URL 文件
将文本文件存儲在某個服務器下，獲得該文件的訪問 URL。
注：請确保報表工程可成功訪問該文件，否則将調用失敗。
擁有權限的用戶登錄報表工程，點擊「管理系統>數據連接>服務器數據集」，選擇「創建數據集>文件數據集」，如下圖所示：
1）設置數據集名稱，名稱不可爲空，不可與已有數據集重複。
2）選擇文件類型爲 TXT。
3）文件來源選擇「URL」，輸入 URL 地址，點擊「測試連接」。連接成功後跳出提示框：連接成功！
5. 數據集設置
1）用戶可自定義設置數據集函數。
2）用戶可選擇文本的編碼類型。
3）用戶可選擇調用的文本文件第一行是否包含标題。
4）用戶可選擇文本文件的分隔符。
5）若存在連續分隔符，用戶可選擇将連續分隔符視爲單個處理。
點擊保存，即保存服務器數據集。
