EAS分析報(bào)表框架說(shuō)明

第1章簡(jiǎn)介本章是對(duì)分析報(bào)表框架的總述。1.1概述EAS分析報(bào)表框架（BIReport）一套分析報(bào)表基礎(chǔ)組件，它做了大部分非具體業(yè)務(wù)的工作，如查詢方案/打印/臨時(shí)表/維表操作等，使開(kāi)發(fā)人員能把精力更多地投入到業(yè)務(wù)相關(guān)的開(kāi)發(fā)工作中。開(kāi)發(fā)人員可通過(guò)繼承、引用相關(guān)組件快速完成分析報(bào)表的開(kāi)發(fā)。1.2分析報(bào)表預(yù)覽以下是分析報(bào)表的示例界面:1.2.1主頁(yè)面醒金蝶EAS-南車系統(tǒng)系統(tǒng)皆文件（D查看⑦工具CD幫助WB^|*?|%顯示圖形管圖形分析廣行列變換m排序頃；I功能菜單消息中心市場(chǎng)份■甄分析中標(biāo)單位中標(biāo)數(shù)量中標(biāo)金額1長(zhǎng)春軌道客車股份有限公司30匕400.002中國(guó)南車股份有F艮公司1501已600.003南車二七車輛有限公司4齊芥哈爾軌道交通撮備有限責(zé)任公司5長(zhǎng)春軌道客車裝備有限責(zé)任恣司6哈爾濱軌道立通裝備有限責(zé)任公司7中國(guó)北車集團(tuán)大連機(jī)車車輛有限公司1009,000.001.2.2顯示圖形1.2.3圖形分析1.2.4排序1.2.5篩選第2章開(kāi)發(fā)流程2.1框架描述2.1.1組成框架元數(shù)據(jù)：主界面UI：com.kingdee.eas.framework.bireport.client.BireportBaseMainUI.ui條件界面UI：com.kingdee.eas.framework.bireport.client.BireportBaseFilterUI.uiFacade功能對(duì)象：com.kingdee.eas.framework.bireport.app.BireportBaseFacade.facade維度配置文件：xml文件，放在與app/client同級(jí)的config目錄下。相關(guān)組件及輔助類。示例：com.kingdee.eas.framework.bireport.app.BireportSample2.1.2類圖2.2步驟概述2.2.1元數(shù)據(jù)設(shè)計(jì)設(shè)計(jì)主界面UI繼承BireportBaseMainUI，根據(jù)業(yè)務(wù)設(shè)計(jì)界面，要求至少有一個(gè)顯示數(shù)據(jù)的KDTableo設(shè)計(jì)條件界面UI繼承BireportBaseFilterUI，根據(jù)業(yè)務(wù)設(shè)計(jì)界面。設(shè)計(jì)功能對(duì)象繼承BireportBaseFacade,通常不再需要添加接口，除非業(yè)務(wù)上自身的要求。注意界面規(guī)范：邊界/Opx，組件間3px，詳見(jiàn)http://uiserver/2.2.2添加未實(shí)現(xiàn)方法Facade生成的ControllerBean通常要重載—init和readySchemaSource兩個(gè)方法，分別用于初始化條件查詢數(shù)據(jù)和準(zhǔn)備主頁(yè)面的維度數(shù)據(jù)。2.2.3配置維度文件config目錄下新建維度配置文件（xml格式，具體參考相關(guān)文檔），根據(jù)具體要求設(shè)計(jì)維度。2.2.4編寫(xiě)業(yè)務(wù)相關(guān)代碼通常包括處理查詢條件：初始化設(shè)置、方案存取等；主頁(yè)面：小標(biāo)題、打印格式、打印變量、自定義圖形等；ControllerBean準(zhǔn)備數(shù)據(jù)。直7:returnconnection直7:returnconnectionxecutemdx&showdataMainUIFi足「UlFacade□1:open>3:returniriitparams<:I4:onlnit:>n5:ok<W>r6:callreadySthemaSource>r第3章維度配置文件3.1多語(yǔ)言目前支持兩種實(shí)現(xiàn)方式單配置文件：里面使用屬性、變量來(lái)實(shí)現(xiàn)多語(yǔ)言。多配置文件，每種語(yǔ)言用一個(gè)文件，只需要寫(xiě)原始一份，通過(guò)插件將生成3份文件。3.2資源屬性、變量3.2.1使用資源屬性文件中指定BOS的資源對(duì)象名全路徑：<Resourcename="...''/><?xmlvei?sion=r,l.0,rencoding=,rUTF-8r,?><Schei[L.=i><Resou口:二ename=rrcom.kingdee.eas.framework.bireport.app.schema.Macr0Replacerrr/>定義屬性，格式為#{varname}<Dimensionname=,rBank,rcaption=rr#{bank}rrtable=rrBank,rprimaryKey="FID,r>如上圖例，則框架解析此文件時(shí)，將獲取MacroReplacer.resource的bank屬性替換#{bank}。3.2.2使用變量有兩種寫(xiě)法，在tag屬性值里，用${varname}在tag外面，用<Vrname=”...”/>,用于需要?jiǎng)討B(tài)變動(dòng)xml結(jié)構(gòu)的情況。如<Measurename=,r$(dyname}r,caption=rr${dycaption},rcolu<Varname=rrdymeasurerr/>服務(wù)端用SchemaSource#setMacroVklue(Stringkey,Stringvalue)方法設(shè)置變量。3.2.3某一維度統(tǒng)計(jì)<?xmlversion="1.0"encoding="UTF-8"?><Schemaname="room"><Parametername="Fact"type="table"/><Parametername="RoomModelType"type="table"/><Dimensionname="RoomModelType"caption="中標(biāo)單位"table="RoomModelType"primaryKey="FID"><Hierarchy><Levelname="RoomModelType"column="FID"><Propertyname="caption"column="FName"caption="FName"/></Level></Hierarchy></Dimension><Cubename="Fact"caption="Fact"table="Fact"><DimensionUsagename="RoomModelType"foreignKey="FCompetitorsNameID"/>〈Measurename="FCounter"caption="數(shù)量"column="FCounter"aggregator="sum"formatString="#,###"visible="false"/><Measurename="FAQty"caption="中標(biāo)數(shù)量"column="FAQty"aggregator="sum"formatString="#,###"visible="true"/><Measurename="FAAmount"caption="中標(biāo)金額"column="FAAmount"aggregator="sum"formatString="#,##0.00"visible="true"/></Cube></Schema>3.2.1多維度統(tǒng)計(jì)（注意紅字）<?xmlversion="1.0"encoding="UTF-8"?><Schemaname="room"><Parametername="Fact"type="table"/><Parametername="RoomModelType"type="table"/><Parametername="TrackModelType"type="table"/>(Dimensionname="RoomModelType"caption="中標(biāo)單位"table="RoomModelType"primaryKey="FID"><Hierarchy><Levelname="RoomModelType"column="FID"><Propertyname="caption"column="FName"caption="FName"/></Level></Hierarchy></Dimension><Dimensionname="TrackModelType"caption="產(chǎn)品類型"table="TrackModelType"primaryKey="FID"><Hierarchy><Levelname="TrackModelType"column="FID"><Propertyname="caption"column="FName"caption="FName"/></Level></Hierarchy></Dimension><Cubename="Fact"caption="Fact"table="Fact"><DimensionUsagename="RoomModelType"foreignKey="FCompetitorsNameID"/><DimensionUsagename="TrackModelType"foreignKey="FMaterialID"/><Measurename="FCounter"caption="數(shù)量"column="FCounter"aggregator="sum"formatString="#,###"visible="false"/><Measurename="FAQty"caption="中標(biāo)數(shù)量"column="FAQty"aggregator="sum"formatString="#,###"visible="true"/><Measurename="FAAmount"caption="中標(biāo)金額"column="FAAmount"aggregator="sum"formatString="#,##0.00"visible="true"/></Cube></Schema>3.3Schema翻譯插件Schema文件翻譯插件KingdeeToolkit_1.0.0.jar，獲取地址見(jiàn)后面的相關(guān)資源vss.［使用方法］如下圖，將生成3個(gè)xml文件：schema_L1.xml英文（需手工翻譯里面的多語(yǔ)言屬性）schema_L2.xml簡(jiǎn)體中文schema_L3.xml繁體中文TukerJilgi-Errur.jFilacruReplacet^.Echema.xml1.算冊(cè)臃?構(gòu)建路徑里）重構(gòu)（X）DeleteAlt+Shi￡t+TSchem:dJilacruF:ai-eBireportBaseFacade幽]導(dǎo)入(X)?-BireportBaseFacade導(dǎo)出(0)...BireportBaseFacadeBireportBaseFacadeBireportBaseFacadeBireportBaseFacadeBireportS:airipleFacaBireportS:airipleFacaBireportS:airipleFacaBireportS:airipleFacaTi1?LIT?F5復(fù)制CVS路徑簡(jiǎn)繁體字典能護(hù)ForpertyjT件簡(jiǎn)繁體轉(zhuǎn)換轉(zhuǎn)換SchemajT件為多語(yǔ)言運(yùn)行方式溟）此插件還提供屬性文件的翻譯，在形如—properties的文件上右鍵菜單可見(jiàn):3.4使用方法代碼只需要在RptXXXControllerBin里添加(分四步)：protectedSchemaSourcereadySchemaSource(RptParamsparams,Contextctx)throwsBOSException,EASBizException{SchemaSourcess=newSchemaSource();1、寫(xiě)查詢條件2、維度類型3、拼寫(xiě)SQL語(yǔ)句4、翻譯坐標(biāo)軸mdx.append("select{[Measures].Members}oncolumns,{[RoomModelType].members}onrowsfromFact");ss.setCaller(this.getClass());ss.setFilename(configFile);ss.setMdx(mdx.toString());returnss;}增加缺省圖片setShowDefaultChart(boolean)是否顯示缺省圖片(整個(gè)表數(shù)據(jù)對(duì)應(yīng)的圖片),在onBeforeQuery()中調(diào)用.addDefaultChart()顯示缺省圖片，在onAfterQuery()中調(diào)用，與setShowDefaultChart結(jié)合可按維度需求實(shí)現(xiàn)是否需要缺省圖片.增加自定義圖片在onAfterQuery()中編寫(xiě)代碼，如代碼說(shuō)明:addShowMember:設(shè)置需要顯示圖片的成員數(shù)據(jù)，第一個(gè)參數(shù)為維度名稱，第二個(gè)參數(shù)是成員名稱，均不區(qū)分大小寫(xiě).維度名與成員名需與mdx語(yǔ)句中的命名對(duì)應(yīng)addNotShowMember:設(shè)置不需要顯示的成員.注意：在同一維度上，不能同時(shí)設(shè)置addShowMember/addNotShowMember,只設(shè)置”顯示”成員，則其它成員(在圖片上)不顯示，只設(shè)置”不顯示”成員，則其它成員默認(rèn)顯示.setReverse(boolean):表示圖形是否顯示為當(dāng)前行列交換后的圖形(但表的顯示是不需要交換的)finishDataSet():表示圖片數(shù)據(jù)設(shè)置結(jié)束(必須調(diào)用且在最后)參考代碼:com.kingdee.eas.fm.fin.client.RptLCFrameAnalysisMainUI3.5臨時(shí)表的處理com.kingdee.eas.fm.birt.app.BirtBaseFacadeControllerBean提供，建議不要自己寫(xiě)創(chuàng)建/刪除臨時(shí)表的sql，因?yàn)榕R時(shí)表處理EAS系統(tǒng)有專門(mén)的管理：獲取臨時(shí)表名：getTempTableName使用o...創(chuàng)建臨時(shí)表及數(shù)據(jù)executeSelectInto>釋放臨時(shí)表dropTempTable3.6SQL執(zhí)行接口com.kingdee.eas.fm.birt.app.BirtBaseFacadeControllerBean提供：_executeQuery_executeUpdate3.7打印設(shè)置打印表頭格式方法protectedvoidpreparePrintPageHeader(HeadFootModelheader)返回打印表頭變量方法protectedMappreparePrintVariantMap()3.8輔助類的使用1.條件自動(dòng)存儲(chǔ)類RptConditionManager一般用法〃條件頁(yè)面：獲取條件publicRptParamsgetCustomCondition()(RptConditionManagerrm=newRptConditionManager();rm.recordAllStatus(this);returnrm.toRptParams();}〃設(shè)置條件publicvoidsetCustomCondition(RptParamsparams)(RptConditionManagerrm=newRptConditionManager(params);rm.restoreAllStatus(this);}［注］用最新的CustomerParams參數(shù)的接口，若要條件支持版本升級(jí)，則本輔助類無(wú)效，請(qǐng)自行處理?？蚣苣J(rèn)轉(zhuǎn)調(diào)最新接口到setCustomCondition(RptParamsparams)與RptParamsgetCustomCondition()，即使用此兩方法仍可用非字符竄對(duì)象作為條件，但條件方案相關(guān)類被修改(客戶升級(jí))后可能報(bào)版本不一致錯(cuò)誤。自動(dòng)存儲(chǔ)的條件獲取方法RptParams.getObjectElement("name.value");name為條件相應(yīng)控件的名稱，getObjectElement方法可以用屬性來(lái)訪問(wèn)其中的對(duì)象，如，name.value為com.kingdee.eas.framework.DataBaseInfo對(duì)象，取其編碼：RptParams.getObjectElement("name.value.number");擴(kuò)展用法示例publicRptParamsgetCustomCondition()(RptConditionManagerrm=newRptConditionManager();rm.recordAllStatus(this);rm.setProperty("companyIdSet",companyIdSet);bankIdSet=AccessHelper.getIds(AccessHelper.getF7Ids(jbpBank));rm.setProperty("bankIdSet",ban