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

1、架构模型动态表单领域模型插件开发步骤定义插件类（参照继承体系）；分析业务定义重载法；引用相关组件（参照组件引用规则）；重载法编码；设置编译路径，编译组件；打开 IDE 设计器，配置插件；动态表单视图接口IDynamicFormViewIDynamicFormViewService2 个重要的属性BusinessInfoLayoutInfo界面元素访问1、访问菜单2、访问表单控件3、访问字段4、执行操作ShowFormUpdateViewInvokeFieldUpdateService动态表单模型接口IDynamicFormModelIDynamicFormModelService属性Busin

2、essInfoDataObject数据操作CreateNewDataCreateNewEntryRowInsertEntryRowGetEntryCurrentRowIndexLoadReferenceDataGetValueGetEntityDataObject动态表单插件命名空间：抽 象 类： AbstractDynamicFormPlugIn业务类（插件）继承自抽象类模型单据插件表单基础资料插件插件动态表单插件列表列表插件插件接口IDynamicFormViewPlugInIDynamicFormModelPlugIn加载机制OnInitializeCreateNewData / Aft

3、erCreateNewDataBeforeBindData / AfterBindDataBeforeClosed表单操作BeforeDoOperation / AfterDoOperationBeforeF7Select / AfterF7SelectTabItemSelectedChange表单事件BarItemClickEntryBarItemClickToolBarItemClickButtonClickEntityRowClickEntityRowDoubleClickEntryButtonCellClick模型访问操作BeforeUpdateValueBeforeDeleteRow

4、AfterDeleteRow单据插件 (基础资料插件 )继承自动态表单接口IBillViewPlugInOnBillInitialize参数 BillOpenParameterIBillModelPlugInBeforeSave / AfterSaveBeforeSubmit / AfterSubmit列表插件继承自动态表单接口IListViewPlugInOnListInitialize参数 ListOpenParameterAfterGetDataFormatCellValueIListModelPlugInPrepareFilterParameterBatchCopyData过滤条件插件

5、接口IListFilterViewIListFilterModelFilterObjectQuickFilterObjectIsolationOrgIdGetFilterField事件OnParseSettingFireBeforeBindFilterMetadataFireBeforeSelectTreeNodeScheme服务插件命名空间：抽象类：AbstractOperationServicePlugIn继承体系 :(继承自抽象类 )接口IOperationServicePlugInBeforeExecuteOperationTransactionAfterExecuteOperatio

6、nTransactionBeginOperationTransactionEndOperationTransaction校验服务IOperationServicePlugInOnAddValidatorsSaveValidator : AbstractValidatorValidate表单插件和列表插件继承层次表单单据叙事簿基础资料插件针对对象动态表单单据基础资料AbstractBillPlugIn接口AbstractBillPlugIn的 ViewPlugin插件接口OnBillInitialize视图模型初始化事件AfterBindData绑定数据后事件处理接口BeforeF7Select

7、基础资料弹出前事件BeforeClosed窗口关闭前事件BarItemClick菜单单击事件处理扩展接口AfterBarItemClick菜单单击事件后BeforeDoOperation操作调用前事件AfterDoOperation操作调用完成后事件ButtonClick按钮单击事件AfterButtonClick按钮单击后事件ListViewClick列表项目单击事件TreeNodeClick树控件单击事件TreeDragDrop树控件拖拽EntityRowClick分录行单击事件AbstractBillPlugIn的 ModelPlugIn接口动态表单数据模型插件编程接口定义了数据模型扩展

8、允通过接口处理数据，以实现特定业务需求AbstractBillPlugIn插件法CreateNewData AfterCreateNewData BeforeUpdateValue DataChanged CreateNewEntryRow BeforeDeleteRow AfterDeleteRow数据模型创建实体对象事件数据模型创建实体对象完成后事件数据更新前事件数据改变后事件创建分录行事件删除分录行事件删除分录后事件叙事簿插件接口AbstractListPlugIn的 ViewPlugIn接口序时簿视图插件编程模型接口定义了序时簿视图模型扩展允通过接口处理视图，实现特定业务需求ListI

9、nitialize视图模型初始化事件AfterGetData完成取数后事件FormatCellValue列表格式化接口BeforeButtonClick按钮和菜单单击前事件AfterButtonClick按钮和菜单单击后事件CellDbButtonClick单元格双击事件AbstractListPlugIn的 ModelPlugIn接口序时簿数据模型插件编程接口定义了序时簿数据模型扩展允通过接口处理数据，以实现特定业务需求PrepareFilterParameter CreateFilterEditorControl BatchCopyData AfterBatchCopyData准备过滤条件

10、触发创建过滤条件控件事件复制单据事件复制单据完毕事件服务插件插件特性IOperationServicePlugin一般会附加校验器运行于 App层事务保护插件针对对象操作服务插件AbstractOperationServicePlugIn应用服务器插件与业务数据更新操作在一个事务执行校验器插件AbstractValidator在服务插件的OnAddValidators加入AbstractOperationServicePlugIn插件法OnPreparePropertysOnAddValidatorsBeforeExecuteOperationTransactionAfterExecuteOp

11、erationTransactionBeginOperationTransactionEndOperationTransaction可以定制加载指定字段到实体里添加自定义数据校验器执行操作事务前事件执行操作事务后事件调用操作事件前触发( 支持事务 )调用操作事件完毕( 支持事务)表单构建插件继承层次表单单据叙事簿基础资料插件针对对象动态表单单据基础资料AbstractDynamicWebFormBuilderPlugIn插件法CreateControl构建界面元素事件AfterCreateControl构建界面元素后事件CreateMainMenu构建菜单事件AfterCreateMainMe

12、nu构建菜单后事件表单插件调用过程由控制器创建视图、模型、插件代理初始化视图、模型由插件服务注册到插件代理插件代理初始化插件加载数据，通知插件创建数据，创建表单数据包表单操作插件服务调用代理，发送事件通知插件代理调用插件，执行事件返回执行结果View 对象属性this.View(View接口 )this.View的常用属性BusinessInfo （界面业务对象元数据）LayoutInfo（布局元数据）Model （动态表单模型接口）OpenParameter（页面调用时传入的参数）法GetFieldEditor（获取界面控件对象）UpdateView（重新更新界面数据及状态）ShowMess

13、age（显示信息）更改界面控件状态this.View. GetFieldEditor示例：/ / 设置金额列精度/ / / private void SetColumnScale(short iScale, string strField)更新界面数据和状态示例：/ / 字段修改事件函数重载/ public override void DataChanged(DataChangedEventArgs e)case FPARENTDEPTID: / 组织隶属案和上级部门变化，重新生成部门全称“FFullName ” , GetFullName(e.Key);“ FFullName ” );bre

14、ak;显示信息示例：if (e.CurParentId = 0)“请先选择顶层组织。”);return;Model对象属性（动态表单模型接口）的常用属性DataObject当前对象的数据实体法GetEntryCurrentRowIndex(获取分录当前行索引)GetEntryRowCount(获取分录行数量)CreateNewEntryRow(新建分录行 )GetValue(获取字段 (对象 )值 )SetValue(设置字段 (对象 )值 )获取单据属性：例如分录集合示例：/ / 获取分录集合/ DynamicObjectCollection entrys =新增单据体分录行示例：/ / 单据复制完成事件/ / public override void AfterCopyData(CopyDataEventArgs e)base.AfterCopyData(e); /单据复制完，处理单据体_billFormID =“” ;“ FFieldControl”);UpdateFieldControlRowLock();获取字段值示例：/ 获取根节点组织复制到目标节点Organization org = (DynamicObject)targetRoot.id = rootOrgId;tar