组件跟踪工具使用方法
本期概述 |
l 本文档适用于 K/3 15.1 所有模块
l 本文档针对组件跟踪工具进行讲解，通过本文档的学习可以了解一般的组件类报错问题
版本信息 |
l 2020年7月11日 V1.0 编写人： 田晓鑫
l 2020年7月11日 V2.0 修改人：
版权信息 |
l 本文件使用须知
著作权人保留本文件的内容的解释权，并且仅将本文件内容提供给阁下个人使用。对于内容中所含的版权和其他所有权声明，您应予以尊重并在其副本中予以保留。您不得以任何方式修改、复制、公开展示、公布或分发这些内容或者以其他方式把它们用于任何公开或商业目的。任何未经授权的使用都可能构成对版权、商标和其他法律权利的侵犯。如果您不接受或违反上述约定，您使用本文件的授权将自动终止，同时您应立即销毁任何已下载或打印好的本文件内容。
著作权人对本文件内容可用性不附加任何形式的保证，也不保证本文件内容的绝对准确性和绝对完整性。本文件中介绍的产品、技术、方案和配置等仅供您参考，且它们可能会随时变更，恕不另行通知。本文件中的内容也可能已经过期，著作权人不承诺更新它们。如需得到最新的技术信息和服务，您可向当地的金蝶业务联系人和合作伙伴进行咨询。
著作权声明 著作权所有 20XX 金蝶软件（中国）有限公司 。
所有权利均予保留。
目 录
2. 使用KdmainDBG.exe跟踪的几种常见报错类型. 3
1. 组件跟踪工具简介（KDMainDBG.exe）
K/3 从 10.2 版本开始，其客户端的安装目录中附带了一个功能强大的调试工具：KDMAINDBG.EXE。该工具可以跟踪 COM+组件的运行情况，但在V10.2版本之前并没有附带这个工具，可安装一个K/3性能监控工具来实现相同的功能；
文件的路径是在……\Kingdee\K3ERP目录下，其执行文件的名称是 kdmaindbg.exe。
如何找到kdmaindbg的快捷方式。在win 7之后的操作系统可以右键桌面金蝶k/3 wise图标，选择【打开文件位置】直接到K3ERP文件夹下搜索打开。
2. 使用KdmainDBG.exe跟踪的几种常见报错类型
2.1 Active X部件不能创建对象
图-1 报错类型1
2.2 Automation错误
图-2 报错类型2
2.3 定义的应用程序或对象错误
图-3 报错类型3
2.4 未设置变量or withblock变量
图-4 报错类型4
3. 组件跟踪操作方法
3.1 报错跟踪
首先，右键桌面金蝶k/3 wise图标，选择【打开文件位置】直接到K3ERP文件夹下搜索【kdmaindbg】，然后右键以管理员身份运行，打开后会提示“您使用的是k/3调试版本！”。如图-5、6所示。
图-5 组件跟踪工具
图-6 组件跟踪工具打开界面
点击【确定】后，程序会自动打开K/3 主控台的登陆窗口，同时也会开启一个组件跟踪窗口，实时记录当前K/3 组件的调用情况，如果有组件出现异常，那么通过它非常方便定位问题并解决问题，另外该工具还跟踪了对象的执行时间，可以用来检测性能数据。如下图所示。
常常会出现打开没有反应或者报错请关闭数据执行保护：打开开始-运行-cmd。输入bcdedit.exe /set {current} nx alwaysoff 回车。重启电脑再打开工具。如图-7所示。
图-7 出现登录客户端主控台界面
在出现的登录界面登录，然后操作到报错的地方，报错出现后，点击【确定】，然后查看跟踪工具界面；当我们跟踪到有组件出现错误时，会出现一条红色显示的记录，表示该组件调用异常，注意下图中的两个组件红色可以忽略。
图-8 组件跟踪界面-可忽略组件
其他的红色标志则是跟踪到的问题组件，一般只需要以第一个“.”前的英文名称为组件名。
图-9 一般组件跟踪报错界面示例
则此问题组件名称为“EBSDataflow.xxx”,xxx是此组件的类型，那我们接下来介绍如何根据组件类型来重新注册组件。
3.2 重新注册
如果是服务器上也报错，那么需要首先在服务器上重新注册组件，一般的服务器报错会带动所有客户端都报错，服务器正常了，客户端也就正常了。当我们想要将跟踪到的组件重新注册的时候，就需要知道这个组件是什么类型的，才能使用正确的方式来注册。
k/3的组件有：
（1）COM+组件：*.dll 和*.vbr文件
服务器：可在Mtsspsetup.lst查看文件列表，文件类型为*.dll
客户端：可在Kdcom.cfg查看文件列表,文件类型为*.vbr，vbr与dll一一对应
图-10 中间层COM+组件
图-11 中间层COM+组件（纵向）
红色框里的是中间层COM+组件，可在Mtsspsetup.lst查看文件列表；
确定了需要重新注册的组件后，即可进行注册操作。在重新注册之前，为避免k3 客户
端正在使用，造成k3应用的错误，需要先关闭此组件所属的组件包。关闭组件包后，删除所对应的组件；然后再重新注册。
注册方法：
（1）工具注册方法：使用中间层组件注册工具注册：注意此工具是重新注册所有中间层COM+组件，注册之前需要先将COM+应用程序里的ebo开头的组件包和加密组件kdsvrmgr删除，然后再运行中间层组件注册工具。
（2）手动注册方法：这里将以中间层组件 EBSDataFlow.dll为例来介绍注册方法。
首先确认到此组件属于哪个ebo组件包，需要到Mtsspsetup.lst查看
图-12 中间层COM+组件列表查找操作
此时可以看到该组件属于ebopublic组件包
①直接拖入法：我们在k/3安装路径下（右键桌面金蝶k/3 wise图标，选择【打开文件位置】直接到K3ERP文件夹下）搜索找到此组件，将其拖入【控制面板—管理工具—组件服务—计算机—我的电脑—COM+应用程序—ebopublic】 双击打开【组件】，将其拖到此处即可完成注册。
图-13 中间层COM+组件重新注册方法
②新建组件法：右键点击组件包下面的【组件】文件夹，在弹出的菜单中选择【新建】→【组件】，然后单击下一步，如图，图-14至图-19为注册步骤。
图-14 新建组件
图-15
选择【安装新组件】，然后点击【下一步】。
图-16
从弹出的窗口找到K3安装路径下的…K3ERP/KDSYSTEM/KDCOM下查找你要注册的文件。
图-17
选择组件后，点击“打开”，界面显示如下。
图-18
注册完成的界面如下：
图-19
至此，组件注册完毕。
（2）非COM+组件：*.dll和*.ocx文件
可在K3ComponentInfo.INI查看文件列表
中间层非 COM+组件主要包含了DLL 和OCX 两种格式的文件，DLL 和OCX 格式的文件，如果在COM+组件列表里查询不到，则到K3ComponentInfo.INI查询，如果有，则是非COM+组件。
注册方法，以组件Ledger50.ocx为例。
通过命令行参数进行注册：在开始－运行中，输入：regsvr32+空格+将此组件拖入，点击【确定】即可完成注册。
图-20 非COM+组件注册方法
或者以管理员身份运行打开cmd命令提示符，在里面输入同样命令回车也可注册。
还有一种所有非COM+组件批注册的方法：执行两个批处理文件即可。
图-21 非COM+组件批处理注册方法
（3）程序/服务文件“*.exe”注册方式以实际程序为准。
3.2.2 个别客户端报错
如果是单台客户端报错，那么我们只需要在此客户端上跟踪，只需要在此客户端上重新注册客户端组件，客户端组件分为：COM+组件和非COM+组件。
COM+组件注册方法：COM+组件的文件类型为*.vbr，与中间层COM+组件的*.dll一一对应。
vbr组件的注册方式：
通过命令行参数注册：在开始－运行中，输入：clireg32+空格+将此组件拖入，点击【确定】即可完成注册；
图-22 客户端COM+组件注册方法
或者通过打开方式注册：右 键 点 击 需 要 注 册 的 vbr 文件， 选择【打开方式】， 在【打开方式】中选择C:\WINDOWS\system32\clireg32.exe，点击【确定】按钮弹出注册对话框，点击确定后，远程传输选择"DCOM"，网络地址输入中间层服务器的机器名或IP 地址，协议默认不变；64位操作系统要选择C:\Windows\SysWOW64\clireg32.exe来注册；下面以Windows server 2016系统来演示一下：（图-23至图-29为注册步骤）
图-23 图-24图-25
图-26
图-27
图-28
图-29
这样即可完成注册；
客户端非COM+组件注册方式：客户端非 com+组件主要包含DLL 和OCX 文件，其注册方法参考中间层非com+组件的注册方法。
3.2.3 报错情况处理
图-30
是由于63位系统直接使用开始-运行注册有时会提示，这时就需要使用打开方式选择syswow64下的clireg32.exe来注册；
图-31
这种情况是由于系统用户权限不足，导致注册权限不够引起的，需要切换管理员权限的用户后再注册。
至此，我们的组件异常操作就基本覆盖，本文档适合一般的管理员和有一定IT基础的人员进行学习。
组件跟踪工具使用方法.docx(1.56MB)
推荐阅读