金蝶知识库文档金蝶软件(中国)有限公司客户成功部第1页共31页WMS模块环境配置及常见问题�本文档适用于WMS二维码模块新版本架构的环境配置�2018年10月18日V1.0编写人:叶鑫�2020年2月21日V2.0编写人:叶鑫�本文件使用须知著作权人保留本文件的内容的解释权,并且仅将本文件内容提供给阁下个人使用。对于内容中所含的版权和其他所有权声明,您应予以尊重并在其副本中予以保留。您不得以任何方式修改、复制、公开展示、公布或分发这些内容或者以其他方式把它们用于任何公开或商业目的。任何未经授权的使用都可能构成对版权、商标和其他法律权利的侵犯。如果您不接受或违反上述约定,您使用本文件的授权将自动终止,同时您应立即销毁任何已下载或打印好的本文件内容。著作权人对本文件内容可用性不附加任何形式的保证,也不保证本文件内容的绝对准确性和绝对完整性。本文件中介绍的产品、技术、方案和配置等仅供您参考,且它们可能会随时变更,恕不另行通知。本文件中的内容也可能已经过期,著作权人不承诺更新它们。如需得到最新的技术信息和服务,您可向当地的金蝶业务联系人和合作伙伴进行咨询。著作权声明著作权所有2017金蝶软件(中国)有限公司。所有权利均予保留。本期概述版本信息版权信息金蝶知识库文档金蝶软件(中国)有限公司客户成功部第2页共31页目录1.IIS安装..............................................................................................................................32.安装.net4.5.....................................................................................................................43.站点发布.............................................................................................................................54.站点配置.............................................................................................................................75.启用服务...........................................................................................................................146.验证...................................................................................................................................147.PDA操作............................................................................................................................248.常见问题...........................................................................................................................25问题1关键词:ADOBO.........................................................................................................25问题2关键词:Lodop.............................................................................................................27问题3关键词:没有注册类...................................................................................................28问题4关键词:灾难性故障...................................................................................................29问题5关键词列名、字段、无效...........................................................................................30问题6关键词:创建…失败、未找到依赖性.......................................................................31金蝶知识库文档金蝶软件(中国)有限公司客户成功部第3页共31页1.IIS安装首先检查WEB服务器与中间层服务器IIS是否正确安装。IIS安装不同操作系统略有不同,这里以WINSERVER2012R2系统安装操作步骤为例,若您的计算机不是以上操作系统,可百度解决,以下方法仅供参考:Win7:参照链接http://www.jb51.net/article/29787.htmWin2008:参照链接https://jingyan.baidu.com/article/455a9950535a95a1662778da.htmlWin2003:参照链接http://www.jb51.net/article/21274.htm,注意安装i386文件打开服务器管理器—仪表盘—配置本地服务器—添加角色和功能。安装类型、服务器选择也都默认下一步,直到添加服务器角色页面,将WEB服务器(IIS)中的每一个子项都勾选,然后点击下一步。金蝶知识库文档金蝶软件(中国)有限公司客户成功部第4页共31页在功能页,将.NETframework3.5功能和.NETframework4.5功能全选,然后点击下一步。然后点安装,直到完成。安装完成之后,检查IIS是否安装正确在本地浏览器输入http://localhost,显示如下则正确安装,否则请重新安装。2.安装.net4.5请务必安装.NetFramework4.5或以上版本。部分win2008/win7、win10/win2012/2016可能系统自带版本为.net4.5甚至更高版本,可以直接在系统里面通过添加的方式进行安装,但是其他系统不自带.net4.5版本的,需要手动下载安装包进行安装。金蝶知识库文档金蝶软件(中国)有限公司客户成功部第5页共31页下载链接:https://www.microsoft.com/zh-cn/download/details.aspx?id=30653如果先装的.NET后装的IIS,需重新注册net到IIS。1、在服务器上运行中输cmd,调出DOS命令窗口。2、在命令窗口中输入:C:\Windows\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe-i命令窗口出现上述界面,表示注册成功。3.站点发布1、服务器上运行“站点及远程组件配置工具”,在第一步里中间层服务器地址里填上对应的IP或者计算机名(中间层和web分开部署时需要特别注意,安装在一起时可默认)。金蝶知识库文档金蝶软件(中国)有限公司客户成功部第6页共31页2、然后点击下一步,进到配置web服务器界面,点应用等待站点发布完成。3、站点发布完成之后,打开IIS->网站->defaultwebsite,显示所有的站点如下图。金蝶知识库文档金蝶软件(中国)有限公司客户成功部第7页共31页4.站点配置4.1应用程序池设置1、打开IIS主页,点击ISAPI和CGI限制功能,查看.net2.0和4.0限制是否都设置成允许。金蝶知识库文档金蝶软件(中国)有限公司客户成功部第8页共31页若此处显示的ASP.NETV4.0.30319后面有(32-bit),请使用命令先卸载掉.net再安装,重新安装后再将限制设置为允许,此问题常见于win7和winservr2008系统。金蝶知识库文档金蝶软件(中国)有限公司客户成功部第9页共31页在应用程序池下,检查是否存在如下两个名称:名称:KingdeeK3Net4,.NET版本为4.0,托管模式:经典。名称:KingdeeK3Net4Integrated,.NET版本为4.0,托管模式:集成。检查2个应用池的高级设置,“启用32位应用程序”需为“是”。金蝶知识库文档金蝶软件(中国)有限公司客户成功部第10页共31页在网站->defaultwebsite->K3netsite->高级设置->应用程序池,查看应用程序池版本为.Netframework版本:4.0,管道模式:经典。若不存在此站点,或应用程序池不满足.Netframework版本:4.0管道模式:经典。则手动添加站点并修改应用程序池。手动添加K3NetSite站点选中defaultwebsite节点,右键添加应用程序,其中别名为:K3netsite,物理路径为:…\kingdee\k3erp\k3netsite。其中…表示K3的安装路径。录入后,点击确定即可添加站点。金蝶知识库文档金蝶软件(中国)有限公司客户成功部第11页共31页修改k3netsite应用程序池。选中k3netsite的节点,点击高级设置,修改应用程序池,选择.Netframework版本:4.0,管道模式:经典的应用程序池。另外WMS模块需要用到的站点分别为WMSAPI和WMSAPP,其应用程序池为KingdeeK3Net4Integrated。金蝶知识库文档金蝶软件(中国)有限公司客户成功部第12页共31页若不存在此站点,或应用程序池不满足.Netframework版本:4.0,管道模式:集成。则手动添加站点并修改应用程序池,操作方法同K3NetSite站点的设置方案。4.2IIS权限设置对IIS几个主要的站点均设置IIS控制权限,IIS6及以下,对用户networkservice赋予控制权限;IIS6以上,给IIS_IUSRS赋予控制权限。可参考以下K3NETSite的权限设置将相关站点(K3NetSite、WMSAPI、WMSAPP)的权限都设置一下。在网站_DefaultWebSite_K3NETSite节点下,点击右侧编辑权限,选择IIS_IUSRS,对其进行授权:完全控制。如果是IIS6以下,则对networkservice赋予控制权限。金蝶知识库文档金蝶软件(中国)有限公司客户成功部第13页共31页4.3配置servername对于非80端口的服务器IP,改变端口需要配置指定文件,路径C:\ProgramFiles\Kingdee\K3ERP\KDHR\SITEFILE\WEBUI\servername.ini。若路径下无此文件,请手工创建一个,内容同上,修改完之后重启下IIS。金蝶知识库文档金蝶软件(中国)有限公司客户成功部第14页共31页5.启用服务打开控制面板\所有控制面板项\管理工具,点击服务。找到kingdeeK/3backgroundtaskservicefor.net和kingdeeK/3servicemanagerfor.net两个服务,并启动。启动操作如下:选中服务->右键->启动。6.验证6.1检查三个关键站点1)浏览K3Netsite站点金蝶知识库文档金蝶软件(中国)有限公司客户成功部第15页共31页正常应能显示以下界面:2)浏览WMSAPI站点正常应能打开以下界面金蝶知识库文档金蝶软件(中国)有限公司客户成功部第16页共31页3)浏览WMSAPP站点正常应能打开以下界面:金蝶知识库文档金蝶软件(中国)有限公司客户成功部第17页共31页6.2站点浏览报错的解决办法1)浏览时报403.14错误解决办法:哪个站点浏览报错,就对哪个站点做以下设置2)浏览时报404.2错误。金蝶知识库文档金蝶软件(中国)有限公司客户成功部第18页共31页解决办法:如下图所示,找到ISAPI和CGI限制,将相关项设置为允许金蝶知识库文档金蝶软件(中国)有限公司客户成功部第19页共31页3)浏览时报500.21错误解决办法:重新安装.net在cmd命令行中执行:cdC:\Windows\Microsoft.NET\Framework64\v4.0.30319再运行aspnet_regiis-i4)浏览器时没有写访问权限“/WMSAPI”应用程序中的服务器错误。当前标识(IISAPPPOOL\KingdeeK3Net4Integrated)没有对“C:\Windows\Microsoft.NET\Framework\v4.0.30319\TemporaryASP.NETFiles”的写访问权限。解决办法:给提示中对应目录赋予everyone的完全控制权限。金蝶知识库文档金蝶软件(中国)有限公司客户成功部第20页共31页如果无法设置权限,参考下面5)的解决办法5)浏览时报文件拒绝访问解决办法:对C\WINDOWS\temp文件夹添加IIS_IUSRS的所有权限。如下图所示金蝶知识库文档金蝶软件(中国)有限公司客户成功部第21页共31页6)浏览时报错如下解决办法:可能.net安装的是4.0,需要安装4.5如果还是出不来界面,请根据界面上的错误提示代码自行百度。金蝶知识库文档金蝶软件(中国)有限公司客户成功部第22页共31页6.3主控台配置1)恢复账套账套属性不能为windows身份验证,需要是SQLServer身份验证2)关闭防火墙关闭防火墙,否则可能无法通过扫描二维码下载程序到手机端。虚拟机配置如果在虚拟机中安装的K/3,请使用桥接模式,且本机不要开防火墙、杀毒软件。金蝶知识库文档金蝶软件(中国)有限公司客户成功部第23页共31页验证环境是否OKK/3主控台-智能WMS-仓存条码作业-基础设置-二维码扫描登录,输入WEB服务器IP和端口(请根据自己电脑的实际情况设置,不要用下面截图的IP)后,若能正常显示二维码,表示环境配置OK。如果二维码出不来,则参考下文进行检查。若环境配置OK,可通过安卓手机的浏览器(如:qq浏览器)扫描“WMS扫描下载”页面的二维码下载APP到手机上,安装打开APP后,再扫描“内网登录”页面的二维码进入WMS主页面进行操作。(苹果手机不能使用WMS)有时候在环境正常的情况下,刚打开二维码扫描登录的时候也会出现下面的提示,可以尝试退出重新进入,刷新下二维码,如果试了两三次后还是出下面的提示,再按上文的配置章节进行环境检查。金蝶知识库文档金蝶软件(中国)有限公司客户成功部第24页共31页7.PDA操作主控台界面显示的扫描登录二维码和下载二维码均能正常显示出来后,打开PDA上的浏览器,然后对着电脑端下载二维码页签,按扫描键识别二维码进行下载,下载好APK程序安装后进入登录界面,然后将主控台界面上切换到登录二维码界面,按PDA上的扫描键识别电脑端的二维码获取登录信息,若有安装二维码补丁,那么PDA上需要重新扫描下载二维码安装新的APK程序,程序文件存放在金蝶安装路径下的:Kingdee\K3ERP\QRCode\WMSAPI\Apps。手机端安装好APK之后,在登录界面有扫描登录的选项,但是PDA上没有,只有通过物理按键。若PDA设备存在问题,请联系金蝶妙想的何斌。注:PDA或者手机端的网络要求和K3的服务器是正常通信的,测试方法,在PDA或者手机的浏览器里面输入K3服务器的IP地址,如果能正常访问当IIS的主页就代表网络是通的。金蝶知识库文档金蝶软件(中国)有限公司客户成功部第25页共31页8.常见问题问题1关键词:ADOBO操作:打开PC菜单或其他地方保错提示:ADOBOversion7.0.3300.0……系统找不到指定文件,类似错误,如下图:金蝶知识库文档金蝶软件(中国)有限公司客户成功部第26页共31页关键词:ADOBO问题原因:.net的数据集文件adodb.dll在操作系统中不存在解决办法:将k3erp目录下adodb.dll文件拖至C:\Windows\assembly目录下金蝶知识库文档金蝶软件(中国)有限公司客户成功部第27页共31页注意:adodb.dll文件的文件版本7.10.6070.0问题2关键词:Lodop操作场景:二维码打印提示:未找到元数据“D:\ProgramsFiles\kingdee\K3erp\AXUnterop.Lodop.dll”如图:关键词:Lodop问题原因:打印控件在操作系统上为正确安装解决办法:将安装目录…\kingdee\Kingdee\K3ERP\QRCode下Interop.Lodop.dll、AxInterop.Lodop.dll金蝶知识库文档金蝶软件(中国)有限公司客户成功部第28页共31页拷贝至…\kingdee\Kingdee\K3ERP下。问题3关键词:没有注册类操作:打印二维码提示:没有注册类,如图:关键词:没有注册类问题原因:打印控件未安装解决办法:在k3安装目录…\kingdee\Kingdee\K3ERP\QRCode\K3TDC\TDCClient找到intall_lodop32.exe(无论是多少位操作系统,均安装intall_lodop32.exe)文件,安装打印控件。金蝶知识库文档金蝶软件(中国)有限公司客户成功部第29页共31页问题4关键词:灾难性故障操作:打印二维码提示:灾难性故障,如图:问题分析:未设置默认打印解决办法:1、为PC设置默认打印机;2、如果默认打印机不是标准打印机,在打印机首选项中,纸张来源必须为输入纸盒,不能是手动纸盒。金蝶知识库文档金蝶软件(中国)有限公司客户成功部第30页共31页问题5关键词列名、字段、无效操作:在二维码相关应用模块,看见提示:列明’…’无效。如类似下图保存关键词:列名、字段、无效问题原因:账套为未升级解决办法:找到补丁路径C:\ProgramFiles(x86)\CommonFiles\Kingdee\K3\KDPatchs,找到对应二维码相关补丁(参见上述),点击KDdataUpdate.exe重新升级账套。金蝶知识库文档金蝶软件(中国)有限公司客户成功部第31页共31页问题6关键词:创建…失败、未找到依赖性操作:在PC上点击二维码模块下的菜单,提示K3BarcodeApp创建二维码组件失败,请重新安装。如图:关键词:创建…失败、未找到依赖性问题原因:程序或补丁未正确安装。解决办法:重新注册组件"C:\WINDOWS\Microsoft.NET\Framework\v4.0.30319\regasm.exe"/unregister"C:\ProgramFiles(x86)\Kingdee\K3ERP\QRCode\K3BarCode.dll"del"C:\ProgramFiles(x86)\Kingdee\K3ERP\QRCode\K3BarCode.tlb""C:\WINDOWS\Microsoft.NET\Framework\v4.0.30319\regasm.exe"/register"C:\ProgramFiles(x86)\Kingdee\K3ERP\QRCode\K3BarCode.dll"/codebase/tlb"C:\WINDOWS\Microsoft.NET\Framework\v4.0.30319\regasm.exe"/unregister"C:\ProgramFiles(x86)\Kingdee\K3ERP\SetWebConfig.dll"del"C:\ProgramFiles(x86)\Kingdee\K3ERP\SetWebConfig.tlb""C:\WINDOWS\Microsoft.NET\Framework\v4.0.30319\regasm.exe"/register"C:\ProgramFiles(x86)\Kingdee\K3ERP\SetWebConfig.dll"/codebase/tlb