K/3eBOS插件开发演讲人：刘兵金蝶软件（中国）有限公司P2版权所有©1993-2008金蝶软件(中国)有限公司提纲插件开发环境介绍插件编程原理什么是插件插件原理eBOS插件开发演示插件之应用程序代理对象单据插件代理对象（BillInterface）序时簿插件代理对象（ListInterface）公共辅助对象K3LibP3版权所有©1993-2008金蝶软件(中国)有限公司插件开发环境介绍eBOS插件开发环境金蝶K/3v11.0以上的版本目前需要安装客户关系管理系统才会有eBOS组件操作系统:MicrosoftWindows2000Server以上版本推荐采用Server类操作系统作为开发、调试操作系统开发平台:MicrosoftVisualStudio2005数据库:MicrosoftSQLServer2000/2005P4版权所有©1993-2008金蝶软件(中国)有限公司提纲插件开发环境介绍插件编程原理什么是插件插件原理eBOS插件开发演示插件之应用程序代理对象单据插件代理对象（BillInterface）序时簿插件代理对象（ListInterface）公共辅助对象K3LibP5版权所有©1993-2008金蝶软件(中国)有限公司插件编程原理—什么是插件什么是插件插件（Plug-Ins）是一种专门为某一软件设计、用于功能扩充的程序。通过插件可以实现客户个性化的定制。通过插件可以实现单据、序时簿、基础资料序时簿中特殊的业务流程处理。当数据改变时，通过中间层插件可以实现特殊处理。插件不只是被动的接受宿主程序调用，更可以控制宿主程序以完成一些特定功能。P6版权所有©1993-2008金蝶软件(中国)有限公司插件编程原理—插件原理插件原理静态图如下：P7版权所有©1993-2008金蝶软件(中国)有限公司插件编程原理—插件原理结合上图，可以对插件原理简单描述如下：以事件驱动为基础：捕获事件:通过应用程序代理对象（ApplicationProxy）应用程序代理对象:就是对应用程序（宿主程序）本身的包装P8版权所有©1993-2008金蝶软件(中国)有限公司提纲插件开发环境介绍插件编程原理什么是插件插件原理eBOS插件开发演示插件之应用程序代理对象单据插件代理对象（BillInterface）序时簿插件代理对象（ListInterface）公共辅助对象K3LibP9版权所有©1993-2008金蝶软件(中国)有限公司eBOS插件开发演示eBOS单据插件（华耐需求）在单据新增时增加“导入模板”菜单按钮，实现导入功能“导入模板”按钮位于关闭按钮前面查看和维护单据时，“导入模板”按钮设置不可用典型功能初始化菜单（OnBarInitialize）新增和设置菜单按钮属性（是否可见、是否可用）响应菜单事件（OnBarItemClick）值改变事件（Change）获得和设置字段值（GetFieldValue、SetFieldValue）P10版权所有©1993-2008金蝶软件(中国)有限公司提纲插件开发环境介绍插件编程原理什么是插件插件原理eBOS插件开发演示插件之应用程序代理对象单据插件代理对象（BillInterface）序时簿插件代理对象（ListInterface）公共辅助对象K3LibP11版权所有©1993-2008金蝶软件(中国)有限公司插件之应用程序代理对象单据插件代理对象（BillInterface）模型图BillInterfaceK3LibNetUserAccountBillHeadsBillEntrysBillHeadBillEntryBOSFieldsBOSFieldsBOSFieldBOSFieldInnerEventsWebLibP12版权所有©1993-2008金蝶软件(中国)有限公司插件之应用程序代理对象function：Alert;说明：显示对话框CloseBill;说明：关闭单据CloseWebTabItem;说明：关闭页签GetFieldValue;说明：获得字段值SetFieldValue;说明：设置字段值SaveBill;说明：请求保存单据P13版权所有©1993-2008金蝶软件(中国)有限公司插件之应用程序代理对象IsLock;说明：字段是否被锁定LockCell;说明：请求锁定字段SendEmail;说明：请求发送邮件SendMessage;说明：请求发送消息SetActiveCell;说明：请求激活字段AddBarItem;说明：增加菜单按钮AddBarItemLink说明：菜单分组中添加子菜单项P14版权所有©1993-2008金蝶软件(中国)有限公司插件之应用程序代理对象ShowF7Select;说明：请求显示F7查询ShowHideField;说明：请求显示和隐藏字段WebLib类表如图请求弹出交互式对话框；Confirm函数执行后触发；ShowF7Select函数执行后触发；ShowBill函数执行后触发；按钮单击后触发的事件；P15版权所有©1993-2008金蝶软件(中国)有限公司插件之应用程序代理对象event：publiceventEventHandlerOnBarInitialize;说明：菜单初始化事件publiceventBar.BarItemClickEventHandleOnBarItemClick;说明：菜单单击事件publiceventEvents.AfterSaveHandlerAfterSave;说明：保存完毕后触发的事件publiceventEvents.AfterNewBillHandlerAfterNewBill;说明：新增单据后触发的事件publiceventEvents.AddNewRowHandlerAddNewRow;说明：新增单据体数据行后触发的事件publiceventEvents.AfterCopyBillHandlerAfterCopyBill;说明：单据复制完成后触发的事件publiceventEvents.ChangeHandlerChange;说明：字段值改变后触发的事件publiceventBar.ButtonClickEventHandleOnButtonClick;说明：按钮单击后触发的事件P16版权所有©1993-2008金蝶软件(中国)有限公司插件之应用程序代理对象序时簿插件代理对象（ListInterface）模型图ListInterfaceK3LibNetUserAccountInnerEventsWebLibP17版权所有©1993-2008金蝶软件(中国)有限公司插件之应用程序代理对象functionAlert;说明：显示对话框RefreshList;说明：请求刷新序时簿GetSession;说明：请求获得缓存对象SendEmail;说明：请求发送邮件SendMessage;说明：请求发送消息SendSMS;说明：请求发送短信ShowBill说明：请求显示单据P18版权所有©1993-2008金蝶软件(中国)有限公司插件之应用程序代理对象AddBarItem;说明：增加菜单按钮AddBarItemLink说明：菜单分组中添加子菜单项RemoveBarItem;说明：删除菜单AspxGetSelectList说明：获得选择的数据行集合(单据ID)Confirm说明：弹出对话框DisplayResult说明：调用K3对话框显示结果(用于批量处理)GetBillData说明：获取指定单据的数据包P19版权所有©1993-2008金蝶软件(中国)有限公司插件之应用程序代理对象WebLib类表如图请求弹出交互式对话框；ShowBill函数执行后触发；序时簿格式化单元格时触发；P20版权所有©1993-2008金蝶软件(中国)有限公司插件之应用程序代理对象event：publiceventEventHandlerOnBarInitialize;说明：菜单初始化事件publiceventBar.BarItemClickEventHandleOnBarItemClick;说明：菜单单击事件publiceventEvents.AfterRefreshListHandlerAfterRefreshList;说明：序时簿刷新后触发publiceventEvents.AfterConfirmHandlerAfterConfirm;说明：Confirm执行后触发publiceventEvents.AfterDeleteBillHandlerAfterDeleteBill;说明：删除单据后触发publiceventEvents.CustomDisplayTextHandlerCustomDisplayText;说明：自定义序时簿中行显示数据P21版权所有©1993-2008金蝶软件(中国)有限公司提纲插件开发环境介绍插件编程原理什么是插件插件原理eBOS插件开发演示插件之应用程序代理对象单据插件代理对象（BillInterface）序时簿插件代理对象（ListInterface）公共辅助对象K3LibP22版权所有©1993-2008金蝶软件(中国)有限公司公共辅助对象K3Lib在BillInterface和ListInterface对象中聚合了K3Lib对象通过应用程序代理对象中的K3Lib可直接获得帐套和用户的相关信息例如：lUserID=m_BillInterface.K3Lib.User.UserID；通过中间层访问数据并返回数据publicDataSetGetData(stringstrSQL)通过中间层访问数据并更新数据publicDataSetUpdateData(stringstrSQL)P23版权所有©1993-2008金蝶软件(中国)有限公司Q&A谢谢！
