k3cloud单据插件

2023-01-31 03:01:24 插件 单据 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（提交后）事件与保存类似，不再做介绍。

 

相关文章