文档介绍：BOS插件开发入门教程
本文主要针对初学者,介绍BOS插件开发与制作的基本流程与步骤,为入门所用。
以一个简单的插件开发需求为例:比如想在新开发的BOS单据上,增加一个自定义菜单按钮,按钮标题为“My BOS MenuBarButton”,位置放在编辑菜单下的驳回审核按钮之后,在工具栏上的退出按钮之前;当点击该自定义按钮时弹出提示框“Hello,This Is My First BOS Bill InterFace!”。针对此需求,让我们一起看看如何一步一步通过BOS插件来实现:
【第一步】:由于插件是基于VB语言开发,首先需要在装有金蝶K3的环境下安装Microsoft Visual Basic ()开发工具。
附开发工具下载地址:ngchan/
【第二步】:,,打开VB之后将出现以下界面(如图1):
图1
在此界面一定要选择“ActiveX DLL”,再点击“打开”按钮,然后会进入以下工作界面(如图2):
图2
注意界面右上方的“插件开发向导”按钮。
“金蝶 k/3-BOS”菜单的问题,解决方法如下:
找到K3安装目录下的ADDIN文件夹,将此文件夹下的两个DLL文件(),在CMD命令行中用RegSvr32命令进行注册。
例如:K3安装目录为C:\Program Files\Kingdee\K3ERP,那么在cmd中输入命令就为:
regsvr32 "C:\Program Files\Kingdee\K3ERP\ADDIN\"
regsvr32 "C:\Program Files\Kingdee\K3ERP\ADDIN\"
回车提示注册成功之后,再重新打开VB就会出现“金蝶 k/3-BOS”菜单,如果还没出现需要再重启下电脑解决。(备注:如果是WIN7环境,,方可成功注册组件)
图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):
图6
选择“新增菜单或工具栏”,点击“下一步”将出现以下界面(如图7):
图7
点击“新增”按钮,出现以下界面(如图8):
图8
在弹出的菜单编辑界面,增加自定义按钮,定义按钮标题、在菜单栏及工具栏上的位置。定义完成之后点击“确定”按钮,然后点击“下一步”,将进入以下界面(如图9):
图9
在图9界面选择你想要实现的插件接口