《金蝶EAS_BI报表框架使用说明》.docVIP

EAS_BI报表框架使用说明 简述 报表框架模块名称：fm_birt 报表框架做了大部分非具体业务的工作,如查询方案/打印/临时表/维表操作等，使开发人员能把精力更多地投入到业务相关的开发工作中。 BOS对象设计 界面设计 主页面继承com.kingdee.eas.fm.birt.client. BirtBaseMainUI.ui 条件查询页面继承com.kingdee.eas.fm.birt.client.BirtBaseFilterUI.ui 功能对象继承 com.kingdee.eas.fm.birt.BirtBaseFacade.facade 命名约定：使用加粗部分作为后缀。 注意, 使用该框架的各模块最好自己加一层基类, 实现业务上的扩展. 如资金组的基类FmbiRptBaseMainUI(扩展)( BirtBaseMainUI 代码基本流程 1--用户点击菜单进入 2--客户端准备初始数据getParamsForInit(),如果返回null, 转入第4步 3--服务端取初始数据init,参数为上一步getParamsForInit()返回值 4--客户端条件查询设置setCustomCondition,参数为上一步init返回值 5--用户点击确定查询 6--调用客户端主界面query方法,查询条件在属性params里,该params是条件界面getCustomCondition()返回的. 编码说明 必要的重载 UI类实现abstract方法(Eclipse里ctrl+1，选择添加未实现的方法)，各方法说明可参考父类注释。 session bean 根据需要重载父类方法，通常只需要_ini和readySchemaSource两个方法。 数据准备 服务端准备数据方法(重载)： protected SchemaSource readySchemaSource(RptParams params, Context ctx)throws BOSException, EASBizException{ //返回SchemaSource对象，里面的属性均需要设置。 … } Schema文件及宏定义 Schema配置请参考相关文档，放在config目录下，config与app/client同级。 ? 1)宏定义：在config.xml中，型如${XXX}$。 2)设置宏值：SchemaSource#setMacroValue(String ?key,String ?value) ? 配置文件 ?xml ?version=1.0 ?encoding=GBK? Schema Parameter ?name=${MyTable}$ ?type=Table/ Parameter ?name=Fact ?type=Table/ ? Dimension ?name=${MyTable}$ ?caption=基期/期末 ?table=${MyTable}$ ?primaryKey=fid ??? Hierarchy ??? Level ?name=PeriodType ?column=fname ? ??? Property ?name=name ?column=fname/ ??? /Level ??? /Hierarchy /Dimension ? Cube ?name=fm ?caption=信用证结构分析 ?table=Fact ??? DimensionUsage ?name=${MyTable}$ ?foreignKey=${MyFK}$/ ??? Measure ?name=FAmount ?caption=金额 ?column=FAmount ?aggregator=sum ?formatString=#,##0.00/ /Cube /Schema ? 代码中设置宏 SchemaSource ss=... ss.setMacroValue(MyTable, PeriodType); ss.setMacroValue(MyFK, FPeriodTypeID); ? 也可以动态添加维度。 ? 客户端处理 实现父类的abstract方法。――具体功能查看父类代码注释 与数据有关常用的三个地方： onBeforeQuery里设置标题 设置打印格式和变量 重载处理单元格事件处理方法(用于联查) 全局变量及主要方法说明 protected RptParams params=null; 查询条件弹出对话框返回的查询条件，常用 initWorksheetComponentStyle(ComponentConfig config) 设置显示格式，查询/刷新时调用，