JAVA報表finereport二次開發的JS使用說明

一、概述

隨著FineReport的發展，它提供的設計器和伺服器應該能夠滿足您絕大部分的需求，完全實現零編碼的軟體開發，革命性地加快軟體開發速度，提高軟體穩定性。但是需求是千變萬化的，而FineReport所包含的功能是報錶行業中比較普遍的典型的，也許某些個性化的功能通過FineReport軟體無法實現。為此，FineReport支持應用開發人員使用網頁腳本、API介面等對FineReport進行深入的開發與控制，以滿足其個性化的需求。當然，如果您發現您的某個需求必須要編程來實現，建議您先給我們的顧問打一個諮詢電話，也許他可以給您提供有一個不需要編程的簡單方法來滿足您的需求，節約您的時間。

在這裡，我們主要介紹JS的使用說明，為需要對FineReport報表進行深入開發的應用開發人員提供參考。

二、JS的使用說明

JavaScript是種腳本語言，它可以用來製作與網路無關的，與用戶交互作用的複雜軟體。它是一種基於對象（Object Based）和事件驅動（Event Driver）的編程語言。JavaScript是動態的，它可以直接對用戶或客戶輸入做出響應，無須經過Web服務程序。它對用戶的反映響應，是採用以事件驅動的方式進行的。所謂事件驅動，就是指在主頁(Home Page)中執行了某種操作所產生的動作，就稱為「事件」(Event)。比如按下滑鼠、移動窗口、選擇菜單等都可以視為事件。當事件發生後，可能會引起相應的事件響應。

JavaScript是依賴於瀏覽器本身，與操作環境無關，只要能運行瀏覽器的計算機，並支持JavaScript的瀏覽器就可正確執行。即JavaScript源代碼在發往客戶端執行之前不需經過編譯，而是將文本格式的字元代碼發送給客戶編由瀏覽器直接解釋執行。

（一）問題描述

FineReport報表採用jquery v1.5.2框架，jquery是一個快速的，簡潔的javaScript庫，使用戶能更方便地處理HTML documents、events、實現動畫效果，方便地為網站提供AJAX交互，並且它兼容各種瀏覽器（IE 6.0+, FF 1.5+, Safari 2.0+, Opera 9.0+）。FineReport報表解析後最終成為一個html頁面，因此可以使用js對報表進行各種處理，您可以使用jQuery框架的所有方法對報表進行操作，在此基礎上，FineReport還封裝了很多內置的js方法。接下來我們就JS的基本使用做一個介紹。

（二）如何使用JS

1、報表模板中使用JS

設計模板時可以給控制項、工具欄按鈕、整個報表添加JS事件，每個事件對應一個function。當報錶轉為htm頁面時會將這些fuction加到html的頭部head。當事件被觸發時如點擊按鈕時，或者導出列印報表時，對應的function就會被執行。

引入現成的js文件

單個模板引入外部js文件：分頁預覽、填報預覽或者數據分析旁的設置圖標，然後點擊引用JavaScript；

報表工程下所有模板統一引入外部js文件：伺服器>伺服器配置>引用JavaScript。

相對路徑引用js：相對於報表工程目錄如WebReport，如WebReport\js下有引用的js文件test.js，則相對路徑為js/test.js；絕對路徑引用js：如D:\tomcat\webapps\WebReport\WEB-INF\scripts\script.js。