自定义参数界面- FineReport帮助文档 - 全面的报表使用教程和学习资料

1. 概述

1.1 問題描述

用戶系統可能已經使用自己框架如 .Net、jQuery、Ext 等中的控件實現了條件查詢界面，不需要再使用FR内置的參數界面，此時如何将用戶表單控件的值傳遞給報表呢？，如下圖所示：

222

1.2 實現思路

用戶自己實現條件表單界面，在點擊如“查詢”等按鈕時，獲取控件的值拼接出最終的報表 URL，賦給 form 表單的 action，再觸發表單提交事件。

若控件值爲中文，表單提交前需要先進行編碼。

2. 操作步驟

2.1 模板準備

打開模板%FR_HOME%webapps\webroot\WEB-INF\reportlets\demo\parameter\庫存每頁顯示固定行.cpt

切換至參數界面，将圖中 ① 拉至最上方，把參數欄高度調至最小，去掉點擊查詢前不顯示報表内容選項後面的勾，如下圖：

模板另存爲%FR_HOME%\webapps\webroot\WEB-INF\reportlets\demo\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&para=" + 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&para=" + 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>顯示代碼