自訂匯出檔案名

1.1 版本說明

1.2 應用場景

注1：目前只支援 .cpt 報表。

注2：不支援新計算引擎。

範本匯出為檔案時，檔案名預設為範本的名稱，使用者想要自訂匯出檔案名，一般都要借助 JavaScript 代碼實現。

但是一方面 JavaScript 有一定的門檻，另一方面維護起來也比較複雜。

針對上述問題，11.0 版本新增匯出事件，可以在選擇匯出檔案類型的同時，自訂檔案名稱，無需再借助 JavaScript 代碼。

1.3 功能入口

目前只支援 .cpt 報表，在 .cpt 報表中元件事件新增一種型別：「匯出事件」，如下圖所示：

該事件可以同時實現：檔案匯出+自訂檔案名。

2.1 匯出設定

• 匯出範本：預設是匯出當前範本，也可以選擇匯出其他範本，選擇其他範本時，需要在報表工程目錄下選擇，且只能選擇普通報表。

• 匯出方式：可以選擇 PDF 匯出、Excel 匯出、Word 匯出、圖片匯出。

• 匯出檔案名：選擇預設，檔案名就是範本名稱，選擇自訂，支援使用公式和字串來定義檔案名，公式就是編輯方塊前面有等於號，字串把前面等於號去掉即可。

注1：自訂匯出檔案名稱時，不支援使用 \ / : * ? " | 等各種特殊字元，不支援使用空格，如使用將自動更換為底線。

注2：自訂匯出檔案名稱時，如使用公式，不支援呼叫儲存格，不支援使用層次座標函式。

2.2 參數

預設勾選「繼承報表的參數」，此時將按照當前 session 參數匯出，也就是在未點選查詢的情況下，將使用當前參數面板選擇的參數進行匯出。

取消勾選「繼承報表的參數」，使用者可以自訂參數。

3.1 設計範本

開啟設計器內建範本：%FR_HOME%\webapps\webroot\WEB-INF\reportlets\GettingStartedTW.cpt

3.2 新增事件

參數面板拖個按鈕元件進來，重命名為「匯出範本」，給按鈕新增一個「點選」事件，型別選擇「匯出事件」。

匯出方式選擇「Excel輸出(原樣匯出)」，匯出檔案用公式來自訂：=$地區+"地區銷售概況"，如下圖所示：

3.3 效果預覽

保存報表，分頁預覽後，匯出檔案的效果如 1.2 節中所示。

不支援 App 端和 HTML5 端預覽。

點選下載範本：自訂匯出檔案名稱.cpt