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

2、配置數據源的目的是為了連接數據庫。配置的步驟如下：Ø 打開設計器后，點擊配置數據源，打開配置數據源的界面。Ø 點擊新建，在數據庫類型中根據實際情況選擇數據庫類型，針對TBM系統，選擇的是關系數據庫，點擊確定。Ø 在數據源常規屬性設置頁面進行數據源的設置，如下圖所示： ü 數據源名稱：可以任意指定，建議采取tbmbj等名稱對各地數據庫進行直觀性區分。ü 數據庫類型：選擇對應數據庫類型，TBM系統采用的是DB2數據庫。ü 客戶端字符集：指的是從數據庫取出的數據在客戶端展現時的字符編碼，可以采用默認的GBK。ü 數據庫字符集：指的

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

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

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

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

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

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

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

10、表示把B5所代表的上報值根據預算科目擴展后的所有上報值單元格進行相加，若寫成B5()則表示只匯總擴展后的第一個上報值單元格，即取第一個單元格的值：在點擊需要超鏈接的單元格后，設計器的右邊會有以下圖片中的名稱顯示：超鏈接處，填寫鏈接地址，雙擊進入后，在表達式一欄中填入需要用到的頁面、參數以及鏈接的報表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?” 為顯示頁面，此段一般是寫死的，基本無變化。 “dateflag="+dateflag+"&dptid="+dptid+"&groupid="+groupid+"&userid="+userid+"&itemid="+B4+"”

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

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

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

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

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

17、具欄中的按鈕啟動默認服務器，工具欄的按鈕變成。Ø 發布報表文件：點擊彈出“請輸入報表名稱”對話框，在對話框中編輯報表發布的路徑和文件名，點擊【確定】按鈕即可完成報表的發布。其中，報表發布路徑不需更改，因為潤乾的發布路徑必須在安裝路徑之下。Ø 在IE瀏覽器中進行查看：點擊工具欄的IE瀏覽器圖標，會自動在IE中打開發布文件，表樣為空表樣。IE中的地址為報表文件在本機中的地址，還需手動在該地址后面輸入報表文件的參數，點擊跳轉即可看到該查詢條件下的報表內容。原地址：:6001/demo/reportJsp/showReport.jsp?raq=/TY_

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