ISV产品接入指南2（DOC33页）.docx

ISV产品接入指南2（DOC33页）目 录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 文档目的本文档用于关心ISV了解其产品接入平台时需要进行哪些工作、如何进行这些工作、完成后如何进行测试等，ISV在开始接入工作前，请详细阅读此文档内容。

2 ISV接入提交项类型提交项重要程度描述文档产品图标必需用户订购时显示的产品图标产品介绍必需产品简介，介绍产品的宣传亮点、在技术、功能、应用等方面的特点，以及产品能为用户在哪些方面带来价值等用户手册必需详细介绍产品的治理功能与应用功能的使用方法，指导企业的治理员与最终用户使用系统安装手册必需系统的安装部署说明文档，能让平台爱护人员参照此文档即可自行完成产品部署FAQ可选提供最终用户在使用系统中遇到一些常见的问题时的一样解决方法多媒体培训材料可选Flash、视频或其它形式的多媒体培训材料程序系统程序必需产品可运行程序与数据库等接口程序必需产品接口可运行程序产品接口访问地址必需产品接口部署后的访问地址，其中的主机名与端口可替换为实际部署环境的主机名与端口产品系统访问地址必需产品部署后的访问地址，其中的主机名与端口可替换为实际部署环境的主机名与端口3 接口开发与测试环境资源描述 ://222.92.117.85:7012沙箱环境平台登录地址 ://222.92.117.85:7011/SaaS2ISVInterface.asmx沙箱环境平台Web Service地址 ://222.92.117.85:7011/SaaS2ISVInterfaceURl.aspx沙箱环境接收Post数据地址 ://222.92.117.85:7012/SSOLogin.aspx沙箱环境平台单点登录地址 ://222.92.117.85:7009提供例如程序、加解密算法、接口调用日志查看、SDK等辅助调试资源4 ISV接入工作内容u ISV产品改造1) 平台中爱护的数据，ISV产品中不可增加或删除，如企业、用户。

2) 平台中爱护的数据，ISV产品中仅可编辑平台中不包含的数据属性的值3) 去掉登录页面4) 去掉注销、退出等功能5) 去掉修改密码、修改个人信息等功能6) 平台用户的ID为GUID，ISV需实现此ID与其产品中的用户身份的对应7) 提供体验功能，能让用户点击产品体验链接后，以一个默认体验帐号的身份直截了当进入系统，让用户简单试用u ISV接口实现1) 企业客户业务受理接口：企业订购时调用，平台会传送企业的信息给ISV；2) 企业客户职员业务受理接口：企业建立用户时调用，平台会传送用户信息给ISV；3) 角色列表同步〔读取〕接口：企业给用户分配权限时调用，假如产品无角色功能，可不实现4) 用户角色权限同步〔读取〕接口：企业给用户分配权限时调用，假如产品无角色功能，可不实现5) 用户角色权限同步〔更新〕接口：企业给用户分配权限时调用，假如产品无角色功能，可不实现5 接口定义5.1 接口实现形式平台与ISV之间的交互接口的实现有三种形式，具体如下：1) 双方提供Web Service供对方调用，参数与返回值使用实体对象〔实体类〕，较适用于.Net平台或Java平台2) 双方提供Web Service供对方调用，参数与返回值使用字符串〔XML文本〕，较适用于Java平台或其它异构平台。

3) 双方提供接收Post数据的页面，Post的数据及返回值均为字符串〔XML文本〕，较适用于Java平台或其它异构平台如PHP、ASP等5.2 平台提供给ISV的接口5.2.1 Web Service〔参数为实体对象〕方法名称SaaSISVInterfaceXMLString参数数据类型RequestInfo返回值数据类型ResponseInfo5.2.2 Web Service〔参数为XML字符串〕方法名称SaaSISVInterfaceXMLString参数数据类型String返回值数据类型String5.2.3 Post方式要求方法POST参数形式Msg=xml格式的字符串参数数据类型String返回值数据类型String5.3 ISV需要实现的接口定义ISV从接口实现的三种方式中，选择一种适合自己平台的方式实现给平台调用的接口5.3.1 实现方式1：Web Service〔参数为实体对象〕方法名称ISVSaaSInterface参数数据类型RequestInfo返回值数据类型ResponseInfo5.3.2 实现方式2：Web Service〔参数为XML字符串〕方法名称ISVSaaSInterfaceXMLString参数数据类型String返回值数据类型String5.3.3 实现方式3：Post方式要求方法POST参数形式Msg=xml格式的字符串参数数据类型String返回值数据类型String5.4 ISV接口实现本卷须知1) Web Service方法只有一个参数，通过传递不同的参数Code来指定调用的功能。

2) namespace 必须是： ://SaaSInterface.Sispark.Microsoft /，包括最后一个反斜线几种实现方式提供的接口方法的功能一样，只是参数和返回值类型不同具体的业务功能和返回信息由要求消息头的操作码〔操作码〕决定，即接口调用只有一个入口例如如下：public ResponseInfo ISVSaaSInterface(RequestInfo req) { ResponseInfo resp = new ResponseInfo(); switch (req.Head.Code) { //企业客户业务受理接口 case "ISV10101": { resp = ISV10101CorpBind.ExecuteBusiness(req); return resp; } //企业客户职员业务受理接口 case "ISV10102": { resp = ISV10102StaffBind.ExecuteBusiness(req); return resp; } //角色列表同步〔读取〕接口 case "ISV10201": { resp = ISV10201PullRoles.ExecuteBusiness(req); return resp; } //用户角色权限同步〔读取〕接口 case "ISV10202": { resp = ISV10202PullUserRole.ExecuteBusiness(req); return resp; } //用户角色权限同步〔更新〕接口 case "ISV10203": { resp = ISV10203SyncUserRole.ExecuteBusiness(req); return resp; } //未知接口，非法调用 default: { return null; } } }5.5 接口调用例如5.5.1 例如：Web Service〔参数为实体对象〕 //构造RequestInfo对象并赋值 RequestInfo request = new RequestInfo(); RequestHeadInfo reqHead = new RequestHeadInfo(); reqHead.SubmitTime = "20。