［平台］正文资料集

1.1 版本

1.2 應用場景

大部分系統生成的 Log 檔案都是正文檔案，例如網站的瀏覽存取量，每個頁面的停留時間等等。

那麼報表系統對正文檔案的分析就必不可少。使用者可以透過伺服器資料集匯入正文檔案作為資料源。

1.3 功能簡介

正文資料集，就是指資料源是一系列的 TXT 正文檔案。

管理者可以將這些檔案作為資料來源，用 FineReport 來呈現這些資料，並做相應的資料分析。

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

超級管理者預設可從數據決策系統新增伺服器資料集。普通使用者如需新增，需要超管授予權限。

超級管理者登入數據決策系統，點選「管理系統>權限管理>全局設定」，開啟「分級授權」和「資料連結控制」，點選「儲存」。如下圖所示：

超級管理者登入數據決策系統，點選「管理系統>權限管理>權限配置」，選擇權限載體「部門/角色/使用者」，選擇具體項，開啟「管理系統>資料連結>查看權限」。如下圖所示：

伺服器資料集支援三種方法呼叫正文檔案，使用者可根據自身情況進行選擇。

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 位址，點選「測試連結」。連結成功後跳出提示框：連結成功！

注：URL位址中若包含中文，必須先進行 URL轉碼 ，在平台填寫轉碼後的路徑，方可正常存取。

1）使用者可自訂設定資料集函式。

2）使用者可選擇正文的編碼型別。

3）使用者可選擇呼叫的正文檔案第一行是否包含標題。

4）使用者可選擇正文檔案的分隔符。

5）若存在連續分隔符，使用者可選擇將連續分隔符視為單個處理。

點選儲存，即儲存伺服器資料集。

6.1 本地檔案上傳失敗

問題描述：

本地檔案上傳失敗，提示：XXX檔案已經存在，但此時系統「伺服器資料集>檔案資料集」中未使用該檔案。如下圖所示：

原因分析：

使用者曾經使用本地檔案的方法呼叫過同名檔案。

本地檔案在呼叫後會自動儲存至 BI 工程，並且在「管理系統>伺服器資料集」頁面中刪除該檔案資料集時，不會刪除 BI 工程下的該檔案。

因此，再次上傳時，會因為同名檔案的存在而導致上傳失敗。

解決方案：

前往 BI 工程%BI_HOME%\webroot\WEB-INF\reportlets\txt資料夾下找到原同名檔案，刪除/重命名原同名檔案後，重新上傳檔案即可。