账表服务取数插件示例代码.docx

账表（服务取数）插件示例代码修订记录Ver. No日期编制\修订校对批准修改的章节号V1.020150415杨兵张晋博刘兵赖碧云初始版本问题和意见如果你对文档有任何意见、问题或想法，或者你的问题未在此文档中找到答案，请通过电子邮件联系我们jinbo_zhang@账表（服务取数）插件概要说明账表的服务端取数插件，是通过插件组装账表取数Sql指令，把取数结果返回给平台账表引擎，平台将取数结果绑定到账表页面的过程，简单说，平台在账表开发过程中，只负责把插件取到的账表数据绑定到设计好的账表模型上，取数逻辑由账表服务端插件完成开发过程中，有几个重要模型设计账表模型账表表头字段账表表体字段（也说成账表列头字段）设计账表过滤模型自定义快捷过滤面板高级过滤条件面板排序面板分组汇总面板显示隐藏列面板账表根据使用场景，分为简单账表、树形账表、分页账表、简单Sql账表简单Sql账表没有服务取数插件所有账表都须实现的重要事件InitializeBuilderSelectFieldSQLBuilderFromWhereSQLBuilderReportSqlAndTempTableGetReportTitlesGetReportHeadersGetSummaryColumnInfo分页账表特点：与简单账表区别在于，分页账表通过导航按钮切换帐表内容分页账表基本原理说明：需要提供用于导航的结果集，如下图中以语言标识为导航结果集（实现GetList方法）显示数据需要按照导航结果过滤（实现BuilderReportSqlAndTempTable方法）树形账表特点：树形账表通过树节点切换账表内容树形账表基本原理说明：需要提供用于导航树形结果集（ListTreeNode），如下图中以语言标识为树形结果集（实现GetTreeNodes方法）显示数据需要按照树节点结果过滤（实现BuilderReportSqlAndTempTable方法，使用CurrentGroupID重要属性作过滤条件）如何创建账表服务插件创建插件类库工程插件类库引用BOS平台组件（被引用组件在Cloud网站website\bin目录下）修改插件类库编译输出路径为website\bin（右键插件类库，选择属性）修改类文件继承基类，并引用基类所在命名空间如何启用账表服务插件插件编写完毕，类库编译通过后进入BOS设计器，打开对应账表模型，配置账表服务插件：公共属性BusinessInfo账表模型的元数据描述信息Context当前登录系统的上下文信息，如数据库连接信息，当前登录操作员信息等DctSpecialTempSumTable临时汇总数据表格DynamicHeader动态列头ReportHeader账表列头ReportId当前账表模型唯一标示ReportProperty账表属性，包含账表开发过程中的全局信息其重要属性说明：属性名描述ReportType账表类型（默认是简单账表、如果开发的是分页或树形帐表，请在账表插件初始化事件中，对此属性进行正确赋值，否则账表引擎会默认按简单账表处理页面）IsGroupSummary是否支持分组汇总IsUIDesignerColumns账表列头是否是通过BOSIDE设计SimpleAllCols是否锁定账表表格列DecimalControlFieldList精度控制字段信息DspInsteadColumnsInfo列表格式化列，指示Key列被Value列内容替代GroupSummaryInfoData分组汇总信息ReportTitles账表表头字段信息SummarySpecialFields汇总字段信息TempTableNameList临时表列表分页账表特有属性CurrentListPosition分页账表属性分页账表当前页账表数据对象的位置信息，此属性与CacheMapTempTableNameList属性一起使用CacheMapTempTableNameList分页账表属性记录分页账表每页账表数据对象信息，此属性与CurrentListPosition属性一起使用CacheDataList分页账表属性根据账表当前页位置，获取DataRow对象树形账表特有属性CurrentGroupID树形账表属性树形账表分组标识，点击树形账表左边树时，由平台账表引擎为其赋值，其数据来源于账表插件GetTreeNodes方法返回的树节点id属性的值，对应树形账表插件在BuilderReportSqlAndTempTable方法拼接账表取数sql时，需要以CurrentGroupID作为过滤条件拼接到Sql指令的Where部分事件Initialize触发时机账表View初始化，开始初始化账表服务取数插件代理对象时应用场景此时账表插件基类已完成账表属性对象（ReportProperty