k3cloud单据插件
命名空间
Kingdee.BOS.Core.Bill.PlugIn
继承体系
System.Object
Kingdee.BOS.Core.DynamicForm.PlugIn.AbstractDynamicFormPlugIn
Kingdee.BOS.Core.Bill.PlugIn.AbstractBillPlugIn
Kingdee.BOS.Core.Base.PlugIn.AbstractBasePlugIn
接口
IBillViewPlugIn
单据视图的插件接口,继承自IDynamicFromViewPlugIn,扩展了初始化接口和单据转换接口。
Name | Description | |
OnBillInitialize | 单据页面初始化事件 | |
OnGetConvertRule | 选单/下推过程, 确定单据转换规则 | |
OnShowConvertOpForm | 选单过程,展示可选源单据;捕获此事件,调整可选的单据类型 | |
OnShowTrackResult | 上/下查过程,获得上/下查结果;捕获此事件,调整上/下查结果 |
OnBillInitialize
单据初始化插件,在OnInitialize后调用。OnInitialize是继承自动态表单的方法,主要应用在动态表单中已介绍。 OnBillInitialize中主要是加载单据参数BillOpenParameter,该参数继承自DynamicFormOpenParameter。
可以在OpenParameter增加自定义参数。例如:
获取参数,设置单据的显示标题,初始化状态变量。
C# | |
public override void OnBillInitialize(BillInitializeEventArgs e) { //取参数 _billTypeId = this.View.OpenParameter.GetCustomParameter("FBillTypeId"); //设置单据标题 this.View.SetFormTitle(this.View.BillBusinessInfo.GetForm().Name); //获取当前操作状态 _curOperationStatus = e.Paramter.Status; base.OnBillInitialize(e); } |
调用方传递CustomParameter方法如下:
C# | |
BillOpenParameter billParam = new BillOpenParameter(); billParam.FormId = K3.Core.SCM.SCMFormIdConst.BD_SerialMainFile; billParam.SyncCallBackAction = true; billParam.ParentPageId = this.View.PageId; billParam.PageId = Kingdee.BOS.Util.SequentialGuid.NewGuid().ToString(); billParam.Status = stats; billParam..CustomParams.Add("FBillTypeId", this.BillTypeId); this.View.ShowForm(billParam); |
IBillModelPlugIn
单据模型的插件接口,继承自IDynamicFromModelPlugIn,提供单据特殊操作。
Name | Description | |
AfterCopyData | 复制单据完毕后事件 | |
AfterLoadData | 业务对象加载后的扩展接口 | |
AfterSave | 调用应用服务保存成功后触发 | |
AfterSetStatus | 设置单据状态后调用 | |
AfterSubmit | 调用应用服务提交成功后触发 | |
BeforeSave | 调用应用服务器,提交数据保存前触发 | |
BeforeSetStatus | 设置单据状态前调用 | |
BeforeSubmit | 调用应用服务器,提交前触发 | |
CopyData | 复制单据 | |
LoadData | 加载业务对象扩展接口 | |
SaveBillFailed | 调用应用服务保存失败,出错时触发 | |
VerifyImportData | 数据导入校验 |
BeforeSave
单据保存前插件。单据内置保存操作,自动将修改数据保存到数据库。插件BeforeSave可以在保存前对单据数据进行处理。通常处理有两个:
数据校验;
计算和更新数据;
在BOS平台当客户端发起请求,到web服务器后,领域模型框架调用运行时,加载插件运行。用户执行操作时,运行时调用操作服务进行数据模型的操作。而插件中调用服务也是先向服务框架请求服务。
通常应用都是在业务保存前进行数据校验,校验通过后,调用保存服务保存,在大多数系统中都是这样应用。在BOS平台中,架构设计上支持集成服务,所有操作都是设计有服务接口,二次开发可以很容易将所有操作发布成服务供外部系统调用。这样对外部系统来说,调用服务保存将会很容易。但如何保证数据的正确性?大部分设计是由外部系统保证,但对复杂业务系统来说,外部系统很难保证每个业务数据的正确性,甚至用大量访问系统来获取验证数据。为此,BOS平台在操作上提供了校验服务,这样在系统内部通过插件调用服务前会自动执行校验服务。而外部系统访问的是BOS操作发布的服务本身也带有校验。
因此建议将数据校验按业务逻辑分开成两类,一类是界面输入校验,如字符、数字类型、格式化和表达式校验等,可以在插件保存前进行校验;而数据业务的校验,如库存校验信用检查等,通过校验服务校验。
校验方法如下:
1. 优先通过IDE配置校验数据,如输入格式,最大最小值限定;
2. 操作控制类校验在表单的操作前插件检查;
3. 业务控制类校验在表单校验服务校验。
该事件中可以通过设置参数的Cancel终止保存操作。
下面例子是保存前更新数据(信用评分单据保存设置信用等级标准)。
C# | |
public override void BeforeSave(BeforeSaveEventArgs e) { DynamicObject doGradeScheme = this.Model.GetValue("FScheme") as DynamicObject; decimal deSumScore = Convert.ToDecimal(this.Model.GetValue("FSumScore")); int iGradeSchemeId = Convert.ToInt32(doGradeScheme["Id"]); // 保存前判断当前信用评分表的综合得分属于哪一个信用等级标准 DynamicObjectCollection docGrades = CreditServiceHelper.GetCreditGrades(this.Context, 0, iGradeSchemeId); for (int i = 0; i < docGrades.Count(); i++) { DynamicObject doGrade = docGrades; decimal deScoreFrom = Convert.ToDecimal(doGrade["FSCOREFROM"]); decimal deScoreTo = Convert.ToDecimal(doGrade["FSCORETO"]); if(deSumScore >= deScoreFrom && deSumScore <= deScoreTo) { this.View.Model.SetValue("FGrade", Convert.ToInt32(doGrade["FID"])); this.View.Model.SetValue("FSuggestion", doGrade["FDESCRIPTION"]); } } } |
AfterSave
单据保存后插件。主要用于保存后界面的控制、控件的显示以及不需要事务保证的其他数据更新。
BeforeSubmit(提交前)和AfterSubmit(提交后)事件与保存类似,不再做介绍。
免责声明:
① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。
② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341