匯出中心

1.1 版本

1.2 應用場景

使用者對於匯出資源管理和匯出前端體驗有一些客製化需求。

• 針對匯出檔案，在匯出程式中，增加檢驗碼認證功能，保障資料安全

• 針對匯出的excel檔案，進行檔案安全加固，為檔案自身的安全性要求，提供瞭解決方案

• 針對匯出檔案，提供檔案中心功能，對匯出檔案進行統一管理，支援檔案匯出到FTP伺服器；增加匯出佇列功能，防止大數據量匯出時，可能導致的前端頁面卡住和系統當機等問題

• 可自訂匯出檔案格式，如限制使用者只可匯出帶有水印的Excel檔案，提升安全性

1.3 功能描述

「匯出中心」插件提供四種功能：

1.4 使用前提

「匯出中心」插件不支援在以下情況下使用：

• 不支援決策報表匯出

• 不支援行式引擎、新計算引擎匯出

• 當前僅支援標準的word、excel、pdf和圖片匯出方式

2.1 插件安裝

點選下載插件：匯出中心插件

伺服器安裝插件方法請參見：伺服器插件管理。

設計器安裝插件方法請參見：設計器插件管理。

2.2 新增匯出中心按鈕

插件安裝後，使用者可在範本工具欄中增加「匯出中心」按鈕。

2.2.1 單張範本

對於單張範本，在「設計器>範本>範本Web屬性」中，選擇該範本的預覽頁面設定，選擇「為該範本單獨設定」。

勾選「使用工具欄」，雙擊「匯出中心」，即可將「匯出中心」按鈕新增到該範本的工具欄中。如下圖所示：

此處也可以自訂匯出檔案格式，在伺服器設定的情況下，選擇某種檔案格式，新增到工具欄。這樣使用者只能匯出該類型的檔案

此時預覽該範本，工具欄中會出現「匯出中心」的按鈕選項。使用者可透過該按鈕進行匯出行為，相關匯出行為會被匯出中心進行記錄/判斷。

2.2.2 全局配置

該設定也可對全部範本生效，管理者只需在「伺服器>伺服器設定」中，在對應預覽設定下，編輯工具欄，雙擊新增「匯出中心」按鈕即可。

2.3 配置匯出中心屬性

插件安裝後，使用者可在自訂配置「匯出中心」相關屬性。

未配置匯出中心屬性時，2.2節的「匯出中心」按鈕，與普通匯出按鈕沒有差別。

配置了匯出中心屬性後，若使用2.2節的「匯出中心」按鈕進行匯出操作，則會觸發相關配置，進行檢驗碼驗證、匯出檔案保護等。

2.3.1 單張範本

對於單張範本，在「設計器>範本>匯出中心」中，可為該範本單獨設定相關屬性。如下圖所示：

2.3.2 全局配置

管理者也可對系統中所有範本配置匯出中心屬性。

管理者登入數據決策系統，點選「管理系統>匯出中心>配置中心」，即可進行相關配置。如下圖所示：

若使用「匯出中心」按鈕進行匯出操作，則會觸發此處的相關配置，進行檢驗碼驗證、匯出檔案保護等。

在使用「匯出中心」按鈕進行匯出時，可以透過使用者信箱和簡訊，進行檢驗碼認證，確定是本人執行相關操作，以防盜用帳號進行匯出。

本章範例：進行配置，在使用者eoco使用「匯出中心」按鈕匯出範本「GettingStartedTW.cpt」時，可使用信箱/手機簡訊收取檢驗碼，輸入正確的檢驗碼之後，方可進行匯出。

3.1 範本設定

如需使用匯出認證功能，必須確定範本工具欄中有「匯出中心」按鈕，且匯出中心開啟了「檢驗碼認證」設定。

3.1.1 新增匯出中心按鈕

開啟範本「GettingStarted.cpt」，點選「範本>範本Web屬性>分頁預覽設定」，選擇「為該範本單獨設定」。

勾選「使用工具欄」，雙擊「匯出中心」，即可將「匯出中心」按鈕新增到該範本的工具欄中。如下圖所示：

3.1.2 設定匯出認證

開啟範本「GettingStartedTW.cpt」，點選「範本>匯出中心>匯出認證」，勾選「檢驗碼認證」，勾選認證方式，可選「簡訊通知」和「郵件通知」。如下圖所示：

3.2 數據決策系統設定

如需使用檢驗碼認證，則必須保證：

1）如需使用簡訊通知，則必須系統配置了簡訊寄件人，進行匯出的使用者配置了手機號碼。

2）如需使用郵件通知，則必須系統配置了郵件寄件人，進行匯出的使用者配置了信箱。

3.2.1 簡訊

1）簡訊寄件人

發簡訊，需要有一個發信人，否則傳送動作無法完成。每個數據決策系統的發信人是唯一的，只需要設定一次即可。

管理者登入數據決策系統，點選「管理系統>系統管理>簡訊」，開啟「使用簡訊平台」，使用一個開通了「簡訊服務」的「帆軟通行證」賬戶登入。如下圖所示：

注1：綁定的帆軟通訊證需要開啟簡訊服務，且充值一些賬戶餘額，否則無法成功傳送簡訊，具體請參見：簡訊

注2：配置完成後，請點選「傳送測試訊息」，確定該手機號碼可使用。

2）簡訊收件人

發簡訊，需要有一個收件人，否則簡訊無法傳送給任何人。

因此進行匯出操作的使用者，在數據決策系統中的使用者資訊，若未綁定手機，則簡訊無法成功傳送。

3.2.2 信箱

1）信箱寄件人

發郵件，需要有一個寄件人，否則傳送動作無法完成。

管理者登入數據決策系統，點選「管理系統>系統管理>信箱」，配置寄件人賬戶，點選「儲存」，如下圖所示：

設定排程管理任務時，寄件人處預設選擇「系統預設寄件人」，可下拉選擇其他寄件人。

注1：寄件人信箱類型不同，配置步驟可能不完全相同，具體請參見：郵箱。

注2：配置完成後，請點選「傳送測試郵件」，確定信箱可使用。

2）信箱收件人

發郵件，需要有一個收件人，否則郵件無法傳送給任何人。

因此進行匯出操作的使用者，在數據決策系統中的使用者資訊，若未綁定信箱，則郵件無法成功傳送。

3.3 效果預覽

由於檢驗碼認證需要傳送檢驗碼給使用者的信箱和簡訊，則必須保證：使用者對範本進行匯出操作時，登入了數據決策系統。

eoco（eoco，123456）登入數據決策系統，存取掛載到目錄中的「GettingStartedTW.cpt」範本。

使用「匯出中心」按鈕進行任意一種匯出格式，跳出彈窗提示輸入檢驗碼。

此時信箱/手機會收到數據決策系統傳送的隨機檢驗碼，輸入之後點選「確定」，即可觸發下載。如下圖所示：

收到的檢驗碼郵件和簡訊如下圖所示：

• 郵件：

• 簡訊：

為了防止使用者隨意分發和惡意編輯，對於匯出後的Excel檔案，支援檔案開啟密碼限制、編輯儲存格密碼保護、檔案水印保護。

本章範例：進行配置，使用者eoco匯出範本「GettingStartedTW.cpt」的Excel格式檔案後：透過信箱獲取開啟檔案的隨機密碼；編輯儲存格時需要輸入預設密碼；Excel檔案中存在水印。

4.1 範本設定

如需使用匯出認證功能，必須確定範本工具欄中有「匯出中心」按鈕，且匯出中心開啟了「安全設定」配置。

如需使用「Excel儲存格編輯保護」，需要選擇需要被保護的儲存格。

如需使用「Excel匯出水印」，需要設定範本水印。

4.1.1 新增匯出中心按鈕

開啟範本「GettingStarted.cpt」，點選「範本>範本Web屬性>分頁預覽設定」，選擇「為該範本單獨設定」。

勾選「使用工具欄」，雙擊「匯出中心」，即可將「匯出中心」按鈕新增到該範本的工具欄中。如下圖所示：

4.1.2 設定安全設定

開啟範本「GettingStarted.cpt」，點選「範本>匯出中心>安全設定」，勾選「啟用Excel匯出增強」。

勾選需要開啟的保護機制，包括「Excel2007檔案保護」、「Excel儲存格編輯保護」和「Excel匯出水印」。如下圖所示：

4.1.3 選擇編輯保護生效儲存格

如需使用「Excel儲存格編輯保護」，需要選擇需要被保護的儲存格。

對於範本的銷售總額總計（D5儲存格），需要限制編輯。因此選中D5儲存格，點選「Excel儲存格編輯保護」，勾選「啟用」。如下圖所示：

開啟儲存格保護之後，範本中未灰化的儲存格預設使用保護樣式，不可編輯

4.1.4 設定範本水印

如需使用「Excel匯出水印」，需要設定範本水印。

開啟範本「GettingStartedTW.cpt」，點選「範本>水印」，選擇「為該範本單獨設定」。

設定水印內容為$fine_username + now()，點選「確定」，如下圖所示：

4.2 數據決策系統設定

如需使用「Excel2007檔案保護」，則必須保證：系統配置了郵件寄件人，進行匯出的使用者配置了信箱，用於接收檔案開啟所需的隨機密碼。

1）信箱寄件人

發郵件，需要有一個寄件人，否則傳送動作無法完成。

管理者登入數據決策系統，點選「管理系統>系統管理>信箱」，配置寄件人賬戶，點選「儲存」，如下圖所示：

設定排程管理任務時，寄件人處預設選擇「系統預設寄件人」，可下拉選擇其他寄件人。

注1：寄件人信箱類型不同，配置步驟可能不完全相同，具體請參見：郵箱。

注2：配置完成後，請點選「傳送測試郵件」，確定信箱可使用。

2）信箱收件人

發郵件，需要有一個收件人，否則郵件無法傳送給任何人。

因此進行匯出操作的使用者，在數據決策系統中的使用者資訊，若未綁定信箱，則郵件無法成功傳送。

4.3 效果預覽

由於檢驗碼認證需要傳送檢驗碼給使用者的信箱和簡訊，則必須保證：使用者對範本進行匯出操作時，登入了數據決策系統。

eoco（eoco，123456）登入數據決策系統，存取掛載到目錄中的「GettingStartedTW.cpt」範本。使用「匯出中心」按鈕進行excel格式匯出。如下圖所示：

匯出之後，數據決策系統會即刻透過信箱傳送檔案隨機密碼，如下圖所示：

開啟匯出的excel檔案時，會彈出密碼輸入框，填寫郵件接收的密碼，即可開啟檔案。如下圖所示：

Excel檔案中可以看到設定的水印。如下圖所示：

當試圖對總計儲存格進行編輯時，彈出提示：

一般情況下，使用者進行匯出操作後，匯出的檔案直接儲存到瀏覽器使用者端。

但是大檔案匯出慢，容易有當機風險的問題，使用者可以將檔案匯出到檔案中心，儲存在伺服器端。

1）後台匯出的形式，確定關閉前端頁面也不會有影響，匯出完成會有郵件提醒。

2）限制匯出併發，增加佇列匯出功能，能有效防止匯出併發過多導致當機的風險。

3）匯出檔案管理，支援檔案批量刪除、下載，檔案名稱查詢，展示檔案的檔案類型，檔案大小等資訊。

4）佇列監視管理，管理者可查看當前系統中待匯出的檔案資訊。

5.1 儲存設定

5.1.1 配置儲存設定

對於需要儲存到檔案中心的範本，需要開啟「儲存到檔案中心」的設定。

開啟範本「GettingStartedTW.cpt」，點選「範本>匯出中心>匯出認證」，勾選「儲存到匯出中心」，勾選通知方式，可選「簡訊通知」和「郵件通知」。如下圖所示：

5.1.2 使用前提

注意事項1：

由於匯出結束後需要傳送通知給使用者的信箱/手機，則必須保證：

1）如需使用簡訊通知，則必須系統配置了簡訊寄件人，進行匯出的使用者配置了手機號碼。

2）如需使用郵件通知，則必須系統配置了郵件寄件人，進行匯出的使用者配置了信箱。

請參考本文3.2節進行配置。

注意事項2：

由於匯出結束後檔案存放在數據決策系統伺服器中，需要依靠帳號方可查詢本人匯出的檔案。

則必須保證：使用者對範本進行匯出操作時，登入了數據決策系統。

5.1.3 導出結束通知

當檔案匯出結束後。

1）範本預覽頁彈窗提示：

點選可跳轉到檔案中心，查看已匯出檔案列表。

2）郵件通知：

點選可跳轉到檔案中心，查看已匯出檔案列表。

3）簡訊通知：

簡訊通知檔案匯出成功。使用者可在瀏覽器端存取檔案中心。

5.2 檔案中心使用

上一節介紹了檔案可以匯出到檔案中心，在檔案中心的管理頁面，可查看使用者設定儲存到匯出中心的全部檔案，並且支援檔案的批量下載、刪除。

檔案中心入口：決策平台右上方位置，如下圖所示：

檔案中心地址格式：http://ip:埠/工程名/decision/exportcenter/filecenter/main，頁面如下圖所示：

支援功能點：

• 根據檔案名稱（檔案類型）、匯出時間、檔案大小查詢對應的檔案。預設查詢條件為當前時間往前7天匯出的全部檔案

• 單檔案下載和刪除，點選每個檔案後的下載和刪除選項，即可實現對應功能

• 批量下載和刪除，先勾選需要進行操作的檔案，再點選工具欄的刪除和批量下載即可

• 可查看匯出失敗檔案的資訊

5.3 檔案中心管理

5.3.1 檔案中心設定

在系統管理—標準中，可自行進行匯出中心的檔案中心地址配置，目前有以下2種情況

• 檔案中心地址為域名連結，則此處配置為域名格式；因為匯出中心預設獲取的是IP地址

• 檔案中心地址為https連結，則此處配置為https格式；因為https在負載均衡上進行配置，但後端伺服器收到的仍然是http請求，所以匯出中心預設獲取的仍是http連結

5.3.2 檔案中心配置

除上一節提到的在檔案中心中，使用者可對自己匯出的檔案進行統一管理外。檔案中心本身還有很多其他配置項，管理者可以進行全局配置。

管理者登入數據決策系統。點選「管理系統>匯出中心>配置中心>檔案中心配置」，可進行如下設定：

配置項	說明
並行任務數配置	針對匯出檔案，可限制同時匯出的任務數量，多餘任務需要佇列等待匯出執行
檔案清除配置	針對匯出檔案，可設定定期自動清除，也可手動清除
檔案儲存倉庫配置	檔案匯出儲存到匯出中心時，後台會儲存檔案的基本資訊和實際的檔案。 檔案的基礎資訊儲存在finedb的fine_plugin_exportCenter_File表中 檔案預設儲存在報表工程的WEB-INF/filcenter目錄下； 同時支援儲存到FTP伺服器

5.3.2 佇列監視

針對多檔案匯出的場景，當匯出任務數超過設定的並行限制數時，存在部分匯出佇列情況。

管理者登入數據決策系統。點選「管理系統>匯出中心>佇列監視」，可查看匯出進度，如下圖所示：

6.1 URL直接匯出

對於不透過數據決策系統目錄查看匯出的情況，匯出中心也支援透過URL直接匯出，採用的是預設URL功能，可參考：URL直接導出報表

使用前提：

如需使用URL直接匯出，則該範本不可開啟「匯出認證」、「安全設定>Excel檔案保護」、「檔案中心」相關功能。

僅可開啟「安全設定>Excel儲存格編輯保護」和「安全設定>Excel匯出水印」設定。

使用說明：

匯出中心的format參數的固定值為export_center，使用exportType參數區分匯出類型。

所以直接匯出地址為：

http://ip:port/webroot/decision/view/report?op=export&viewlet=範本路徑&format=export_center&exportType=匯出類型

各種匯出方式對應的exportType參數值如下表所示：

6.2 導出日誌

透過「匯出中心」按鈕進行的匯出操作行為，均記錄在finedb的指定表中。

1）exportCenter_record 記錄使用匯出中心匯出的資料

2）exportCenter_manager_record  記錄針對檔案中心的操作