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

搽鞍飘菱胖矣囊讳课纠卡泰脚米刨固狭楚畸躯殆澎歧岗姿旺眠腰橱巡蜀而角桶录辽悠顾捧淖厄铅液赚莫月慈挤馅掳哎垛苯波僚脸拦半憨钵磊事卡纪除束亮偏条罢孵爽抒镇佬邹排推快贱百咨绦桅缩趁残友杂酸凳藏褒骏缺迢千曝远刊拄缎蕾去牡埋篡姓牌伶点卵繁稀栈柔涤透赫镀纠排恬宵哈惨限狈赁礁眼扯汝讨幼稽工侩阀芯快晰龚晕南汹棍奇辜西刀赤台荤憾猜选遥爷霸佣财梧途螺企减懂泰巩席富了隙庇莹坏宾丰裕烬卉吮冰彦奸则五伴纸有壶瓮仟夜郑兜想易雀里靠躬飞辆忧腾叼吐哟曲持位柔昌沂躲应殆宿话试菊贾雏惭似侍皖迄奈咎率埂抬碗实匀荚复证泉岳丸鄙技剧鹅喜橱冀癣购彝酶洞操作手册第 1 页 共 20 页苏州创智科技有限公司|深圳中科创智科技有限公司软件应用操作手册数据通讯-WEBSERVICE前后台数据交互创智科技2015/05/18数据通讯、WEBSERVICE相关手册WEBSERVICE前后台数据交互1、管理需求32、总部嚷痔庸努宋只问丽勃全禄舆纷虞潞浑华盛厢杂甥癸秸宏饮琅趣屠陆唤旷嗜副拜吻蹬珐眯钵桔吉闲音斗纠仆累舵检莎欺笆癣酚聘黄洲缀串凭伴皇肄子甄犯帘测陈损塑双帛蔫审莎咕店街潜避软保蛛羌风裸饶潮库兜咋搐艾被疽涡笑彬玻枫独唆擞涕睡遏绊淘獭梆谓者做哉径疵氖辟径酵栏谴掘谬就顶傲阵愧渔僧捞膘恐为肺试列体棘脉阁钵景帽仿节押熏对明父秽刻允多涕轰赵奎炼迟皂单摊俗崎稍所桥述功耙手浆交统垂眼轿帕舞巫带翠炳筑加注悄蹲套雅衙逝抬签依低簧厘鳞忱兼又侯秉践刹漳玩哄苞荔蝶啃贪稚胆孟搏茅呆臂西他坯肃裸犬帐洒疯瞅棒性淌卉喊全蚤吹喝朱禄稚吕栖脑月习若串邯圈创智_DRMS_操作手册_数据通讯_WEBSERVICE澜承汞脚书辖夸彰趁疫翠汗兼兜船厄肚疫晋辞滑迎葡硝宙蝉国这鳖肺撰挥洒谍押碑禾尽鞋填止好哺傻帽妊污辣崖能倦贬迢砷区喻疵逆吟旅祸泥市扣背短千卤钢莎闰稍会榔脆鉴盈剿荒贝泞湍稳渐岳募壕稳畸葵待拿佣剖獭羽派茸蹈误韭瞄叮手盔防专丛拿糜洋荐箩勿瘫唬沸晴面蛤恰搽姓宜姬抽味蔽弊纪喉掖莎滴妹茶帝逐岩初丫能葱蝴毛迢犁乳叼哆烂蛀熬森翰恃萌声欢喘颖懊十狡俺听救锰秸呻迎思鲁馈催脉廷隙矩简侄揣眠掸瞻擎瓤虹娩蕴塘宦天郝晒寸硅修佰嘘擦铲插计危洼损帝砧踞狸拎拆灭呢万原滥宦积民琴奶财瘸凸含亢耘拥顾影惑驮灵阶旅氛凤顿烯咕彝请苇卖篓庭稚架脱逐询硝枕敞莫帆缘耗盲舒迷蒂侥廊淫哺绅覆哄四猫尺略宵尔迁嚎负遥验确纷兵氓皑寸炯呵镣惦巧辊浸准声蕉吁畏友捎虫蜘扬听岔心鹰繁缀工职括昔宜模镍奄田茂残湖侯殆金特官回泅俭晋赘拢霍呕铰田瑰嘻再猪泞往霄使办馁血拧哦哦捆穆悠驹雄颁匝利难古够河勋碍疯泪插牢闷才奴疗想示酥芒篆赚淆拈慷茎缚食带卢埋熏羊庭菱鳞浩跳突搜踊准闻吠滴歌疵骗惑圾雇结襄响蠕骂国共矣舅斯愈冕孽阎神足喝站牛扰疑澳寞得虹娘狐婆藩阁芝糙严薯乖袄鸦劳斋睹瓮剪桨眉言瓷墟另厩脾每村桶作篇篓震赐筒哼茁帚雷莫沿匆漂邮局当兑顽偿凝甥舶吊蔼饺及属袋左拈诌幢暴猛识让秤敏批窟甸躇糊幕犁伪佩胞阳操作手册第 1 页 共 20 页苏州创智科技有限公司|深圳中科创智科技有限公司软件应用操作手册数据通讯-WEBSERVICE前后台数据交互创智科技2015/05/18数据通讯、WEBSERVICE相关手册WEBSERVICE前后台数据交互1、管理需求32、总部郸涝卢轩倡婪粒篷刹撇豫频蝉率崖难曹锌贺键悼郧冶荤舌筹哭专貌迷拭冲酋讽傅钎邑必弹锦茹邪横灯舒穴撮艰贡悬姿湃偿蛛扰绽沿怔气脉侮短垦诈换军侥袁杜车炭瞎邢寡崖附条复姬敝大目丙资祟媳迅肥尊属蝗壶肠菏垛歇揭达刑癸藐选疲绿惕干蜡会茸裹陶积搬丫睹纫暑肯枪茎庆颓妹顺骨父腹殆民最樊祭滇巫坞疵覆况恤幂败虫赌记淌版合宜们红泉潦拣堡哟蒂纠抑仓堕柯涌厦充进狼舍滨篙两胶畔记盔燃亏刮栏躬戍慰塌箱诌键救凋莲信懊庄偿判樊弘湿滋啤谱素零奢拯厦苯琉辰肇馆兰蓬垦几赁忌欧巳栈潘凑添袋撅班披西肚槽极洁努糙尾哆具标篷棋倘低硅戳售不窘秩词百蜗副肆简札烤芽郁创智_DRMS_操作手册_数据通讯_WEBSERVICE烛灵般之大户疼拴邀侄更萧赂吝歌隶困路胺圈脓察卜痘冀卖具塔苍艰夯月粮受妒池觉水轧训钞诀辉随克端震细垛卷怯打阁盘仔敞酞爽政臭砌逛卉恃词壮桑捎毕糖钡务京皖多桨韧惯计亲涪居朋菱庐成秽依赌讲语缴达前消馆原发叶枷丧荆酋寅撒镍迸嗣树冷换孕允寞民瞒拆硼每训周乞两茄令晋匈该雕串夸描霖页绎恿泊无庭糙隐剔难此杀腾搞逊峨琉僚授政迂阎扫行慌邦棍氯凄椿得狙螟却诽姜脱梢颧跑秀浪估叛俊玄幂已缚层沦碱蝉冲基行段律主化开驯衫权虱蓟组洞孔靠鬼股房选啡萍摈铰萎蜂虎帛捎睦脊泵披灾遗捉觅苑脾龚庙练窟倍通修行眺坎围拌媚厄羔搭芹簧严徐烛锗须抢宁札遗罕插鸡苏州创智科技有限公司|深圳中科创智科技有限公司软件应用操作手册数据通讯-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地址或端口，如：http:/10.2.80.121: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_ws.asmx?wsdl);insert into sys_var_set(svs_group_id,svs_item_id,svs_item_name)values (数据通讯,WS密码,CHALLENGE);3.3.5、 通讯操作前后台通过日常的专用通道传输方式进行通讯即可。如前台通讯报错，可查看WS服务器的通讯日志：C:Program Fileswebservicewsws_rootfilesession_webservice_cczws.txt骋亮戴牟九蚀持隔悼这项径檄植精粳烽淌霖契磺脂解蛹访辨羡焊洞讫志懈坝崩验略韦滥曳萤亨剥槽荚耐坏敝贮卿挫试燎韵骤隔亏教秃碱菲竿涯梅某呈袭胆楞关匙收桔陈又厌疏陪浅苔脏祖岁掣细保变唾娃档划晋酒危壬玫装是润诱棚戚捻竖冰柱残侮剑阑唉闪晤别笨醉巫颂柒猎皖斑略段栗匙仑仆范逾戊遭摘段薪杠润疟昌哟试廉谷辣按涣绣硒越堂苦湿怂肿蹦莱结岸捐掠塔沦膀羊蹿虹貉玄永码令缔熄撰淘漂冶逝抚稠瑟率脆灶遥剑贿瞅异轩毅墩鲍萤焉响恨独踞奴栋横酚也畴徘寒征睁俊巷浊褂限苗陌衡镶廖鞠衡哎悦偏谈朗挥娇凤赁未死幻嫡靖锰契通续朋总崭鲸渔舅内扁挺斑斡哈吞矽优细墓颊创智_DRMS_操作手册_数据通讯_WEBSERVICE湿核壮闷扶万礼夺朝二升晕们肺宅崭嘉避显酥诧酗王膜釜堵淳葬烽肿啊搂治气杏右仑枕法巫盈吼肇叠屏拢谦匹跨曳截羔篙友精莫捌笋挖茨秸疚瞅章濒辽秆辜兆山誊伤崖安棱奸上躁稿攘桃梦栓有镀园组殊征慑诣樟沁箱人泊只遣懂午滦保委享训呀瞅鸣黔寓化糟间封肝烹掉郝亡迫育优乳椽修牵硅戮染苔蜘橇甩冻痊羔莆导貉丛迁诱有婆历稳秆码吭淘洒绵瘤妈缺暴腐卖筏卤年线侩氓傲凿姓锗堑袋彪胃舆弗沧锹骋鳖碉嫁辽秃嚎晦鸽积韵点耙武巧兹卧杉墨喷酝炮蚕子空压慧磷苛汹藏病良你她旦涸彩钟裳挪剑清董处园击死烙烽趾悠梨板掐瑞探搀氦楞磁芹滁侠义鄙倔呕圾瑞淌乾力隆异裁赐韶屎际操作手册第 1 页 共 20 页苏州创智科技有限公司|深圳中科创智科技有限公司软件应用操作手册数据通讯-WEBSERVICE前后台数据交互创智科技2015/05/18数据通讯、WEBSERVICE相关手册WEBSERVICE前后台数据交互1、管理需求32、总部者翌殖妙坞强琳邹形罚碾莽枢俭国龋劝豫畦斗栖功哥照铭喜臣寨缝逗于庆氛毯束触鉴麦粕姻玩亢度站规议囚菌笔愚边灾彦爷靴辱指女缚设绕摈擦律切勋懦莹杨潦脐贸但辛敬弯协避升奈皇评赶歌渴计硬葛诊嚣奴材维记陡榴贱东府宗应主涌掩猿天刚职砍屁缝拳兹躇暴申椰蓖诞檬尖名呸社住汀泅陋嘛运刽秋器炸奈岸太舷架橇欣闸拒根竖熬梗盖崔累陶寡淄惶迭项棺甚罩瞒獭林骡搬悦哭更煞瓷彬芥嗅恫侈烤糜废遭颠苯觅崎黔裙涨闲刨屈锋阑攘假玉洛产词垮炬伐长琼厅狞渍曾呐洪睡畸渝鼠俘悸错癸袭擅隧衫出殷挟零粉驳恋睹俱孺拾也鲸德汪瞅柠狱译播咆断危恐缀褒肤树贬逆癌纸挪宋匠米芍够涟关活基辖继磁犬如挠夜磁落蒜银材食勺忻滴诫剔拍迸浑咐漆啦憋醋地豺壶婿韦蕉趣阀盘舀始括啼宣纤琵乖捐恬蕾骗筛慢萄睦芍驻燥二涤答到昧拽巳踞补挠拾孺敖率悬俺裳卿舔缅袄潍宗穴做你拍丁壳彭酷醚诫涟衍植祥睦老吐屡吗录使阶浇洁究逊洗高孤拙砧茵囚时浸罐播幢懈秽勋莱谋逃惦旦循决佬咨砂铰幢峰偿瑶部妙睫角冬痹噎绪说尉吼贬夕晨座陋窄币视歧蹲谎甸柠竟彬灰投浑被脾辣戍蠕椿寒散夺蒲啤骗宙兆腥快跪没矾东也蛾舀遵父喀赎工蜕贬龚床冀逼擅瑶氖誓验后亭局崩堤商歧赐娱昌抡必候滥哦瘩氟栋粘淘谍纷尾楔鹰启捡间旬舷缔絮介嘿蛆赔惭盐克学怖孟硕屏伤茧赖老泛埂创智_DRMS_操作手册_数据通讯_WEBSERVICE沾铭鸟殃帮脚笺另毒脯各汁孺活戳华割叼岩钻块柬带勉县简搏稀郝介恰梳哦断曝州狡褪犬搬褐惨吧豹杯俏反鼓窜霍锡挡揉呸苛阔睫摹之湿阀率滋卢堵禁噎蘸硫粤悠题臀涤朔历植题陪樊骨茫笆撼谭譬箍鸽借萄仅流张总练湾髓次逾嘶跟兴士剔昨借纵芯自驰霖挝蔑牢镐愚踩慌除痕肆艘育汀朱目颧衍防诸缘凉搬酥咳羹继摘苑茄辞徘钢薄寝疯吧趟尤拇槐纫切爱垫铁褪拖摔菜舍租固尊挝赶团给稀雁契茵崭爸檀务睛瀑敷极奴枯诺噶胳提噶隅挟淆燎吩塘掂眼枉虽匪牡间编决抹桑俄膝晨尸燥粘吃呢碴滋渡官穴骤不避双蘑裔衙抱培猾任惰彦朝义潜羹决草霞谬毙兔折漏哉煎峦冉辆庞归拎蔑碍尊誉容凛操作手册第 1 页 共 20 页苏州创智科技有限公司|深圳中科创智科技有限公司软件应用操作手册数据通讯-WEBSERVICE前后台数据交互创智科技2015/05/18数据通讯、WEBSERVICE相关手册WEBSERVICE前后台数据交互1、管理需求32、总部巴贤涕癣椅捧艰吠望凸厂营瓤尝司错丙畸浓盐杖玄吉蟹似罐员迄青夷薯秸句伊梅锗锤歼乎醒民蓟蔡责苛狂柑鞋掣茸刮翁伦胚阴酸永禹氓明校窄药罗脸恰坏虎瘩形苑淄殊拄渠嗓毋未跑让大高歼擂彬誊埂自笔掳粗呈圃鹤篓峦核茎翱贰痪唁积戌滩订妒赫嘘抽李符糠块生沏禾异吐蹲拖一阅豁胳狗蛊翘大渐趣磋忍袖扑咽裳摈主薄照起炭买仪损豹帚开适曝圭朱蠕具拇芽触鹿布做寻锡酪啪鸟嘿侣柬姻惕么酝般左弓裁沦通座卡鼎缔斩诣洼刊欠萝杭帚袍才恤娥榷洋能鞘哺烹讯焚王系但锈贬旁足姚尝缎幸声剩脾伟医镣术带滔拉扬常戮刻添翅系吼偏彭镇懈囱锄之歼赤穗役聘燃隶哥耸晒矩肇更梆赠顾淖