创智_DRMS_操作手册_数据通讯_WEBSERVICE

操作手册第1页共20页苏州创智科技有限公司|深圳中科创智科技有限公司软件应用操作手册数据通讯-WEBSERVICE前后台数据交互创智科技2015/05/18数据通讯、WEBSERVICE相关手册操作手册第2页共20页WEBSERVICE前后台数据交互1、管理需求.......................................................................32、总部布署.......................................................................32.1、IIS安装...............................................................32.2、安装.NETFramework4.0.......................................42.3、ASP配置..............................................................42.4、网站访问权限........................................................72.5、安装创智WEBSERVICE服务....................................72.6、安装PB12.5动态库...............................................112.7、其它异常情况处理................................................132.8、安装数据库客户端................................................142.9、配置cz_conn_ws.ini文件......................................152.10、安全性控制.........................................................183、门店部署.....................................................................183.1、POS程序升级......................................................183.2、SOAP安装.........................................................183.3、策略设置............................................................19操作手册第3页共20页WEBSERVICE前后台数据交互1、管理需求通过WEBSERVICE的方式来解决门店与总部的数据通讯。2、总部布署2.1、IIS安装安装winxp、win2003、win7或以上操作系统。并配置好IIS（win2003和win7安装方法不一样，请查看相关操作手册，提供的操作手册只作为参考，成功安装好IIS即可）。开放HTTP访问端口。操作手册第4页共20页2.2、安装.NETFramework4.0WS服务是基于.net技术的。如果是用于发布环境（即客户应用服务器的服务端），则只需要安装.NETFrameWork4.0或以上版本即可。如果在安装IIS之前，已经安装了.NETFrameWorkSDK,则需要在电脑开始-运行中执行以下命令，在IIS中注册.NETFrameWork的运行环境。C:\windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe-i注：1.如果是用于开发环境，则需要安装.NETFrameWork4.0或以上版本的SDK。2.如果电脑没有C:\windows\Microsoft.NET\Framework\v4.0.30319\这个目录，说明安装的.NETFrameWork版本太低，需要重新安装4.0版本以上。（部分win2003环境在安装【dotNetFx40_Full_x86_x64.zip】前需要先安装32位windows映像处理组件【wic_x86_chs.exe】。）2.3、ASP配置网站的ASP.NET版本必须选择4.0或以上版本。（win2003）IIS里面Web服务扩展中ASP.NETv4.0.30319，必须启用（允许）,如果没有该选项就要做上述说的aspnet_regiis注册。操作手册第5页共20页默认网站-属性-ASP.NET，缺省的ASP.NET版本是1.1.4322或2.0.50727，需要手工修改为4.0.30319版本，至此IIS部署完毕，稍候可以把PB开发的WebService，发布到该网站下面。如是WIN7系统，先要查看网站高级设置的应用程序池是什么，默认是DefaultAppPool,再到IIS应用程序池中，把相应程序池的.netframework版本改成v4.0.30319操作手册第6页共20页WIN7的64位系统，还需把程序池高级设置里面的“启用32位应用程序”设为True。操作手册第7页共20页2.4、网站访问权限WIN7系统如遇权限问题，可对下面两个目录添加和设置NetworkService和IIS_IUSERS这两个用户的”完全访问”权限．1、C:\Windows\Temp2、C:\Windows\Microsoft.NET\Framework\v4.0.30319\TemporaryASP.NETFiles相应文件夹右键-属性-安全-编辑，找到相应用户设置权限，没有则添加。2.5、安装创智WEBSERVICE服务运行ws.msi进行安装。操作手册第8页共20页操作手册第9页共20页操作手册第10页共20页操作手册第11页共20页2.6、安装PB12.5动态库动态库文件分两部分。把需要用到的Sybase.PowerBuilder.*.dll动态库文件放到目录C:\ProgramFiles\webservice\ws\ws\bin下面WIN7系统是C:\ProgramFiles(x86)\webservice\ws\ws\bin下面再把其它DLL动态库支持文件msvcp71.dll，msvcp100.dll，msvcr100.dll，PBSHR125.DLL，PBSYC125.DLL，PBSYJ125.DLL，PBSYS125.DLL，PBDWM125.DLL放到c:\windows目录。（注意：由于oracle版本WS通讯的动态库支持文件尚未确认具体文件，测试时请把PB125_DLL_ALL.rar所有动态库文件拷到c:\windows目录。）然后便可以测试WS的可用性（按下图操作或在浏览器中直接输入）：操作手册第12页共20页出现上图的各类函数，表明安装成功。如浏览仍然报错或出现其它异常错误，请看下一节“其它异常情况处理”。操作手册第13页共20页2.7、其它异常情况处理如果按上述要求拷贝了所有动态库文件到指定目录后，测试WS可用性仍然报错提示：未能加载文件或程序集“Sybase.PowerBuilder.Interop.DLL”或它的某一个依赖项。则说明相关动态库文件所在路径没有被找到或识别，需要更换动态库文件路径，主要出现在win7环境的PBSHR125.DLL文件，文件可放在c:\windows或c:\windows\system32。如提示：未能加载由“Sybase.PowerBuilder.Interop.DLL”导入的过程。则说明相关动态库文件损坏或版本不符，需要替换动态库文件，主要出现在win7环境的msvcp71.dll文件，需替换掉c:\windows\sysWOW64路径下原来的msvcp71.dll文件。注：如DLL文件提示被占用替换不了，可把原文件改名，再把你的DLL文件复制粘贴进去。如何快速查询哪些DLL文件缺失、版本错误或系统识别不了？可借助“DLL依赖查看工具”，打开未能加载的DLL文件，就会显示与它相关的其它所有依赖的动态库文件，如前面有黄色问号标识，就说明对应的DLL文件不存在或所在路径无法识别，如果DLL文件显示红色，则说明对应的DLL文件版本不符或损坏，系统无法识别。操作手册第14页共20页2.8、安装数据库客户端WS要连接访问数据库，就要安装数据库客户端支持，如安装SYBASE客户端、ORACLE客户端等。如安装Oracle客户端，需通过ODBC在系统DSN中进行连接配置：操作手册第15页共20页2.9、配置cz_conn_ws.ini文件主要用于解决数据库联接配置问题。修改C:\ProgramFiles\webservice\ws\ws_root\file\common\c\目录下的cz_conn_ws.ini配置文件内容，包括数据库的服务名、数据库名、登录用户名和密码等。注：如果没有cz_conn_ws.ini文件，需要新建或复制一个进去。操作手册第16页共20页Sybase数据库连接配置实例示例：[webservice]vendor=sybasedriver=SYCSybaseSystem10/11server=服务名database=数据库名dbparm=cp850logid=salogpw=userid=sauserpw=操作手册第17页共20页connect_times=1Oracle数据库通过ODBC连接配置实例示例：[webservice]vendor=oracledriver=ODBCserver=服务名database=数据库名dbparm=ODBC名称logid=登录用户名logpw=密码userid=systemuserpw=connect_times=1操作手册第18页共20页2.10、安全性控制WEBSERVICE是开放的，防止别人调用WS来恶意攻击。前台WS通讯增加用户身份检查，在客户端用：门店号+预设的密码进行验证。后台pos.sys_license表增加机构WS通讯密码：栏位作用示例sl_type类型WS-webservice的控制项sl_id机构号0001sl_license密码tsc0001insertintopos.sys_license(sl_type,sl_id,sl_license)values('WS','机构号','CHALLENGE');3、门店部署3.1、POS程序升级升级到PB9.0版本的程序。a.先覆盖PB9.0所需要的DLL动态库包（PB90_dll.rar）。b.再覆盖前台系统更新包升级到最新程序。3.2、SOAP安装特殊情况下，安装SOAPTOOLKITWindows自带有，如不支持才需安装。操作手册第19页共20页3.3、策略设置3.3.1、启用WS通讯前台【系统维护】-【策略性控制】增加以下策略[数据通讯][WS启用]=YN-不启用WS功能。缺省值。Y-启用WS功能。3.3.2、设置WS通讯密码前台【系统维护】-【策略性控制】增加以下策略[数据通讯][WS密码]=CHALLENGECHALLENGE为密码，目前测试必须为大写，可自定义，需与后台设定的密码一致。3.3.3、WS通讯地址设置根据各类数据处理存贮的设定不同，分为二种WS服务器的设定。[数据通讯][WS地址总部]=[数据通讯][WS地址区域]=如果不区分服务器，就二个地址设定成一样。这个是示例，根据实际情况，要修改好域名、IP地址或端口