BOS插件开发入门教程
本文主要针对初学者,介绍BOS插件开发与制作的基本流程与步骤,为入门所用。 以一个简单的插件开发需求为例:比如想在新开发的BOS单据上,增加一个自定义菜单按钮,按钮标题为“My BOS MenuBarButton”,位置放在编辑菜单下的驳回审核按钮之后,在工具栏上的退出按钮之前;当点击该自定义按钮时弹出提示框“Hello,This Is My First BOS Bill InterFace!”。针对此需求,让我们一起看看如何一步一步通过BOS插件来实现: 【第一步】:由于插件是基于VB语言开发,首先需要在装有金蝶K3的环境下安装Microsoft Visual Basic 6.0(简称VB6.0)开发工具。
附开发工具下载地址:http://www.liangchan.net/liangchan/1935.html
【第二步】:安装好VB6.0之后,在开始菜单中找到VB6.0的快捷方式,打开VB之后将出现以下界面(如图1):
图1
在此界面一定要选择“ActiveX DLL”,再点击“打开”按钮,然后会进入以下工作界面(如图2):
图2
注意界面右上方的“插件开发向导”按钮。
有的环境可能会出现打开VB6.0后并没有“金蝶 k/3-BOS”菜单的问题,解决方法如下: 找到K3安装目录下的ADDIN文件夹,将此文件夹下的两个DLL文件(K3BOSPLUGINSADDIN.dll和K3GLParaConsolePlugin.dll),在CMD命令行中用RegSvr32命令进行注册。
例如:K3安装目录为C:\\Program Files\\Kingdee\\K3ERP,那么在cmd中输入命令就为: regsvr32 \regsvr32 \
回车提示注册成功之后,再重新打开VB就会出现“金蝶 k/3-BOS”菜单,如果还没出现需要再重启下电脑解决。(备注:如果是WIN7环境,运行cmd.exe需要以管理员身份运行,方可成功注册组件)
图3
【第三步】:插件向导界面操作
点击VB右上方的“插件开发向导”按钮,将会出现以下界面(如图4):
图4
在以上界面,我们可以看到有4个选项供选择,具体含义如下:
? 金蝶 K/3-BOS 客户端插件:在金蝶K3客户端运行,针对K3客户端业务逻辑的扩展处
理,仅适用于BOS新单。
比如更改单据菜单按钮外观及位置、增加自定义按钮菜单功能、单据字段数据更改、单据保存前的特殊校验、序时薄实现动态过滤、下推前的逻辑控制、审核或者驳回操作前的特殊判断等等客户端的逻辑扩展,都有可能用到客户端插件
? 金蝶 K/3-BOS 中间层插件:在金蝶K3中间层运行,针对K3中间层业务逻辑的扩展处
理,仅适用于BOS新单。
特别涉及到需要在中间层进行一些特殊业务处理,需要同BOS单据的中间层保存、删除、审核或驳回等操作的事务保持在同一事务里进行控制时,就会用到中间层插件。 ? 金蝶 K/3 工业单据客户端插件:在金蝶K3客户端运行,针对K3客户端业务逻辑的扩
展处理,仅适用于K3老单。
? 金蝶 K/3 工业单据中间层插件:在金蝶K3中间层运行,针对K3中间层业务逻辑的扩
展处理,仅适用于K3老单。
案例要求是在单据上增加按钮,是对BOS单据客户端运行时的扩展处理,所以此处我们选择“金蝶 K/3-BOS 客户端插件”,点击确定后将进入以下界面(如图5):
图5
界面上有四种插件类型供我们选择,不同插件类型的说明如下:
? 金蝶 K/3-BOS 客户端单据插件:针对BOS单据新增、修改及查看等场景下的业务逻辑
的扩展处理。
? 金蝶 K/3-BOS 客户端序时薄插件:针对BOS单据序时薄维护等场景下的业务逻辑的扩
展处理。
? 金蝶 K/3-BOS 基础资料序时薄插件:针对BOS基础资料序时薄维护场景下的业务逻辑
的扩展处理
? 金蝶 K/3-BOS 审批流插件:针对BOS单据运行审批流相关的业务逻辑的扩展处理。 此处我们选择“金蝶 K/3-BOS 客户端单据插件”,在单据界面上增加自定义按钮,点击“下一步”将出现以下界面(如图6):