ISV产品接入指南2（DOC33）.docx
77页
ISV产品接入指南目 录1 文档目的 32 ISV接入提交项 33 接口开发与测试环境 34 ISV接入工作内容 45 接口定义 55.1 接口实现形式 55.2 平台提供给ISV的接口 55.2.1 Web Service（参数为实体对象） 55.2.2 Web Service（参数为XML字符串） 55.2.3 Post方式 55.3 ISV需要实现的接口定义 65.3.1 实现方式1：Web Service（参数为实体对象） 65.3.2 实现方式2：Web Service（参数为XML字符串） 65.3.3 实现方式3：Post方式 65.4 ISV接口实现注意事项 65.5 接口调用示例 75.5.1 示例：Web Service（参数为实体对象） 75.5.2 示例：Web Service（参数为XML字符串） 85.5.3 示例：Post方式 85.6 接口消息格式 105.6.1 请求消息 105.6.2 返回消息 115.7 消息体加密处理 135.8 消息调用返回码定义 136 接口开发与产品改造指南 166.1 接口实现过程步骤 166.2 配置文件 166.3 接口实现 176.3.1 产品订购 176.3.2 用户授权 196.3.3 健康检查 266.3.4 产品登录 286.3.5 心跳保持 306.3.6 数据同步 316.3.7 客户端登录 317 接口测试指南 327.1 测试准备工作 327.1.1 基本数据准备 327.1.2 基本数据检查 327.2 加解密算法测试 337.3 开通企业客户测试 337.4 企业用户授权测试 337.4.1 集成授权测试1 337.4.2 集成授权测试2 347.5 产品登录测试 341 文档目的本文档用于于帮助IISV了了解其产产品接入入平台时时需要进进行哪些些工作、如如何进行行这些工工作、完完成后如如何进行行测试等等，ISSV在开开始接入入工作前前，请详详细阅读读此文档档内容。
2 ISV接入入提交项项类型提交项重要程度描述文档产品图标必需用户订购时时显示的的产品图图标产品介绍必需产品简介，介介绍产品品的宣传传亮点、在在技术、功功能、应应用等方方面的特特点，以以及产品品能为用用户在哪哪些方面面带来价价值等用户手册必需详细介绍产产品的管管理功能能与应用用功能的的使用方方法，指指导企业业的管理理员与最最终用户户使用系系统安装手册必需系统的安装装部署说说明文档档，能让让平台维维护人员员参照此此文档即即可自行行完成产产品部署署FAQ可选提供最终用用户在使使用系统统中遇到到一些常常见的问问题时的的一般解解决方法法多媒体培训训材料可选Flashh、视频频或其它它形式的的多媒体体培训材材料程序系统程序必需产品可运行行程序与与数据库库等接口程序必需产品接口可可运行程程序产品接口访访问地址址必需产品接口部部署后的的访问地地址，其其中的主主机名与与端口可可替换为为实际部部署环境境的主机机名与端端口产品系统访访问地址址必需产品部署后后的访问问地址，其其中的主主机名与与端口可可替换为为实际部部署环境境的主机机名与端端口3 接口开发与与测试环环境资源描述http:://2222..92..1177.855:70012沙箱环境平平台登录录地址http:://2222..92..1177.855:70011/SSaaSS2ISSVInnterrfacce.aasmxx沙箱环境平平台Weeb SServvicee地址http:://2222..92..1177.855:70011/SSaaSS2ISSVInnterrfacceURRl.aaspxx沙箱环境接接收Poost数数据地址址http:://2222..92..1177.855:70012/SSSOLLogiin.aaspxx沙箱环境平平台单点点登录地地址http:://2222..92..1177.855:70009提供示例程程序、加加解密算算法、接接口调用用日志查查看、SSDK等等辅助调调试资源源4 ISV接入入工作内内容u ISV产品品改造1) 平台中维护护的数据据，ISSV产品品中不可可增加或或删除，如如企业、用用户。
2) 平台中维护护的数据据，ISSV产品品中仅可可编辑平平台中不不包含的的数据属属性的值值3) 去掉登录页页面4) 去掉注销、退退出等功功能5) 去掉修改密密码、修修改个人人信息等等功能6) 平台用户的的ID为为GUIID，IISV需需实现此此ID与与其产品品中的用用户身份份的对应应7) 提供体验功功能，能能让用户户点击产产品体验验链接后后，以一一个默认认体验帐帐号的身身份直接接进入系系统，让让用户简简单试用用u ISV接口口实现1) 企业客户业业务受理理接口：：企业订订购时调调用，平平台会传传送企业业的信息息给ISSV；2) 企业客户员员工业务务受理接接口：企企业建立立用户时时调用，平平台会传传送用户户信息给给ISVV；3) 角色列表同同步（读读取）接接口：企企业给用用户分配配权限时时调用，如如果产品品无角色色功能，可可不实现现4) 用户角色权权限同步步（读取取）接口口：企业业给用户户分配权权限时调调用，如如果产品品无角色色功能，可可不实现现5) 用户角色权权限同步步（更新新）接口口：企业业给用户户分配权权限时调调用，如如果产品品无角色色功能，可可不实现现5 接口定义5.1 接口实现形形式平台与ISSV之间间的交互互接口的的实现有有三种形形式，具具体如下下：1) 双方提供WWeb Serrvicce供对对方调用用，参数数与返回回值使用用实体对对象（实实体类），较较适用于于.Neet平台台或Jaava平平台。
2) 双方提供WWeb Serrvicce供对对方调用用，参数数与返回回值使用用字符串串（XMML文本本），较较适用于于Javva平台台或其它它异构平平台3) 双方提供接接收Poost数数据的页页面，PPostt的数据据及返回回值均为为字符串串（XMML文本本），较较适用于于Javva平台台或其它它异构平平台如PPHP、AASP等等5.2 平台提供给给ISVV的接口口5.2.1 Web SServvicee（参数数为实体体对象）方法名称SaaSIISVIInteerfaaceXXMLSStriing参数数据类类型RequeestIInfoo返回值数据据类型RespoonseeInffo5.2.2 Web SServvicee（参数数为XMML字符符串）方法名称SaaSIISVIInteerfaaceXXMLSStriing参数数据类类型Strinng返回值数据据类型Strinng5.2.3 Post方方式请求方法POST参数形式Msg=xxml格格式的字字符串参数数据类类型Strinng返回值数据据类型Strinng5.3 ISV需要要实现的的接口定定义ISV从接接口实现现的三种种方式中中，选择择一种适适合自己己平台的的方式实实现给平平台调用用的接口口。
5.3.1 实现方式11：Weeb SServvicee（参数数为实体体对象）方法名称ISVSaaaSIInteerfaace参数数据类类型RequeestIInfoo返回值数据据类型RespoonseeInffo5.3.2 实现方式22：Weeb SServvicee（参数数为XMML字符符串）方法名称ISVSaaaSIInteerfaaceXXMLSStriing参数数据类类型Strinng返回值数据据类型Strinng5.3.3 实现方式33：Poost方方式请求方法POST参数形式Msg=xxml格格式的字字符串参数数据类类型Strinng返回值数据据类型Strinng5.4 ISV接口口实现注注意事项项1) Web SServvicee方法只只有一个个参数，通通过传递递不同的的参数CCodee来指定定调用的的功能2) namesspacce 必必须是：：htttp:///SaaaSIInteerfaace..Sissparrk.MMm/，包包括最后后一个反反斜线几种实现方方式提供供的接口口方法的的功能一一样，只只是参数数和返回回值类型型不同具具体的业业务功能能和返回回信息由由请求消消息头的的操作码码（
示示例如下下：publiic RessponnseIInfoo ISSVSaaaSIInteerfaace((ReuesstInnfo re) { ReespoonseeInffo rrespp = neww RessponnseIInfoo();; swwitcch ((re.Heead..Codde) { ///企业业客户业业务受理理接口 ccasee "ISSV1001011": { reesp = IISV1101001CoorpBBindd.ExxecuuteBBusiinesss(rreq)); reeturrn rrespp; } ///企业业客户员员工业务务受理接接口 ccasee "ISSV1001022": { reesp = IISV1101002SttafffBinnd.EExeccuteeBussineess((re); reeturrn rrespp; } ///角色色列表同同步（读读取）接接口 ccasee "ISSV1002011": { reesp = IISV1102001PuullRRolees.EExeccuteeBussineess((re); reeturrn rrespp; } ///用户户角色权权限同步步（读取取）接口口 ccasee "ISSV。
