上傳下載檔案插件

1.1 應用場景

有時候使用者需要將檔案上傳到伺服器或者FTP進行儲存，並且可以提供檔案下載。以前 FineReport 實現此功能需要自訂函式實現，但代碼實現會比較麻煩。該插件將此功能封裝，安裝後可以透過視覺化介面操作，方便快捷。

1.2 功能限制

• 請確定您的工程可以支援遠端設計，不然插件可能無法正常使用

• 同一檔案元件上傳多個檔案時，不支援自訂檔案名稱，會重疊顯示

• 上傳和下載的路徑不支援網路路徑
  

• 檔案下載重命名功能不支援讀取擴展儲存格值

• 檔案下載路徑不支援動態計算公式

• 檔案下載不支援「決策報表」

• 不支援刪除檔案

• 除了FTP外，不支援其他型別的遠端伺服器上傳和下載檔案

• 不支援叢集環境

• 行動端只支援上傳圖片型別的檔案，不支援上傳其他檔案和下載功能

• 容器化環境上傳檔案給主機，需要做容器和主機之間的上傳路徑檔案映射

• 出於安全考慮，需要登入決策平台帳號後才可以下載檔案

• 不支援在範本 Web 屬性中設定檔案上傳事件

注：如果實際場景受到以上功能限制影響，可以考慮使用悅享版檔案上傳下載插件解決，其功能和改寫的場景更多。

2.1 插件安裝

插件下載請點選：上傳下載檔案插件

伺服器-設計器插件安裝方法請參見：伺服器-設計器插件管理

2.2 插件功能

2.2.1 上傳至伺服器

選擇提交型別為【上傳至伺服器】，此方式適用於單機工程。

【同名檔案改寫】預設不勾選，同名檔案重新命名，勾選後，同名檔案只保留後上傳的檔案。

點選【 】按鈕，新增伺服器設定，可自訂伺服器的磁碟路徑、檔案和檔名。

選中一條伺服器設定，點選【X】按鈕，可刪除當前設定。

2.2.2 上傳至 FTP

選擇提交型別為【上傳至FTP】，此方式適用於單機和叢集工程。

【同名檔案改寫】預設不勾選，同名檔案重新命名，勾選後，同名檔案只保留後上傳的檔案。

點選【FTP設定】，新增一個 FTP 遠端。

點選【 】按鈕，新增FTP設定，可自訂FTP的上傳路徑、檔案、檔名和FTP地點。

選中一條FTP設定，點選【X】按鈕，可刪除當前設定。

2.2.3 檔案下載

點選【超連結】→【檔案下載】，進入檔案下載設定介面。

2.3 設定項格式

注1：檔案名稱如果為空，會預設獲取上傳的檔案名稱，支援多檔案上傳。如果不為空，則不支援多檔案上傳，檔案名稱會重疊。

注2：下載重命名功能不支援讀取擴展儲存格值。檔案下載路徑不支援動態計算公式。

3.1 報表設計

1）在FineReport設計器中點選「檔案>建立普通報表」。

2）選中A1儲存格，為 A1 儲存格新增「檔案元件」，檔案型別選擇「全部檔案」。如下圖所示：

3.2 上傳至伺服器

1）菜單欄點選「範本>報表填報屬性」，新增「自訂提交」，提交型別選擇「上傳至伺服器」，根據實際情況輸入磁碟路徑、檔案、檔案名稱。如下圖所示：

具體設定項說明如下表所示：

設定項	本次範例	說明
磁碟路徑	"C:/Users/Leo.Tsai/Desktop/Document/"	檔案儲存位置，請勿丟棄雙引號
檔案	A1	檔案元件所在儲存格編號
檔案名稱	空	選填 如果為空，會預設獲取上傳的檔案名稱，支援多檔案上傳。 如果不為空，可以自訂或者使用公式生成檔案名稱，但不支援多檔案上傳，檔案名稱會重疊。

2）儲存報表，點選「填報預覽」，上傳檔案點選提交，查看檔案儲存位置即可看到剛上傳的檔案。

3.3 上傳至 FTP

1）菜單欄點選「範本>報表填報屬性」，新增「自訂提交」，提交型別選擇「上傳至FTP」，點選「FTP設定」，彈出「FTP設定頁」。

2）點選「FTP設定頁」左上角新增按鈕，建立一個 FTP 連結，使用者需根據實際場景填寫連結資訊。帳號和密碼如沒有可以不設定，如下圖所示：

注：該配置為伺服器級別配置，儲存位置為finedb，因此遠端環境下直接複制範本無法繼承ftp配置，需要使用遠端設計功能。

3）設定檔案資訊，如下圖所示：

各設定項說明如下表所示：

4）儲存報表，點選「填報預覽」，上傳檔案並提交，查看檔案儲存位置即可看到剛上傳的檔案。

3.4 下載檔案

1）A2 儲存格插入公式=filename(A1)，表示獲取 A1 儲存格上傳的檔案名稱。除了使用公式外，也可以使用資料集欄位，手寫檔案名稱等方式來設定。

2）選中A2儲存格，右邊屬性面板新增一個「檔案下載」型別的「超級連結」，具體設定如下：

4）儲存報表，點選「填報預覽」，點選下載超連結，即可下載檔案。

點選下載範本：上傳下載檔案.cpt