《2020年(产品管理）ISV产品接入指南2（DOC33页）_》由会员分享，可在线阅读，更多相关《2020年(产品管理）ISV产品接入指南2（DOC33页）_（46页珍藏版）》请在金锄头文库上搜索。
1、云计算ISV产品接入指南目 录1文档目的32ISV接入提交项33接口开发与测试环境34ISV接入工作内容45接口定义55.1接口实现形式55.2平台提供给ISV的接口55.2.1Web Service（参数为实体对象）55.2.2Web Service（参数为XML字符串）55.2.3Post方式55.3ISV需要实现的接口定义65.3.1实现方式1：Web Service（参数为实体对象）65.3.2实现方式2：Web Service（参数为XML字符串）65.3.3实现方式3：Post方式65.4ISV接口实现注意事项65.5接口调用示例75.5.1示例：Web Service（参数为实体
2、对象）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开通企业客户测
3、试337.4企业用户授权测试337.4.1集成授权测试1337.4.2集成授权测试2347.5产品登录测试34RD-PI-0807003 50/501 文档目的本文档用于帮助ISV了解其产品接入平台时需要进行哪些工作、如何进行这些工作、完成后如何进行测试等，ISV在开始接入工作前，请详细阅读此文档内容。2 ISV接入提交项类型提交项重要程度描述文档产品图标必需用户订购时显示的产品图标产品介绍必需产品简介，介绍产品的宣传亮点、在技术、功能、应用等方面的特点，以及产品能为用户在哪些方面带来价值等用户手册必需详细介绍产品的管理功能与应用功能的使用方法，指导企业的管理员与最终用户使用系统安装手册必需系
4、统的安装部署说明文档，能让平台维护人员参照此文档即可自行完成产品部署FAQ可选提供最终用户在使用系统中遇到一些常见的问题时的一般解决方法多媒体培训材料可选Flash、视频或其它形式的多媒体培训材料程序系统程序必需产品可运行程序与数据库等接口程序必需产品接口可运行程序产品接口访问地址必需产品接口部署后的访问地址，其中的主机名与端口可替换为实际部署环境的主机名与端口产品系统访问地址必需产品部署后的访问地址，其中的主机名与端口可替换为实际部署环境的主机名与端口3 接口开发与测试环境资源描述http:/222.92.117.85:7012沙箱环境平台登录地址http:/222.92.117.85:70
5、11/SaaS2ISVInterface.asmx沙箱环境平台Web Service地址http:/222.92.117.85:7011/SaaS2ISVInterfaceURl.aspx沙箱环境接收Post数据地址http:/222.92.117.85:7012/SSOLogin.aspx沙箱环境平台单点登录地址http:/222.92.117.85:7009提供示例程序、加解密算法、接口调用日志查看、SDK等辅助调试资源4 ISV接入工作内容u ISV产品改造1) 平台中维护的数据，ISV产品中不可增加或删除，如企业、用户。2) 平台中维护的数据，ISV产品中仅可编辑平台中不包含的数据属性
6、的值。3) 去掉登录页面4) 去掉注销、退出等功能5) 去掉修改密码、修改个人信息等功能6) 平台用户的ID为GUID，ISV需实现此ID与其产品中的用户身份的对应。7) 提供体验功能，能让用户点击产品体验链接后，以一个默认体验帐号的身份直接进入系统，让用户简单试用。u ISV接口实现1) 企业客户业务受理接口：企业订购时调用，平台会传送企业的信息给ISV；2) 企业客户员工业务受理接口：企业建立用户时调用，平台会传送用户信息给ISV；3) 角色列表同步（读取）接口：企业给用户分配权限时调用，如果产品无角色功能，可不实现。4) 用户角色权限同步（读取）接口：企业给用户分配权限时调用，如果产品无
7、角色功能，可不实现。5) 用户角色权限同步（更新）接口：企业给用户分配权限时调用，如果产品无角色功能，可不实现。5 接口定义5.1 接口实现形式平台与ISV之间的交互接口的实现有三种形式，具体如下：1) 双方提供Web Service供对方调用，参数与返回值使用实体对象（实体类），较适用于.Net平台或Java平台。2) 双方提供Web Service供对方调用，参数与返回值使用字符串（XML文本），较适用于Java平台或其它异构平台。3) 双方提供接收Post数据的页面，Post的数据及返回值均为字符串（XML文本），较适用于Java平台或其它异构平台如PHP、ASP等。5.2 平台提供给I
8、SV的接口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
9、 实现方式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
10、) namespace 必须是：http:/SaaSInterface.Sispark.M ResponseInfo ISVSaaSInterface(RequestInfo req) ResponseInfo resp = new ResponseInfo(); switch (req.Head.Code) /企业客户业务受理接口 case ISV10101: resp = ISV10101CorpBind.ExecuteBusiness(req); return resp; /企业客户员工业务受理接口 case ISV10102: resp = ISV10102StaffBind.Exec
11、uteBusiness(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();
