金蝶KIS专业版二次开发技术详解.doc

金金蝶蝶 K KI IS S 专专业业版版二二次次开开发发技技术术详详解解 目 录 第第一一章章 概概述述 1 第一节 个性化介绍 1 第第二二章章 二二次次开开发发类类别别 2 第第三三章章 技技术术详详解解 3 第一节 单据嵌入式插件 3 第二节 主控台外挂报表 5 第三节 主控台外挂 DLL 组件 9 第四节 单据增加自定义菜单 12 第五节 创建新的表单序时簿 14 第六节 第三方系统与 KIS 的集成 20 第七节 标准 EXE执行程序 20 第第四四章章 附附注注 22 第一节专业版单据相关 ID 22 第二节专业版数据库常用表介绍 23 金金蝶蝶 K KI IS S 专专业业版版二二次次开开发发技技术术详详解解 金蝶 KIS 专业版 第 1 页 第第一一章章 概概述述 本文着重介绍如何利用 KIS 专业版产品自身架构 进行相关功能的二次开发 在 产品标准财务 业务一体化流程基础上 实现客户个性化需求 真正做到随需应变 第第一一节节 个个性性化化介介绍绍 KIS 个性化 ERP 又称第三代国产小企业 ERP 第一代 ERP 定制化 定义 客户需要怎么样 就做成怎么样 完全以客户需求为导向 由于客户的专业性 有限 容易导致业务前后不一致 流程中断 结果 小部分企业成功 大部分失败 第二代 ERP 标准化 定义 软件厂商从专业角度出发 按照理论形成稳定的标准流程 做出通用型产品 特点是产品过于通用化 不能与企业自身管理特点或企业所在行业特点很好的吻合 结果 小部分企业成功 大部分不满意 第三代 ERP 个性化 定义 基于产品平台接口 确保财务业务一体化流程稳定为基础 通过插件开发 实 现客户个性化需求 最终实现客户 ERP 的个性化 目标 帮助顾客成功 金金蝶蝶 K KI IS S 专专业业版版二二次次开开发发技技术术详详解解 第 2 页 金蝶 KIS 商贸版 第第二二章章 二二次次开开发发类类别别 金蝶 KIS 专业版的二次开发共分为下面 7 大类别 一 单据嵌入式插件 如 客户品名 二 主控台外挂报表 如 采购价格分析表 三 主控台外挂 DLL 如 客户订单号回写功能插件 四 单据增加自定义菜单 如 销售订单的 拆分生成采购入库 菜单 五 创建新的表单序时簿 如 预收预付协议单序时簿 六 第三方系统与 KIS 的集成 如 计件工资 税务系统 七 独立运行的 Exe 可以调用 KIS 登录窗口获得数据源 支持 F7 调用 金金蝶蝶 K KI IS S 专专业业版版二二次次开开发发技技术术详详解解 金蝶 KIS 专业版 第 3 页 第第三三章章 技技术术详详解解 按照 KIS 专业版二次开发的 7 大类别 分别进行以实现原理与实际应用案例相结 合的详细介绍 第第一一节节 单单据据嵌嵌入入式式插插件件 插件根据单据表头或表体界面操作 获取界面数据 并插件中进行数据加工处理 最后将结果回填到单据界面 下面以 客户品名 又名 一品多名 插件为例 插件需求 有些行业的物料名称别名很多 同样的物料销售给不同客户时 各客户要求送货 单上显示自己规定的名称 这样情况在化工和医药等行业比较普遍 如 编码为 01 001 的盐酸 销售给 A 客户叫洗涤剂 销售给 B 客户叫漂白水 销售出库单第一次输入 A 客户 输入 01 001 物料 输入客户产品名称 插件自 动保存该客户对应该物料的客户产品名称 销售出库单第二次输入同样客户 同样物 料时 插件自动查询并显示对应的客户产品名称 实现步骤 步骤一 通过下面脚本 销售出库单表体增加 客户产品名称 字段 步骤二 通过下面脚本 在系统的销售出库单嵌入一个 VB 插件类对象名 KISBillPlugCustItemName Bill21 并且数据库中新建一张用于存放客户 物料 和客户产品名称信息的表 t custitem 步骤三 专专专专FCustItemName txt 专专专专专专专专专专专专专专 txt 金金蝶蝶 K KI IS S 专专业业版版二二次次开开发发技技术术详详解解 第 4 页 金蝶 KIS 商贸版 用 VB 开发并编译在步骤二中嵌入的插件类对象 插件实现的逻辑是 在销售出 库单 表体选择物料后 插件自动根据当前的客户和物料 从数据库中取出对应的客 户产品名称 然后填入表体的相应单元格 客户产品名称有编辑后 需要自动回写到 数据库 具体实现参照下面代码 实现效果 套打 金金蝶蝶 K KI IS S 专专业业版版二二次次开开发发技技术术详详解解 金蝶 KIS 专业版 第 5 页 第第二二节节 主主控控台台外外挂挂报报表表 指开发用户个性化报表 并将报表菜单挂到 KIS 专业版主控台的相应模块右下方 具体实现过程如下 插件需求 以简单的采购明细报表为例 实现步骤 步骤一 在 KISCom 目录下创建 KISBOS 目录 解压下面报表例子文件包 放到 KISBOS 目录 如下图 专专专专专专专专专 rar 金金蝶蝶 K KI IS S 专专业业版版二二次次开开发发技技术术详详解解 第 6 页 金蝶 KIS 商贸版 步骤二 注册上图显示 KISBOSRptSample 目录下的 KISBOSRptSample dll 组件 DLL 组件的注册方法 双击该文件 选择打开方式为 system32 目录下的 REGSVR32 EXE 文件 提示注册成功 实现效果 采购模块的账簿报表中出现 采购报表例子 菜单 金金蝶蝶 K KI IS S 专专业业版版二二次次开开发发技技术术详详解解 金蝶 KIS 专业版 第 7 页 点击 采购报表例子 可以显示下面报表效果 金金蝶蝶 K KI IS S 专专业业版版二二次次开开发发技技术术详详解解 第 8 页 金蝶 KIS 商贸版 原理介绍 1 专业版主控台显示时 自动读取 KISCom KISBOS 目录下的 xls 文件 每个 xls 文件中存放一条记录 该记录的相关字段说明 可以打开 xls 文件 查看该文 件的 字段说明 页表中相关解释 此 xls 相当于菜单挂接模板 如果要挂接新 报表或新的 dll 组件 可以拷贝此文件 对相应字段进行修改即可 注意 如果 是手工 Excel 新建的 xls 文件 专业版主控台会出现不能显示的问题 2 点击 采购报表例子 菜单后 系统读取 KISBOS KISBOSRptSample KISBOSReport mdb 文件 从 T RepList 表中 读取本报表对应的 数据处理插件对象 从 T RepFilter 表中 读取出报表的 过滤条件设置 T RepFilter 表中 对于客户 供应商 物料 职员等基础资料 的选择 请参照 T Select 表 注意 T RepList T RepFilter 表中的 FRepKey 字段的值需要与 xls 文件记录 RPT 001 的 001 编码一致 3 点击报表过滤界面上的 确定 按钮 系统自动创建 T RepList 表中设定的 数 据处理插件对象 并将过滤条件传到此对象 关于 数据处理插件对象 的实 现原理 请参阅 KISBOS KISBOSRptSample 报表插件源代码 目录下的 VB 源代码 金金蝶蝶 K KI IS S 专专业业版版二二次次开开发发技技术术详详解解 金蝶 KIS 专业版 第 9 页 第第三三节节 主主控控台台外外挂挂 DLL 组组件件 指开发用户个性化功能插件 并将功能菜单挂到 KIS 专业版主控台的相应模块右 下方 相对嵌入式插件 外挂 DLL 组件的功能相对比较独立 具体实现过程如下 插件需求 销售模块的右下方 挂接一个简单的 VB DLL 组件程序 该演示程序介绍数据库 连接的获取 F7 基础资料的选择 实现步骤 步骤一 在 KISCom 目录下创建 KISBOS 目录 解压下面报表例子文件包 放到 KISBOS 目录 如下图 专专DLL专专专专专专 rar 金金蝶蝶 K KI IS S 专专业业版版二二次次开开发发技技术术详详解解 第 10 页 金蝶 KIS 商贸版 步骤二 注册上图显示 KISBOSDllSample 目录下的 KISBOSDllSample dll 组件 DLL 组 件的注册方法 双击该文件 选择打开方式为 system32 目录下的 REGSVR32 EXE 文件 提示注册成功 实现效果 销售模块的账簿报表中出现 Dll 例子 菜单 点击 DLL 例子 可以显示下面窗口 金金蝶蝶 K KI IS S 专专业业版版二二次次开开发发技技术术详详解解 金蝶 KIS 专业版 第 11 页 原理介绍 1 专业版主控台显示时 自动读取 KISCom KISBOS 目录下的 xls 文件 每个 xls 文件中存放一条记录 该记录的相关字段说明 可以打开 xls 文件 查看该文 件的 字段说明 页表中相关解释 此 xls 相当于菜单挂接模板 如果要挂接新 报表或新的 dll 组件 可以拷贝此文件 对相应字段进行修改即可 注意 如果 是手工 Excel 新建的 xls 文件 专业版主控台会出现不能显示的问题 2 点击 DLL 例子 菜单后 根据 xls 文件记录中设置的 DLL KISBOSDllSample Application 创建KISBOSDllSample Application 对象 并自动调用该对象的指定方法 如下 Public Function Show str As String As Boolean PropString str frmMain Show 1 End Function 金金蝶蝶 K KI IS S 专专业业版版二二次次开开发发技技术术详详解解 第 12 页 金蝶 KIS 商贸版 具体代码实现 请参阅 KISBOS KISBOSDllSample 目录下的 VB 源代码 第第四四节节 单单据据增增加加自自定定义义菜菜单单 插件需求 贸易型企业 在接到销售订单后 直接按照订单商品进行采购 这样 订单上有 很多商品 但是需要从多家供应商处进行采购 也就是需要一张销售订单 能自动生 成多张采购订单 实现步骤 步骤一 通过下面脚本 销售订单表体增加 供应商 字段 并在销售订单顶部菜单中增加 拆分生成采购订单 的菜单 并对应此菜单 嵌入一个 DLL 插件到销售订单 这 样通过点击此菜单 系统自动调用嵌入的 DLL 插件 并在插件中自动按照订单上的 供应商 生成多张采购订单 步骤二 关于步骤一中的 DLL 插件 单据自定义菜单所触发的插件事件如下 Private Sub m BillTransfer UserMenuClick ByVal Index As Long ByVal Caption As String Dim sBillNoPlace As Integer Dim sBillNo As String Dim oProp As KFO Dictionary Dim oSvr As Object Dim RtnCode As Long Dim RtnDesc As String sBillNoPlace GetCtlOrderByFieldName FBillNo 0 金金蝶蝶 K KI IS S 专专业业版版二二次次开开发发技技术术详详解解 金蝶 KIS 专业版 第 13 页 If sBillNoPlace 0 Then sBillNo m BillTransfer GetHeadText sBillNoPlace Else Exit Sub End If Set oProp New KFO Dictionary oProp FBillNo sBillNo Set oSvr CreateProxy KISMenuDllCreMulPOM clsUpdate Call oSvr CreatePO MMTS PropsString oProp RtnCode RtnDesc If RtnCode 0 Then RtnDesc 完成 End If MsgBox RtnDesc 信息提示 End Sub 实现效果 金金蝶蝶 K KI IS S 专专业业版版二二次次开开发发技技术术详详解解 第 14 页 金蝶 KIS 商贸版 第第五五节节 创创建建新新的的表表单单序序时时簿簿 指用户根据个性化特点 需要在专业版系统上增加新的表单 对该表单数据进行 增 删 改 查 套打等功能 并且希望能将新表单数据下推到系统现有的单据上 插件需求 企业在预收款时 要记录下预收多少钱 预售什么产品 多少数量 什么价位 在做销售出库时 自动从预收款协议单下推携带 并单价自动带出来 同时预付也实 现类似功能 实现步骤 步骤一 通过下面脚本 在专业版系统中增加预收款协议单和预付款协议单共两套单据模 金金蝶蝶 K KI IS S 专专业业版版二二次次开开发发技技术术详详解解 金蝶 KIS 专业版 第 15 页 板脚本 并且 AddMenu sql 文件脚本将两个单据分别增加扩展菜单 用于下推到销 售出库单或采购入库单 专专专专专专专专 rar 步骤二 将下面文件包中文件放置到对应的 Advance 和 KISCom 目录 并对 dll 文件进行 Regsvr32 exe 注册 专专专专专专 rar KISBOS 目录如下图显示 KISBOSLstPrePay xls 该文件用于在主控台显示 预付协议单序时簿 菜单 KISBOSLstPreRec xls 该文件用于在主控台显示 预收协议单序时簿 菜单 KISBOSRptPrePay xls 与 KISBOSRptPrePay 目录对应 形成预付执行情况报表 KISBOSRptPreRec xls 与 KISBOSRptPreRec 目录对应 形成预收执行情况报表 金金蝶蝶 K KI IS S 专专业业版版二二次次开开发发技技术术详详解解 第 16 页 金蝶 KIS 商贸版 KISCom 目录下 KISMenuDllCreBillM dll 中间层组件 用于后台生成销售出库单或采购入库单 Advance 目录下 ERPSwitch SSS 该文件用 access 打开 在 GLNoteType ICTransType 表中增 加了相应的预收预付协议单记录 KIS 预收协议单 NDF KIS 预付协议单 NDF 这两个为新单据对应套打文件 KISMenuDllCreBill dll 该文件为单据自定义菜单调用的嵌入式组件 KISBills dll 该文件为专业版系统的单据组件 覆盖原有安装的文件 否则新 单据上的单价和金额不能显示出来 附注 如果用户需要创建类似的新单据 即复制本案例的脚本文件 xls 文件 ERPSwitch SSS 文件和套打文件 然后修改下相应的单据名称 并根据需要对模板的 表头和表体脚本进行相关修改 即可轻松实现新单据的增删改查和套打功能 再根据 前面介绍的嵌入式插件 自定义菜单功能原理 实现新单据与系统单据的下推等功能 实现效果 主控台 金金蝶蝶 K KI IS S 专专业业版版二二次次开开发发技技术术详详解解 金蝶 KIS 专业版 第 17 页 单据界面 金金蝶蝶 K KI IS S 专专业业版版二二次次开开发发技技术术详详解解 第 18 页 金蝶 KIS 商贸版 点击 扩展功能 的 下推采购入库 菜单 弹出下面窗口 选择明细 并输入 数量 可以自动生成采购入库单 金金蝶蝶 K KI IS S 专专业业版版二二次次开开发发技技术术详详解解 金蝶 KIS 专业版 第 19 页 相应报表 金金蝶蝶 K KI IS S 专专业业版版二二次次开开发发技技术术详详解解 第 20 页 金蝶 KIS 商贸版 第第六六节节 第第三三方方系系统统与与 KIS 的的集集成成 第三方系统 Exe 程序直接在 KIS 专业版主控台上调出启动 并且 KIS 传递登录 数据库的连接串 便于第三方系统与 KIS 在同一数据库中操作 第三方系统集成 涉及到数据库的整合 同时还有基础资料的同步或重用 所以 此类型的插件 一般由总部主导完成 第第七七节节 标标准准 Exe 执执行行程程序序 指用 VB 开发可执行的标准 EXE 程序 程序可以调用专业版登录组件 实现 KIS 风格登录 获取数据库连接串 并程序中可以直接调用专业版 F7 基础资料查询功能 具体实现过程参照下面例子程序 金金蝶蝶 K KI IS S 专专业业版版二二次次开开发发技技术术详详解解 金蝶 KIS 专业版 第 21 页 专专专专专专专专专专专专专专专专专专专专 rar 金金蝶蝶 K KI IS S 专专业业版版二二次次开开发发技技术术详详解解 第 22 页 金蝶 KIS 商贸版 第第四四章章 附附注注 本文所讲述的插件开发接口技术都是基于金蝶 KIS 专业版 V9 1SP1 版本 如需 技术交流 可以发送邮件到 kaihong wang 相关资料和金蝶 KIS 现已发布插件情况说明文档 可以从下面地址获取 下载时 建议采用迅雷等下载工具 由于网络原因 该地址有出现第一次下载 不成功的情况 这时需要重试 第第一一节节 专专业业版版单单据据相相关关 ID 单单据据名名称称单单据据 ID模模板板 Id序序时时簿簿 ID套套打打 ID 采购订单71P028150 采购发票 普通 76I038445 采购发票 专用 75I028444 采购入库1A015819 产品入库2A025520 成本调整100T017358 调拨单41D017537 领料单24B047729 盘亏毁损43C025136 盘盈入库40C015035 其他出库单29B096834 其他入库10A975725 销售报价单84G016042 销售出库21B017626 销售订单81S016153 金金蝶蝶 K KI IS S 专专业业版版二二次次开开发发技技术术详详解解 金蝶 KIS 专业版 第 23 页 销售发票 普通 86I056247 销售发票 专用 80I046246 虚仓出库26ZOU7962 虚仓调拨74P058560 虚仓入库6ZIN5461 单据 序时簿 套打相关对象类型表直接的关联关系 可以参照下面 SQL 语句 select distinct a fname a fid a ftemplateid b ftemplateid as flistid b fname as flistname c fnotetypeid from ictransactiontype a inner join iclisttemplate b on a fid b fbilltemplateid inner join glnotetype c on a ftemplateid c ftemplateid order by a fname 第第二二节节 专专业业版版数数据据库库常常用用表表介介绍绍 ictransactiontype 单据类型表 FTemplateID 是关联模板信息表的字段 FID 关 联 ICStockBi