Web報(bào)表工具FineReport定時(shí)器使用說明.doc

FineReport-報(bào)表技術(shù)領(lǐng)跑者Web報(bào)表工具FineReport定時(shí)器使用說明本書介紹了報(bào)表工具FineReportV6.5定時(shí)器功能的相關(guān)參數(shù)及配置說明，本書最后詳細(xì)列舉了幾個(gè)使用定時(shí)器功能的模板制作示例。6.5定時(shí)器配置簡要說明 26.5定時(shí)器參數(shù)專題106.5定時(shí)器填報(bào)156.5定時(shí)器日報(bào)專題196.5定時(shí)器月報(bào)專題246.5定時(shí)器年報(bào)專題296.5定時(shí)器郵件專題33/6.5配置簡要說明在制作報(bào)表中，您可能需要面臨定期產(chǎn)生，定期發(fā)布等問題，F(xiàn)ineReport提供了定時(shí)器這個(gè)功能，對于6.5版本，在6.2的基礎(chǔ)上進(jìn)行了擴(kuò)充 ，可在頁面直接進(jìn)行操作，下面就簡單介紹一下。1. 配置環(huán)境此環(huán)境是自在tomcat環(huán)境中配置的，因此需要把FineReport6.5安裝目錄下的WebReport文件拷貝到%Tomcat_HOME%/webapps/下1.1 整合web.xml打開%Tomcat_HOME%/webapps/WebReport/WEB-INF目錄下的web.xml, 將 ScheduleServer com.fr.schedule.ScheduleServlet 1 ScheduleServer /ScheduleServer com.fr.schedule.ScheduleInitializerListener整合到現(xiàn)有的web.xml中，如下圖1.2 拷貝數(shù)據(jù)庫在WebReportWEB-INFresourcesdata下面新建文件夾schedule；將hsql數(shù)據(jù)庫放置到該文件夾里面,如圖所示1.3 替換jar包將fr-server-6.5.jar和fr-third-6.5.jar替換WEB-INFlib下原來的jar包，如下圖所示1.4 查看啟動(dòng)tomcat服務(wù)器，打開鏈接http:/localhost:8088/WebReport/ScheduleServer?action=dashboard，8088是tomcat服務(wù)器的端口，可改變。這樣就可看到定時(shí)器管理界面，如圖所示2. 添加定時(shí)任務(wù)在Schedule頁面上可直接添加定時(shí)報(bào)表，2.1 添加定時(shí)報(bào)表點(diǎn)擊頁面最下面的添加定時(shí)報(bào)表，如圖所示在此頁面填入報(bào)表的名字，并選擇報(bào)表路徑，選擇是否填報(bào)，如下圖所示注意：如果非火狐瀏覽器，下面的確定按鈕和取消按鈕將被遮住，需要滾動(dòng)鼠標(biāo)點(diǎn)擊確定按鈕,在schedule頁面就出現(xiàn)該模板，如圖2.2 添加定時(shí)任務(wù)在schedule界面中，點(diǎn)擊相應(yīng)的定時(shí)報(bào)表欄中添加定時(shí)任務(wù)按鈕，如圖點(diǎn)擊后出現(xiàn)如下界面點(diǎn)擊添加定時(shí)任務(wù)按鈕，進(jìn)入定時(shí)任務(wù)的基本設(shè)置頁面，在頁面中必須填寫任務(wù)名稱，任務(wù)描述可有可無，如圖點(diǎn)擊下一步，進(jìn)入第二步，時(shí)間表設(shè)置，可對時(shí)區(qū)選擇，開始的時(shí)間可選擇立即執(zhí)行，也可自定義開始時(shí)間，循環(huán)方式有三種不循環(huán)，即定時(shí)器只執(zhí)行一次，點(diǎn)擊下一步，進(jìn)入第三步，參數(shù)設(shè)置，可添加參數(shù)，可刪除參數(shù)，可根據(jù)模板自動(dòng)生成參數(shù)點(diǎn)擊下一步，進(jìn)入第四步，導(dǎo)出設(shè)置，填寫文件顯示名，并選擇管理目錄，導(dǎo)出文件類型可選擇cpt,excel,pdf,word四種格式，并選擇是否郵件通知如果選擇郵件通知，則會(huì)出現(xiàn)如下圖所示頁面，必須要填入發(fā)送的地址，其他可不填點(diǎn)擊完成，生成定時(shí)任務(wù)，加入定時(shí)任務(wù)列表，如下圖所示3. 瀏覽定時(shí)任務(wù)生成的新報(bào)表都放在%Tomcat_Home%webappsWebReportWEB-INFscheduletaskNameactionName文件夾下面。其中taskName是根據(jù)上面例子添加任務(wù)中的任務(wù)名稱：日報(bào)定時(shí)任務(wù)。actionName是根據(jù)定時(shí)器的日期，比如上述例子就是2010-03-31。actionName文件夾下將產(chǎn)生根據(jù)定時(shí)任務(wù)生成的定時(shí)文件的時(shí)間命名，如上述例子，根據(jù)定時(shí)任務(wù)，在11：52的時(shí)候生成新的報(bào)表和excel,所以該文件夾的命名為1152，在該文件夾下根據(jù)上面例子生成三個(gè)文test_20100331115225265_841.cpt;test_20100331115225281_569.xml和info.xml點(diǎn)擊定時(shí)器任務(wù)所在的目錄，我們能在左邊窗口看到添加的定時(shí)報(bào)表以及由定時(shí)任務(wù)生成的文件，生成的文件名就是在上面第四步中的導(dǎo)出文件名，如下圖所示6.5定時(shí)器參數(shù)專題在FineReport定時(shí)器中，參數(shù)尤為重要，特別是時(shí)間參數(shù)，在涉及到時(shí)間的定時(shí)任務(wù)中都需要用到它的公式。下面就詳細(xì)介紹一下定時(shí)器的參數(shù)。1. 時(shí)間參數(shù)定時(shí)器中主要用到的時(shí)間參數(shù)如下：日報(bào)當(dāng)前日期的前一天：Format(today()-1,”yyyy-MM-dd”)周報(bào)當(dāng)前日期的上一周的第一天：Format(dateInWeek(today()-7),1)，”yyyy-MM-dd”)當(dāng)前日期的上一周的最后一天：Format(dateInWeek(today()-7),7),yyyy-MM-dd)當(dāng)前日期的上上周的第一天：Format(dateInWeek(dateDelta(dateInWeek(today()-7),1),-7),1),yyyy-MM-dd)當(dāng)前日期的上上周的最后一天：Format(dateInWeek(dateDelta(dateInWeek(today()-7),7),-7),7),yyyy-MM-dd)月報(bào)當(dāng)前日期的上一個(gè)月的第一天：Format(dateInMonth(monthDelta(today(),-1),1),yyyy-MM-dd)當(dāng)前日期的上一個(gè)月的最后一天：Format(dateInMonth(monthDelta(today(),-1),daysOfMonth(monthDelta(today(),-1),yyyy-MM-dd)當(dāng)前日期的上上月的第一天：Format(dateInMonth(monthDelta(dateInMonth(monthDelta(today(),-1),1),-1),1),yyyy-MM-dd)當(dāng)前日期的上上月的最后一天： Format(dateInMonth(monthDelta(dateInMonth(monthDelta(today(),-1),daysOfMonth(monthDelta(today(),-1),-1),daysOfMonth(monthDelta(dateInMonth(monthDelta(today(),-1),daysOfMonth(monthDelta(today(),-1),-1),yyyy-MM-dd)年報(bào)當(dāng)前日期的上一年的第一天： Format(dateInYear(yearDelta(today(),-1),1),yyyy-MM-dd)當(dāng)前日期的上一年的最后一天Format(dateInYear(yearDelta(today(),-1),daysOfYear(yearDelta(today(),-1),yyyy-MM-dd)2. 其他類型參數(shù)值報(bào)表當(dāng)中除了時(shí)間參數(shù)之外，為了節(jié)省報(bào)表設(shè)計(jì)的工作量和減少報(bào)表文件的總量，我們往往要在報(bào)表里面加入其他的參數(shù)。例如主機(jī)名，指標(biāo)名等等。 首先我們在報(bào)表里面定義這些參數(shù)的時(shí)候，建議使用中文的參數(shù)名稱，這樣在定時(shí)生成之后，在報(bào)表查看時(shí)上方的參數(shù)名稱也就是直接讀的在報(bào)表當(dāng)中定義的參數(shù)名稱。中文對于最終用戶來說比較容易理解。 在報(bào)表當(dāng)中有這些參數(shù)的時(shí)候，定時(shí)生成的時(shí)候，我們需要設(shè)定參數(shù)包含哪些具體的值。比如exchange郵件服務(wù)器的性能報(bào)表，在哪幾臺機(jī)器上有exchange，exchange又包含哪些參數(shù)指標(biāo)。這些我們都需要通過定義全局?jǐn)?shù)據(jù)源得到。 也就是說，我們先定義好一個(gè)全局?jǐn)?shù)據(jù)源，該數(shù)據(jù)源返回的結(jié)果是exchange服務(wù)器所在的所有主機(jī)。然后在設(shè)置定時(shí)生成的時(shí)候，主機(jī)這個(gè)參數(shù)的參數(shù)類型，設(shè)置為“列”。選擇我們已經(jīng)定義好的全局?jǐn)?shù)據(jù)源，以及該數(shù)據(jù)源中代表主機(jī)的列即可。這樣在這個(gè)數(shù)據(jù)源內(nèi)返回了多少結(jié)果，則報(bào)表在生成的時(shí)候，會(huì)每一個(gè)值生成一個(gè)報(bào)表。 有一種特殊的情況，也許要通過多定義一些全局?jǐn)?shù)據(jù)源來實(shí)現(xiàn)。例如我們的報(bào)表當(dāng)中，有一部分是windows主機(jī)的性能報(bào)表。但是windows的主機(jī)又分 為OA和CallCenter。如果分開來設(shè)計(jì)報(bào)表的話，是一種重復(fù)勞動(dòng)。 解決的辦法，就是通過定義不同的全局?jǐn)?shù)據(jù)源。還是以主機(jī)這個(gè)參數(shù)舉例。在全局?jǐn)?shù)據(jù)源里面定義兩個(gè)不同的數(shù)據(jù)源分別返回的結(jié)果是OA的主機(jī)和CallCenter的主機(jī)。 然后我們只要設(shè)計(jì)一張Windows主機(jī)的報(bào)表即可。在定義定時(shí)任務(wù)時(shí)，可以定義兩個(gè)不同的action, 只是主機(jī)這個(gè)參數(shù)定義的時(shí)候，選擇的數(shù)據(jù)源不同。選擇OA的主機(jī)，那么生成的報(bào)表就是OA的性能報(bào)表，選擇CallCenter的主機(jī)，生成的即是CallCenter的報(bào)表。 再舉一個(gè)例子。各個(gè)業(yè)務(wù)系統(tǒng)的報(bào)表，也可以通過這個(gè)方法，大大減少報(bào)表的數(shù)量。例如業(yè)務(wù)系統(tǒng)的日報(bào)，我們只需要設(shè)計(jì)一張報(bào)表。在設(shè)置定時(shí)生成的時(shí)候，業(yè)務(wù)系統(tǒng)這個(gè)參數(shù)，可以分別設(shè)置固定的值。即十個(gè)不同的action。3. 簡單例子示例3.1 制作帶參的模板新建內(nèi)置數(shù)據(jù)集e1,如圖所示添加參數(shù)p1，控件類型為日期類型，參數(shù)界面設(shè)置如下表樣設(shè)計(jì)如下圖所示，并在B4單元格中添加過濾條件：date=$p13.2 添加定時(shí)報(bào)表在定時(shí)器管理界面點(diǎn)擊按鈕，添加定時(shí)報(bào)表，如下圖所示3.3 添加定時(shí)任務(wù)點(diǎn)擊定時(shí)器界面相應(yīng)模板的添加定時(shí)任務(wù)，并點(diǎn)擊第一步基本設(shè)置，如圖點(diǎn)擊下一步進(jìn)入時(shí)間設(shè)置，選擇立即執(zhí)行，循環(huán)方式選擇不循環(huán)，如圖點(diǎn)擊下一步，進(jìn)入?yún)?shù)設(shè)置，直接點(diǎn)擊界面上的按鈕，自動(dòng)生成報(bào)表中所帶的參數(shù)，并雙擊參數(shù)的值，對參數(shù)值進(jìn)行編輯，參數(shù)類型選擇公式，將參數(shù)值設(shè)為：Format(today()-1,yyyy-MM-dd) ,該公式表示當(dāng)前日期的前一天，如圖所示點(diǎn)擊下一步，進(jìn)入導(dǎo)出設(shè)置，填寫文件顯示名，并選中管理目錄和導(dǎo)出文件類型，如圖所示點(diǎn)擊完成，生成定時(shí)任務(wù)3.4 生成文件預(yù)覽刷新管理界面，發(fā)現(xiàn)生成定時(shí)文件參數(shù)測試1.cpt點(diǎn)擊該生成文件，預(yù)覽，如圖6.5定時(shí)器填報(bào)定時(shí)器的另一個(gè)重要功能就是可以用來定時(shí)填報(bào)，通過定時(shí)功能實(shí)現(xiàn)自動(dòng)填寫功能，而不必一個(gè)一個(gè)的手動(dòng)輸入，下面就通過一個(gè)例子介紹一下6.5版本定時(shí)器填報(bào)的用法1. 制作簡單填報(bào)模板連接數(shù)據(jù)庫scheduleDemo,新建模板，并添加數(shù)據(jù)庫查詢ds1: SELECT year(countdate) as year,month(countdate) as month,empid,num FROM empdetails where year(countdate) = $year and month(countdate)= $month，并將year參數(shù)的默認(rèn)值設(shè)為2010,month參數(shù)的默認(rèn)值設(shè)為4。報(bào)表樣式設(shè)計(jì)如圖所示，并雙擊A3單元格，選擇高級里面的自定義顯示值：=CONCATENATE($,年,month,月)，將C3單元格設(shè)置為：匯總|求和報(bào)表填報(bào)屬性設(shè)置，如圖所示，將empdetails表中的值插入到表empcount中去報(bào)表制作完成之后將模板存儲到reportlets目錄下2. 添加定時(shí)報(bào)表在定時(shí)器管理界面點(diǎn)擊按鈕，添加定時(shí)報(bào)表，并選中是否填報(bào)，如下圖所示3. 添加定時(shí)任務(wù)點(diǎn)擊定時(shí)器界面相應(yīng)模板的添加定時(shí)任務(wù)，并點(diǎn)擊第一步基本設(shè)置，如圖點(diǎn)擊下一步進(jìn)入時(shí)間設(shè)置，選擇立即執(zhí)行，循環(huán)方式選擇不循環(huán)，如圖點(diǎn)擊下一步進(jìn)入?yún)?shù)設(shè)置，點(diǎn)擊，并雙擊參數(shù)month和year進(jìn)行編輯，將參數(shù)類型都選擇公式，month的參數(shù)值為：month(today(),表示當(dāng)前的月份，year的參數(shù)值為：year(today()，表示當(dāng)前的年份點(diǎn)擊下一步，進(jìn)入導(dǎo)出設(shè)置，填寫文件顯示名，并選中管理目錄和導(dǎo)出文件類型，如圖所示4. 查看效果6.5定時(shí)器的填報(bào)功能不能在定時(shí)器管理界面顯示，效果只能在數(shù)據(jù)庫中查看。打開scheduleDemo數(shù)據(jù)庫的empcount表，發(fā)現(xiàn)通過定時(shí)任務(wù)，數(shù)據(jù)已經(jīng)自動(dòng)填入表中了。如圖所示6.5定時(shí)器日報(bào)專題在finereport定時(shí)器中，涉及到幾個(gè)典型問題，日報(bào)，月報(bào)，年報(bào)。這三種典型報(bào)表具體如何通過定時(shí)器生成定時(shí)任務(wù)呢？本專題專門介紹定時(shí)器的日報(bào)問題。日報(bào)顧名思義就是在每日的定點(diǎn)生成關(guān)于每天的統(tǒng)計(jì)。常見使用主要是人事考勤，訂單管理之類的，下面就做一個(gè)人事考勤的簡單例子介紹一下。1. 制作模板新建內(nèi)置數(shù)據(jù)集E1，如圖所示添加參數(shù)統(tǒng)計(jì)時(shí)間，控件類型為日期類型，參數(shù)界面設(shè)置如下表樣設(shè)計(jì)如下圖所示，并在A6單元格中添加過濾：統(tǒng)計(jì)時(shí)間=$統(tǒng)計(jì)時(shí)間報(bào)表制作完成之后將模板存儲到reportlets目錄下2. 添加定時(shí)報(bào)表在定時(shí)器管理界面點(diǎn)擊按鈕，添加定時(shí)報(bào)表，如下圖所示3. 添加定時(shí)任務(wù)點(diǎn)擊定時(shí)器界面相應(yīng)模板的添加定時(shí)任務(wù)，并點(diǎn)擊第一步基本設(shè)置，如圖點(diǎn)擊下一步進(jìn)入時(shí)間設(shè)置，開始時(shí)間選擇4月1日，循環(huán)方式選擇自定義循環(huán)，結(jié)束時(shí)間選擇4月30日，時(shí)間選擇每天的10點(diǎn)50分執(zhí)行，月選擇四月，這樣4月1號到4月30號每天的11點(diǎn)01分該定時(shí)任務(wù)都會(huì)執(zhí)行點(diǎn)擊下一步，進(jìn)入?yún)?shù)設(shè)置，直接點(diǎn)擊界面上的按鈕，自動(dòng)生成報(bào)表中所帶的參數(shù)，并雙擊參數(shù)的值，對參數(shù)值進(jìn)行編輯，參數(shù)類型選擇公式，將參數(shù)值設(shè)為：Format(today()-1,yyyy-MM-dd) ,該公式表示當(dāng)前日期的前一天，這樣該定時(shí)任務(wù)就 在4月份的每一天的11點(diǎn)01 分生成當(dāng)前日期的前一天的考勤統(tǒng)計(jì)，如圖所示點(diǎn)擊下一步，進(jìn)入導(dǎo)出設(shè)置，填寫文件顯示名，并選中管理目錄和導(dǎo)出文件類型，如圖所示4. 效果預(yù)覽刷新管理界面，發(fā)現(xiàn)在設(shè)置的11點(diǎn)01分生成定時(shí)文件：日報(bào)專題文件導(dǎo)出.cpt點(diǎn)擊該生成的定時(shí)文件，即在11點(diǎn)01分統(tǒng)計(jì)的當(dāng)前日期的前一天的考情統(tǒng)計(jì)，預(yù)覽6.5定時(shí)器月報(bào)專題在定時(shí)器的幾個(gè)典型案例中，月報(bào)經(jīng)常應(yīng)用于業(yè)月份統(tǒng)計(jì)中，下面通過一個(gè)典型的汽車年度銷售統(tǒng)計(jì)來介紹如何利用FineReport6.5定時(shí)器自動(dòng)實(shí)現(xiàn)月報(bào)統(tǒng)計(jì)。1. 修改模板打開模板%WebReportWEB-INFreportletsdemochartcar3.cpt，并刪除圖表，頁面修改后如圖所示將三個(gè)參數(shù)刪掉兩個(gè)，并添加一個(gè)新的參數(shù)$month,如圖所示在C5單元格中刪除原來的過濾條件，添加新的過濾條件將修改后的報(bào)表另存到到reportlets目錄下2. 添加定時(shí)報(bào)表在定時(shí)器管理界面點(diǎn)擊按鈕，添加定時(shí)報(bào)表，如下圖所示3. 添加定時(shí)任務(wù)點(diǎn)擊定時(shí)器界面相應(yīng)模板的添加定時(shí)任務(wù)，并點(diǎn)擊第一步基本設(shè)置，如圖點(diǎn)擊下一步進(jìn)入時(shí)間設(shè)置，開始時(shí)間選擇2007年1月1日，循環(huán)方式選擇自定義循環(huán)，結(jié)束時(shí)間選擇2010年4月16日，時(shí)間選擇17點(diǎn)15分執(zhí)行，天選擇每月的31日，月選擇所有月，這樣從07年1月到10年4月每月的31日的17點(diǎn)15分該定時(shí)任務(wù)都會(huì)執(zhí)行點(diǎn)擊下一步，進(jìn)入?yún)?shù)設(shè)置，直接點(diǎn)擊界面上的按鈕，自動(dòng)生成報(bào)表中所帶的參數(shù)，并雙擊參數(shù)的值，對參數(shù)值進(jìn)行編輯，兩個(gè)參數(shù)的類型都選擇公式，將Year的參數(shù)值設(shè)為：year(today()-2 ，表示當(dāng)前年份的上上年，month的參數(shù)值設(shè)為： month(today(),該公式表示每月的15日的17點(diǎn)15分，生成上上年的當(dāng)前月份的月報(bào)，如圖所示點(diǎn)擊下一步，進(jìn)入導(dǎo)出設(shè)置，填寫文件顯示名，并選中管理目錄和導(dǎo)出文件類型，如圖所示點(diǎn)擊完成，生成定時(shí)任務(wù)4. 生成文件預(yù)覽刷新管理界面，發(fā)現(xiàn)生成定時(shí)文件:月報(bào)導(dǎo)出.cpt點(diǎn)擊該生成文件，預(yù)覽，生成了08年4月份的統(tǒng)計(jì)報(bào)表，如圖6.5定時(shí)器年報(bào)專題在定時(shí)器的幾個(gè)典型案例中，年報(bào)經(jīng)常應(yīng)用于和年度統(tǒng)計(jì)中，下面通過一個(gè)典型的汽車年度銷售統(tǒng)計(jì)來介紹如何利用FineReport6.5定時(shí)器來自動(dòng)實(shí)現(xiàn)年報(bào)統(tǒng)計(jì)。月報(bào)5. 修改模板打開月報(bào)專題.cpt模板，樣式設(shè)計(jì)稍作修改，如圖刪掉month參數(shù)，如圖所示在C5單元格中刪除原來的過濾條件。將修改后的報(bào)表另存到到reportlets目錄下6. 添加定時(shí)報(bào)表在定時(shí)器管理界面點(diǎn)擊按鈕，添加定時(shí)報(bào)表，如下圖所示7. 添加定時(shí)任務(wù)點(diǎn)擊定時(shí)器界面相應(yīng)模板的添加定時(shí)任務(wù)，并點(diǎn)擊第一步基本設(shè)置，如圖點(diǎn)擊下一步進(jìn)入時(shí)間設(shè)置，開始時(shí)間選擇2007年1月1日，循環(huán)方式選擇自定義循環(huán)，結(jié)束時(shí)間選擇2010年4月30日，時(shí)間選擇12點(diǎn)00分執(zhí)行，天選擇每月的16日，月選擇四月，這樣從07年1月到10年4月每年的4月16日的12點(diǎn)00分該定時(shí)任務(wù)都會(huì)執(zhí)行點(diǎn)擊下一步，進(jìn)入?yún)?shù)設(shè)置，直接點(diǎn)擊界面上的按鈕，自動(dòng)生成報(bào)表中所帶的參數(shù)，并雙擊參數(shù)的值，對參數(shù)值進(jìn)行編輯，Year參數(shù)的類型都選擇公式，將Year的參數(shù)值設(shè)為：year(today()-2 ，表示當(dāng)前年份的上上年，該公式表示每年的4月16日12點(diǎn)00分，生成上上年的年報(bào)，如圖所示點(diǎn)擊下一步，進(jìn)入導(dǎo)出設(shè)置，填寫文件顯示名，并選中管理目錄和導(dǎo)出文件類型，如圖所示點(diǎn)擊完成，生成定時(shí)任務(wù)8. 生成文件預(yù)覽刷新管理界面，發(fā)現(xiàn)在設(shè)置的4月16日的12：00生成定時(shí)文件:年報(bào)導(dǎo)出.cpt點(diǎn)擊該生成文件，預(yù)覽，生成了08年的年報(bào)統(tǒng)計(jì)報(bào)表，如圖6.5定時(shí)器郵件專題在FineReport6.5版本中，定時(shí)器比6.2版本中多了郵件通知的功能，該功能使得定時(shí)器的定時(shí)任務(wù)生成定時(shí)文件時(shí)能夠及時(shí)通知用戶，而用也可通過是否收到郵件判斷定時(shí)器的定時(shí)任務(wù)是否正常工作。下面就詳細(xì)介紹一下定時(shí)器的郵件設(shè)置。1. 服務(wù)器配置打開報(bào)表設(shè)計(jì)器，登錄環(huán)境設(shè)置為tomcat所在目錄（因?yàn)槎〞r(shí)