1. 概述
1.1 問題描述
使用者系統可能已經使用自己框架如 .Net、jQuery、Ext 等中的元件實現了條件查詢介面,不需要再使用FR內建參數介面,此時如何將使用者表儲存格件的值傳遞給報表呢?如下圖所示:
1.2 實現思路
使用者自己實現條件表單介面,在點選如“查詢”等按鈕時,獲取元件的值連接出最終的報表 URL,賦給 form 表單的 action,再觸發表單提交事件。
若元件值為中文,表單提交前需要先進行編碼。
2. 操作步驟
2.1 範本準備
開啟範本%FR_HOME%webapps\webroot\WEB-INF\reportlets\demoTW\parameter\庫存每頁顯示固定行.cpt
切換至參數介面,將圖中 ① 拉至最上方,把參數欄高度調至最小,去掉
範本另存為%FR_HOME%\webapps\webroot\WEB-INF\reportlets\demoTW\parameter\庫存每頁顯示固定行1.cpt
2.2 自訂表單介面
實際系統中使用的框架不同,元件的種類和定義方法也不同,因此如上圖中的表單查詢介面我們不做介紹,使用者自行實現,該例使用最簡單的 HTML 元素。
主要注意的是如果是 form 表單提交參數的話,action 地址及表單提交結果顯示位置目標範本 target;
如該例中定義 form 表單時沒有指定 action,target 的值為嵌入報表的 iframe 名稱。
另外我們在點選查詢按鈕時需要先獲取元件值,因此查詢按鈕 type 使用 button,不要使用 submit(直接觸發 action)。
其中
① 沒有設定表單的提交 action
② 使用 iframe 引用表儲存格件
③ 為表單的查詢介面
④ 中不用 submit,使用普通按鈕
2.3 表單提交事件
點選“查詢”按鈕時,觸發 autoSubmit(),在該方法中透過 JS 獲取表儲存格件的值,連接出完整的報表存取路徑,並對最終的 URL 進行 encodeURI 編碼。
將最終的報表 URL 賦給 form 的 action,並觸發提交,傳回的報表結果就會顯示在指定的 iframe 中。
function autoSubmit() {
var num = document.getElementById('num').value; //獲取正文元件的值
var row = document.getElementById('row').value; //獲取下拉框元件的值
//連接出最終報表存取路徑,並對完整的路徑進行編碼轉換,防止亂碼問題
var reportURL = encodeURI("../../decision/view/report?viewlet=/demo/parameter/庫存查詢每頁顯示固定行.cpt¶=" + num + "&row=" + row);
document.paraForm.action = reportURL; //透過 form 的 name 獲取表單,並將報表存取路徑賦給表單的 action
document.paraForm.submit(); //觸發表單提交事件
}
2.4 範例完整程式碼
<html>
<head>
<title>FineReport Demo</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<script type="text/javascript">
function autoSubmit() {
var num = document.getElementById('num').value; //獲取正文元件的值
var row = document.getElementById('row').value; //獲取下拉框元件的值
//連接出最終報表存取路徑,並對完整的路徑進行編碼轉換,防止亂碼問題
var reportURL = encodeURI("../../decision/view/report?viewlet=/demo/parameter/庫存查詢每頁顯示固定行.cpt¶=" + num + "&row=" + row);
document.paraForm.action = reportURL; //透過 form 的 name 獲取表單,並將報表存取路徑賦給表單的 action
document.paraForm.submit(); //觸發表單提交事件
}
</script>
</head>
<body>
<fieldset>
<legend>查詢表單:</legend>
<form name="paraForm" method="post" target="reportFrame">
最小庫存量:<input type="text" name="num" id="num" value="1"/>
每頁顯示行數:<select name="row" id="row">
<option value="10" select>10
<option value="20">20
<option value="30">30
<input type="button" name="show" value="查詢" onclick="autoSubmit()"/>
</form>
</fieldset>
<iframe id="reportFrame" name="reportFrame" width="100%" height="100%" ></iframe>
</body>
</html>
2.5 效果預覽
已完成頁面查看%FR_HOME%/webapps/webroot/help/page_demo/parameter.html
啟動工程,在瀏覽器輸入:http://localhost:8075/webroot/help/page_demo/parameter.html ,效果如下圖: