決策報表導出插件

1.1 版本

1.2 應用場景

用戶有時需要将決策報表以其他形式導出進行預覽時，可下載安裝「決策報表導出插件」進行實現。

1.3 功能簡介

「決策報表導出插件」支持将決策報表整體導出爲 Excel、PDF 、Word 格式。

注：如需導出決策報表爲 PPT、image 格式，請參見 決策報表導出 Plus 插件 。

不支持的功能項如下：

1）JAR 包爲 2018-12-27 及之後版本，需要将插件升級爲 3.0 及以上版本，否則無法導出。

2）不支持導出控件的值；不支持導出按鈕控件。

3）不支持導出 body 背景色；不支持導出組件自定義邊框。

4）不支持決策報表存在重疊的圖表塊或報表塊。

5）Tab 組件只導出第一個 Tab 頁；翻頁只導出當前頁。

6）JAR 包爲 2020-08-31 之前版本導出 Word 不支持圖表組件，只支持單元格元素的圖表。

7）不可與同類型插件同時啓用，如：決策報表導出 Plus 插件、決策報表多标簽頁導出插件。

8）不支持移動端。

點擊下載插件：決策報表導出

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

服務器安裝插件方法參見 服務器插件管理

将決策報表整體導出爲 Excel、PDF 、Word 格式，只需要在「PC端預覽」時的 URL 鏈接添加後綴&op=export&format=xxx，回車即可導出。xxx 代表導出的格式， 如下表所示：

例如導出決策報表爲 Excel ，如下圖所示：

決策報表中含有參數時，決策報表或決策報表内的組件内容，會因爲參數（例如參數查詢，主子報表等）變化而改變。那麽使用 URL 導出決策報表時，需要添加 sessionID 來導出當前查詢結果，否則導出内容會與參數查詢内容不一緻。

注：浏覽器請求 Web 服務，在創建會話時，服務器會爲每一個會話生成一個單獨的會話标識，這個會話标識就是 sessionID，以長整形數據類型返回。sessionID 就等於本次會話的 ID 記錄。

4.1 添加初始化後事件

打開内置的模板%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\frm\example.frm，選中參數面板「para」，添加「初始化事件」，設置一個參數「aaa」，值用公式表達爲：sessionID。步驟如下圖所示：

JS 代碼如下所示：

alert(aaa);

4.2 獲取sessionID導出

1）保存表單，點擊「PC端預覽」，彈出當前 sessionID，複制當前 sessionID 後，點擊确定。如下圖所示：

注：sessionID 每次刷新都會變化。

2）導出時，後綴加上&op=export&format=xxx&sessionID=***，xxx 代表導出的文件格式，*** 代表複制的當前 sessionID ，回車即可導出當前的查詢結果。

4.3 效果預覽

視頻演示效果如下：

4.4 模板下載

已完成模板可參見：%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\frm\帶參決策報表導出.frm

點擊下載模板：帶參決策報表導出.frm

通過在參數面板添加「按鈕控件」（也可以在 body 直接添加按鈕控件），設置參數「aaa」獲取當前sessionID  ，添加「點擊事件」導出。

5.1 添加按鈕

打開内置的模板%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\frm\example.frm，在參數面板中添加「按鈕控件」，按鈕名稱爲「導出 Excel」，如下圖所示：

5.2 添加點擊事件

選中「按鈕控件」，添加一個「點擊事件」，設置一個參數「aaa」，值用公式表達爲：sessionID。如下圖所示：

JavaScript 代碼如下：

var REPORT_URL = '${servletURL}?viewlet=doc/frm/example.frm&op=export&format=excel&sessionID=' + aaa;
window.location = encodeURI(REPORT_URL);

注：将「&format=excel」中的 excel 修改爲 pdf 或者 word 即爲導出 PDF 或 Word。

5.3 效果預覽

保存表單，點擊「PC端預覽」，點擊「查詢」按鈕後再點擊「導出 Excel」按鈕。效果如下所示：

注：用戶必須先預覽查詢，得到查詢後的界面再導出，若不查詢直接導出，導出文件的數據與效果無法保證。

5.4 模板下載

已完成模板可參見：%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\JS\表單JS實例\JS 實現點擊按鈕導出帶參決策報表.frm

點擊下載模板：JS 實現點擊按鈕導出帶參決策報表.frm