U9 前台调用 BP 范例说明 版 本 号 ：V1.0 作者：周仑 版本记录 【此部分要记录该文档形成过程中的历次版本变更过程及变更的内容】 版本 修改与参与人 修改时间 修改原因 修改概述 审批人1.0 周仑 2008/06/26 原始文档建立 1.0 周仑 2008/08/01 修改文档结构 1.0 周仑 2008/08/15 修改文档 一． 问题域说明 本文主要介绍前台调用 BP 时需要注意的事项。 二． 基本原理 前台访问后台的操作必须通过调用 BP 来实现，比如:UI 模型中数据通过通用 CRUD方式获取比较困难的情况,或者需要执行后台的业务逻辑的情况等。在此范例中的情况是:成本阶卡片页面维护数据时需要取得当前组织最低成本阶的信息，使用通用 CRUD不方便，故采用 BP 方式取数。 使用 BP 取数时应注意： 1． 设计 BP 时应尽量压缩 BP 参数返回值的字段数量，减少 BP 调用次数，以提高用户交互性能。 2． 禁止在 UI 端直接使用 Entity 对象，例如不能调用 EntityKey 的 GetEntity 方法，不能使用 EntityData 作为 BP 的返回值 三． 关键代码及说明 1. 完成取数 BP 的模型设计: BP 的名称:GetLastRecord 参数:OrgID 传入当前组织 数据类型为 long 返回值：LastRecordDTO 返回最后一条成本阶记录以及当前组织低价码最大值 BP 事务类型：Supported 对于取数 BP 应使用 Supported 类型，如果有数据更新操作，应使用 Required 类型 2. 完成 BP 策略代码的编写: public override object Do(object obj) { GetLastRecord bpObj = (GetLastRecord)obj; LastRecordDTO dto = new LastRecordDTO(); // 取最后一条记录的信息 CostLevel LastRecord = CostLevel.Finder.Find(" Org = @Org order by Level desc", new OqlParam(bpObj.OrgID)); if (LastRecord == null) { //取不到表示当前系统没有维护成本阶 dto.LastLevel = 0; dto.LastToLLC = -1; } else { dto.LastLevel = LastRecord.Level; dto.LastToLLC = LastRecord.ToLLC; } // 取最大低阶码 dto.MaxLLC = CostLevel.GetMaxLLC( new Organization.EntityKey(bpObj.OrgID)); //返回 dto 数据 return dto; }// public override object Do(object obj) 3. UI 项目添加对 BP 的引用： 由于前台调用 BP 时使用的代理方式远程调用，添加引用时所有代理方法接口文件是以 AGENT 结尾的，代理的数据接口文件是以 DEPLOY 结尾的，不可直接添加 BP 实现文件。 4. UI 代码添加对 BP 的调用： //创建BP实例 U9.CBO.MFG.CostLevel.Proxy.GetLastRecordProxy bpobj = new UFIDA.U9.CBO.MFG.CostLevel.Proxy.GetLastRecordProxy(); //为BP参数赋值 bpobj.OrgID = Convert.ToInt64(PlatformContext.Current.OrgID); //取BP返回值DTO LastRecordDTOData lastRecord = bpobj.Do(); 四． 源代码使用说明 下载: http://u9scm91/isvdoc/download/U9 研发体系（前台调用BP）.rar文件解压路径： 1. 后台 BP 模型路径: \\U9AppCode\U9.VOB.Apps.CBO\MFG\Model\MFGBP\CostLevel\ CostLevelBP.ubfbp 2. 后台 BP 代码路径： \\U9AppCode\U9.VOB.Apps.CBO\MFG\Code\MFGBP 3. 前台 UI 模型路径： \\U9UICode\U9.VOB.PD.CBO\MFG\Model\CostLevelUI 4. 前台 UI 代码路径： \\U9UICode\U9.VOB.PD.CBO\MFG\Code\CostLevelUI
