金蝶K3 BOS插件开发产品培训.ppt

BOS插件开发培训,提纲,插件开发概述案例介绍插件开发基础插件开发向导K3ClassEvents业务对象接口BillEvent单据接口ListEvents序事簿接口K3ClassEvents公用对象K3Lib,为什么要用插件完成当前版本无法用K/3BOS标准功能实现的需求，插件原理图如下,插件开发概述,插件开发概述,插件的作用实现单据、序时簿、基础资料序时簿中特殊的业务流程处理中间层数据改变时的特殊处理规则个性化的菜单、外观定制；增加自定义的菜单并响应其操作对审核、消息流程的自定义控制,插件开发环境金蝶K/3v10.1以上的版本必选安装客户端、K/3BOS，推荐同时安装中间层MicrosoftVisualBasic推荐使用vb6.0版本，并且安装SP5MicrosoftWindows2000Server以上版本推荐采用Server类操作系统作为开发、调试操作系统注意：如果要使用“金蝶K/3BOS插件开发向导”工具，需要采用简体中文操作系统MicrosoftSQLServer2000数据库,插件开发概述-开发环境介绍,提纲,插件开发概述案例介绍插件开发基础插件开发向导K3ClassEvents业务对象接口BillEvent单据接口ListEvents序事簿接口K3ClassEvents公用对象K3Lib,ABC公司主营业务是生产和销售各种高档卫浴五金、水暖器材等。拥有五个厂区，产品外销欧美、日本等国家和地区,为了统一物流管理，解决重复请购、资金占用严重的问题，ABC公司提出了寄存仓的管理模式，与供应商之间通过统一窗口来管理供应商将物料寄存到ABC公司指定的物流中心仓库，但所有权属供应商ABC公司根据生产实际需求从物流中心领料并进行相应的结算处理,案例分析,解决方案,演示案例插件开发需求,在寄存入库单单据上增加复制按钮的浮动按钮，隐藏“页面设置”菜单当前登录用户只能看到本人制作的寄存入库单寄存入库单新增时给表体赋一行默认值寄存入库单下推外购入库单时，所选记录必须部门相同,提纲,插件开发概述案例介绍插件开发基础插件开发向导K3ClassEvents业务对象接口BillEvent单据接口ListEvents序事簿接口K3ClassEvents公用对象K3Lib,插件开发基础插件开发向导,体验K/3BOS插件开发向导,提纲,插件开发概述案例介绍插件开发基础插件开发向导K3ClassEvents业务对象接口BillEvent单据接口ListEvents序事簿接口K3ClassEvents公用对象K3Lib,插件对象模型(BillEvent),K3ClassEventsBillEvent单据接口ListEvents序事簿接口BaseClassEvent基础资料序事簿接口,BillEvent对象,BillEvent对象MenuBar概述BOSBands和BOSBand对象BOSTools和BOSTool对象单据基础对象BillHeads和BillEntrysBOSFields单据接口常用事件常用函数、方法常用属性,概述,BOSBands、BOSTools对象在BillEvent、ListEvents对象中包含MenuBar属性使用。例如：DimoMenuBarAsK3ClassEvents.MenuBarSetoMenuBar=BillEventObject.Menubar在BillEvent、ListEvents、BaseClassEvent对象新增事件SubMenuBarInitialize(ByValoMenuBarAsK3ClassEvents.MenuBar)SubMenuBarClick(ByValBOSToolAsK3ClassEvents.BOSTool,CancelAsBoolean),BOSBands和BOSBand对象,基本和ActiveBar的Bands、Band对象属性、方法一致BOSBands不能使用ForEach方法遍历BOSBand对象可以通过Add方法来新建BOSBand对象。,BOSTools常用方法,FunctionAdd(ToolNameAsString)AsBOSTool与ActiveBar的Tools的Add相比可以在任何的BOSTools对象中调用不需要考虑ToolID重复的问题SubInsertBefore(Index,oToolAsBOSTool)Index可以是数字，以表示当前BOSBand上的BOSTool的顺序（与ActiveBar中的方法一致）也可以是一个BOSTool的Name（字符串）SubInsertAfter(Index,oToolAsBOSTool)新增方法，特性与上相同,练习,在寄存入库单单据上增加复制按钮的浮动按钮，隐藏“页面设置”菜单,BillEvent对象,BillEvent对象MenuBar概述BOSBands和BOSBand对象BOSTools和BOSTool对象单据基础对象BillHeads和BillEntrysBOSFields单据接口事件函数、方法属性,概述,在BillEvent对象中包含使用。例如：DimoHeadAsK3ClassEvents.BillHeadSetoHead=BillEventObject.BillHeads(1)BillHeads、BillEntrys、BOSFields不能使用ForEach方法遍历对象,BillEntrys对象,BillEntrys对象包含了和单据体相关的属性通过这些属性可以在运行时操作单据体,BOSFields和BOSField对象,BOSField对象每个字段对象，对应单据（包括单据头和单据体）上的每一个字段通过这些属性，可以在运行时操作字段。,属性集,BOSField属性,某些属性值只适用于单据头中的字段FieldTopFieldLeftFieldHeightFieldWidthLabelWidthLabelColorFrameBorderColorFrameBorderFontNameFontSizeFontBoldFontItalicTextColor某些两者都支持TableNameFieldNameCaptionPageLayerFKeyVisibleNeedSaveMustInputFieldLockNote某些只适用于特殊的字段Row仅支持多分录单据体Filter仅支持基础资料字段,BOSField属性详解,Visible:字段显示/隐藏属性,只有设计时没有设计为“可见”状态的字段，才可以在运行时更改可见性状态FieldLock:只有设计时没有设计为“锁定”状态的字段，才可以在运行时更改锁定状态Value:得到字段内码值。即保存在数据库中的值Number:得到字段查找类型字段查找值Text:得到字段显示值。即显示在界面的值，不支持通过该属性直接赋值。Value:得到/设置字段非查找类型字段赋值使用Number:得到/设置字段查找类型字段赋值使用,BillEvent对象,BillEvent对象MenuBar概述BOSBands和BOSBand对象BOSTools和BOSTool对象单据基础对象BillHeads和BillEntrysBOSFields单据接口常用事件常用函数、方法常用属性,事件EventMenuBarInitialize(oMenuBarAsMenuBar)说明：该事件在菜单、工具栏初始化时发生。EventMenuBarClick(BOSToolAsBOSTool,CancelAsBoolean)说明：该事件在点击菜单、工具栏项时发生。EventAfterNewBill()说明：新建单据对象后发生。EventAfterLoadBill()说明：单据对象加载完成后发生。EventAfterSelBill(lSelBillTypeAsLong)说明：选单操作完成后发生。EventChange(dctAsDictionary,dctFldAsDictionary,ColAsLong,RowAsLong,CancelAsBoolean)说明：单据对象上的字段值发生改变时发生。,BillEvent对象-常用事件,方法FunctionGetFieldValue(sKeyAsString,nRowAsLong=-1,ValueTypeAsEnu_ValueType=Enu_ValueType_FFLD)说明：用于返回字段的值。FunctionSetFieldValue(sKeyAsString,vValue,nRowAsLong=-1)AsBoolean说明：用于设置字段的值。FunctionInsertNewRowAndFill(nPageAsLong,nRowAsLong,ParamArrayvFieldsData()AsVariant)AsBoolean说明：在多分录单据体中插入一个新行，并填充数据。,BillEvent对象-常用函数、方法,BillEvent对象-属性,练习,通过插件实现寄存入库单新增时给表体赋一行值，物料代码为”01.001”，应收数量为100，实收数量为100，单价为1500。主要练习Insertnewrowandfill方法,插件对象模型(ListEvents),K3ClassEventsBillEvent单据接口ListEvents序事簿接口BaseClassEvent基础资料序事簿接口,ListEvents对象,ListEvents对象常用事件常用函数、方法常用属性,ListEvents对象-常用事件,EventMenuBarInitialize(oMenuBarAsMenuBar)说明：菜单、工具栏初始化时发生。EventMenuBarClick(BOSToolAsBOSTool,CancelAsBoolean)说明：点击菜单、工具栏项时发生。EventListFillRow(lRowAsLong,RowDataAsObject,HeadDictAsDictionary,CellDataAsString,BackColorAsLong,ContinueRaiseAsBoolean)说明：序时簿的行填充数据时发生。,ListEvents对象-常用方法,FunctionGetSelectedBillInfo()AsVector说明：获取当前选中的单据的数据。,ListEvents对象-属性,ListFilterString说明：序事簿运行时设置过滤条件,练习,通过插件实现当前登录用户只能看到本人制作的寄存入库单,主要练习序事簿ListFilterString属性,提纲,插件开发概述案例介绍插件开发基础插件开发向导数据结构K3ClassEvents业务对象接口BillEvent单据接口ListEvents序事簿接口K3ClassEvents公用对象K3Lib常用元数据表结构,概述,在BillEvent、ListEvents、BaseClassEvent对象中包含K3Lib对象使用。例如：DimoK3AsK3ClassEvents.K3LibSetoK3=BillEventObject.K3Lib也可直接使用：lUserID=BillEventObject.K3Lib.User.UserID,方法集,FunctionGetData(SQLCodeAsString)AsObject通过SQL语句从中间层访问数据库，返回数据。返回值是ADODB.Recordset类型SubUpdateData(SQLCode)通过SQL语句从中间层访问数据库，更新数据参数SQLCode可以是String（单条SQL语句），也可以是String()（多条SQL语句）FunctionCreateK3Object(ClassStringAsString)AsObject通过这个函数在插件中创建K/3的对象，使得插件可以单独调试,练习,通过插件实现寄存入库单下推外购入库单时所选单据部门必须相同，主要练习K3lib方法GetData以及序事簿方法GetSelectedBillInfo,关于K/3BOS完整案例的介绍，请参考K3BOS应用开发培训教材关于K/3BOS完整开发流程的介绍，请参考K3BOS开发指导手册关于插件中接口的函数、方法、事件、属性的详细信息，请参考K3BOS插件开发参考手册关于BOS万能报表工具包介绍，请参考K3BOS万能报表工具包用户手册常见问题请参考K/3BOS百问百答关于工业单据插件开发，函数、方法、属性的详细信息，K3客户化开发工具包,资料,谢谢!,特别声明,没有金蝶软件（中国）有限公司的特别许可，任何人不能以任何形式或为任何目的复制或传播本文档的任何部分。本文档中包含的信息如有更改，恕不另行通知。由金蝶软件（中国）有限公司和其分销商所销售的某些软件产品包含有其它软件供应商版权所有的软件组件。Microsoft、WINDOWS、NT、EXCEL、Word、PowerPoint和SQLServer是微软公司的注册商标。IBM、DB2、DB2通用数据库、OS/2、ParallelSysplex、MVS/ESA、