潤乾報表入門

1、精選優(yōu)質(zhì)文檔-傾情為你奉上1 前言鑒于目前報表開發(fā)沒有一個統(tǒng)一的規(guī)范，每個開發(fā)的風(fēng)格和習(xí)慣也不一致，所以動手寫了這份報表開發(fā)文檔，一來有助于統(tǒng)一大家的報表的風(fēng)格，提供一些常見問題的解決方案，二來方便以后新人的學(xué)習(xí)使用。本人也是略懂皮毛，有什么錯誤和不足之處，歡迎大家補充修改。2.報表工具安裝解壓后運行runqian-v4.5.5-install.exe 安裝文件，按引導(dǎo)完成安裝。其中，在初次打開報表文件和發(fā)布報表文件的時候（后續(xù)會提到），會提示我們需要lic文件，就是下圖中的兩個lic文件。Figure 13.報表工具的使用3-1 配置數(shù)據(jù)源使用報表時需要先對數(shù)據(jù)源進行配置：Figure 2選

2、擇新建一個數(shù)據(jù)源：Figure 3項目中默認使用的數(shù)據(jù)源名稱為reportjndi.參考圖3進行配置后，點擊連接，進行數(shù)據(jù)源連接，這樣就完成了報表服務(wù)器與數(shù)據(jù)庫的連接。3-2 新建報表目前的報表形式分為兩部分，一是用來顯示查詢結(jié)果的“報表名.raq”文件，另一個是用來提供查詢條件的“報表名_arg.raq”文件。我們只需要在保存文件的時候，按上述格式命名，打開.raq文件時，會自動打開相關(guān)的_arg.raq文件。3-3 結(jié)果顯示報表設(shè)計首先新建一張報表，直接點擊左上角工具欄上的即可。按照給定的表樣設(shè)計好報表名名、列名。如下圖，這里提供一種樣式當(dāng)做參考模板，如客戶無特殊需求，希望各開發(fā)按照統(tǒng)一的

3、樣式標(biāo)準(zhǔn)進行設(shè)計，有助于提高所有報表的統(tǒng)一性，后面還會提到一些規(guī)范，希望大家也可以遵守起來。Figure 4報表名這一行，采用黑色、二號字，加粗。列名采用白色、三號字，加粗，背景色使用淡紫色（顏色相近即可）。若每一列下面還要分列，則使用黑色、小三號字，結(jié)果數(shù)據(jù)使用黑色、四號字。Figure 5設(shè)定好報表樣式后，開始根據(jù)邏輯進行取數(shù)，設(shè)置每一列的寬度時，如果需要在一行中完整顯示的，要選擇“按單元格內(nèi)容擴大”，并去掉“自動換行”。Figure 6報表通過配置的“數(shù)據(jù)集”進行取數(shù)。點擊配置數(shù)據(jù)集，新增一個數(shù)據(jù)集，大部分邏輯，通過sql檢索即可完成，若遇到比較復(fù)雜的也可以使用存儲過程。Figure 7

4、在“語法”中輸入sql語句，獲得我們想要的查詢結(jié)果：然后在報表中通過數(shù)據(jù)源名.select（列名），即可獲得我們要的數(shù)據(jù)，select方法還 提供了排序等功能，詳細用法可以參考安裝D:develop安裝包安裝包，幫助文檔，licrunqian_helpdoc使用手冊報表設(shè)計潤乾報表4.5用戶手冊.chm，通過搜索關(guān)鍵字，可以了解相關(guān)的功能，開發(fā)的時候可以多使用這個手冊。3-4 查詢條件報表設(shè)計很多時候需要根據(jù)一些條件來對數(shù)據(jù)進行篩選，點擊左上角新建報表，選擇填報報表，生成一張空白報表，設(shè)計好需要的查詢條件，例如：Figure 8在設(shè)計的時候需要統(tǒng)一一下樣式：從上往下，每行四個查詢條件，黑色小三

5、號字體。右擊查詢條件后面的空白格，選擇填報屬性們可以選擇編輯風(fēng)格，如所屬機構(gòu)、銀行大類這些條件，我們一般使用下拉數(shù)據(jù)集，通過數(shù)據(jù)集進行取數(shù)，可以分別設(shè)置顯示列和數(shù)據(jù)列。Figure 9比較常用的編輯風(fēng)格包括下拉日歷，下拉列表框以及普通的文本編輯框。通過配置查詢條件所在格的WEB變量名，可以在結(jié)果報表中通過相同的參數(shù)名獲得該單元格的數(shù)據(jù)。Figure 10在結(jié)果報表中，點擊配置參數(shù)，配置對應(yīng)的參數(shù)名Figure 11在這里配置好以后，我們在數(shù)據(jù)集中也需要配置參數(shù)，然后在sql語句中，使用“?”與該參數(shù)進行綁定。需要注意的是，sql語句中的?與參數(shù)中的參數(shù)是按照順序一一對應(yīng)綁定的，有幾個“?”就有

6、幾個參數(shù)，而且對應(yīng)順序要一致。如下圖，參數(shù)列表中第9，第10個參數(shù)為bankid，在sql語句中，對應(yīng)的剛好也是第9，第10個“?”Figure 12Figure 133-5 發(fā)布報表完成報表的設(shè)計之后，點擊右上方的“發(fā)布報表” ，可以將報表發(fā)布到指定路徑中。再點擊Internet圖標(biāo)，就可以在網(wǎng)頁中查看報了。Figure 144.常見問題及解決方案4-1 分組，排序經(jīng)常要對查詢結(jié)果進行排序和分組，報表工具自帶group語法，可以在sql里先用order by排好序，然后在報表工具里使用group進行分組。常用的select排序和group排序是：ds1.select（AAA，false，BB

7、B），從數(shù)據(jù)集ds1中獲取AAA字段，并根據(jù)BBB字段進行排序ds1.group（AAA，true），把數(shù)據(jù)集ds1中所有記錄按照AAA字段降序排列，然后根據(jù)AAA進行分組對組織進行排序，可以通過org_level和org_id兩個條件來排序。4-2 非必填查詢條件有時候查詢條件很多，使用的時候往往不是所有的條件都要輸入，這時可以在sql的判斷中加上 or ? is null。如圖12所示，對非必填的條件，加上 or ? is null，就可以在沒有傳該條件參數(shù)的時候也能查出數(shù)據(jù)。（如果條件為多選，設(shè)置的數(shù)據(jù)類型為“字符串組”，這種情況下如果寫 or ? is null 是會報錯的，這里提供一

8、種處理方法：在綁定參數(shù)的時候需要特殊處理，如下圖，typecode為多選條件的變量名，第一個變量為正常的字符串組變量，第二個變量特殊處理，如果為null時，賦值1，如果不是，賦值2，這樣在sql中判斷的時候，只要將 or ? is null 改為 or ? = 1即可完成對空值的判斷。這樣配置后，對應(yīng)的sql應(yīng)該寫成 and (code in (?) or ? = 1)）4-3 組織隔離需要對查詢條件中的“組織機構(gòu)”下拉框進行數(shù)據(jù)隔離時，可以這樣配置數(shù)據(jù)集：SELECT org_code|'-'|org_name namecode,org_id from tsys_organi

9、zation t where org_id in(SELECT org_id FROM tsys_organization start with org_id = nvl(? , '') CONNECT BY NOCYCLE PRIOR org_id = PARENT_ID)ORDER BY org_code“？”表示傳進來的expectedorgID，這樣就只能選到登錄用戶所在組織的本級以及下級組織。4-4 是否包含下級需要這個條件時，查詢報表需要添加一個下拉列表框，假設(shè)“1”表示“是”，“0”表示“否”,WEB變量名為“includesubs”，設(shè)置該單元格不能為空，則默認

10、選擇“是”。在結(jié)果報表的sql中，需要判斷的字段為id，可以參考下面的代碼：and ( (? is not null and ( (?='1' and id in(SELECT org_id FROM tsys_organization START WITH org_id =? CONNECT BY NOCYCLE PRIOR org_id = PARENT_ID) or (?='0' and id=?) or ( ? is null and ( (?='1' and id in(SELECT or

11、g_id FROM tsys_organization START WITH org_id =? CONNECT BY NOCYCLE PRIOR org_id = PARENT_ID) or (?='0' and id=?) )10個？對應(yīng)的參數(shù)為：Figure 15上訴代碼的邏輯是：如果選了“組織”條件，那么是否包含下級就根據(jù)這個組織來進行判斷，選是，就顯示該組織及下級的數(shù)據(jù)，選否，只顯示該組織的數(shù)；如果沒有選“組織”條件，則以登錄用戶的組織ID（expectedorgID）作為參考組織。4-5 中文傳參亂碼和無法分頁問題類似于開戶行這類查詢條件，由于數(shù)據(jù)太多，無法做成下拉的形式，就只能通過文本輸入進行模糊查詢，但是有時候發(fā)現(xiàn)報表工具在傳中文時會變成亂碼。