命名空间 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，扩展了初始化接口和单据转换接口。
OnBillInitialize单据初始化插件，在OnInitialize后调用。OnInitialize是继承自动态表单的方法，主要应用在动态表单中已介绍。 OnBillInitialize中主要是加载单据参数BillOpenParameter，该参数继承自DynamicFormOpenParameter。可以在OpenParameter增加自定义参数。例如：获取参数，设置单据的显示标题，初始化状态变量。
[tr][td]C#
[td]
[tr][td=2,1]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方法如下：
[tr][td]C#
[td]
[tr][td=2,1]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，提供单据特殊操作。 BeforeSave单据保存前插件。单据内置保存操作，自动将修改数据保存到数据库。插件BeforeSave可以在保存前对单据数据进行处理。通常处理有两个：Ø 数据校验；Ø 计算和更新数据；在BOS平台当客户端发起请求，到web服务器后，领域模型框架调用运行时，加载插件运行。用户执行操作时，运行时调用操作服务进行数据模型的操作。而插件中调用服务也是先向服务框架请求服务。通常应用都是在业务保存前进行数据校验，校验通过后，调用保存服务保存，在大多数系统中都是这样应用。在BOS平台中，架构设计上支持集成服务，所有操作都是设计有服务接口，二次开发可以很容易将所有操作发布成服务供外部系统调用。这样对外部系统来说，调用服务保存将会很容易。但如何保证数据的正确性？大部分设计是由外部系统保证，但对复杂业务系统来说，外部系统很难保证每个业务数据的正确性，甚至用大量访问系统来获取验证数据。为此，BOS平台在操作上提供了校验服务，这样在系统内部通过插件调用服务前会自动执行校验服务。而外部系统访问的是BOS操作发布的服务本身也带有校验。因此建议将数据校验按业务逻辑分开成两类，一类是界面输入校验，如字符、数字类型、格式化和表达式校验等，可以在插件保存前进行校验；而数据业务的校验，如库存校验信用检查等，通过校验服务校验。校验方法如下：1. 优先通过IDE配置校验数据，如输入格式，最大最小值限定；2. 操作控制类校验在表单的操作前插件检查；3. 业务控制类校验在表单校验服务校验。该事件中可以通过设置参数的Cancel终止保存操作。下面例子是保存前更新数据（信用评分单据保存设置信用等级标准）。
[tr][td]C#
[td]
[tr][td=2,1]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[i]; 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"]); } }}
[/i]
AfterSave单据保存后插件。主要用于保存后界面的控制、控件的显示以及不需要事务保证的其他数据更新。BeforeSubmit（提交前）和AfterSubmit（提交后）事件与保存类似，不再做介绍。
