潤(rùn)乾報(bào)表設(shè)計(jì)器簡(jiǎn)易教程

1、潤(rùn)乾報(bào)表設(shè)計(jì)器簡(jiǎn)易教程建立一個(gè)新的報(bào)表由存儲(chǔ)過程的編寫和表樣的設(shè)計(jì)兩部分組成，其中，表樣的設(shè)計(jì)是利用潤(rùn)乾設(shè)計(jì)器進(jìn)行的。用潤(rùn)乾建立一個(gè)新的表樣可以分為以下幾步：新建數(shù)據(jù)源、連接數(shù)據(jù)源、設(shè)置參數(shù)、設(shè)置數(shù)據(jù)集、繪制表樣、預(yù)覽表樣。在以下步驟說(shuō)明中，以預(yù)算上報(bào)下達(dá)差異表為例進(jìn)行說(shuō)明。該報(bào)表的查詢條件包括年度、單位和模板。表樣如下所示：2010年預(yù)算上報(bào)下達(dá)差異表制表部門：查詢單位期間：2010年單位：萬(wàn)元預(yù)算科目 本單位 下級(jí)單位1 下級(jí)單位2 上報(bào)值 下達(dá)值 差異 上報(bào)值 下達(dá)值 差異 預(yù)算科目1預(yù)算科目2預(yù)算科目3預(yù)算科目4預(yù)算科目5合計(jì)制表人：登錄用戶制表時(shí)間：2010-07-261 新建數(shù)據(jù)源

2、配置數(shù)據(jù)源的目的是為了連接數(shù)據(jù)庫(kù)。配置的步驟如下：Ø 打開設(shè)計(jì)器后，點(diǎn)擊配置數(shù)據(jù)源，打開配置數(shù)據(jù)源的界面。Ø 點(diǎn)擊新建，在數(shù)據(jù)庫(kù)類型中根據(jù)實(shí)際情況選擇數(shù)據(jù)庫(kù)類型，針對(duì)TBM系統(tǒng)，選擇的是關(guān)系數(shù)據(jù)庫(kù)，點(diǎn)擊確定。Ø 在數(shù)據(jù)源常規(guī)屬性設(shè)置頁(yè)面進(jìn)行數(shù)據(jù)源的設(shè)置，如下圖所示： ü 數(shù)據(jù)源名稱：可以任意指定，建議采取tbmbj等名稱對(duì)各地?cái)?shù)據(jù)庫(kù)進(jìn)行直觀性區(qū)分。ü 數(shù)據(jù)庫(kù)類型：選擇對(duì)應(yīng)數(shù)據(jù)庫(kù)類型，TBM系統(tǒng)采用的是DB2數(shù)據(jù)庫(kù)。ü 客戶端字符集：指的是從數(shù)據(jù)庫(kù)取出的數(shù)據(jù)在客戶端展現(xiàn)時(shí)的字符編碼，可以采用默認(rèn)的GBK。ü 數(shù)據(jù)庫(kù)字符集：指的

3、是從數(shù)據(jù)庫(kù)中取過來(lái)的字符編碼，根據(jù)數(shù)據(jù)庫(kù)的編碼類型選擇，可以采用默認(rèn)的GBK。ü 驅(qū)動(dòng)程序：輸入“”即可。ü 數(shù)據(jù)源URL：數(shù)據(jù)源URL的輸入格式為jdbc:db2:/IP地址:端口號(hào)/數(shù)據(jù)庫(kù)名，例如：jdbc:db2:/:50000/tbmbj。ü 用戶、口令：數(shù)據(jù)庫(kù)用戶名和密碼。Ø 設(shè)置完成后，點(diǎn)擊【確定】按鈕，回到數(shù)據(jù)源配置界面，關(guān)系數(shù)據(jù)庫(kù)類型的數(shù)據(jù)源就配置完成了，數(shù)據(jù)源配置界面中就列出了新建的數(shù)據(jù)源。2 連接和斷開數(shù)據(jù)源選中需要連接和斷開的數(shù)據(jù)源后，點(diǎn)擊數(shù)據(jù)源配置窗口的連接或斷開即可。3 設(shè)置參數(shù)此處設(shè)置的參數(shù)是指報(bào)表中

4、需要的參數(shù)，包括報(bào)表的查詢條件、從頁(yè)面URL傳過來(lái)的參數(shù)等。對(duì)于預(yù)算上報(bào)和下達(dá)差異表，需要傳入兩類參數(shù)：一是查詢條件，包括年份dateflag、單位dptid和模板groupid；二是從URL中傳過來(lái)的參數(shù)，用于顯示制表部門和制表人，其中指標(biāo)部門即用戶在查詢條件中選擇的單位，無(wú)需再次設(shè)置該參數(shù)，制表人即當(dāng)前登錄用戶，因此需設(shè)置參數(shù)userid。由于從頁(yè)面或URL傳入的都是ID而不是名稱，所以在設(shè)置參數(shù)的時(shí)候也是設(shè)置的dptid而不是dptname，別的參數(shù)類似。Ø 點(diǎn)擊配置參數(shù)，打開參數(shù)編輯頁(yè)面，點(diǎn)擊增加后在該頁(yè)面增加一條參數(shù)記錄；Ø 修改參數(shù)名稱為dateflag，其數(shù)據(jù)

5、類型為字符串型；與此類推，增加其他參數(shù)，最后結(jié)果如下圖所示：4 設(shè)置數(shù)據(jù)集數(shù)據(jù)集是報(bào)表的數(shù)據(jù)來(lái)源，可以通過數(shù)據(jù)庫(kù)的sql查詢獲得，也可以通過存儲(chǔ)過程獲得。在TBM的報(bào)表中，采取的是通過存儲(chǔ)過程獲取報(bào)表中需要查詢的數(shù)據(jù)，同時(shí)會(huì)使用sql語(yǔ)句進(jìn)行輔助字段的查詢，例如通過使用sql語(yǔ)句查詢url傳入的userid對(duì)應(yīng)的username，從而顯示制表人的名稱。4.1 增加存儲(chǔ)過程類數(shù)據(jù)集Ø 點(diǎn)擊配置數(shù)據(jù)集，彈出數(shù)據(jù)集配置窗口。Ø 點(diǎn)擊增加，在彈出窗口中選擇數(shù)據(jù)集類型為存儲(chǔ)過程，點(diǎn)擊確定。Ø 定義標(biāo)簽頁(yè)中輸入CALL PRC_R_TY_CYBJ_SBXD(?,?,?)，其中

6、PRC_R_TY_CYBJ_SBXD為預(yù)算上報(bào)下達(dá)差異表對(duì)應(yīng)的存儲(chǔ)過程的名稱，三個(gè)問號(hào)表明該存儲(chǔ)過程需要傳入三個(gè)參數(shù)，依次是年度、單位、模板。Ø 在參數(shù)標(biāo)簽頁(yè)中對(duì)應(yīng)地新建三個(gè)參數(shù)，雙擊第一個(gè)參數(shù)的參數(shù)表達(dá)式，彈出如下窗口，在報(bào)表表達(dá)式窗口中刪除原有的arg1，雙擊數(shù)據(jù)列表中的dateflag，點(diǎn)擊確定。Ø 單位和模板參數(shù)的設(shè)置與上步類似，最后得到如下結(jié)果。需要注意的是，這三個(gè)參數(shù)的順序與存儲(chǔ)過程中參數(shù)的順序必須保持一致。Ø 點(diǎn)擊確定后，在數(shù)據(jù)集設(shè)置頁(yè)面增加了一個(gè)類型為存儲(chǔ)過程的數(shù)據(jù)集Ø 點(diǎn)擊數(shù)據(jù)集設(shè)置頁(yè)面的確定按鈕，設(shè)計(jì)器右下角的數(shù)據(jù)集標(biāo)簽頁(yè)也相應(yīng)的多了

7、一個(gè)名為ds1的數(shù)據(jù)集，展開該數(shù)據(jù)集可以看到對(duì)應(yīng)的存儲(chǔ)過程查出的字段4.2 增加SQL檢索數(shù)據(jù)集Ø 點(diǎn)擊配置數(shù)據(jù)集，彈出數(shù)據(jù)集配置窗口。Ø 點(diǎn)擊增加，在彈出窗口中選擇數(shù)據(jù)集類型為SQL檢索，點(diǎn)擊確定。Ø 可以直接在語(yǔ)法標(biāo)簽頁(yè)中輸入SQL語(yǔ)句，也可以逐個(gè)設(shè)置SQL編輯器各標(biāo)簽頁(yè)的數(shù)據(jù)和條件，讓潤(rùn)乾報(bào)表設(shè)計(jì)器在語(yǔ)法標(biāo)簽頁(yè)自動(dòng)生成SQL語(yǔ)句。Ø SQL語(yǔ)句中需要傳入?yún)?shù)的地方依舊用問號(hào)標(biāo)示，并在參數(shù)標(biāo)簽頁(yè)進(jìn)行設(shè)置。5 繪制表樣潤(rùn)乾報(bào)表采取的是類EXCEL界面，在操作上與EXCEL類似。由于該報(bào)表文件需要展示的是所選單位及其下級(jí)直屬單位的預(yù)算上報(bào)下達(dá)差異情況，也

8、就是說(shuō)需要對(duì)報(bào)表的展示單位根據(jù)實(shí)際情況進(jìn)行擴(kuò)展。Ø 繪制空白表樣。按照EXCEL設(shè)計(jì)的表樣在設(shè)計(jì)器中設(shè)計(jì)出空白的表樣，如下圖Ø 從存儲(chǔ)過程中獲取報(bào)表文件的字段信息：ü 該存儲(chǔ)過程查出的字段如下圖，依次表示預(yù)算科目ID，預(yù)算科目名稱，預(yù)算科目展示順序，部門ID，部門名稱，部門展示順序，預(yù)算上報(bào)值，預(yù)算集團(tuán)下達(dá)值；ü 獲取預(yù)算科目的值，點(diǎn)擊ds1下面的SHOWNAME，然后拖動(dòng)至報(bào)表文件的A5中，如下圖所示，圖中紅色的箭頭表示該單元格的擴(kuò)展方式為縱向擴(kuò)展ü 同理，將上報(bào)值下達(dá)值的字段拖入表中，由于上報(bào)下達(dá)值是針對(duì)特定的預(yù)算科目的，因此將方式設(shè)為取值

9、，然后拖入表中即可，如下圖：ü 根據(jù)報(bào)表需要，在設(shè)計(jì)時(shí)要將同一部門的上報(bào)值、下達(dá)值和差異進(jìn)行分組展示，因此選擇的方式是分組，將擴(kuò)展方式改為橫向擴(kuò)展，如下圖ü 由于在展示部門時(shí)，其順序要按照省本部，省本部財(cái)務(wù)部這樣的順序展示，因此需要對(duì)B3單元格的表達(dá)式進(jìn)行更改，增加其排序方式，更改為：ds1.Group(DPTNAME,false,DPTVIEWORDER)。更改的方式是雙擊B3單元格的表達(dá)式，在彈出的表達(dá)式編輯對(duì)話框中進(jìn)行更改，在表達(dá)式編輯對(duì)話框中雙擊字段就可以將雙擊的字段添加到表達(dá)式光標(biāo)所在位置。ü 在合計(jì)、差異等單元格添上計(jì)算公式，其中 SUM(B5)中B5

10、表示把B5所代表的上報(bào)值根據(jù)預(yù)算科目擴(kuò)展后的所有上報(bào)值單元格進(jìn)行相加，若寫成B5()則表示只匯總擴(kuò)展后的第一個(gè)上報(bào)值單元格，即取第一個(gè)單元格的值：在點(diǎn)擊需要超鏈接的單元格后，設(shè)計(jì)器的右邊會(huì)有以下圖片中的名稱顯示：超鏈接處，填寫鏈接地址，雙擊進(jìn)入后，在表達(dá)式一欄中填入需要用到的頁(yè)面、參數(shù)以及鏈接的報(bào)表raq文件；例子："/tbm/report/reportcontent.jsp?dateflag="+dateflag+"&dptid="+dptid+"&groupid="+groupid+"&useri

11、d="+userid+"&itemid="+B4+"&raq=/TY/TY_BMSB_YS_KMXM.raq"“/tbm/report/reportcontent.jsp?” 為顯示頁(yè)面，此段一般是寫死的，基本無(wú)變化。 “dateflag="+dateflag+"&dptid="+dptid+"&groupid="+groupid+"&userid="+userid+"&itemid="+B4+"”

12、此段是參數(shù) 一般為主表所用到的全部參數(shù)以及被鏈接表的參數(shù)，由于普通情況都是 主表參數(shù)為 A+B+C 被鏈接參數(shù)為 A+B+C+D； 那么，我們也可以理解為將被鏈接參數(shù)全部填入即可；只是被鏈接報(bào)表多出的參數(shù) 一般都是 在 鏈接項(xiàng) 所選的單元格 。“&raq=/TY/TY_BMSB_YS_KMXM.raq” 最后一段既是被連接的 報(bào)表raq文件名。 超鏈接窗口 只要在中間空處填死“_blank”即可ü 新建SQL檢索的數(shù)據(jù)集ds2，目的是通過dptid和userid獲取dptname和username，按照增加SQL檢索類數(shù)據(jù)集的步驟建立，SQL語(yǔ)句是SELECT BAS_DPT

13、.DPTNAME,BAS_USERINFO.USERNAME FROM BAS_DPT,BAS_USERINFO WHERE BAS_DPT.DPTID =? AND BAS_USERINFO.USERID =?，兩個(gè)參數(shù)分別取之前建好的參數(shù)dptid和userid。如圖，將A2單元格的表達(dá)式設(shè)置為“='制表部門：'+ds2.DPTNAME”，當(dāng)傳入dptid后，通過SQL檢索獲取dptname，然后顯示在報(bào)表文件中，例如傳入dptid的值2，顯示發(fā)布報(bào)表后顯示為“制表部門：省本部”。同理，對(duì)A7單元格的公式進(jìn)行更改。ü 將制表時(shí)間、期間兩個(gè)單元格的表達(dá)式更改如下，各

14、函數(shù)的含義分別是：='制表時(shí)間：'+str(year(now()+'-'+str(month(now()+'-'+str(day(now()='期間：'+str(int(dateflag)/100,"#")+'年'² -：表示引用單引號(hào)內(nèi)的字符（串）² now()：獲取當(dāng)前的日期時(shí)間² year()：從日期型數(shù)據(jù)中獲得年信息，例如year("1972-11-08 10:20:30") 返回：1972² month()：從日期型數(shù)據(jù)中獲得

15、月信息，例如year("1972-11-08 10:20:30") 返回：11² day()：從日期型數(shù)據(jù)中獲得日信息，例如year("1972-11-08 10:20:30") 返回：8² str()：將對(duì)象轉(zhuǎn)換成字符型，轉(zhuǎn)換過程中可以進(jìn)行格式化，例如str(3456.9876,"￥#,#0.00") 返回值："￥3,456.99"² int()：將字符串或數(shù)字轉(zhuǎn)換成整數(shù)，例如int(100.9999) 返回：100ü 設(shè)置報(bào)表標(biāo)題，報(bào)表頭。我們希望能夠像EXCEL凍結(jié)拆分

16、一樣，在翻頁(yè)的時(shí)候使表名，表頭和左邊第一列固定不變；這在潤(rùn)乾報(bào)表中是通過將行列的屬性設(shè)置為頭標(biāo)題、報(bào)表頭、左表頭等實(shí)現(xiàn)的。6 預(yù)覽表樣6.1 在設(shè)計(jì)器中進(jìn)行預(yù)覽：點(diǎn)擊潤(rùn)乾報(bào)表工具欄的預(yù)覽按鈕會(huì)彈出報(bào)表參數(shù)設(shè)置對(duì)話框，用于模擬查詢條件以及URL參數(shù)的傳入情況。設(shè)置dateflag的值為201000，dptid為2，groupid為20000，userid為1，即查詢2010年省本部模板ID為20000的模板的所有預(yù)算科目的上報(bào)下達(dá)情況，制表部門為省本部，制表人即登錄用戶為userid為1的系統(tǒng)管理員。6.2 發(fā)布到本機(jī)進(jìn)行預(yù)覽：Ø 啟動(dòng)默認(rèn)服務(wù)器：點(diǎn)擊本地應(yīng)用-預(yù)覽-發(fā)布報(bào)表，或點(diǎn)擊工

17、具欄中的按鈕啟動(dòng)默認(rèn)服務(wù)器，工具欄的按鈕變成。Ø 發(fā)布報(bào)表文件：點(diǎn)擊彈出“請(qǐng)輸入報(bào)表名稱”對(duì)話框，在對(duì)話框中編輯報(bào)表發(fā)布的路徑和文件名，點(diǎn)擊【確定】按鈕即可完成報(bào)表的發(fā)布。其中，報(bào)表發(fā)布路徑不需更改，因?yàn)闈?rùn)乾的發(fā)布路徑必須在安裝路徑之下。Ø 在IE瀏覽器中進(jìn)行查看：點(diǎn)擊工具欄的IE瀏覽器圖標(biāo)，會(huì)自動(dòng)在IE中打開發(fā)布文件，表樣為空表樣。IE中的地址為報(bào)表文件在本機(jī)中的地址，還需手動(dòng)在該地址后面輸入報(bào)表文件的參數(shù)，點(diǎn)擊跳轉(zhuǎn)即可看到該查詢條件下的報(bào)表內(nèi)容。原地址：:6001/demo/reportJsp/showReport.jsp?raq=/TY_

18、CYBJ_SBXD.raq在URL中手動(dòng)輸入?yún)?shù)：:6001/demo/reportJsp/showReport.jsp?raq=/TY_CYBJ_SBXD.raq&dateflag=201000&dptid=2&groupid=20702&userid=1一。潤(rùn)乾報(bào)表的部署涉及到以下基本配置文件的修改：1.reportConfig.xml中<name>license</name>下面的一行是指定許可證文件的，需要使用潤(rùn)乾的有效.lic文件，該文件在應(yīng)用中的地點(diǎn)是：/tbm/report/lic，文件名和地址不能錯(cuò)，根據(jù)現(xiàn)在所擁有的操作系統(tǒng)，各省應(yīng)該使用類似這樣的文件：xxxOther.lic。在reportConfig.xml中有以下配置是對(duì)db2的：<config> <name>dataSource</name> <value>jdbc/tbm,db2,1,UTF-8,UTF-8,1</value> </co