操作插件示例代码.docxVIP

操作插件示例代码修订记录Ver. No日期编制\修订校对批准修改的章节号V1.020150420丁振华张晋博赖碧云初始版本问题和意见如果你对文档有任何意见、问题或想法，或者你的问题未在此文档中找到答案，请通过电子邮件联系我们jinbo_zhang@目录操作插件示例代码1操作插件概要说明3如何创建一个操作插件3操作插件概览5如何启用操作插件10公共属性13BusinessInfo13语法13案例 – 单据已经生成凭证则禁止反审核13Context15语法15案例 – 采购调价表审核时自动生效16FormOperation19语法19案例 - 销售订单保存不做信用检查19OperationResult21语法21案例 – 检查到负库存，提醒用户确认21Option23语法23案例 – 寄售结算单只在列表上审核时，需检查价格24基类虚方法，可捕获的事件25OnPrepareOperationServiceOption25语法25案例 – 初始化库存保存26OnPreparePropertys32语法32案例 – 采购价目表审核时，同步更新供应商价格33OnAddValidators35语法35案例 – 单据反审核时，生成凭证校验36BeforeExecuteOperationTransaction40语法41案例 – 销售价目表保存前更新数量区间价格41BeginOperationTransaction44语法45案例 – 反审核采购退货单，删除关联的内部交易单据45EndOperationTransaction48语法48案例 – 采购折扣表审核时，同步更新供应商折扣49AfterExecuteOperationTransaction51语法51案例 – 消耗汇总审核，提示同步生成的物权转移单编号52操作插件概要说明操作插件，用于对操作的执行过程进行干预、控制，以实现自定义扩展功能；如可以为审核操作，附加插件，在审核前，进行数据检查，只有符合条件的数据才允许审核；审核后，进行自动下推，并与审核操作保持在一个事务，如果自动下推失败，则审核回滚，确保数据的完整性。特别说明：请谨慎使用单据维护界面插件的BeforeDoOperate事件、AfterDoOperate事件，进行操作前后处理。单据维护界面的这两个事件，与操作本身并不是同一事务，如果在AfterDoOperate进行同步数据处理，如果处理失败，则无法回滚数据，从而造成数据不一致。如何创建一个操作插件创建类库工程，包含插件类定义引用如下类库（类库文件在K/3 Cloud站点目录\Bin\）必选的类库文件包括：Kingdee.BOS.dll;Kingdee.BOS.App.dll;Kingdee.BOS.BusinessEntity.dll;Kingdee.BOS.Contracts.dll;Kingdee.BOS.Core.dll;Kingdee.BOS.DataEntity.dll;在类库中添加一个插件类操作插件概览如下是一个典型的操作插件定义代码：C#?using System;using System.Collections.Generic;using System.Linq;using System.Text;using Kingdee.BOS;using Kingdee.BOS.Util;using Kingdee.BOS.Core.DynamicForm.PlugIn;using Kingdee.BOS.Core.DynamicForm.PlugIn.Args;namespace SamplePlugIn.ServicePlugIn{ /// summary /// 操作服务端插件示例 /// /summary /// remarks /// 1. 示例如何强制要求加载某字段 /// 2. 示例如何注入校验器，校验器可以通用，为避免在各操作中重复编码，剥离出来，然后各操作注入剥离出的校验器 /// 3. 说明一些关键事件的用途 /// /remarks [System.ComponentModel.Description(操作服务端插件示例)] public class OperationPlugSample : AbstractOperationServicePlugIn { /// summary /// 操作初始化时，确认操作执行参数 /// /summary /// param name=e/param public override void OnPrepareOperationServiceOption(OnPrepareOperationServiceEventArgs e) { base.OnPrepareOperationServiceOption