创智DRMS操作手册数据通讯WEBSERVICE.doc

操作手册第 20 页 共 20 页苏州创智科技有限公司|深圳中科创智科技有限公司软件应用操作手册数据通讯-WEBSERVICE前后台数据交互创智科技2015/05/18数据通讯、WEBSERVICE相关手册WEBSERVICE前后台数据交互1、管理需求32、总部布署32.1、IIS安装32.2、安装.NET Framework 4.042.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、策略设置19WEBSERVICE前后台数据交互1、 管理需求通过WEBSERVICE的方式来解决门店与总部的数据通讯。2、 总部布署2.1、 IIS安装安装winxp、win2003、win7或以上操作系统。并配置好IIS（win2003和win7安装方法不一样，请查看相关操作手册，提供的操作手册只作为参考，成功安装好IIS即可）。开放HTTP访问端口。2.2、 安装.NET Framework 4.0WS服务是基于.net技术的。如果是用于发布环境（即客户应用服务器的服务端），则只需要安装.NET FrameWork 4.0或以上版本即可。如果在安装IIS之前，已经安装了.NET FrameWork SDK,则需要在电脑开始-运行中执行以下命令，在IIS中注册.NET FrameWork的运行环境。C:windowsMicrosoft.NETFrameworkv4.0.30319aspnet_regiis.exe -i 注：1.如果是用于开发环境，则需要安装.NET FrameWork 4.0或以上版本的SDK。2. 如果电脑没有C:windowsMicrosoft.NETFrameworkv4.0.30319这个目录，说明安装的.NET FrameWork版本太低，需要重新安装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.NET v4.0.30319，必须启用（允许）,如果没有该选项就要做上述说的aspnet_regiis注册。默认网站-属性-ASP.NET，缺省的ASP.NET版本是1.1.4322或2.0.50727，需要手工修改为4.0.30319版本，至此IIS部署完毕，稍候可以把PB开发的WebService，发布到该网站下面。如是WIN7系统，先要查看网站高级设置的应用程序池是什么，默认是DefaultAppPool,再到IIS应用程序池中，把相应程序池的.net framework版本改成v4.0.30319WIN7的64位系统，还需把程序池高级设置里面的“启用32位应用程序”设为True。2.4、 网站访问权限WIN7系统如遇权限问题，可对下面两个目录添加和设置Network Service和IIS_IUSERS这两个用户的”完全访问”权限1、C:WindowsTemp2、C:WindowsMicrosoft.NETFrameworkv4.0.30319Temporary ASP.NET Files相应文件夹右键-属性-安全-编辑，找到相应用户设置权限，没有则添加。2.5、 安装创智WEBSERVICE服务运行ws.msi进行安装。2.6、 安装PB12.5动态库动态库文件分两部分。把需要用到的Sybase.PowerBuilder.*.dll动态库文件放到目录C:Program Fileswebservicewswsbin下面WIN7系统是C:Program Files (x86)webservicewswsbin下面再把其它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的可用性（按下图操作或在浏览器中直接输入http:/localhost/ws/n_ws.asmx）：出现上图的各类函数，表明安装成功。 如浏览仍然报错或出现其它异常错误，请看下一节“其它异常情况处理”。2.7、 其它异常情况处理如果按上述要求拷贝了所有动态库文件到指定目录后，测试WS可用性仍然报错提示：未能加载文件或程序集“Sybase.PowerBuilder.Interop.DLL”或它的某一个依赖项。则说明相关动态库文件所在路径没有被找到或识别，需要更换动态库文件路径，主要出现在win7环境的PBSHR125.DLL文件，文件可放在c:windows或c:windowssystem32。如提示：未能加载由“Sybase.PowerBuilder.Interop.DLL”导入的过程。则说明相关动态库文件损坏或版本不符，需要替换动态库文件，主要出现在win7环境的msvcp71.dll文件，需替换掉c:windowssysWOW64路径下原来的msvcp71.dll文件。注：如DLL文件提示被占用替换不了，可把原文件改名，再把你的DLL文件复制粘贴进去。 如何快速查询哪些DLL文件缺失、版本错误或系统识别不了？可借助“DLL依赖查看工具”，打开未能加载的DLL文件，就会显示与它相关的其它所有依赖的动态库文件，如前面有黄色问号标识，就说明对应的DLL文件不存在或所在路径无法识别，如果DLL文件显示红色，则说明对应的DLL文件版本不符或损坏，系统无法识别。2.8、 安装数据库客户端WS要连接访问数据库，就要安装数据库客户端支持，如安装SYBASE客户端、ORACLE客户端等。如安装Oracle客户端，需通过ODBC在系统DSN中进行连接配置：2.9、 配置cz_conn_ws.ini文件主要用于解决数据库联接配置问题。修改C:Program Fileswebservicewsws_rootfilecommonc 目录下的cz_conn_ws.ini配置文件内容，包括数据库的服务名、数据库名、登录用户名和密码等。 注：如果没有cz_conn_ws.ini文件，需要新建或复制一个进去。Sybase数据库连接配置实例示例：webservicevendor=sybasedriver=SYC Sybase System 10/11server=服务名database=数据库名dbparm=cp850logid=salogpw= userid=sauserpw= connect_times=1Oracle数据库通过ODBC连接配置实例示例：webservicevendor=oracledriver=ODBCserver=服务名database=数据库名dbparm=ODBC名称logid=登录用户名logpw=密码userid=systemuserpw=connect_times=1 2.10、 安全性控制WEBSERVICE是开放的，防止别人调用WS来恶意攻击。前台WS通讯增加用户身份检查，在客户端用：门店号+预设的密码进行验证。后台pos.sys_license表增加机构WS通讯密码：栏位作用示例sl_type类型WS-webservice的控制项sl_id机构号0001sl_license密码tsc0001insert into pos.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安装特殊情况下，安装SOAP TOOLKITWindows自带有，如不支持才需安装。3.3、 策略设置3.3.1、 启用WS通讯前台【系统维护】-【策略性控制】增加以下策略数据通讯WS启用=YN-不启用WS功能。缺省值。Y-启用WS功能。3.3.2、 设置WS通讯密码前台【系统维护】-【策略性控制】增加以下策略数据通讯WS密码=CHALLENGE CHALLENGE为密码，目前测试必须为大写，可自定义，需与后台设定的密码一致。3.3.3、 WS通讯地址设置根据各类数据处理存贮的设定不同，分为二种WS服务器的设定。数据通讯WS地址总部=http:/localhost:80/ws/n_ws.asmx?wsdl数据通讯WS地址区域=http:/localhost:80/ws/n_ws.asmx?wsdl如果不区分服务器，就二个地址设定成一样。http:/localhost:80/ws/n_ws.asmx?wsdl这个是示例，根据实际情况，要修改好域名、IP地址或端口，如：21:8080/ws/n_ws.asmx?wsdl之类的。注意：后面要加上“?wsdl”。3.3.4、 策略快速增加语法同样，需先修改好域名、IP地址或端口。insert into sys_var_set(svs_group_id,svs_item_id,svs_item_name)values (数据通讯,WS启用,Y);insert into sys_var_set(svs_group_id,svs_item_id,svs_item_name)values (数据通讯,WS地址总部,http:/localhost:80/ws/n_ws.asmx?wsdl);insert into sys_var_set(svs_group_id,svs_item_id,svs_item_name)values (数据通讯,WS地址区域,http:/localhost:80/ws/n_w