潤乾報表入門

1、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ù)會提到），會提示我們需要lie文件，就是下圖中的兩個lie文件。*> 't,.咅 T. H叫吐.d丘丹一帝匠卩，心-irrrI. niRir®?: r iTi二，m斫曰討.羋（：

2、 “ft_ _r B .* 叫 ” IJ w ；、J _ 如I- .111 'ri L'dl i/v-&站（S I匕-ifcnBflccjFigure 13.報表工具的使用3-1配置數(shù)據(jù)源使用報表時需要先對數(shù)據(jù)源進行配置:nil* .Figure 2選擇新建一個數(shù)據(jù)源:Utl名豺物e涯Itluwt LJT眞R性 1trttfWrOPOtllr icpi-HI-iracip Mbr drtwf OracleOf-ve-H議撮沖-RL：注M摘話W中前內(nèi)古pbc匚險1日怖的他60 uaw 121畑maiT用戶口會shiiae1U轉(zhuǎn)B.feTtS石宇.''橢掛槍

3、髦raSTiJi L劃丐*8-&表一甘ifi-麒韋年式毎抵鋼I 8（甲苓引尋的粗L匸總T均Figure 3項目中默認(rèn)使用的數(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è)計好報首先新建一張報表，直接點擊左上角工具欄上的表名名

4、、列名。如下圖， 這里提供一種樣式當(dāng)做參考模板，如客戶無特殊需求，希望各開發(fā) 按照統(tǒng)一的樣式標(biāo)準(zhǔn)進行設(shè)計，有助于提高所有報表的統(tǒng)一性，后面還會提到一些規(guī)范， 希望大家也可以遵守起來。6Figure 4報表名這一行，采用黑色、二號字，加粗。列名采用白色、三號字，加粗， 背景色使用淡紫色（顏色相近即可）。若每一列下面還要分列，則使用黑色、小 三號字，結(jié)果數(shù)據(jù)使用黑色、四號字。z?Jl Uua樣品RHP；85選擇糊色170<3時幵戶闔點；85es丨W1TC255Q,25511170磧守s-t-口 y EFigure 5設(shè)定好報表樣式后，完整顯示的，要選擇“按單元格內(nèi)容擴大”開始根據(jù)邏輯進行取數(shù)

5、， 設(shè)置每一列的寬度時, ，并去掉“自動換行”。如果需要在一行中U-±|'laK性名禰ti表尺寸調(diào)整方式"亠P值_Btf 可視隱藏列'W>S按單元格內(nèi)g擴大Figure 6D - ET 兇戢£集設(shè)畫I審田t /fi ,；i顯羨b I _I|7J-沁林 荊it訥星 夏爭泗 Te儀件 XML丈辟 巧諸揄掘_ 丑目膜自字* ft MS 距亂卿!匚n日期=0貂.qiftBop gne£33*1 VVEE 語麗FC M+E，F(xiàn)igure 7在“語法”中輸入 sql語句，獲得我們想要的查詢結(jié)果:報表通過配置的“數(shù)據(jù)集”進行取數(shù)。點擊配置一數(shù)據(jù)集

6、，新增一個數(shù)據(jù)集，大部分邏輯, 通過sql檢索即可完成，若遇到比較復(fù)雜的也可以使用存儲過程。IS定楓式 ANOMVMOUS5Q備理器碩h 撾時陽計筋片 壬麗廠j排帛毎薛'一豐帥twi匚-卓他'然后在報表中通過數(shù)據(jù)源名.select （列名），即可獲得我們要的數(shù)據(jù)，select方法還提供了排 序等功能，詳 細(xì)用法可 以參考安 裝安裝包 安裝包，幫助文檔，使用手冊 報表設(shè)計 潤乾報表4.5用戶手冊.chm,通過搜索關(guān)鍵字，可 以了解相關(guān)的功能，開發(fā)的時候可以多使用這個手冊。3-4很多時候需要根據(jù)一些條件來對數(shù)據(jù)進行篩選，點擊左上角新建報表，選擇填報報表, 生成一張空白報表，設(shè)計好需

7、要的查詢條件，例如：Figure 8在設(shè)計的時候需要統(tǒng)一一下樣式： 從上往下，每行四個查詢條件，黑色小三號字體。右擊查詢條件后面的空白格，選擇填報屬性們可以選擇編輯風(fēng)格，如所屬機構(gòu)、銀行大類這些條件，我們一般使用下拉數(shù)據(jù)集，通過數(shù)據(jù)集進行取數(shù)，可以分別設(shè)置顯示列和數(shù)據(jù)列。mT 二匚二I創(chuàng)巴上. WjJ_1 -Z.l_L' U = Oj LL E f II 'K « 9 HDi iln ji嚴(yán)小.plj '： Vt- 'Vr-f tlC' ik.'. ITL jb /：L r iJl_ 腫1 4幵戶日wat10ttMXeraL1i14去&

8、quot;Tift亠frJWF-'i'CFHt列171崎t|OR5=ICW1J1fl柵18岀9L|Tj7»nia祀1-s話X 7«當(dāng)-W©輛:;at脅逋自如ItXI穴廉墻L rs詐就（Ii"i花許空誼1 用馮I3E -irFigure 9比較常用的編輯風(fēng)格包括下拉日歷，下拉列表框以及普通的文本編輯框。通過配置查詢條件所在格的WEB變量名，可以在結(jié)果報表中通過相同的參數(shù)名獲得該單元格的數(shù)據(jù)。1075 、口；-屜1 城是否有敢磁戶:銷戶日期從:Figure 10在結(jié)果報表中，點擊 配置一參數(shù)，配置對應(yīng)的參數(shù)名A側(cè)« ryHTMLlf

9、t性兇B-團4報衰W幵:版tS生電子呼叫中心產(chǎn)品】 jaVJ;wrnp/enw/jidbc/ePayJJ*A<!) iBiEtD卓換炯心鰻辜帥已ver-ort L-'leii lift flartaFgla期n0uds伽ndd帕H« 100門闿臺3112aroi曰期Q0ilA 胡dsl&tnd刖00:iiA££rOrgijd占 ihg5虧再00nincludesubs5(400tBilM計eifpecl EaartflD日5-F iJb 壬tls0'c普iir閩draB0c春!1羞就,b jnF.pdHr學(xué)訪審0D1tBa薈君'

10、;'arcgiinBYpeida neeQ 01育d斟忤跆 a«lsS0SM« 層式 M袞 1fi酈I flhtt 兇旬代碼1 .selectWWO I£5® I兇；aw ；_'n' Cih DI&賬戶:dsl.accounFigure 11在這里配置好以后，我們在數(shù)據(jù)集中也需要配置參數(shù)，然后在sql語句中，使用“ ？”與該參數(shù)進行綁定。需要注意的是，sql語句中的？與參數(shù)中的參數(shù)是 按照順序一一對應(yīng)綁定的，有幾個“ ？”就有幾個參數(shù)，而且對應(yīng)順序要一致。如下圖，參數(shù)列表中第9，第10個參數(shù)為ban kid，在sql語句中

11、，對應(yīng)的剛好也是第:廠叮犀，禺a(chǎn) 圏問呵9，第 10 個“ ？ ”UI *!111| T；詐甚 口勺三刃L編轄辭存BUI廠炳3Ma果計:Jjte6tjrt2dd.le&Ea12barkidflbankidset=ds1*ognai*7aCCDUriltVpeidl牯*孝型tra 日期 日期 日期ddlAprtd? rtalftencj敲棚fl記暈行設(shè)矍嚴(yán)I «»?膛fe當(dāng)尋住 押庫iR圭naieern11 甘12 _ %胡険 USM回上移®卜4兇也L唾宣 pjJol'niiaoDSfrth¥T4Sac; quAlk pgirt0吃=疋 i

12、fifiudaUBS«-5 -5 ft- J1n_ 畠5 3 fl _s印一小甸一"希翎WteiL.fl豐二»他盤!T lr, TFigure 12SQUtiS畀;赴HE表1數(shù)ffl字慢j計算列'遇呈雖件善黒'語遶I更散_It) *_$ubk附膽 n una ortt)c_$Mbi(eyifeiii acienintappWflwMEs 梟I (select oEd咅eI sfheriicfluintni 0 Uienelse"lit D untnentJ)Trom WlobsWrag tb iMieretb 匚taTsloa like

13、TtACCOJLJT%' ana 1)5 f_M)e='7' and(Wi.f_sui3kevi(i ifi(seieciii.ufi(i fromLac c Q umapioiie g tiwnre ttatco uriiwm lurid nd n 叭 me states '2 F or lb f_su&keviid=i1 urm ortb c_siibJ<eiici=i1l 心Qurit叩ph 沾id捕 trpe7 from LacfounT? rl,t$s_orflaftiia!ion t2,LiJani(l orations t3 wher

14、e tl orgl(l=t2 orgjd and t1 b3nklocalicinjd=d ufidand (11 .daleopened*- & w ? is nuMand(11 .daleopien<)*-'? oria nuh>and Ct1 .datecl05ed>-? or ? is nujhJand nl Maier lose(=二？ or 寧 la niui"jntJ KI .bankicl in (selecil *hcp，'',) ot ? isnull)|and ffV-'l 'and tT Kco

15、untlts lirii 3)i or (7=11" and tl aecounfsIaTe iM】/.工M? 19 nulljand Ct1 .MCDunttvpeid in®R|0廿 * from table'.y)! qf *? i$ mu町他 11式 AWOMVMOUSFigure 13昭滇(0)土郢 土擴R卜 I-WEB-'HtTWLB f tlT * M他I ftWS匚瓷耳煜刪BSA dsiA a參離，可以將報表發(fā)布到指定路徑中。3-5發(fā)布報表11 3屬性宅稱.值,表迖式，F(xiàn)igure 14完成報表的設(shè)計之后，點擊右上方的“發(fā)布報表” 再點擊In

16、 ternet圖標(biāo)，就可以在網(wǎng)頁中查看報了。第二個 賦值1'如果不是，賦值 2'這樣在sql中判斷的時候， 即可完成對空值的判斷。這樣配置后，對應(yīng)的sql應(yīng)該寫成 '1 ）4.常見問題及解決方案4-1分組，排序經(jīng)常要對查詢結(jié)果進行排序和分組，報表工具自帶group語法，可以在sql里先用orderby排好序，然后在報表工具里使用group進行分組。常用的 select排序和group排序是：ds1.select（ AAA，false，BBB），從數(shù)據(jù)集ds1中獲取AAA字段，并根據(jù) BBB字段進行排序 ds1.group （ AAA，true），把數(shù)據(jù)集ds1中所有記錄

17、按照 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是會報錯的，這里提供一種處理方法：在綁定參數(shù)的時候需要特殊 處理，如下圖，typecode為多選條件的變量名，第一個變量為正常的字符串組變量， 變量特殊處理，

18、如果為null時， 只要將 or ? is null改為 or ?=and （code in or ?=）4-3組織隔離需要對查詢條件中的“組織機構(gòu)”下拉框進行數(shù)據(jù)隔離時，可以這樣配置數(shù)據(jù)集：SELECTorg_code -'|org_namenamecode,org_id from tsys_organization t where org_idin( SELECT org_id FROM tsys_orga nization start with org_id = nvl(? , '6000001')CONNECT BY NOCYCLE P RIOR org_id

19、= PARENT_ID)ORDER BY org_code“？”表示傳進來的expectedorgID，這樣就只能選到登錄用戶所在組織的本級以及下級組織。4-4是否包含下級需要這個條件時，查詢報表需要添加一個下拉列表框，假設(shè)“1 ”表示“是”，“0”表示“否”，WEB變量名為“ includesubs ”，設(shè)置該單元格不能為空，則默認(rèn)選擇“是”。在結(jié)果報表的sql中，需要判斷的字段為 id，可以參考下面的代碼：and (in( SELECT org_id FROM(? is not null and ( (?-1' and id tsys_orga ni zat

20、i on START WITH org_id =?CONNECTBY NOCYCLEP RIOR org_id = P ARENT_ID) or (?='O' and id=?) orin( SELECT org_id FROM(? is null and ( (?-1' and id tsys orga nization START WITH org id =?CONNECTBY NOCYCLE16orgjd手符串17imcludesuhs'寧符串18orgjd字苻串19includesubs20orgjd字符串21orgjd字符串22includesubsI寧符串23e