K3+Cloud+BOS开发培训_插件开发1-接口

1、架构模型展示层Siterlight VYebPI WPF其亞言円Httr Http 嘩二宁建羊应总厂动态表单元慕据动态表单领域模型动齐表单理聖羊据祎年过摊条桂昨余愎型表甲垮出哥岳动态丟单向显燮口 |：話单早础帘料亩军骤日表 列表过遥条件捌食模妲jjy 壬Tl简单账表悔形账表插件开发步骤定义插件类（参照继承体系）；分析业务定义重载方法；引用相关组件（参照组件引用规则）；重载方法编码； 设置编译路径，编译组件； 打开 IDE 设计器，配置插件； 动态表单视图接口IDynamicFormViewIDynamicFormViewService2 个重要的属性BusinessInfoLayoutInfo

2、界面元素访问1、访问菜单 this.View.GetMainBarItem this.View.GetBarItem2、访问表单控件 this.View.GetControl this.View.GetView3、访问字段 this.View.GetFieldEditor this.View.LockField this.View.SetFormTitle4、执行操作ShowFormUpdateViewInvokeFieldUpdateService动态表单模型接口IDynamicFormModelIDynamicFormModelService属性BusinessInfoDataObject

3、数据操作CreateNewDataCreateNewE ntryRowIn sertE ntryRowGetE ntryCurre ntRowl ndexLoadRefere nceDataGetValueGetE ntityDataObject动态表单插件命名空间：Ki ngdee.BOS.Core.Dy namicForm.Plugln抽象类：AbstractDynamicFormPlugln业务模型类（插件）继承自抽象类表单插件单据插件Kin gdee.BOS.Core.Bill.Plugl n.AbstractBillPlug In基础资料插件Kin gdee.BOS.Core.Bas

4、e.Plugl n. AbstractBasePlugln动态表单插件Kin gdee.BOS.Core.Dyn amicForm.Plugl n. AbstractD yn amicFormPlugln列表插件列表插件Kin gdee.BOS.Core.List.Plugl n.A bstractListPlugln接口IDyn amicFormViewPlugl nIDy namicFormModelPlugln加载机制Onln itializeCreateNewData / AfterCreateNewDataBeforeBindData / AfterBindDataBeforeClo

5、sed表单操作BeforeDoOperation / AfterDoOperationBeforeF7Select / AfterF7SelectTabItemSelectedChange表单事件BarItemClickEntryBarItemClickToolBarItemClickButtonClickEntityRowClickEntityRowDoubleClickEntryButtonCellClick模型访问操作BeforeUpdateValueBeforeDeleteRowAfterDeleteRow单据插件 （基础资料插件 ）继承自动态表单!: ZDynami cFoirrnM

6、odelFlugliLIDynm i 匚F QirmV i ewFla$zv IHateTr intriuglnj4 冲 stgmynmmleFhE PJugfl/TTEillViTEillModelPliigTAb Uhct Cl TLi s tVi ewFlu.ginTLi 5 tM o de 1P1 uigliMAbstr actLi 占tFLxiLii皆产 T 0 U L_ V 吕 nT jbiSTz-actD yTi 三二 i zF dxzdP lizg Zji_ 丿47Ab a tzra e t 1 a esH| A b s t z- ac t L-yn Hzzz cFozziPL

7、izgZrii ： IBseVii&wFlugliiIE isModelPluglni接口IBillViewPlugl nOn Billl ni tialize参数 BillOpenParameterIBillModelPluglnBeforeSave / AfterSaveBeforeSubmit / AfterSubmit列表插件继承自动态表单ZDynani FoirinModlFluXTi IDynani cFcrmYi ewFIngin Iijf teFr intFluglnZLi s t V i feFl.gZriXLi EinQeir*J.jgilzkIBillVi el lugl

8、ntract Cl ae&f Ab s t r * c 1cFr=f LuElr：Q IE asPluginIE 注 mdelFluglTtAit处#少齐&Ab t r ac t Cla-T Abst*ae-ELliPli-ElB接口IListViewPluglnOn List In itialize参数 ListOpenParameterAfterGetDataFormatCellValueIListModelPlugl nPrepareFilterParameterBatchCopyData过滤条件插件接口IListFilterViewIListFilterModelFilterObjec

9、tQuickFilterObjectIsolationOrgId GetFilterField事件OnParseSettingFireBeforeBindFilterMetadataFireBeforeSelectTreeNodeScheme命名空间：Kingdee.BOS.Core.DynamicForm.PlugIn抽象类：AbstractOperationServicePlugIn继承体系 :（继承自抽象类 ）Kingdee.BOS.Core.DynamicForm.PlugIn.AbstractOperationServicePlugIn接口IOperationServicePlugI

10、nBeforeExecuteOperationTransaction AfterExecuteOperationTransaction BeginOperationTransaction EndOperationTransaction校验服务IOperationServicePlugInOnAddValidatorsSaveValidator : AbstractValidatorValidate表单插件和列表插件继承层次表单 单据 叙事簿 基础资料插件针对对象动态表单单据基础资料Kingdee.BOS.Core.dllAbstractBillPlugIn接口AbstractBillPlugI

11、n 的 ViewPlugin 插件接口OnBillInitialize视图模型初始化事件AfterBindData绑定数据后事件处理接口BeforeF7Select基础资料弹出前事件BeforeClosed窗口关闭前事件BarItemClick菜单单击事件处理扩展接口AfterBarItemClick菜单单击事件后BeforeDoOperation操作调用前事件AfterDoOperation操作调用完成后事件ButtonClick按钮单击事件AfterButtonClick按钮单击后事件ListViewClick列表项目单击事件TreeNodeClick树控件单击事件TreeDragDrop

12、树控件拖拽EntityRowClick分录行单击事件AbstractBillPlugIn 的 ModelPlugIn 接口 动态表单数据模型插件编程接口 定义了数据模型扩展 允许通过接口处理数据，以实现特定业务需求AbstractBillPlugIn 插件方法CreateNewDataAfterCreateNewData BeforeUpdateValue DataChanged CreateNewEntryRow BeforeDeleteRowAfterDeleteRow数据模型创建实体对象事件 数据模型创建实体对象完成后事件 数据更新前事件 数据改变后事件 创建分录行事件 删除分录行事件

13、删除分录后事件叙事簿插件接口AbstractListPlugIn 序时簿视图插件编程模型接口 定义了序时簿视图模型扩展 允许通过接口处理视图，实现特定业务需求 ListInitialize AfterGetData的 ViewPlugIn 接口FormatCellValueBeforeButtonClickAfterButtonClickCellDbButtonClick视图模型初始化事件 完成取数后事件 列表格式化接口 按钮和菜单单击前事件 按钮和菜单单击后事件 单元格双击事件AbstractListPlugIn 的 ModelPlugIn 接口 序时簿数据模型插件编程接口 定义了序时簿数据

14、模型扩展允许通过接口处理数据，以实现特定业务需求PrepareFilterParameterCreateFilterEditorControlBatchCopyDataAfterBatchCopyData 准备过滤条件 触发创建过滤条件控件事件复制单据事件 复制单据完毕事件服务插件插件特性IOperationServicePlugin 一般会附加校验器 运行于 App 层 事务保护插件针对对象操作Kingdee.BOS.Core.dll服务插件AbstractOperationServicePlugIn 应用服务器插件与业务数据更新操作在一个事务执行 校验器插件AbstractValidato

15、r 在服务插件的 OnAddValidators 加入AbstractOperationServicePlugIn 插件方法OnPreparePropertysOnAddValidatorsBeforeExecuteOperationTransaction AfterExecuteOperationTransaction BeginOperationTransaction EndOperationTransaction 可以定制加载指定字段到实体里 添加自定义数据校验器 执行操作事务前事件 执行操作事务后事件 调用操作事件前触发 （支持事务 ）调用操作事件完毕 （支持事务 ）表单构建插件继承层

16、次表单 单据 叙事簿 基础资料插件针对对象动态表单 单据 基础资料Kingdee.BOS.Core.dll插件方法AbstractDynamicWebFormBuilderPlugInCreateControl 构建界面元素事件AfterCreateControl 构建界面元素后事件CreateMainMenu 构建菜单事件AfterCreateMainMenu 构建菜单后事件表单插件调用过程 由控制器创建视图、模型、插件代理 初始化视图、模型 由插件服务注册到插件代理 插件代理初始化插件 加载数据，通知插件创建数据，创建表单数据包 表单操作插件服务调用代理，发送事件通知插件代理调用插件，执行

17、事件返回执行结果View 对象属性this.View（View 接口 ） this.View 的常用属性BusinessInfo （界面业务对象元数据） LayoutInfo （布局元数据） Model （动态表单模型接口） OpenParameter （页面调用时传入的参数）方法GetFieldEditor （获取界面控件对象） UpdateView （重新更新界面数据及状态） ShowMessage （显示信息）更改界面控件状态this.View. GetFieldEditor 示例：/ / 设置金额列精度/ / / private void SetColumnScale（short iS

18、cale, string strField） his.View.GetFieldEditor（strField, -1）.Scale = iScale;更新界面数据和状态this.View.UpdateView示例：/ / 字段修改事件函数重载/ public override void DataChanged(DataChangedEventArgs e)switch (e.Key.ToUpper()case FPARENTDEPTID: / 组织隶属方案和上级部门变化，重新生成部门全称 this.Model.SetValue( “FFullName ”, GetFullName(e.Key

19、); this.View.UpdateView( “FFullName ”);break;显示信息this.View.ShowMessage示例：if (e.CurParentId = 0)this.View.ShowMessage( “请先选择顶层组织。”);return;Model 对象属性this.View.Model (动态表单模型接口)This.View.Model 的常用属性DataObject 当前对象的数据实体方法GetEntryCurrentRowIndex( 获取分录当前行索引 )GetEntryRowCount( 获取分录行数量 )CreateNewEntryRow( 新

20、建分录行 )GetValue(获取字段(对象)值)SetValue（设置字段（对象）值）获取单据属性：例如分录集合this.View.Model.DataObject示例：/ / 获取分录集合/ DynamicObjectCollection entrys = (DynamicObjectCollection)this.View.Model.DataObjectPOOrderEntry;新增单据体分录行this.View.Model.CreateNewEntryRow 示例：/ / 单据复制完成事件/ / public override void AfterCopyData(CopyDataEventArgs e) base.AfterCopyData(e); /