1. 概述
1.1 版本
報表伺服器版本 | 功能變更 |
---|---|
11.0 | - |
1.2 應用場景
報表伺服器開啟後,無需開啟範本,也無需查看報表,在瀏覽器地址欄鍵入報表存取地址+匯出參數+匯出格式,即可將報表匯出為其他格式的檔案。
如下圖範例,將一個複選框查詢範本的兩個參數內容匯出為 Excel 檔案。
1.3 實現思路
URL 後加匯出參數的方式:&參數名=xxx,範本沒有參數可以不寫
URL 後加匯出格式的方式:&format=匯出格式
URL 直接匯出的檔案名稱預設為報表名稱,如需重新命名請參見: 导出重命名
2. 匯出格式寫法
2.1 匯出格式對照表
各種匯出格式對應的寫法如下表所示:
匯出檔案格式 | 分類 | 參數值 |
---|---|---|
PDF檔案 | &format=pdf | |
Excel檔案 | 分頁匯出 xlsx 格式 | &format=excel |
原樣匯出 xlsx 格式 | &format=excel&extype=simple | |
分頁分 Sheet 匯出 xlsx格式 | &format=excel&extype=sheet | |
分頁匯出 xls 格式 | &format=excel&extype=page&isExcel2003=true | |
原樣匯出 xls 格式 | &format=excel&extype=simple&isExcel2003=true | |
分頁分 Sheet 匯出 xls 格式 | &format=excel&extype=sheet&isExcel2003=true | |
Word檔案 | &format=word | |
圖片 | JPG 格式 | &format=image&extype=JPG |
PNG 格式 | &format=image&extype=PNG | |
GIF 格式 | &format=image&extype=GIF | |
BMP 格式 | &format=image&extype=BMP | |
TXT檔案 | &format=text 注:圖片斜線等無法匯出 | |
SVG檔案 | &format=svg | |
CSV檔案 | &format=csv |
2.2 注意事項
1)2016-10-10 之前的 JAR 包,匯出的 Excel 格式預設為 xls 。
2)多 Sheet 報表匯出指定 Sheet 時,參數值為 :&sheets=[sheet序號],Sheet 序號從 0 開始,匯出多個 sheet 時序號以逗號分隔。如匯出 sheet1:&format=excel&sheets=[0],匯出 sheet1 和 sheet2:&format=excel&sheets=[0,1]。
3)多 Sheet 報表匯出指定 Sheet 時,如果 Sheet 的序號大於等於 10 則需要:&sheets=[10,],或者:&sheets='+encodeURIComponent("[10]") ; 再編碼一次。
4)參數面板的按鈕中新增 JS 獲取到當前報表 sessionid 的值,並連接 URL 匯出 Excel 時,若要求可以匯出頁面上修改的元件值以及參數面板中元件傳給儲存格的值,匯出參數要用 op=export&format=excel 而非 &format=excel。
5)URL匯出時,匯出的範本可能不自適應。詳情請參見:匯出後不自適應
6)不支援行動端
3. 參數查詢後按鈕匯出
此處為場景延伸,希望報表參數查詢後可以透過按鈕匯出範本。方法如下:
1)開啟設計器內建範本: %FR_HOME%\webroot\WEB-INF\reportlets\GettingStartedTW.cpt
2)在參數面板新增一個按鈕,按鈕名稱為「匯出」。
3)新增一個「點選」事件,實現點選按鈕後匯出成 Excel 。
設定參數aaa,值為公式sessionID
設定JavaScript 程式碼如下:
儲存範本並預覽,查詢後點選匯出按鈕即可匯出成 Excel 。