ISV产品接入指南.DOC

ISV产品接入指南 目 录 1 文档目的 3 2 ISV接入提交项 3 3 接口开发与测试环境 3 4 ISV接入工作内容 3 5 接口定义 5 5.1 接口实现形式 5 5.2 平台提供给ISV的接口 5 5.2.1 Web Service（参数为实体对象） 5 5.2.2 Web Service（参数为XML字符串） 5 5.2.3 Post方式 5 5.3 ISV需要实现的接口定义 6 5.3.1 实现方式1：Web Service（参数为实体对象） 6 5.3.2 实现方式2：Web Service（参数为XML字符串） 6 5.3.3 实现方式3：Post方式 6 5.4 ISV接口实现注意事项 6 5.5 接口调用示例 7 5.5.1 示例：Web Service（参数为实体对象） 7 5.5.2 示例：Web Service（参数为XML字符串） 8 5.5.3 示例：Post方式 8 5.6 接口消息格式 9 5.6.1 请求消息 9 5.6.2 返回消息 10 5.7 消息体加密处理 11 5.8 消息调用返回码定义 12 6 接口开发与产品改造指南 14 6.1 接口实现过程步骤 14 6.2 配置文件 14 6.3 接口实现 15 6.3.1 产品订购 15 6.3.2 用户授权 17 6.3.3 产品登录 24 6.3.4 心跳保持 26 6.3.5 数据同步 27 6.3.6 客户端登录 27 7 接口测试指南 28 7.1 测试准备工作 28 7.1.1 基本数据准备 28 7.1.2 基本数据检查 28 7.2 加解密算法测试 29 7.3 开通企业客户测试 29 7.4 企业用户授权测试 29 7.4.1 集成授权测试1 29 7.4.2 集成授权测试2 30 7.5 产品登录测试 30 文档目的 本文档用于帮助ISV了解其产品接入平台时需要进行哪些工作、如何进行这些工作、完成后如何进行测试等，ISV在开始接入工作前，请详细阅读此文档内容。 ISV接入提交项 类型 提交项 重要程度 描述 程序 系统程序 必需 产品可运行程序与数据库等 接口程序 必需 产品接口可运行程序 产品接口访问地址 必需 产品接口部署后的访问地址，其中的主机名与端口可替换为实际部署环境的主机名与端口 产品系统访问地址 必需 产品部署后的访问地址，其中的主机名与端口可替换为实际部署环境的主机名与端口 接口开发与测试环境 资源 描述 5:7012 沙箱环境平台登录地址 5:7011/SaaS2ISVInterface.asmx 沙箱环境平台Web Service地址 5:7011/SaaS2ISVInterfaceUrl.aspx 沙箱环境接收Post数据地址 5:7012/SSOLogin.aspx 沙箱环境平台单点登录地址 5:7009 提供示例程序、加解密算法、接口调用日志查看、SDK等辅助调试资源 ISV接入工作内容 ISV产品改造 平台中维护的数据，ISV产品中不可增加或删除，如企业、用户。 平台中维护的数据，ISV产品中仅可编辑平台中不包含的数据属性的值。 去掉登录页面 去掉注销、退出等功能 去掉修改密码、修改个人信息等功能 平台用户的ID为GUID，ISV需实现此ID与其产品中的用户身份的对应。 提供体验功能，能让用户点击产品体验链接后，以一个默认体验帐号的身份直接进入系统，让用户简单试用。 ISV接口实现 企业客户业务受理接口：企业订购时调用，平台会传送企业的信息给ISV； 企业客户员工业务受理接口：企业建立用户时调用，平台会传送用户信息给ISV； 角色列表同步（读取）接口：企业给用户分配权限时调用，如果产品无角色功能，可不实现。 用户角色权限同步（读取）接口：企业给用户分配权限时调用，如果产品无角色功能，可不实现。 用户角色权限同步（更新）接口：企业给用户分配权限时调用，如果产品无角色功能，可不实现。 接口定义 接口实现形式 平台与ISV之间的交互接口的实现有三种形式，具体如下： 双方提供Web Service供对方调用，参数与返回值使用实体对象（实体类），较适用于.Net平台或Java平台。 双方提供Web Service供对方调用，参数与返回值使用字符串（XML文本），较适用于Java平台或其它异构平台。 双方提供接收Post数据的页面，Post的数据及返回值均为字符串（XML文本），较适用于Java平台或其它异构平台如PHP、ASP等。 我们推荐使用Post方式（编程简单、测试方便）。 平台提供给ISV的接口 Web Service（参数为实体对象） 方法名称 SaaSISVInterfaceXMLString 参数数据类型 RequestInfo